diff options
267 files changed, 14801 insertions, 7680 deletions
diff --git a/MANIFEST.in b/MANIFEST.in index 9495469b..6c867365 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -29,7 +29,7 @@ recursive-include lib/ansible/modules *.yml recursive-include lib/ansible/plugins/test *.yml recursive-include lib/ansible/plugins/filter *.yml recursive-include licenses *.txt -recursive-include packaging * +recursive-include packaging Makefile *.py recursive-include test/ansible_test *.py Makefile recursive-include test/integration * recursive-include test/lib/ansible_test/config *.yml *.template @@ -37,7 +37,7 @@ recursive-include test/lib/ansible_test/_data *.cfg *.in *.ini *.ps1 *.txt *.yml recursive-include test/lib/ansible_test/_util *.cfg *.ini *.json *.ps1 *.psd1 *.py *.sh *.txt *.yml recursive-include test/lib/ansible_test/_util/controller/sanity/validate-modules validate-modules recursive-include test/sanity *.in *.json *.py *.txt -recursive-include test/support *.py *.ps1 *.psm1 *.cs +recursive-include test/support *.py *.ps1 *.psm1 *.cs *.md exclude test/sanity/code-smell/botmeta.* exclude test/sanity/code-smell/release-names.* exclude test/lib/ansible_test/_internal/commands/sanity/bin_symlinks.py @@ -1,6 +1,6 @@ Metadata-Version: 2.1 Name: ansible-core -Version: 2.14.3 +Version: 2.14.6 Summary: Radically simple IT automation Home-page: https://ansible.com/ Author: Ansible, Inc. diff --git a/bin/ansible-doc b/bin/ansible-doc index 80365303..9f560bcb 100755 --- a/bin/ansible-doc +++ b/bin/ansible-doc @@ -1241,10 +1241,16 @@ class DocCLI(CLI, RoleMixin): if 'module' in item: text.append(textwrap.fill(DocCLI.tty_ify('Module %s' % item['module']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) - description = item.get('description', 'The official documentation on the %s module.' % item['module']) - text.append(textwrap.fill(DocCLI.tty_ify(description), limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) - text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink('modules/%s_module.html' % item['module'])), - limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) + description = item.get('description') + if description is None and item['module'].startswith('ansible.builtin.'): + description = 'The official documentation on the %s module.' % item['module'] + if description is not None: + text.append(textwrap.fill(DocCLI.tty_ify(description), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) + if item['module'].startswith('ansible.builtin.'): + relative_url = 'collections/%s_module.html' % item['module'].replace('.', '/', 2) + text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink(relative_url)), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) elif 'name' in item and 'link' in item and 'description' in item: text.append(textwrap.fill(DocCLI.tty_ify(item['name']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) diff --git a/bin/ansible-galaxy b/bin/ansible-galaxy index 3cb7fe2c..c280380c 100755 --- a/bin/ansible-galaxy +++ b/bin/ansible-galaxy @@ -27,7 +27,7 @@ from ansible import context from ansible.cli.arguments import option_helpers as opt_help from ansible.errors import AnsibleError, AnsibleOptionsError from ansible.galaxy import Galaxy, get_collections_galaxy_meta_info -from ansible.galaxy.api import GalaxyAPI +from ansible.galaxy.api import GalaxyAPI, GalaxyError from ansible.galaxy.collection import ( build_collection, download_collections, @@ -242,7 +242,7 @@ class GalaxyCLI(CLI): help='The Ansible Galaxy API key which can be found at ' 'https://galaxy.ansible.com/me/preferences.') common.add_argument('-c', '--ignore-certs', action='store_true', dest='ignore_certs', help='Ignore SSL certificate validation errors.', default=None) - common.add_argument('--timeout', dest='timeout', type=int, + common.add_argument('--timeout', dest='timeout', type=int, default=60, help="The time to wait for operations against the galaxy server, defaults to 60s.") opt_help.add_verbosity_options(common) @@ -1214,7 +1214,7 @@ class GalaxyCLI(CLI): remote_data = None try: remote_data = self.api.lookup_role_by_name(role, False) - except AnsibleError as e: + except GalaxyError as e: if e.http_code == 400 and 'Bad Request' in e.message: # Role does not exist in Ansible Galaxy data = u"- the role %s was not found" % role diff --git a/bin/ansible-playbook b/bin/ansible-playbook index c94cf0ff..9c091a67 100755 --- a/bin/ansible-playbook +++ b/bin/ansible-playbook @@ -54,6 +54,8 @@ class PlaybookCLI(CLI): opt_help.add_module_options(self.parser) # ansible playbook specific opts + self.parser.add_argument('--syntax-check', dest='syntax', action='store_true', + help="perform a syntax check on the playbook, but do not execute it") self.parser.add_argument('--list-tasks', dest='listtasks', action='store_true', help="list all tasks that would be executed") self.parser.add_argument('--list-tags', dest='listtags', action='store_true', diff --git a/changelogs/CHANGELOG-v2.14.rst b/changelogs/CHANGELOG-v2.14.rst index d54fccbd..51436b14 100644 --- a/changelogs/CHANGELOG-v2.14.rst +++ b/changelogs/CHANGELOG-v2.14.rst @@ -5,6 +5,101 @@ ansible-core 2.14 "C'mon Everybody" Release Notes .. contents:: Topics +v2.14.6 +======= + +Release Summary +--------------- + +| Release Date: 2023-05-22 +| `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + +Minor Changes +------------- + +- ansible-test - Allow float values for the ``--timeout`` option to the ``env`` command. This simplifies testing. +- ansible-test - Refactored ``env`` command logic and timeout handling. +- ansible-test - Use ``datetime.datetime.now`` with ``tz`` specified instead of ``datetime.datetime.utcnow``. + +Bugfixes +-------- + +- Display - Defensively configure writing to stdout and stderr with the replace encoding error handler that will replace invalid characters (https://github.com/ansible/ansible/issues/80258) +- Properly disable ``jinja2_native`` in the template module when jinja2 override is used in the template (https://github.com/ansible/ansible/issues/80605) +- ansible-galaxy - fix installing signed collections (https://github.com/ansible/ansible/issues/80648). +- ansible-galaxy collection verify - fix verifying signed collections when the keyring is not configured. +- ansible-test - Fix handling of timeouts exceeding one day. +- ansible-test - Fix various cases where the test timeout could expire without terminating the tests. +- ansible-test - When bootstrapping remote FreeBSD instances, use the OS packaged ``setuptools`` instead of installing the latest version from PyPI. +- pep517 build backend - Copy symlinks when copying the source tree. This avoids tracebacks in various scenarios, such as when a venv is present in the source tree. + +v2.14.5 +======= + +Release Summary +--------------- + +| Release Date: 2023-04-24 +| `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + +Bugfixes +-------- + +- Windows - Display a warning if the module failed to cleanup any temporary files rather than failing the task. The warning contains a brief description of what failed to be deleted. +- Windows - Ensure the module temp directory contains more unique values to avoid conflicts with concurrent runs - https://github.com/ansible/ansible/issues/80294 +- Windows - Improve temporary file cleanup used by modules. Will use a more reliable delete operation on Windows Server 2016 and newer to delete files that might still be open by other software like Anti Virus scanners. There are still scenarios where a file or directory cannot be deleted but the new method should work in more scenarios. +- ansible-doc - stop generating wrong module URLs for module see-alsos. The URLs for modules in ansible.builtin do now work, and URLs for modules outside ansible.builtin are no longer added (https://github.com/ansible/ansible/pull/80280). +- ansible-galaxy - Improve retries for collection installs, to properly retry, and extend retry logic to common URL related connection errors (https://github.com/ansible/ansible/issues/80170 https://github.com/ansible/ansible/issues/80174) +- ansible-galaxy - reduce API calls to servers by fetching signatures only for final candidates. +- ansible-test - Add support for ``argcomplete`` version 3. +- jinja2_native - fix intermittent 'could not find job' failures when a value of ``ansible_job_id`` from a result of an async task was inadvertently changed during execution; to prevent this a format of ``ansible_job_id`` was changed. +- password lookup now correctly reads stored ident fields. +- pep517 build backend - Use the documented ``import_module`` import from ``importlib``. +- roles - Fix templating ``public``, ``allow_duplicates`` and ``rolespec_validate`` (https://github.com/ansible/ansible/issues/80304). +- syntax check - Limit ``--syntax-check`` to ``ansible-playbook`` only, as that is the only CLI affected by this argument (https://github.com/ansible/ansible/issues/80506) + +v2.14.4 +======= + +Release Summary +--------------- + +| Release Date: 2023-03-27 +| `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + +Minor Changes +------------- + +- ansible-test - Moved git handling out of the validate-modules sanity test and into ansible-test. +- ansible-test - Removed the ``--keep-git`` sanity test option, which was limited to testing ansible-core itself. +- ansible-test - Updated the Azure Pipelines CI plugin to work with newer versions of git. + +Breaking Changes / Porting Guide +-------------------------------- + +- ansible-test - Integration tests which depend on specific file permissions when running in an ansible-test managed host environment may require changes. Tests that require permissions other than ``755`` or ``644`` may need to be updated to set the necessary permissions as part of the test run. + +Bugfixes +-------- + +- Fix ``MANIFEST.in`` to exclude unwanted files in the ``packaging/`` directory. +- Fix ``MANIFEST.in`` to include ``*.md`` files in the ``test/support/`` directory. +- Fix an issue where the value of ``become`` was ignored when used on a role used as a dependency in ``main/meta.yml`` (https://github.com/ansible/ansible/issues/79777) +- ``ansible_eval_concat`` - avoid redundant unsafe wrapping of templated strings converted to Python types +- ansible-galaxy role info - fix unhandled AttributeError by catching the correct exception. +- ansible-test - Always indicate the Python version being used before installing requirements. Resolves issue https://github.com/ansible/ansible/issues/72855 +- ansible-test - Exclude ansible-core vendored Python packages from ansible-test payloads. +- ansible-test - Integration test target prefixes defined in a ``tests/integration/target-prefixes.{group}`` file can now contain an underscore (``_``) character. Resolves issue https://github.com/ansible/ansible/issues/79225 +- ansible-test - Removed pointless comparison in diff evaluation logic. +- ansible-test - Set ``PYLINTHOME`` for the ``pylint`` sanity test to prevent failures due to ``pylint`` checking for the existence of an obsolete home directory. +- ansible-test - Support loading of vendored Python packages from ansible-core. +- ansible-test - Use consistent file permissions when delegating tests to a container or remote host. Files with any execute bit set will use permissions ``755``. All other files will use permissions ``644``. (Resolves issue https://github.com/ansible/ansible/issues/75079) +- copy - fix creating the dest directory in check mode with remote_src=True (https://github.com/ansible/ansible/issues/78611). +- copy - fix reporting changes to file attributes in check mode with remote_src=True (https://github.com/ansible/ansible/issues/77957). + v2.14.3 ======= diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index 8331a9bc..18bf7b13 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -1117,3 +1117,190 @@ releases: - strategy_badid_fix.yml - v2.14.3rc1_summary.yaml release_date: '2023-02-20' + 2.14.4: + changes: + release_summary: '| Release Date: 2023-03-27 + + | `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.4_summary.yaml + release_date: '2023-03-27' + 2.14.4rc1: + changes: + breaking_changes: + - ansible-test - Integration tests which depend on specific file permissions + when running in an ansible-test managed host environment may require changes. + Tests that require permissions other than ``755`` or ``644`` may need to be + updated to set the necessary permissions as part of the test run. + bugfixes: + - Fix ``MANIFEST.in`` to exclude unwanted files in the ``packaging/`` directory. + - Fix ``MANIFEST.in`` to include ``*.md`` files in the ``test/support/`` directory. + - Fix an issue where the value of ``become`` was ignored when used on a role + used as a dependency in ``main/meta.yml`` (https://github.com/ansible/ansible/issues/79777) + - '``ansible_eval_concat`` - avoid redundant unsafe wrapping of templated strings + converted to Python types' + - ansible-galaxy role info - fix unhandled AttributeError by catching the correct + exception. + - ansible-test - Always indicate the Python version being used before installing + requirements. Resolves issue https://github.com/ansible/ansible/issues/72855 + - ansible-test - Exclude ansible-core vendored Python packages from ansible-test + payloads. + - ansible-test - Integration test target prefixes defined in a ``tests/integration/target-prefixes.{group}`` + file can now contain an underscore (``_``) character. Resolves issue https://github.com/ansible/ansible/issues/79225 + - ansible-test - Removed pointless comparison in diff evaluation logic. + - ansible-test - Set ``PYLINTHOME`` for the ``pylint`` sanity test to prevent + failures due to ``pylint`` checking for the existence of an obsolete home + directory. + - ansible-test - Support loading of vendored Python packages from ansible-core. + - ansible-test - Use consistent file permissions when delegating tests to a + container or remote host. Files with any execute bit set will use permissions + ``755``. All other files will use permissions ``644``. (Resolves issue https://github.com/ansible/ansible/issues/75079) + - copy - fix creating the dest directory in check mode with remote_src=True + (https://github.com/ansible/ansible/issues/78611). + - copy - fix reporting changes to file attributes in check mode with remote_src=True + (https://github.com/ansible/ansible/issues/77957). + minor_changes: + - ansible-test - Moved git handling out of the validate-modules sanity test + and into ansible-test. + - ansible-test - Removed the ``--keep-git`` sanity test option, which was limited + to testing ansible-core itself. + - ansible-test - Updated the Azure Pipelines CI plugin to work with newer versions + of git. + release_summary: '| Release Date: 2023-03-21 + + | `Porting Guide <https://docs.ansible.com/ansible/devel/porting_guides.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.4rc1_summary.yaml + - 78624-copy-remote-src-check-mode.yml + - 79777-fix-inheritance-roles-meta.yml + - a-g-role-fix-catching-exception.yml + - ansible-test-fix-pointless-comparison.yml + - ansible-test-git-handling.yml + - ansible-test-integration-target-prefixes.yml + - ansible-test-payload-file-permissions.yml + - ansible-test-pylint-home.yml + - ansible-test-requirements-message.yml + - ansible-test-vendoring-support.yml + - ansible_eval_concat-remove-redundant-unsafe-wrap.yml + - fix-manifest.yml + release_date: '2023-03-21' + 2.14.5: + changes: + release_summary: '| Release Date: 2023-04-24 + + | `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.5_summary.yaml + release_date: '2023-04-24' + 2.14.5rc1: + changes: + bugfixes: + - Windows - Display a warning if the module failed to cleanup any temporary + files rather than failing the task. The warning contains a brief description + of what failed to be deleted. + - Windows - Ensure the module temp directory contains more unique values to + avoid conflicts with concurrent runs - https://github.com/ansible/ansible/issues/80294 + - Windows - Improve temporary file cleanup used by modules. Will use a more + reliable delete operation on Windows Server 2016 and newer to delete files + that might still be open by other software like Anti Virus scanners. There + are still scenarios where a file or directory cannot be deleted but the new + method should work in more scenarios. + - ansible-doc - stop generating wrong module URLs for module see-alsos. The + URLs for modules in ansible.builtin do now work, and URLs for modules outside + ansible.builtin are no longer added (https://github.com/ansible/ansible/pull/80280). + - ansible-galaxy - Improve retries for collection installs, to properly retry, + and extend retry logic to common URL related connection errors (https://github.com/ansible/ansible/issues/80170 + https://github.com/ansible/ansible/issues/80174) + - ansible-galaxy - reduce API calls to servers by fetching signatures only for + final candidates. + - ansible-test - Add support for ``argcomplete`` version 3. + - jinja2_native - fix intermittent 'could not find job' failures when a value + of ``ansible_job_id`` from a result of an async task was inadvertently changed + during execution; to prevent this a format of ``ansible_job_id`` was changed. + - password lookup now correctly reads stored ident fields. + - pep517 build backend - Use the documented ``import_module`` import from ``importlib``. + - roles - Fix templating ``public``, ``allow_duplicates`` and ``rolespec_validate`` + (https://github.com/ansible/ansible/issues/80304). + - syntax check - Limit ``--syntax-check`` to ``ansible-playbook`` only, as that + is the only CLI affected by this argument (https://github.com/ansible/ansible/issues/80506) + release_summary: '| Release Date: 2023-04-17 + + | `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.5rc1_summary.yaml + - 80280-ansible-doc-seealso-urls.yml + - 80334-reduce-ansible-galaxy-api-calls.yml + - 80506-syntax-check-playbook-only.yml + - ansible-basic-tmpdir-uniqueness.yml + - ansible-test-argcomplete-3.yml + - fix-templating-private-role-FA.yml + - fix_jinja_native_async.yml + - galaxy-improve-retries.yml + - password_lookup_file_fix.yml + - pep517-backend-import-fix.yml + - win-temp-cleanup.yml + release_date: '2023-04-17' + 2.14.6: + changes: + release_summary: '| Release Date: 2023-05-22 + + | `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.6_summary.yaml + release_date: '2023-05-22' + 2.14.6rc1: + changes: + bugfixes: + - Display - Defensively configure writing to stdout and stderr with the replace + encoding error handler that will replace invalid characters (https://github.com/ansible/ansible/issues/80258) + - Properly disable ``jinja2_native`` in the template module when jinja2 override + is used in the template (https://github.com/ansible/ansible/issues/80605) + - ansible-galaxy - fix installing signed collections (https://github.com/ansible/ansible/issues/80648). + - ansible-galaxy collection verify - fix verifying signed collections when the + keyring is not configured. + - ansible-test - Fix handling of timeouts exceeding one day. + - ansible-test - Fix various cases where the test timeout could expire without + terminating the tests. + - ansible-test - When bootstrapping remote FreeBSD instances, use the OS packaged + ``setuptools`` instead of installing the latest version from PyPI. + - pep517 build backend - Copy symlinks when copying the source tree. This avoids + tracebacks in various scenarios, such as when a venv is present in the source + tree. + minor_changes: + - ansible-test - Allow float values for the ``--timeout`` option to the ``env`` + command. This simplifies testing. + - ansible-test - Refactored ``env`` command logic and timeout handling. + - ansible-test - Use ``datetime.datetime.now`` with ``tz`` specified instead + of ``datetime.datetime.utcnow``. + release_summary: '| Release Date: 2023-05-15 + + | `Porting Guide <https://docs.ansible.com/ansible-core/2.14/porting_guides/porting_guide_core_2.14.html>`__ + + ' + codename: C'mon Everybody + fragments: + - 2.14.6rc1_summary.yaml + - 80258-defensive-display-non-utf8.yml + - 80605-template-overlay-native-jinja.yml + - 80648-fix-ansible-galaxy-cache-signatures-bug.yml + - ansible-test-freebsd-bootstrap-setuptools.yml + - ansible-test-long-timeout-fix.yml + - ansible-test-timeout-fix.yml + - ansible-test-utcnow.yml + - pep517-backend-traceback-fix.yml + release_date: '2023-05-15' diff --git a/docs/docsite/rst/community/collection_contributors/collection_integration_updating.rst b/docs/docsite/rst/community/collection_contributors/collection_integration_updating.rst index 46d18c06..b519c4d4 100644 --- a/docs/docsite/rst/community/collection_contributors/collection_integration_updating.rst +++ b/docs/docsite/rst/community/collection_contributors/collection_integration_updating.rst @@ -106,7 +106,7 @@ We will add the following code to the file. .. code-block:: yaml # https://github.com/ansible-collections/community.postgresql/issues/NUM - # We should also run the same tasks with check_mode: yes. We omit it here for simplicity. + # We should also run the same tasks with check_mode: true. We omit it here for simplicity. - name: Test for new_option, create new user WITHOUT the attribute community.postgresql.postgresql_user: name: test_user @@ -149,7 +149,7 @@ We will add the following code to the file. Then we :ref:`run the tests<collection_run_integration_tests>` with ``postgresql_user`` passed as a test target. -In reality, we would alternate the tasks above with the same tasks run with the ``check_mode: yes`` option to be sure our option works as expected in check-mode as well. See :ref:`Recommendations on coverage<collection_integration_recommendations>` for details. +In reality, we would alternate the tasks above with the same tasks run with the ``check_mode: true`` option to be sure our option works as expected in check-mode as well. See :ref:`Recommendations on coverage<collection_integration_recommendations>` for details. If we expect a task to fail, we use the ``ignore_errors: true`` option and check that the task actually failed and returned the message we expect: diff --git a/docs/docsite/rst/community/collection_contributors/collection_requirements.rst b/docs/docsite/rst/community/collection_contributors/collection_requirements.rst new file mode 100644 index 00000000..bae0f21d --- /dev/null +++ b/docs/docsite/rst/community/collection_contributors/collection_requirements.rst @@ -0,0 +1,499 @@ +.. _collections_requirements: + +************************************************** +Ansible community package collections requirements +************************************************** + +This section describes the requirements for maintainers of Ansible community collections in the `ansible-collections <https://github.com/ansible-collections>`_ repository or included in the Ansible community package. + +.. contents:: + :local: + + +Overview +======== + +This section provides help, advice, and guidance on making sure your collections are correct and ready for inclusion in the Ansible community package. + +.. note:: + + `Inclusion of a new collection <https://github.com/ansible-collections/ansible-inclusion>`_ in the Ansible package is ultimately at the discretion of the :ref:`community_steering_committee`. Every rejected candidate will get feedback. Differences of opinion should be taken to a dedicated `Community Topic <https://github.com/ansible-community/community-topics/issues>`_ for discussion and a final vote. + +Feedback and communications +============================== + +As with any project it is very important that we get feedback from users, contributors, and maintainers. You can get feedback and help as follows: + +* Discussing in the `#community:ansible.com Matrix room <https://matrix.to/#/#community:ansible.com>`_, which is bridged with the ``#ansible-community`` channel on Libera.Chat IRC. See the :ref:`Ansible Communication Guide <communication_irc>` for details. +* Discussing in the `Community Working Group meeting <https://github.com/ansible/community/blob/main/meetings/README.md#wednesdays>`_. +* Creating `GitHub Issues <https://github.com/ansible-collections/overview/issues>`_ in the ``ansible-collections`` repository. + +Keeping informed +================ + +You should subscribe to: + +* The `news-for-maintainers repository <https://github.com/ansible-collections/news-for-maintainers>`_ to track changes that collection maintainers should be aware of. Subscribe only to issues if you want less traffic. +* The `Bullhorn <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ Ansible contributor newsletter. + +.. _coll_infrastructure_reqs: + +Collection infrastructure +========================= + + +The following guidelines describe the required structure for your collection: + +* MUST have a publicly available issue tracker that does not require a paid level of service to create an account or view issues. +* MUST have a Code of Conduct (CoC). + + * The collection's CoC MUST be compatible with the :ref:`code_of_conduct`. + * The collections SHOULD consider using the Ansible CoC if they do not have a CoC that they consider better. + * The :ref:`Diversity and Inclusion working group <working_group_list>` may evaluate all CoCs and object to a collection's inclusion based on the CoCs contents. + * The CoC MUST be linked from the ``README.md`` file, or MUST be present or linked from the ``CODE_OF_CONDUCT.md`` file in the collection root. + +* MUST be published to `Ansible Galaxy <https://galaxy.ansible.com>`_. +* SHOULD NOT contain any large objects (binaries) comparatively to the current Galaxy tarball size limit of 20 MB, For example, do not include package installers for testing purposes. +* SHOULD NOT contain any unnecessary files such as temporary files. +* MUST only contain objects that follow the :ref:`Licensing rules <coll_licensing_req>`. + + +.. _coll_python_compatibility: + +Python Compatibility +==================== + +A collection MUST be developed and tested using the below Python requirements as Ansible supports a wide variety of machines. + +The collection should adhere to the tips at :ref:`ansible-and-python-3`. + +.. _coll_python_reqs: + +Python Requirements +------------------- + +Python requirements for a collection vary between **controller environment** and **other environment**. On the controller-environment, the Python versions required may be higher than what is required on the other-environment. While developing a collection, you need to understand the definitions of both the controller-environment and other-environment to help you choose Python versions accordingly: + +* controller environment: The plugins/modules always run in the same environment (Python interpreter, venv, host, and so on) as ansible-core itself. +* other environment: It is possible, even if uncommon in practice, for the plugins/modules to run in a different environment than ansible-core itself. + +One example scenario where the "even if" clause comes into play is when using cloud modules. These modules mostly run on the controller node but in some environments, the controller might run on one machine inside a demilitarized zone which cannot directly access the cloud machines. The user has to have the cloud modules run on a bastion host/jump server which has access to the cloud machines. + +.. _coll_controller_req: + +Controller environment +~~~~~~~~~~~~~~~~~~~~~~ + +In the controller environment, collections MUST support Python 2 (version 2.7) and Python 3 (Version 3.6 and higher), unless required libraries do not support these versions. Collections SHOULD also support Python v3.5 if all required libraries support this version. + +Other environment +~~~~~~~~~~~~~~~~~ + +In the other environment, collections MUST support Python 2 (version 2.7) and Python 3 (Version 3.6 and higher), unless required libraries do not support these versions. Collections SHOULD also support Python v2.6 and v3.5 if all required libraries support this version. + +.. note:: + + If the collection does not support Python 2.6 and/or Python 3.5 explicitly then take the below points into consideration: + + - Dropping support for Python 2.6 in the other environment means that you are dropping support for RHEL6. RHEL6 ended full support in November, 2020, but some users are still using RHEL6 under extended support contracts (ELS) until 2024. ELS is not full support; not all CVEs of the python-2.6 interpreter are fixed, for instance. + + - Dropping support for Python 3.5 means that Python 2.7 has to be installed on Ubuntu Xenial (16.04) and that you have to support Python 2.7. + + Also, note that dropping support for a Python version for an existing module/plugin is a breaking change, and thus requires a major release. A collection MUST announce dropping support for Python versions in their changelog, if possible in advance (for example, in previous versions before support is dropped). + +.. _coll_python_docs_req: + +Python documentation requirements +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* If everything in your collection supports the same Python versions as the collection-supported versions of ansible-core, you do not need to document Python versions. +* If your collection does not support those Python versions, you MUST document which versions it supports in the README. +* If most of your collection supports the same Python versions as ansible-core, but some modules and plugins do not, you MUST include the supported Python versions in the documentation for those modules and plugins. + +For example, if your collection supports Ansible 2.9 to ansible-core 2.13, the Python versions supported for modules are 2.6, 2.7, and 3.5 and newer (until at least 3.10), while the Python versions supported for plugins are 2.7 and 3.5 and newer (until at least 3.10). So if the modules in your collection do not support Python 2.6, you have to document this in the README, for example ``The content in this collection supports Python 2.7, Python 3.5 and newer.``. + +.. _coll_plugin_standards: + +Standards for developing module and plugin utilities +==================================================== + +* ``module_utils`` and ``plugin_utils`` can be marked for only internal use in the collection, but they MUST document this and MUST use a leading underscore for filenames. +* It is a breaking change when you make an existing ``module_utils`` private and in that case the collection requires a major version bump. +* Below are some recommendations for ``module_utils`` documentation: + + * No docstring: everything we recommend for ``other-environment`` is supported. + * The docstring ``'Python versions supported: same as for controller-environment'``: everything we recommend for ``controller-environment`` is supported. + * The docstring with specific versions otherwise: ``'Python versions supported: '``. + +.. _coll_repo_structure: + +Repository structure requirements +================================== + +galaxy.yml +---------- + +* The ``tags`` field MUST be set. +* Collection dependencies must meet a set of rules. See the section on `Collection Dependencies <collection_dependencies_>` for details. +* The ``ansible`` package MUST NOT depend on collections not shipped in the package. +* If you plan to split up your collection, the new collection MUST be approved for inclusion before the smaller collections replace the larger in Ansible. +* If you plan to add other collections as dependencies, they MUST run through the formal application process. + +.. _coll_readme_req: + +README.md +--------- + +Your collection repository MUST have a ``README.md`` in the root of the collection, see `collection_template/README.md <https://github.com/ansible-collections/collection_template/blob/main/README.md>`_ for an example. + +meta/runtime.yml +---------------- +Example: `meta/runtime.yml <https://github.com/ansible-collections/collection_template/blob/main/meta/runtime.yml>`_ + +* The ``meta/runtime.yml`` MUST define the minimum version of Ansible which this collection works with. + + * If the collection works with Ansible 2.9, then this should be set to `>=2.9.10` + * It is usually better to avoid adding `<2.11` as a restriction, since this for example makes it impossible to use the collection with the current ansible-base devel branch (which has version 2.11.0.dev0) + +.. _coll_module-reqs: + +Modules & Plugins +------------------ + +* Collections MUST only use the directories specified below in the ``plugins/`` directory and + only for the purposes listed: + + :Those recognized by ansible-core: ``doc_fragments``, ``modules``, ``module_utils``, ``terminal``, and those listed in :ref:`working_with_plugins`. This list can be verified by looking at the last element of the package argument of each ``*_loader`` in https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/loader.py#L1126 + :plugin_utils: For shared code which is only used controller-side, not in modules. + :sub_plugins: For other plugins which are managed by plugins inside of collections instead of ansible-core. We use a subfolder so there aren't conflicts when ansible-core adds new plugin types. + + The core team (which maintains ansible-core) has committed not to use these directories for + anything which would conflict with the uses specified here. + +Other directories +----------------- + +Collections MUST not use files outside ``meta/``, ``plugins/``, ``roles/`` and ``playbooks/`` in any plugin, role, or playbook that can be called by FQCN, used from other collections, or used from user playbooks and roles. A collection must work if every file or directory is deleted from the installed collection except those four directories and their contents. + +Internal plugins, roles and playbooks (artifacts used only in testing, or only to release the collection, or only for some other internal purpose and not used externally) are exempt from this rule and may rely on files in other directories. + +.. _coll_docs_structure_reqs: + +Documentation requirements +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +All modules and plugins MUST: + +* Include a :ref:`DOCUMENTATION <documentation-block>` block. +* Include an :ref:`EXAMPLES <examples-block>` block (except where not relevant for the plugin type). +* Use FQCNs when referring to modules, plugins and documentation fragments inside and outside the collection (including ``ansible.builtin`` for the listed entities from ansible-core. + +When using ``version_added`` in the documentation: + +* Declare the version of the collection in which the options were added -- NOT the version of Ansible. +* If you for some reason really have to specify version numbers of Ansible or of another collection, you also have to provide ``version_added_collection: collection_name``. We strongly recommend to NOT do this. +* Include ``version_added`` when you add new content (modules, plugins, options) to an existing collection. The values are shown in the documentation, and can be useful, but you do not need to add ``version_added`` to every option, module, and plugin when creating a new collection. + +Other items: + +* The ``CONTRIBUTING.md`` (or ``README.md``) file MUST state what types of contributions (pull requests, feature requests, and so on) are accepted and any relevant contributor guidance. Issues (bugs and feature request) reports must always be accepted. +* Collections are encouraged to use z:ref:`links and formatting macros <linking-and-other-format-macros-within-module-documentation>` +* Including a :ref:`RETURN <return-block>` block for modules is strongly encouraged but not required. + +.. _coll_workflow: + +Contributor Workflow +==================== + +.. _coll_changlogs_req: + +Changelogs +---------- + +Collections are required to include a changelog. To give a consistent feel for changelogs across collections and ensure changelogs exist for collections included in the ``ansible`` package we suggest you use `antsibull-changelog <https://github.com/ansible-community/antsibull-changelog>`_ to maintain and generate this but other options exist. Preferred (in descending order): + +#. Use antsibull-changelog (preferred). +#. Provide ``changelogs/changelog.yaml`` in the `correct format <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelog.yaml-format.md>`_. (You can use ``antsibull-lint changelog-yaml /path/to/changelog.yaml`` to validate the format.) +#. Provide a link to the changelog file (self-hosted) (not recommended). + +Note that the porting guide is compiled from ``changelogs/changelog.yaml`` (sections ``breaking_changes``, ``major_changes``, ``deprecated_features``, ``removed_features``). So if you use option 3, you will not be able to add something to the porting guide. + +.. _coll_versioning_req: + +Versioning and deprecation +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* Collections MUST adhere to `semantic versioning <https://semver.org/>`_. +* To preserve backward compatibility for users, every Ansible minor version series (x.Y.z) will keep the major version of a collection constant. If ansible 3.0.0 includes ``community.general`` 2.2.0, then each 3.Y.z (3.1.z, 3.2.z, and so on) release will include the latest ``community.general`` 2.y.z release available at build time. Ansible 3.y.z will **never** include a ``community.general`` 3.y.z release, even if it is available. Major collection version changes will be included in the next Ansible major release (4.0.0 in this example). +* Therefore, ensure that the current major release of your collection included in 3.0.0 receives at least bugfixes as long as new 3.Y.Z releases are produced. +* Since new minor releases are included, you can include new features, modules and plugins. You must make sure that you do not break backwards compatibility! (See `semantic versioning <https://semver.org/>`_.) This means in particular: + + * You can fix bugs in patch releases, but not add new features or deprecate things. + * You can add new features and deprecate things in minor releases, but not remove things or change behavior of existing features. + * You can only remove things or make breaking changes in major releases. +* We recommend that you ensure that if a deprecation is added in a collection version that is included in Ansible 3.y.z, the removal itself will only happen in a collection version included in Ansible 5.0.0 or later, but not in a collection version included in Ansible 4.0.0. +* Content moved from ansible/ansible that was scheduled for removal in 2.11 or later MUST NOT be removed in the current major release available when ansible 2.10.0 is released. Otherwise it would already be removed in 2.10, unexpectedly for users! Deprecation cycles can be shortened (since they are now uncoupled from ansible or ansible-base versions), but existing ones must not be unexpectedly terminated. +* We recommend you announce your policy of releasing, versioning and deprecation to contributors and users in some way. For an example of how to do this, see `the announcement in community.general <https://github.com/ansible-collections/community.general/issues/582>`_. You could also do this in the README. + +.. _ coll_naming_req: + +Naming +====== + +Collection naming +----------------- + +For collections under ansible-collections the repository SHOULD be named ``NAMESPACE.COLLECTION``. + +To create a new collection and corresponding repository, first, a new namespace in Galaxy has to be created by submitting `Request a namespace <https://github.com/ansible/galaxy/issues/new/choose>`_. + +`Namespace limitations <https://galaxy.ansible.com/docs/contributing/namespaces.html#galaxy-namespace-limitations>`_ lists requirements for namespaces in Galaxy. + +For collections created for working with a particular entity, they should contain the entity name, for example ``community.mysql``. + +For corporate maintained collections, the repository can be named ``COMPANY_NAME.PRODUCT_NAME``, for example ``ibm.db2``. + +We should avoid FQCN / repository names: + +* which are unnecessary long: try to make it compact but clear. +* contain the same words / collocations in ``NAMESPACE`` and ``COLLECTION`` parts, for example ``my_system.my_system``. + +If your collection is planned to be certified on **Red Hat Automation Hub**, please consult with Red Hat Partner Engineering through ``ansiblepartners@redhat.com`` to ensure collection naming compatibility between the community collection on **Galaxy**. + +.. _coll_module_name_req: + +Module naming +------------- + +Modules that only gather information MUST be named ``<something>_info``. Modules that return ``ansible_facts`` are named ``<something>_facts`` and do not return non-facts. +For more information, refer to the :ref:`Developing modules guidelines <creating-an-info-or-a-facts-module>`. + +.. _coll_licensing_req: + +Collection licensing requirements +=================================== + +.. note:: + + The guidelines below are more restrictive than strictly necessary. We will try to add a larger list of acceptable licenses once we have approval from Red Hat Legal. + +There are four types of content in collections which licensing has to address in different +ways: + +:modules: must be licensed with a free software license that is compatible with the + `GPL-3.0-or-later <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`_ +:module_utils: must be licensed with a free software license that is compatible with the + `GPL-3.0-or-later <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`_. Ansible + itself typically uses the `BSD-2-clause + <https://opensource.org/licenses/BSD-2-Clause>`_ license to make it possible for + third-party modules which are licensed incompatibly with the GPLv3 to use them. + Please consider this use case when licensing your own ``module_utils``. +:All other code in ``plugins/``: All other code in ``plugins/`` must be under the `GPL-3.0-or-later + <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`_. These plugins + are run inside of the Ansible controller process which is licensed under + the ``GPL-3.0-or-later`` and often must import code from the controller. + For these reasons, ``GPL-3.0-or-later`` must be used. +:All other code: Code outside ``plugins/`` may be licensed under another free software license that is compatible + with the `GPL-3.0-or-later <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`_, + provided that such code does not import any other code that is licensed under + the ``GPL-3.0-or-later``. If the file does import other ``GPL-3.0-or-later`` code, + then it must similarly be licensed under ``GPL-3.0-or-later``. Note that this applies in + particular to unit tests; these often import code from ansible-core, plugins, module utils, + or modules, and such code is often licensed under ``GPL-3.0-or-later``. +:Non code content: At the moment, these must also be under the `GPL-3.0-or-later + <https://www.gnu.org/licenses/gpl-3.0-standalone.html>`_. + +Use `this table of licenses from the Fedora Project +<https://fedoraproject.org/wiki/Licensing:Main#Software_License_List>`_ to find which licenses are +compatible with the GPLv3+. The license must be considered open source on both the Fedora License +table and the `Debian Free Software Guidelines <https://wiki.debian.org/DFSGLicenses>`_ to be +allowed. + +These guidelines are the policy for inclusion in the Ansible package and are in addition to any +licensing and legal concerns that may otherwise affect your code. + +.. _coll_repo_management: + +Repository management +===================== + +Every collection MUST have a public git repository. Releases of the collection MUST be tagged in said repository. This means that releases MUST be ``git tag``\ ed and that the tag name MUST exactly match the Galaxy version number. Tag names MAY have a ``v`` prefix, but a collection's tag names MUST have a consistent format from release to release. + +Additionally, collection artifacts released to Galaxy MUST be built from the sources that are tagged in the collection's git repository as that release. Any changes made during the build process MUST be clearly documented so the collection artifact can be reproduced. + +We are open to allowing other SCM software once our tooling supports them. + +.. _coll_branch_config: + +Branch name and configuration +----------------------------- + +This subsection is **only** for repositories under `ansible-collections <https://github.com/ansible-collections>`_! Other collection repositories can also follow these guidelines, but do not have to. + +All new repositories MUST have ``main`` as the default branch. + +Existing repositories SHOULD be converted to use ``main``. + +Repository Protections: + +* Allow merge commits: disallowed + +Branch protections MUST be enforced: + +* Require linear history +* Include administrators + +.. _coll_ci_tests: + +CI Testing +=========== + +.. note:: + + You can copy the free-to-use `GitHub action workflow file <https://github.com/ansible-collections/collection_template/blob/main/.github/workflows/ansible-test.yml>`_ from the `Collection Template repository <https://github.com/ansible-collections/collection_template/>`_ to the `.github/workflows` directory in your collection to set up testing through GitHub actions. The workflow covers all the requirements below. + +* You MUST run the ``ansible-test sanity`` command from the `latest stable ansible-base/ansible-core branch <https://github.com/ansible/ansible/branches/all?query=stable->`_. + + * Collections MUST run an equivalent of the ``ansible-test sanity --docker`` command. + * If they do not use ``--docker``, they must make sure that all tests run, in particular the compile and import tests (which should run for all :ref:`supported Python versions <ansible-and-python-3>`). + * Collections can choose to skip certain Python versions that they explicitly do not support; this needs to be documented in ``README.md`` and in every module and plugin (hint: use a docs fragment). However we strongly recommend you follow the :ref:`Ansible Python Compatibility <ansible-and-python-3>` section for more details. + +* You SHOULD suggest to *additionally* run ``ansible-test sanity`` from the ansible/ansible ``devel`` branch so that you find out about new linting requirements earlier. +* The sanity tests MUST pass. + + * Adding some entries to the ``test/sanity/ignore*.txt`` file is an allowed method of getting them to pass, except cases listed below. + * You SHOULD not have ignored test entries. A reviewer can manually evaluate and approve your collection if they deem an ignored entry to be valid. + + * You MUST not ignore the following validations. They must be fixed before approval: + * ``validate-modules:doc-choices-do-not-match-spec`` + * ``validate-modules:doc-default-does-not-match-spec`` + * ``validate-modules:doc-missing-type`` + * ``validate-modules:doc-required-mismatch`` + * ``validate-modules:mutually_exclusive-unknown`` + * ``validate-modules:no-log-needed`` (use ``no_log=False`` in the argument spec to flag false positives!) + * ``validate-modules:nonexistent-parameter-documented`` + * ``validate-modules:parameter-list-no-elements`` + * ``validate-modules:parameter-type-not-in-doc`` + * ``validate-modules:undocumented-parameter`` + + * All entries in ignores.txt MUST have a justification in a comment in the ignore.txt file for each entry. For example ``plugins/modules/docker_container.py use-argspec-type-path # uses colon-separated paths, can't use type=path``. + * Reviewers can block acceptance of a new collection if they don't agree with the ignores.txt entries. + +* You MUST run CI against each of the "major versions" (2.10, 2.11, 2.12, etc) of ``ansible-base``/``ansible-core`` that the collection supports. (Usually the ``HEAD`` of the stable-xxx branches.) +* All CI tests MUST run against every pull request and SHOULD pass before merge. +* At least sanity tests MUST run against a commit that releases the collection; if they do not pass, the collection will NOT be released. + + - If the collection has integration/unit tests, they SHOULD run too; if they do not pass, the errors SHOULD be analyzed to decide whether they should block the release or not. +* All CI tests MUST run regularly (nightly, or at least once per week) to ensure that repositories without regular commits are tested against the latest version of ansible-test from each ansible-base/ansible-core version tested. The results from the regular CI runs MUST be checked regularly. + +All of the above can be achieved by using the `GitHub Action template <https://github.com/ansible-collections/collection_template/tree/main/.github/workflows>`_. + +To learn how to add tests to your collection, see: + +* :ref:`collection_integration_tests` +* :ref:`collection_unit_tests` + + +.. _coll_wg_reqs: + +Collections and Working Groups +============================== + +The collections have: + +* Working group page(s) on a corresponding wiki if needed. Makes sense if there is a group of modules for working with one common entity, for example postgresql, zabbix, grafana, and so on. +* Issue for agenda (or pinboard if there are not regular meetings) as a pinned issue in the repository. + +.. _coll_migrating_reqs: + +When moving modules between collections +======================================= + +All related entities must be moved/copied including: + +* Related plugins and module_utils files (when moving, be sure it is not used by other modules, otherwise copy). +* CI and unit tests. +* Corresponding documentation fragments from ``plugins/doc_fragments``. + +Also: + +* Change ``M()``, examples, ``seealso``, ``extended_documentation_fragments`` to use actual FQCNs in moved content and in other collections that have references to the content. +* Move all related issues, pull requests, and wiki pages. +* Look through ``docs/docsite`` directory of `ansible-base GitHub repository <https://github.com/ansible/ansible>`_ (for example, using the ``grep`` command-line utility) to check if there are examples using the moved modules and plugins to update their FQCNs. + +See :ref:`Migrating content to a different collection <migrating-ansible-content-to-a-different-collection>` for complete details. + +.. _coll_development_conventions: + +Development conventions +======================= + +Besides all the requirements listed in the :ref:`module_dev_conventions`, be sure: + +* Your modules satisfy the concept of :ref:`idempotency <term-Idempotency>`: if a module repeatedly runs with the same set of inputs, it will not make any changes on the system. +* Your modules do not query information using special ``state`` option values like ``get``, ``list``, ``query``, or ``info`` - + create new ``_info`` or ``_facts`` modules instead (for more information, refer to the :ref:`Developing modules guidelines <creating-an-info-or-a-facts-module>`). +* ``check_mode`` is supported in all ``*_info`` and ``*_facts`` modules (for more information, refer to the :ref:`Development conventions <#following-ansible-conventions>`). + +.. _coll_dependencies: + +Collection Dependencies +======================= + +**Notation:** if foo.bar has a dependency on baz.bam, we say that baz.bam is the collection *depended on*, and foo.bar is the *dependent collection*. + +* Collection dependencies must have a lower bound on the version which is at least 1.0.0. + + * This means that all collection dependencies have to specify lower bounds on the versions, and these lower bounds should be stable releases, and not versions of the form 0.x.y. + * When creating new collections where collection dependencies are also under development, you need to watch out since Galaxy checks whether dependencies exist in the required versions: + + #. Assume that ``foo.bar`` depends on ``foo.baz``. + #. First release ``foo.baz`` as 1.0.0. + #. Then modify ``foo.bar``'s ``galaxy.yml`` to specify ``'>=1.0.0'`` for ``foo.baz``. + #. Finally release ``foo.bar`` as 1.0.0. + +* The dependencies between collections included in Ansible must be valid. If a dependency is violated, the involved collections must be pinned so that all dependencies are valid again. This means that the version numbers from the previous release are kept or only partially incremented so that the resulting set of versions has no invalid dependencies. + +* If a collection has a too strict dependency for a longer time, and forces another collection depended on to be held back, that collection will be removed from the next major Ansible release. What "longer time" means depends on when the next Ansible major release happens. If a dependent collection prevents a new major version of a collection it depends on to be included in the next major Ansible release, the dependent collection will be removed from that major release to avoid blocking the collection being depended on. + +* We strongly suggest that collections also test against the ``main`` branches of their dependencies to ensure that incompatibilities with future releases of these are detected as early as possible and can be resolved in time to avoid such problems. Collections depending on other collections must understand that they bear the risk of being removed when they do not ensure compatibility with the latest releases of their dependencies. + +* Collections included in Ansible must not depend on other collections except if they satisfy one of the following cases: + + #. They have a loose dependency on one (or more) major versions of other collections included in Ansible. For example, ``ansible.netcommon: >=1.0.0``, or ``ansible.netcommon: >=2.0.0, <3.0.0``. In case the collection depended on releases a new major version outside of this version range that will be included in the next major Ansible release, the dependent collection will be removed from the next major Ansible release. The cut-off date for this is feature freeze. + #. They are explicitly being allowed to do so by the Steering Committee. + +Examples +-------- + +#. ``community.foo 1.2.0`` has a dependency on ``community.bar >= 1.0.0, < 1.3.0``. + + * Now ``community.bar`` creates a new release ``1.3.0``. When ``community.foo`` does not create a new release with a relaxed dependency, we have to include ``community.bar 1.2.x`` in the next Ansible release despite ``1.3.0`` being available. + * If ``community.foo`` does not relax its dependency on ``community.bar`` for some time, ``community.foo`` will be removed from the next Ansible major release. + * Unfortunately ``community.bar`` has to stay at ``1.2.x`` until either ``community.foo`` is removed (in the next major release), or loosens its requirements so that newer ``community.bar 1.3.z`` releases can be included. + +#. ``community.foonetwork`` depends on ``ansible.netcommon >= 2.0.0, <3.0.0``. + + * ``ansible.netcommon 4.0.0`` is released during this major Ansible release cycle. + * ``community.foonetwork`` either releases a new version before feature freeze of the next major Ansible release that allows depending on all ``ansible.netcommon 4.x.y`` releases, or it will be removed from the next major Ansible release. + +.. _coll_inclusion_reqs: + +Requirements for collections to be included in the Ansible Package +================================================================== + +To be included in the `ansible` package, collections must meet the following criteria: + +* :ref:`Development conventions <module_dev_conventions>`. +* `Collection requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_ (this document). + + * The `Collection Inclusion Criteria Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_ covers most of the criteria from this document. +* :ref:`Ansible documentation format <module_documenting>` and the :ref:`style guide <style-guide>`. +* To pass the Ansible :ref:`sanity tests <testing-sanity>`. +* To have :ref:`unit <unit-tests>`_and / or :ref:`integration tests <integration-tests>` according to the corresponding sections of this document. + + +Other requirements +=================== + +* After content is moved out of another currently included collection such as ``community.general`` or ``community.network`` OR a new collection satisfies all the requirements, add the collection to the ``ansible.in`` file in a corresponding directory of the `ansible-build-data repository <https://github.com/ansible-community/ansible-build-data/>`_.
\ No newline at end of file diff --git a/docs/docsite/rst/community/collection_contributors/collection_reviewing.rst b/docs/docsite/rst/community/collection_contributors/collection_reviewing.rst index 0eb203b5..4a379dcd 100644 --- a/docs/docsite/rst/community/collection_contributors/collection_reviewing.rst +++ b/docs/docsite/rst/community/collection_contributors/collection_reviewing.rst @@ -39,10 +39,10 @@ Other standards to check for in a PR include: * For jinja2 filter and test plugins, check out the `special syntax for changelog fragments <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelogs.rst#adding-new-roles-playbooks-test-and-filter-plugins>`_. * The changelog content contains useful information for end users of the collection. -* If new files are added with the pull request, they follow the `licensing rules <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#licensing>`_. +* If new files are added with the pull request, they follow the :ref:`coll_licensing_req`. * The changes follow the :ref:`Ansible documentation standards <developing_modules_documenting>` and the :ref:`style_guide`. * The changes follow the :ref:`Development conventions <developing_modules_best_practices>`. -* If a new plugin is added, it is one of the `allowed plugin types <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#modules-plugins>`_. +* If a new plugin is added, it is one of the :ref:`allowed plugin types <coll_module-reqs>`. * Documentation, examples, and return sections use FQCNs for the ``M(..)`` :ref:`format macros <module_documents_linking>` when referring to modules. * Modules and plugins from ansible-core use ``ansible.builtin.`` as an FQCN prefix when mentioned. * When a new option, module, plugin, or return value is added, the corresponding documentation or return sections use ``version_added:`` containing the *collection* version in which they will be first released. diff --git a/docs/docsite/rst/community/collection_contributors/collection_unit_tests.rst b/docs/docsite/rst/community/collection_contributors/collection_unit_tests.rst index e3573584..7a758c50 100644 --- a/docs/docsite/rst/community/collection_contributors/collection_unit_tests.rst +++ b/docs/docsite/rst/community/collection_contributors/collection_unit_tests.rst @@ -26,7 +26,7 @@ Ansible uses `pytest <https://docs.pytest.org/en/latest/>`_ as a testing framewo See :ref:`testing_units_modules` for complete details. -Inclusion in the Ansible package `requires integration and/or unit tests <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#requirements-for-collections-to-be-included-in-the-ansible-package>`_ You should have tests for your collection as well as for individual modules and plugins to make your code more reliable To learn how to get started with integration tests, see :ref:`collection_integration_tests`. +Inclusion in the Ansible package :ref:`requires integration and/or unit tests <coll_ci_tests>` You should have tests for your collection as well as for individual modules and plugins to make your code more reliable To learn how to get started with integration tests, see :ref:`collection_integration_tests`. See :ref:`collection_prepare_local` to prepare your environment. diff --git a/docs/docsite/rst/community/contributing_maintained_collections.rst b/docs/docsite/rst/community/contributing_maintained_collections.rst index b0441912..f7c0d1d9 100644 --- a/docs/docsite/rst/community/contributing_maintained_collections.rst +++ b/docs/docsite/rst/community/contributing_maintained_collections.rst @@ -72,7 +72,7 @@ The following table shows: <td>✓</td> <td>Zuul</td> <td>✓</td> - <td><a href="https://docs.ansible.com/ansible/devel/dev_guide/platforms/aws_guidelines.html">AWS guide</a></td> + <td><a href="https://docs.ansible.com/ansible/devel/collections/amazon/aws/docsite/dev_guidelines.html">AWS guide</a></td> </tr> <tr> <td><a href="https://galaxy.ansible.com/ansible/netcommon">ansible.netcommon***</a></td> @@ -247,7 +247,7 @@ The following table shows: <td>✓</td> <td>Zuul</td> <td>✓</td> - <td><a href="https://docs.ansible.com/ansible/devel/dev_guide/platforms/vmware_rest_guidelines.html">VMware REST guide</a></td> + <td><a href="https://docs.ansible.com/ansible/devel/collections/vmware/vmware_rest/docsite/dev_guide.html">VMware REST guide</a></td> </tr> </table> diff --git a/docs/docsite/rst/community/contributions_collections.rst b/docs/docsite/rst/community/contributions_collections.rst index f702d590..7b1aad4c 100644 --- a/docs/docsite/rst/community/contributions_collections.rst +++ b/docs/docsite/rst/community/contributions_collections.rst @@ -12,6 +12,7 @@ Ansible Collections Contributor Guide create_pr_quick_start collection_contributors/test_index collection_contributors/collection_reviewing + collection_contributors/collection_requirements maintainers contributing_maintained_collections steering/steering_index diff --git a/docs/docsite/rst/community/documentation_contributions.rst b/docs/docsite/rst/community/documentation_contributions.rst index 0f464f11..082a7b25 100644 --- a/docs/docsite/rst/community/documentation_contributions.rst +++ b/docs/docsite/rst/community/documentation_contributions.rst @@ -93,21 +93,26 @@ To work with documentation on your local machine, you need to have python-3.9 or .. _Ansible dependencies: https://github.com/ansible/ansible/blob/devel/requirements.txt .. _documentation dependencies: https://github.com/ansible/ansible/blob/devel/docs/docsite/requirements.txt -.. code-block:: bash +Drop the ``--user`` option in the following commands if you use a virtual environment (venv/virtenv). - pip install --user -r requirements.txt - pip install --user -r docs/docsite/requirements.txt +#. Upgrade pip before installing dependencies (recommended). -The :file:`docs/docsite/requirements.txt` file allows a wide range of versions and may install new releases of required packages. New releases of these packages may cause problems with the Ansible docs build. If you want to install tested versions of these dependencies, use :file:`test/sanity/code-smell/docs-build.requirements.txt` instead, which matches the dependencies used by CI: + .. code-block:: bash -.. code-block:: bash + pip install --user --upgrade pip + +#. Install Ansible dependencies. + + .. code-block:: bash - pip install --user -r requirements.txt - pip install --user -r test/sanity/code-smell/docs-build.requirements.txt + pip install --user -r requirements.txt +#. Install either the unpinned or tested documentation dependencies. + .. code-block:: bash -You can drop ``--user`` if you have set up a virtual environment (venv/virtenv). + pip install --user -r docs/docsite/requirements.txt # This file installs unpinned versions that can cause problems with the Ansible docs build. + pip install --user -r test/sanity/code-smell/docs-build.requirements.txt # This file installs tested dependency versions that are used by CI. .. note:: diff --git a/docs/docsite/rst/community/maintainers_guidelines.rst b/docs/docsite/rst/community/maintainers_guidelines.rst index 43a0e696..cfdd0e95 100644 --- a/docs/docsite/rst/community/maintainers_guidelines.rst +++ b/docs/docsite/rst/community/maintainers_guidelines.rst @@ -21,7 +21,7 @@ In general, collection maintainers: - :ref:`Backport <Backporting>` changes to stable branches. - Address or assign issues to appropriate contributors. - :ref:`Release collections <Releasing>`. -- Ensure that collections adhere to the `Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_, +- Ensure that collections adhere to the :ref:`collections_requirements`. - Track changes announced in `News for collection contributors and maintainers <https://github.com/ansible-collections/news-for-maintainers>`_ and update a collection in accordance with these changes. - Subscribe and submit news to the `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_. - :ref:`Build a healthy community <expanding_community>` to increase the number of active contributors and maintainers around collections. diff --git a/docs/docsite/rst/community/maintainers_workflow.rst b/docs/docsite/rst/community/maintainers_workflow.rst index 6754d125..e14ce5c0 100644 --- a/docs/docsite/rst/community/maintainers_workflow.rst +++ b/docs/docsite/rst/community/maintainers_workflow.rst @@ -76,7 +76,7 @@ For convenience, backporting can be implemented automatically using GitHub bots Including a collection in Ansible ----------------------------------- -If a collection is not included in Ansible (not shipped with Ansible package), maintainers can submit the collection for inclusion by creating a discussion under the `ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_. For more information, see the `repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_, and the `Ansible community package collections requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`. +If a collection is not included in Ansible (not shipped with Ansible package), maintainers can submit the collection for inclusion by creating a discussion under the `ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_. For more information, see the `repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_, and the :ref:`Ansible community package collections requirements <collections_requirements>`. Stepping down as a collection maintainer =========================================== diff --git a/docs/docsite/rst/community/other_tools_and_programs.rst b/docs/docsite/rst/community/other_tools_and_programs.rst index 954d6218..fbf21514 100644 --- a/docs/docsite/rst/community/other_tools_and_programs.rst +++ b/docs/docsite/rst/community/other_tools_and_programs.rst @@ -114,11 +114,14 @@ Other tools - `Ansible Shell <https://github.com/dominis/ansible-shell>`_ - an interactive shell for Ansible with built-in tab completion for all the modules. - `Ansible Silo <https://github.com/groupon/ansible-silo>`_ - a self-contained Ansible environment by Docker. - `Ansigenome <https://github.com/nickjj/ansigenome>`_ - a command line tool designed to help you manage your Ansible roles. +- `antsibull-changelog <https://github.com/ansible-community/antsibull-changelog>`_ - a changelog generator for Ansible collections. +- `antsibull-docs <https://github.com/ansible-community/antsibull-docs>`_ - generates docsites for collections and can validate collection documentation. - `ARA <https://github.com/ansible-community/ara>`_ - ARA Records Ansible playbooks and makes them easier to understand and troubleshoot with a reporting API, UI and CLI. - `Awesome Ansible <https://github.com/jdauphant/awesome-ansible>`_ - a collaboratively curated list of awesome Ansible resources. - `AWX <https://github.com/ansible/awx>`_ - provides a web-based user interface, REST API, and task engine built on top of Ansible. Red Hat Ansible Automation Platform includes code from AWX. - `Mitogen for Ansible <https://mitogen.networkgenomics.com/ansible_detailed.html>`_ - uses the `Mitogen <https://github.com/dw/mitogen/>`_ library to execute Ansible playbooks in a more efficient way (decreases the execution time). - `nanvault <https://github.com/marcobellaccini/nanvault>`_ - a standalone tool to encrypt and decrypt files in the Ansible Vault format, featuring UNIX-style composability. - `OpsTools-ansible <https://github.com/centos-opstools/opstools-ansible>`_ - uses Ansible to configure an environment that provides the support of `OpsTools <https://wiki.centos.org/SpecialInterestGroup/OpsTools>`_, namely centralized logging and analysis, availability monitoring, and performance monitoring. +- `Steampunk Spotter <https://pypi.org/project/steampunk-spotter/>`_ - provides an Assisted Automation Writing tool that analyzes and offers recommendations for your Ansible Playbooks. - `TD4A <https://github.com/cidrblock/td4a>`_ - a template designer for automation. TD4A is a visual design aid for building and testing jinja2 templates. It will combine data in yaml format with a jinja2 template and render the output. - `PHP-Ansible <https://github.com/maschmann/php-ansible>`_ - an object oriented Ansible wrapper for PHP. diff --git a/docs/docsite/rst/community/steering/community_steering_committee.rst b/docs/docsite/rst/community/steering/community_steering_committee.rst index 282d0ca0..5a5f2672 100644 --- a/docs/docsite/rst/community/steering/community_steering_committee.rst +++ b/docs/docsite/rst/community/steering/community_steering_committee.rst @@ -92,7 +92,7 @@ To submit new collections for inclusion into the Ansible package: Depending on a topic you want to discuss with the Community and the Committee, as you prepare your proposal, please consider the requirements established by: * :ref:`code_of_conduct`. -* `Ansible Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_. +* :ref:`collections_requirements`. * `Ansible Collection Inclusion Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_. Community topics workflow @@ -131,7 +131,7 @@ A person starting the triage: Collection inclusion requests workflow ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -When reviewing community collection `inclusion requests <https://github.com/ansible-collections/ansible-inclusion/discussions>`_, the Committee members check if a collection adheres to the `Community collection requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_. +When reviewing community collection `inclusion requests <https://github.com/ansible-collections/ansible-inclusion/discussions>`_, the Committee members check if a collection adheres to the :ref:`collections_requirements`. #. A Committee member who conducts the inclusion review copies the `Ansible community collection checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_ into a corresponding `discussion <https://github.com/ansible-collections/ansible-inclusion/discussions>`_. diff --git a/docs/docsite/rst/dev_guide/developing_modules_documenting.rst b/docs/docsite/rst/dev_guide/developing_modules_documenting.rst index f459e433..e7b5c2d5 100644 --- a/docs/docsite/rst/dev_guide/developing_modules_documenting.rst +++ b/docs/docsite/rst/dev_guide/developing_modules_documenting.rst @@ -162,8 +162,8 @@ All fields in the ``DOCUMENTATION`` block are lower-case. All fields are require * If ``required`` is false/missing, ``default`` may be specified (assumed 'null' if missing). * Ensure that the default value in the docs matches the default value in the code. * The default field must not be listed as part of the description, unless it requires additional information or conditions. - * If the option is a boolean value, you can use any of the boolean values recognized by Ansible: - (such as true/false or yes/no). Choose the one that reads better in the context of the option. + * If the option is a boolean value, you can use any of the boolean values recognized by Ansible + (such as ``true``/``false`` or ``yes``/``no``). Document booleans as ``true``/``false`` for consistency and compatibility with ansible-lint. :choices: diff --git a/docs/docsite/rst/dev_guide/developing_plugins.rst b/docs/docsite/rst/dev_guide/developing_plugins.rst index 341e4fc8..25662f01 100644 --- a/docs/docsite/rst/dev_guide/developing_plugins.rst +++ b/docs/docsite/rst/dev_guide/developing_plugins.rst @@ -75,7 +75,17 @@ To define configurable options for your plugin, describe them in the ``DOCUMENTA type: boolean/float/integer/list/none/path/pathlist/pathspec/string/tmppath version_added: X.x -To access the configuration settings in your plugin, use ``self.get_option(<option_name>)``. For the plugin types (such as 'become', 'cache', 'callback', 'cliconf', 'connection', 'httpapi', 'inventory', 'lookup', 'netconf', 'shell', and 'vars') that support embedded documentation, the controller pre-populates the settings. If you need to populate settings explicitly, use a ``self.set_options()`` call. +To access the configuration settings in your plugin, use ``self.get_option(<option_name>)``. +Some plugin types hande this differently: + +* Become, callback, connection and shell plugins are guaranteed to have the engine call ``set_options()``. +* Lookup plugins always require you to handle it in the ``run()`` method. +* Inventory plugins are done automatically if you use the ``base _read_config_file()`` method. If not, you must use ``self.get_option(<option_name>)``. +* Cache plugins do it on load. +* Cliconf, httpapi and netconf plugins indirectly piggy back on connection plugins. +* Vars plugin settings are populated when first accessed (using the ``self.get_option()`` or ``self.get_options()`` method. + +If you need to populate settings explicitly, use a ``self.set_options()`` call. Configuration sources follow the precedence rules for values in Ansible. When there are multiple values from the same category, the value defined last takes precedence. For example, in the above configuration block, if both ``name_of_ansible_var`` and ``name_of_second_var`` are defined, the value of the ``option_name`` option will be the value of ``name_of_second_var``. Refer to :ref:`general_precedence_rules` for further information. diff --git a/docs/docsite/rst/dev_guide/testing_sanity.rst b/docs/docsite/rst/dev_guide/testing_sanity.rst index 01b167bc..93769c1d 100644 --- a/docs/docsite/rst/dev_guide/testing_sanity.rst +++ b/docs/docsite/rst/dev_guide/testing_sanity.rst @@ -22,10 +22,6 @@ How to run To run sanity tests using docker, always use the default docker image by passing the ``--docker`` or ``--docker default`` argument. -.. note:: - When using docker and the ``--base-branch`` argument, - also use the ``--keep-git`` argument to avoid git related errors. - .. code:: shell source hacking/env-setup diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/404.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/404.po index 84ad1114..5d8e8e8e 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/404.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/404.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-02-23 10:50+0100\n" +"POT-Creation-Date: 2022-11-03 09:23+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -24,7 +24,11 @@ msgstr "Oops!" msgid "The version of the Ansible documentation you were looking at doesn't contain that page." msgstr "å‚ç…§ã—ã¦ã„ã‚‹ Ansible ドã‚ュメントã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã¯ã€ãã®ãƒšãƒ¼ã‚¸ãŒå«ã¾ã‚Œã¦ã„ã¾ã›ã‚“。" +msgid "Cowsay 404" +msgstr "Cowsay 404" + #: ../../rst/404.rst:12 msgid "Use the back button to return to the version you were browsing, or use the navigation at left to explore our latest release. Once you're on a non-404 page, you can use the version-changer to select a version." msgstr "戻るボタンを使用ã—ã¦é–²è¦§ã—ã¦ã„ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«æˆ»ã‚‹ã‹ã€å·¦å´ã®ãƒŠãƒ“ゲーションを使用ã—ã¦æœ€æ–°ãƒªãƒªãƒ¼ã‚¹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。404 以外ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·å¤‰æ›´ãƒ¡ãƒ‹ãƒ¥ãƒ¼ã‚’使用ã—ã¦ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’é¸æŠžã§ãã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/cli.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/cli.po index 736b4fec..2c85c53a 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/cli.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/cli.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/cli/ansible.rst:7 msgid "ansible" @@ -32,345 +32,345 @@ msgstr ":strong:`一連ã®ãƒ›ã‚¹ãƒˆã«å¯¾ã—ã¦å˜ä¸€ã®ã‚¿ã‚¹ã‚¯ã€ŒPlaybookã€ã msgid "Synopsis" msgstr "概è¦" -#: ../../rst/cli/ansible-config.rst:30 ../../rst/cli/ansible-console.rst:37 +#: ../../rst/cli/ansible-config.rst:30 ../../rst/cli/ansible-console.rst:38 #: ../../rst/cli/ansible-doc.rst:33 ../../rst/cli/ansible-galaxy.rst:30 -#: ../../rst/cli/ansible-inventory.rst:33 ../../rst/cli/ansible-playbook.rst:38 -#: ../../rst/cli/ansible-pull.rst:37 ../../rst/cli/ansible-vault.rst:30 -#: ../../rst/cli/ansible.rst:37 +#: ../../rst/cli/ansible-inventory.rst:34 ../../rst/cli/ansible-playbook.rst:39 +#: ../../rst/cli/ansible-pull.rst:38 ../../rst/cli/ansible-vault.rst:30 +#: ../../rst/cli/ansible.rst:38 msgid "Description" msgstr "説明" -#: ../../rst/cli/ansible.rst:40 +#: ../../rst/cli/ansible.rst:41 msgid "is an extra-simple tool/framework/API for doing 'remote things'. this command allows you to define and run a single task 'playbook' against a set of hosts" msgstr "「リモートã®ã“ã¨ã€ã‚’è¡Œã†éžå¸¸ã«å˜ç´”ãªãƒ„ール/フレームワーク/API ã§ã™ã€‚ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã§ã¯ã€ãƒ›ã‚¹ãƒˆ 1 å°ã«å¯¾ã—ã¦å˜ä¸€ã‚¿ã‚¹ã‚¯ã€ŒPlaybookã€ã‚’定義ãŠã‚ˆã³å®Ÿè¡Œã§ãã¾ã™" -#: ../../rst/cli/ansible-config.rst:37 ../../rst/cli/ansible-console.rst:65 -#: ../../rst/cli/ansible-doc.rst:43 ../../rst/cli/ansible-galaxy.rst:37 -#: ../../rst/cli/ansible-inventory.rst:40 ../../rst/cli/ansible-playbook.rst:46 -#: ../../rst/cli/ansible-pull.rst:52 ../../rst/cli/ansible-vault.rst:44 -#: ../../rst/cli/ansible.rst:45 +#: ../../rst/cli/ansible-config.rst:37 ../../rst/cli/ansible-console.rst:66 +#: ../../rst/cli/ansible-doc.rst:43 ../../rst/cli/ansible-galaxy.rst:40 +#: ../../rst/cli/ansible-inventory.rst:41 ../../rst/cli/ansible-playbook.rst:47 +#: ../../rst/cli/ansible-pull.rst:56 ../../rst/cli/ansible-vault.rst:44 +#: ../../rst/cli/ansible.rst:46 msgid "Common Options" msgstr "共通オプション" -#: ../../rst/cli/ansible-console.rst:72 ../../rst/cli/ansible-inventory.rst:47 -#: ../../rst/cli/ansible-playbook.rst:53 ../../rst/cli/ansible-pull.rst:64 +#: ../../rst/cli/ansible-console.rst:73 ../../rst/cli/ansible-inventory.rst:48 +#: ../../rst/cli/ansible-playbook.rst:54 ../../rst/cli/ansible-pull.rst:68 #: ../../rst/cli/ansible-vault.rst:87 ../../rst/cli/ansible-vault.rst:121 #: ../../rst/cli/ansible-vault.rst:155 ../../rst/cli/ansible-vault.rst:189 #: ../../rst/cli/ansible-vault.rst:219 ../../rst/cli/ansible-vault.rst:257 -#: ../../rst/cli/ansible-vault.rst:311 ../../rst/cli/ansible.rst:52 +#: ../../rst/cli/ansible-vault.rst:311 ../../rst/cli/ansible.rst:53 msgid "ask for vault password" msgstr "Vault ã®ãƒ‘スワード入力を尋ãã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:77 ../../rst/cli/ansible-playbook.rst:58 -#: ../../rst/cli/ansible.rst:57 +#: ../../rst/cli/ansible-console.rst:78 ../../rst/cli/ansible-playbook.rst:59 +#: ../../rst/cli/ansible.rst:58 msgid "privilege escalation method to use (default=sudo), use `ansible-doc -t become -l` to list valid choices." msgstr "使用ã™ã‚‹ç‰¹æ¨©æ˜‡æ ¼æ–¹æ³• (デフォルト㯠sudo)。有効ãªé¸æŠžã‚’一覧表示ã™ã‚‹ã«ã¯ `ansible-doc -t become -l` を使用ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:82 ../../rst/cli/ansible-playbook.rst:63 -#: ../../rst/cli/ansible-pull.rst:69 ../../rst/cli/ansible.rst:62 +#: ../../rst/cli/ansible-console.rst:83 ../../rst/cli/ansible-playbook.rst:64 +#: ../../rst/cli/ansible-pull.rst:73 ../../rst/cli/ansible.rst:63 msgid "Become password file" msgstr "become パスワードファイル" -#: ../../rst/cli/ansible-console.rst:87 ../../rst/cli/ansible-playbook.rst:68 -#: ../../rst/cli/ansible.rst:67 +#: ../../rst/cli/ansible-console.rst:88 ../../rst/cli/ansible-playbook.rst:69 +#: ../../rst/cli/ansible.rst:68 msgid "run operations as this user (default=root)" msgstr "ã“ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¨ã—ã¦æ“作を実行ã—ã¾ã™ (デフォルト㯠root)。" -#: ../../rst/cli/ansible-console.rst:92 ../../rst/cli/ansible-playbook.rst:73 -#: ../../rst/cli/ansible-pull.rst:84 ../../rst/cli/ansible.rst:72 +#: ../../rst/cli/ansible-console.rst:93 ../../rst/cli/ansible-playbook.rst:74 +#: ../../rst/cli/ansible-pull.rst:88 ../../rst/cli/ansible.rst:73 msgid "Connection password file" msgstr "接続ã®ãƒ‘スワードファイル" -#: ../../rst/cli/ansible-console.rst:97 ../../rst/cli/ansible-playbook.rst:88 -#: ../../rst/cli/ansible-pull.rst:99 ../../rst/cli/ansible.rst:77 +#: ../../rst/cli/ansible-console.rst:98 ../../rst/cli/ansible-playbook.rst:89 +#: ../../rst/cli/ansible-pull.rst:103 ../../rst/cli/ansible.rst:78 msgid "outputs a list of matching hosts; does not execute anything else" msgstr "一致ã™ã‚‹ãƒ›ã‚¹ãƒˆã®ä¸€è¦§ã‚’出力ã—ã¾ã™ã€‚ä»–ã«ã¯ä½•ã‚‚実行ã—ã¾ã›ã‚“。" -#: ../../rst/cli/ansible-console.rst:102 ../../rst/cli/ansible-doc.rst:60 -#: ../../rst/cli/ansible-inventory.rst:82 ../../rst/cli/ansible.rst:82 +#: ../../rst/cli/ansible-console.rst:103 ../../rst/cli/ansible-doc.rst:60 +#: ../../rst/cli/ansible-inventory.rst:83 ../../rst/cli/ansible.rst:83 msgid "Since this tool does not use playbooks, use this as a substitute playbook directory. This sets the relative path for many features including roles/ group_vars/ etc." msgstr "ã“ã®ãƒ„ール㯠Playbook を使用ã—ãªã„ãŸã‚ã€ä»£æ›¿ã® Playbook ディレクトリーã¨ã—ã¦ä½¿ç”¨ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€roles/ group_vars/ ãªã©ã®å¤šãã®æ©Ÿèƒ½ã®ç›¸å¯¾ãƒ‘スãŒè¨å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:107 ../../rst/cli/ansible-playbook.rst:103 -#: ../../rst/cli/ansible-pull.rst:104 ../../rst/cli/ansible.rst:87 +#: ../../rst/cli/ansible-console.rst:108 ../../rst/cli/ansible-playbook.rst:104 +#: ../../rst/cli/ansible-pull.rst:108 ../../rst/cli/ansible.rst:88 msgid "use this file to authenticate the connection" msgstr "ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã—ã¦æŽ¥ç¶šã‚’èªè¨¼ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:112 ../../rst/cli/ansible-playbook.rst:108 -#: ../../rst/cli/ansible-pull.rst:114 ../../rst/cli/ansible.rst:92 +#: ../../rst/cli/ansible-console.rst:113 ../../rst/cli/ansible-playbook.rst:109 +#: ../../rst/cli/ansible-pull.rst:118 ../../rst/cli/ansible.rst:93 msgid "specify extra arguments to pass to scp only (e.g. -l)" msgstr "scp ã®ã¿ã«æ¸¡ã™è¿½åŠ ã®å¼•æ•°ã‚’指定ã—ã¾ã™ (例: -l)。" -#: ../../rst/cli/ansible-console.rst:117 ../../rst/cli/ansible-playbook.rst:113 -#: ../../rst/cli/ansible-pull.rst:119 ../../rst/cli/ansible.rst:97 +#: ../../rst/cli/ansible-console.rst:118 ../../rst/cli/ansible-playbook.rst:114 +#: ../../rst/cli/ansible-pull.rst:123 ../../rst/cli/ansible.rst:98 msgid "specify extra arguments to pass to sftp only (e.g. -f, -l)" msgstr "sftp ã®ã¿ã«æ¸¡ã™è¿½åŠ ã®å¼•æ•°ã‚’指定ã—ã¾ã™ (例: -fã€-l)。" -#: ../../rst/cli/ansible-console.rst:122 ../../rst/cli/ansible-playbook.rst:123 -#: ../../rst/cli/ansible-pull.rst:129 ../../rst/cli/ansible.rst:102 +#: ../../rst/cli/ansible-console.rst:123 ../../rst/cli/ansible-playbook.rst:124 +#: ../../rst/cli/ansible-pull.rst:133 ../../rst/cli/ansible.rst:103 msgid "specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)" msgstr "sftp/scp/ssh ã«æ¸¡ã™ä¸€èˆ¬çš„ãªå¼•æ•°ã‚’指定ã—ã¾ã™ (例: ProxyCommand)。" -#: ../../rst/cli/ansible-console.rst:127 ../../rst/cli/ansible-playbook.rst:128 -#: ../../rst/cli/ansible-pull.rst:134 ../../rst/cli/ansible.rst:107 +#: ../../rst/cli/ansible-console.rst:128 ../../rst/cli/ansible-playbook.rst:129 +#: ../../rst/cli/ansible-pull.rst:138 ../../rst/cli/ansible.rst:108 msgid "specify extra arguments to pass to ssh only (e.g. -R)" msgstr "ssh ã®ã¿ã«æ¸¡ã™è¿½åŠ ã®å¼•æ•°ã‚’指定ã—ã¾ã™ (例: -R)。" -#: ../../rst/cli/ansible-console.rst:137 ../../rst/cli/ansible-playbook.rst:143 -#: ../../rst/cli/ansible.rst:112 +#: ../../rst/cli/ansible-console.rst:138 ../../rst/cli/ansible-playbook.rst:144 +#: ../../rst/cli/ansible.rst:113 msgid "perform a syntax check on the playbook, but do not execute it" msgstr "Playbook ã§æ§‹æ–‡ãƒã‚§ãƒƒã‚¯ã‚’実行ã—ã¾ã™ãŒã€Playbook ã¯å®Ÿè¡Œã—ã¾ã›ã‚“。" -#: ../../rst/cli/ansible-console.rst:142 ../../rst/cli/ansible.rst:117 +#: ../../rst/cli/ansible-console.rst:143 ../../rst/cli/ansible.rst:118 msgid "set task timeout limit in seconds, must be positive integer." msgstr "タスクã®ã‚¿ã‚¤ãƒ アウト制é™ã‚’秒å˜ä½ã§è¨å®šã—ã¾ã™ã€‚æ£ã®æ•´æ•°ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:147 ../../rst/cli/ansible-inventory.rst:97 -#: ../../rst/cli/ansible-playbook.rst:148 ../../rst/cli/ansible-pull.rst:144 +#: ../../rst/cli/ansible-console.rst:148 ../../rst/cli/ansible-inventory.rst:98 +#: ../../rst/cli/ansible-playbook.rst:149 ../../rst/cli/ansible-pull.rst:148 #: ../../rst/cli/ansible-vault.rst:95 ../../rst/cli/ansible-vault.rst:129 #: ../../rst/cli/ansible-vault.rst:163 ../../rst/cli/ansible-vault.rst:193 #: ../../rst/cli/ansible-vault.rst:231 ../../rst/cli/ansible-vault.rst:277 -#: ../../rst/cli/ansible-vault.rst:327 ../../rst/cli/ansible.rst:122 +#: ../../rst/cli/ansible-vault.rst:327 ../../rst/cli/ansible.rst:123 msgid "the vault identity to use" msgstr "使用ã™ã‚‹ Vault アイデンティティー" -#: ../../rst/cli/ansible-console.rst:152 -#: ../../rst/cli/ansible-inventory.rst:102 -#: ../../rst/cli/ansible-playbook.rst:153 ../../rst/cli/ansible-pull.rst:149 +#: ../../rst/cli/ansible-console.rst:153 +#: ../../rst/cli/ansible-inventory.rst:103 +#: ../../rst/cli/ansible-playbook.rst:154 ../../rst/cli/ansible-pull.rst:153 #: ../../rst/cli/ansible-vault.rst:99 ../../rst/cli/ansible-vault.rst:133 #: ../../rst/cli/ansible-vault.rst:167 ../../rst/cli/ansible-vault.rst:197 #: ../../rst/cli/ansible-vault.rst:235 ../../rst/cli/ansible-vault.rst:281 -#: ../../rst/cli/ansible-vault.rst:331 ../../rst/cli/ansible.rst:127 +#: ../../rst/cli/ansible-vault.rst:331 ../../rst/cli/ansible.rst:128 msgid "vault password file" msgstr "Vault パスワードファイル" -#: ../../rst/cli/ansible-config.rst:44 ../../rst/cli/ansible-console.rst:157 -#: ../../rst/cli/ansible-doc.rst:65 ../../rst/cli/ansible-galaxy.rst:44 -#: ../../rst/cli/ansible-inventory.rst:107 -#: ../../rst/cli/ansible-playbook.rst:158 ../../rst/cli/ansible-pull.rst:159 -#: ../../rst/cli/ansible-vault.rst:51 ../../rst/cli/ansible.rst:132 +#: ../../rst/cli/ansible-config.rst:44 ../../rst/cli/ansible-console.rst:158 +#: ../../rst/cli/ansible-doc.rst:65 ../../rst/cli/ansible-galaxy.rst:47 +#: ../../rst/cli/ansible-inventory.rst:108 +#: ../../rst/cli/ansible-playbook.rst:159 ../../rst/cli/ansible-pull.rst:163 +#: ../../rst/cli/ansible-vault.rst:51 ../../rst/cli/ansible.rst:133 msgid "show program's version number, config file location, configured module search path, module location, executable location and exit" msgstr "プãƒã‚°ãƒ©ãƒ ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã€è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã®å ´æ‰€ã€è¨å®šã—ãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«æ¤œç´¢ãƒ‘スã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å ´æ‰€ã€å®Ÿè¡Œå¯èƒ½ãªå ´æ‰€ã€ãŠã‚ˆã³çµ‚了を表示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible.rst:137 +#: ../../rst/cli/ansible.rst:138 msgid "run asynchronously, failing after X seconds (default=N/A)" msgstr "éžåŒæœŸçš„ã«å®Ÿè¡Œã—ã€X 秒後ã«å¤±æ•—ã—ã¾ã™ (デフォルト㯠N/A)。" -#: ../../rst/cli/ansible-console.rst:162 ../../rst/cli/ansible-playbook.rst:163 -#: ../../rst/cli/ansible-pull.rst:74 ../../rst/cli/ansible.rst:142 +#: ../../rst/cli/ansible-console.rst:163 ../../rst/cli/ansible-playbook.rst:164 +#: ../../rst/cli/ansible-pull.rst:78 ../../rst/cli/ansible.rst:143 msgid "don't make any changes; instead, try to predict some of the changes that may occur" msgstr "å¤‰æ›´ã‚’åŠ ãˆãªã„ã§ãã ã•ã„。代ã‚ã‚Šã«ã€ç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ã®ã‚る変更ã®ã„ãã¤ã‹ã‚’予測ã—ã¦ã¿ã¦ãã ã•ã„。" -#: ../../rst/cli/ansible-console.rst:167 ../../rst/cli/ansible-playbook.rst:168 -#: ../../rst/cli/ansible-pull.rst:89 ../../rst/cli/ansible.rst:147 +#: ../../rst/cli/ansible-console.rst:168 ../../rst/cli/ansible-playbook.rst:169 +#: ../../rst/cli/ansible-pull.rst:93 ../../rst/cli/ansible.rst:148 msgid "when changing (small) files and templates, show the differences in those files; works great with --check" msgstr "(å°è¦æ¨¡ãª) ファイルãŠã‚ˆã³ãƒ†ãƒ³ãƒ—レートã®å¤‰æ›´æ™‚ã«ã€ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã®ç›¸é•ç‚¹ã‚’表示ã—ã¾ã™ã€‚--check ã¨é©åˆ‡ã«é€£æºã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:172 ../../rst/cli/ansible-playbook.rst:173 -#: ../../rst/cli/ansible-pull.rst:169 ../../rst/cli/ansible.rst:152 +#: ../../rst/cli/ansible-console.rst:173 ../../rst/cli/ansible-playbook.rst:174 +#: ../../rst/cli/ansible-pull.rst:173 ../../rst/cli/ansible.rst:153 msgid "ask for privilege escalation password" msgstr "権é™æ˜‡æ ¼ã®ãƒ‘スワードをè¦æ±‚ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:177 ../../rst/cli/ansible-doc.rst:75 -#: ../../rst/cli/ansible-playbook.rst:178 ../../rst/cli/ansible-pull.rst:174 -#: ../../rst/cli/ansible.rst:157 +#: ../../rst/cli/ansible-console.rst:178 ../../rst/cli/ansible-doc.rst:75 +#: ../../rst/cli/ansible-playbook.rst:179 ../../rst/cli/ansible-pull.rst:178 +#: ../../rst/cli/ansible.rst:158 msgid "prepend colon-separated path(s) to module library (default={{ ANSIBLE_HOME ~ \"/plugins/modules:/usr/share/ansible/plugins/modules\" }})" msgstr "モジュールライブラリーã¸ã®ã‚³ãƒãƒ³åŒºåˆ‡ã‚Šãƒ‘ス (デフォルト㯠{{ ANSIBLE_HOME ~ \"/plugins/modules:/usr/share/ansible/plugins/modules\" }}) ã‚’å…ˆé ã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible.rst:162 +#: ../../rst/cli/ansible.rst:163 msgid "set the poll interval if using -B (default=15)" msgstr "-B (デフォルト㯠15) を使用ã™ã‚‹å ´åˆã¯ãƒãƒ¼ãƒªãƒ³ã‚°é–“隔をè¨å®šã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:182 ../../rst/cli/ansible-playbook.rst:183 -#: ../../rst/cli/ansible-pull.rst:179 ../../rst/cli/ansible.rst:167 +#: ../../rst/cli/ansible-console.rst:183 ../../rst/cli/ansible-playbook.rst:184 +#: ../../rst/cli/ansible-pull.rst:183 ../../rst/cli/ansible.rst:168 msgid "override the connection timeout in seconds (default=10)" msgstr "接続タイムアウトを秒å˜ä½ã§ä¸Šæ›¸ãã—ã¾ã™ (デフォルト㯠10)。" -#: ../../rst/cli/ansible.rst:172 +#: ../../rst/cli/ansible.rst:173 msgid "The action's options in space separated k=v format: -a 'opt1=val1 opt2=val2' or a json string: -a '{\"opt1\": \"val1\", \"opt2\": \"val2\"}'" msgstr "スペースã§åŒºåˆ‡ã‚‰ã‚ŒãŸ k=v å½¢å¼ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚ªãƒ—ション: -a 'opt1=val1 opt2=val2' ã¾ãŸã¯ json æ–‡å—列: -a '{\"opt1\": \"val1\", \"opt2\": \"val2\"}'" -#: ../../rst/cli/ansible-console.rst:187 ../../rst/cli/ansible-playbook.rst:188 -#: ../../rst/cli/ansible.rst:177 +#: ../../rst/cli/ansible-console.rst:188 ../../rst/cli/ansible-playbook.rst:189 +#: ../../rst/cli/ansible.rst:178 msgid "run operations with become (does not imply password prompting)" msgstr "become ã§æ“作ã®å®Ÿè¡Œ (パスワード入力をæ„味ã™ã‚‹ã‚‚ã®ã§ã¯ã‚ã‚Šã¾ã›ã‚“)" -#: ../../rst/cli/ansible-console.rst:192 ../../rst/cli/ansible-playbook.rst:193 -#: ../../rst/cli/ansible-pull.rst:189 ../../rst/cli/ansible.rst:182 +#: ../../rst/cli/ansible-console.rst:193 ../../rst/cli/ansible-playbook.rst:194 +#: ../../rst/cli/ansible-pull.rst:193 ../../rst/cli/ansible.rst:183 msgid "connection type to use (default=smart)" msgstr "使用ã™ã‚‹æŽ¥ç¶šã‚¿ã‚¤ãƒ— (デフォルト㯠smart)" -#: ../../rst/cli/ansible-console.rst:197 -#: ../../rst/cli/ansible-inventory.rst:112 -#: ../../rst/cli/ansible-playbook.rst:198 ../../rst/cli/ansible-pull.rst:199 -#: ../../rst/cli/ansible.rst:187 +#: ../../rst/cli/ansible-console.rst:198 +#: ../../rst/cli/ansible-inventory.rst:113 +#: ../../rst/cli/ansible-playbook.rst:199 ../../rst/cli/ansible-pull.rst:203 +#: ../../rst/cli/ansible.rst:188 msgid "set additional variables as key=value or YAML/JSON, if filename prepend with @" msgstr "ファイルåã®å‰ã« @ を付ã‘ã‚‹å ´åˆã¯ã€è¿½åŠ ã®å¤‰æ•°ã‚’ key=value ã¾ãŸã¯ YAML/JSON ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:202 ../../rst/cli/ansible-playbook.rst:203 -#: ../../rst/cli/ansible.rst:192 +#: ../../rst/cli/ansible-console.rst:203 ../../rst/cli/ansible-playbook.rst:204 +#: ../../rst/cli/ansible.rst:193 msgid "specify number of parallel processes to use (default=5)" msgstr "使用ã™ã‚‹ä¸¦åˆ—プãƒã‚»ã‚¹æ•°ã‚’指定ã—ã¾ã™ (デフォルト㯠5)。" -#: ../../rst/cli/ansible-config.rst:49 ../../rst/cli/ansible-console.rst:207 -#: ../../rst/cli/ansible-doc.rst:85 ../../rst/cli/ansible-galaxy.rst:49 -#: ../../rst/cli/ansible-inventory.rst:117 -#: ../../rst/cli/ansible-playbook.rst:208 ../../rst/cli/ansible-pull.rst:209 -#: ../../rst/cli/ansible-vault.rst:56 ../../rst/cli/ansible.rst:197 +#: ../../rst/cli/ansible-config.rst:49 ../../rst/cli/ansible-console.rst:208 +#: ../../rst/cli/ansible-doc.rst:85 ../../rst/cli/ansible-galaxy.rst:52 +#: ../../rst/cli/ansible-inventory.rst:118 +#: ../../rst/cli/ansible-playbook.rst:209 ../../rst/cli/ansible-pull.rst:213 +#: ../../rst/cli/ansible-vault.rst:56 ../../rst/cli/ansible.rst:198 msgid "show this help message and exit" msgstr "ヘルプメッセージを表示ã—ã¦çµ‚了ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:212 -#: ../../rst/cli/ansible-inventory.rst:122 -#: ../../rst/cli/ansible-playbook.rst:213 ../../rst/cli/ansible-pull.rst:214 -#: ../../rst/cli/ansible.rst:202 +#: ../../rst/cli/ansible-console.rst:213 +#: ../../rst/cli/ansible-inventory.rst:123 +#: ../../rst/cli/ansible-playbook.rst:214 ../../rst/cli/ansible-pull.rst:218 +#: ../../rst/cli/ansible.rst:203 msgid "specify inventory host path or comma separated host list. --inventory-file is deprecated" msgstr "インベントリーホストパスã¾ãŸã¯ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šãƒ›ã‚¹ãƒˆä¸€è¦§ã‚’指定ã—ã¾ã™ã€‚--inventory-file ã¯éžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/cli/ansible-console.rst:217 ../../rst/cli/ansible-playbook.rst:218 -#: ../../rst/cli/ansible-pull.rst:219 ../../rst/cli/ansible.rst:207 +#: ../../rst/cli/ansible-console.rst:218 ../../rst/cli/ansible-playbook.rst:219 +#: ../../rst/cli/ansible-pull.rst:223 ../../rst/cli/ansible.rst:208 msgid "ask for connection password" msgstr "接続ã®ãƒ‘スワードをè¦æ±‚ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:222 ../../rst/cli/ansible-playbook.rst:223 -#: ../../rst/cli/ansible-pull.rst:224 ../../rst/cli/ansible.rst:212 +#: ../../rst/cli/ansible-console.rst:223 ../../rst/cli/ansible-playbook.rst:224 +#: ../../rst/cli/ansible-pull.rst:228 ../../rst/cli/ansible.rst:213 msgid "further limit selected hosts to an additional pattern" msgstr "é¸æŠžã—ãŸãƒ›ã‚¹ãƒˆã‚’è¿½åŠ ãƒ‘ã‚¿ãƒ¼ãƒ³ã«ã•ã‚‰ã«åˆ¶é™ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible.rst:217 +#: ../../rst/cli/ansible.rst:218 msgid "Name of the action to execute (default=command)" msgstr "実行ã™ã‚‹å‹•ä½œã®åå‰ (default=command)" -#: ../../rst/cli/ansible.rst:222 +#: ../../rst/cli/ansible.rst:223 msgid "condense output" msgstr "出力をè¦ç´„ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible.rst:227 +#: ../../rst/cli/ansible.rst:228 msgid "log output to this directory" msgstr "ã“ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ãƒã‚°ã‚’記録ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:227 ../../rst/cli/ansible-playbook.rst:233 -#: ../../rst/cli/ansible-pull.rst:249 ../../rst/cli/ansible.rst:232 +#: ../../rst/cli/ansible-console.rst:228 ../../rst/cli/ansible-playbook.rst:234 +#: ../../rst/cli/ansible-pull.rst:253 ../../rst/cli/ansible.rst:233 msgid "connect as this user (default=None)" msgstr "ã“ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¨ã—ã¦æŽ¥ç¶šã—ã¾ã™ (デフォルト㯠None)。" -#: ../../rst/cli/ansible-config.rst:54 ../../rst/cli/ansible-console.rst:232 -#: ../../rst/cli/ansible-doc.rst:115 ../../rst/cli/ansible-galaxy.rst:54 -#: ../../rst/cli/ansible-inventory.rst:132 -#: ../../rst/cli/ansible-playbook.rst:238 ../../rst/cli/ansible-pull.rst:254 -#: ../../rst/cli/ansible-vault.rst:61 ../../rst/cli/ansible.rst:237 +#: ../../rst/cli/ansible-config.rst:54 ../../rst/cli/ansible-console.rst:233 +#: ../../rst/cli/ansible-doc.rst:115 ../../rst/cli/ansible-galaxy.rst:57 +#: ../../rst/cli/ansible-inventory.rst:133 +#: ../../rst/cli/ansible-playbook.rst:239 ../../rst/cli/ansible-pull.rst:258 +#: ../../rst/cli/ansible-vault.rst:61 ../../rst/cli/ansible.rst:238 msgid "Causes Ansible to print more debug messages. Adding multiple -v will increase the verbosity, the builtin plugins currently evaluate up to -vvvvvv. A reasonable level to start is -vvv, connection debugging might require -vvvv." msgstr "Ansible ãŒã‚ˆã‚Šå¤šãã®ãƒ‡ãƒãƒƒã‚°ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’出力ã™ã‚‹åŽŸå› ã«ãªã‚Šã¾ã™ã€‚複数㮠-v ã‚’è¿½åŠ ã™ã‚‹ã¨è©³ç´°åº¦ãŒå¢—ã—ã€ç¾åœ¨ã®çµ„ã¿è¾¼ã¿ãƒ—ラグイン㯠-vvvvvv ã¾ã§è©•ä¾¡ã—ã¾ã™ã€‚開始ã™ã‚‹ã®ã«é©åˆ‡ãªãƒ¬ãƒ™ãƒ«ã¯ -vvv ã§ã™ã€‚接続ã®ãƒ‡ãƒãƒƒã‚°ã«ã¯ã€-vvvv ãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-config.rst:193 ../../rst/cli/ansible-console.rst:241 -#: ../../rst/cli/ansible-doc.rst:124 ../../rst/cli/ansible-galaxy.rst:891 -#: ../../rst/cli/ansible-inventory.rst:146 -#: ../../rst/cli/ansible-playbook.rst:247 ../../rst/cli/ansible-pull.rst:263 -#: ../../rst/cli/ansible-vault.rst:342 ../../rst/cli/ansible.rst:246 +#: ../../rst/cli/ansible-config.rst:193 ../../rst/cli/ansible-console.rst:242 +#: ../../rst/cli/ansible-doc.rst:124 ../../rst/cli/ansible-galaxy.rst:894 +#: ../../rst/cli/ansible-inventory.rst:147 +#: ../../rst/cli/ansible-playbook.rst:248 ../../rst/cli/ansible-pull.rst:267 +#: ../../rst/cli/ansible-vault.rst:342 ../../rst/cli/ansible.rst:247 msgid "Environment" msgstr "環境" -#: ../../rst/cli/ansible-config.rst:195 ../../rst/cli/ansible-console.rst:243 -#: ../../rst/cli/ansible-doc.rst:126 ../../rst/cli/ansible-galaxy.rst:893 -#: ../../rst/cli/ansible-inventory.rst:148 -#: ../../rst/cli/ansible-playbook.rst:249 ../../rst/cli/ansible-pull.rst:265 -#: ../../rst/cli/ansible-vault.rst:344 ../../rst/cli/ansible.rst:248 +#: ../../rst/cli/ansible-config.rst:195 ../../rst/cli/ansible-console.rst:244 +#: ../../rst/cli/ansible-doc.rst:126 ../../rst/cli/ansible-galaxy.rst:896 +#: ../../rst/cli/ansible-inventory.rst:149 +#: ../../rst/cli/ansible-playbook.rst:250 ../../rst/cli/ansible-pull.rst:269 +#: ../../rst/cli/ansible-vault.rst:344 ../../rst/cli/ansible.rst:249 msgid "The following environment variables may be specified." msgstr "以下ã®ç’°å¢ƒå¤‰æ•°ã‚’指定ã§ãã¾ã™ã€‚" -#: ../../rst/cli/ansible-config.rst:199 ../../rst/cli/ansible-console.rst:247 -#: ../../rst/cli/ansible-doc.rst:130 ../../rst/cli/ansible-galaxy.rst:897 -#: ../../rst/cli/ansible-inventory.rst:152 -#: ../../rst/cli/ansible-playbook.rst:253 ../../rst/cli/ansible-pull.rst:269 -#: ../../rst/cli/ansible-vault.rst:348 ../../rst/cli/ansible.rst:252 +#: ../../rst/cli/ansible-config.rst:199 ../../rst/cli/ansible-console.rst:248 +#: ../../rst/cli/ansible-doc.rst:130 ../../rst/cli/ansible-galaxy.rst:900 +#: ../../rst/cli/ansible-inventory.rst:153 +#: ../../rst/cli/ansible-playbook.rst:254 ../../rst/cli/ansible-pull.rst:273 +#: ../../rst/cli/ansible-vault.rst:348 ../../rst/cli/ansible.rst:253 msgid ":envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file" msgstr ":envvar:`ANSIBLE_CONFIG` -- デフォルト㮠Ansible è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã‚’上書ãã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-config.rst:201 ../../rst/cli/ansible-console.rst:249 -#: ../../rst/cli/ansible-doc.rst:132 ../../rst/cli/ansible-galaxy.rst:899 -#: ../../rst/cli/ansible-inventory.rst:154 -#: ../../rst/cli/ansible-playbook.rst:255 ../../rst/cli/ansible-pull.rst:271 -#: ../../rst/cli/ansible-vault.rst:350 ../../rst/cli/ansible.rst:254 +#: ../../rst/cli/ansible-config.rst:201 ../../rst/cli/ansible-console.rst:250 +#: ../../rst/cli/ansible-doc.rst:132 ../../rst/cli/ansible-galaxy.rst:902 +#: ../../rst/cli/ansible-inventory.rst:155 +#: ../../rst/cli/ansible-playbook.rst:256 ../../rst/cli/ansible-pull.rst:275 +#: ../../rst/cli/ansible-vault.rst:350 ../../rst/cli/ansible.rst:255 msgid "Many more are available for most options in ansible.cfg" msgstr "ansible.cfg ã®ã»ã¨ã‚“ã©ã®ã‚ªãƒ—ションã§ã€ã•ã‚‰ã«å¤šãã®ã‚‚ã®ãŒåˆ©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/cli/ansible-config.rst:205 ../../rst/cli/ansible-console.rst:253 -#: ../../rst/cli/ansible-doc.rst:136 ../../rst/cli/ansible-galaxy.rst:903 -#: ../../rst/cli/ansible-inventory.rst:158 -#: ../../rst/cli/ansible-playbook.rst:259 ../../rst/cli/ansible-pull.rst:275 -#: ../../rst/cli/ansible-vault.rst:354 ../../rst/cli/ansible.rst:258 +#: ../../rst/cli/ansible-config.rst:205 ../../rst/cli/ansible-console.rst:254 +#: ../../rst/cli/ansible-doc.rst:136 ../../rst/cli/ansible-galaxy.rst:906 +#: ../../rst/cli/ansible-inventory.rst:159 +#: ../../rst/cli/ansible-playbook.rst:260 ../../rst/cli/ansible-pull.rst:279 +#: ../../rst/cli/ansible-vault.rst:354 ../../rst/cli/ansible.rst:259 msgid "Files" msgstr "ファイル" -#: ../../rst/cli/ansible-config.rst:208 ../../rst/cli/ansible-console.rst:256 -#: ../../rst/cli/ansible-doc.rst:139 ../../rst/cli/ansible-galaxy.rst:906 -#: ../../rst/cli/ansible-inventory.rst:161 -#: ../../rst/cli/ansible-playbook.rst:262 ../../rst/cli/ansible-pull.rst:278 -#: ../../rst/cli/ansible-vault.rst:357 ../../rst/cli/ansible.rst:261 +#: ../../rst/cli/ansible-config.rst:208 ../../rst/cli/ansible-console.rst:257 +#: ../../rst/cli/ansible-doc.rst:139 ../../rst/cli/ansible-galaxy.rst:909 +#: ../../rst/cli/ansible-inventory.rst:162 +#: ../../rst/cli/ansible-playbook.rst:263 ../../rst/cli/ansible-pull.rst:282 +#: ../../rst/cli/ansible-vault.rst:357 ../../rst/cli/ansible.rst:262 msgid ":file:`/etc/ansible/ansible.cfg` -- Config file, used if present" msgstr ":file:`/etc/ansible/ansible.cfg` -- å˜åœ¨ã™ã‚‹å ´åˆã¯ã€ä½¿ç”¨ã•ã‚Œã‚‹è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/cli/ansible-config.rst:210 ../../rst/cli/ansible-console.rst:258 -#: ../../rst/cli/ansible-doc.rst:141 ../../rst/cli/ansible-galaxy.rst:908 -#: ../../rst/cli/ansible-inventory.rst:163 -#: ../../rst/cli/ansible-playbook.rst:264 ../../rst/cli/ansible-pull.rst:280 -#: ../../rst/cli/ansible-vault.rst:359 ../../rst/cli/ansible.rst:263 +#: ../../rst/cli/ansible-config.rst:210 ../../rst/cli/ansible-console.rst:259 +#: ../../rst/cli/ansible-doc.rst:141 ../../rst/cli/ansible-galaxy.rst:911 +#: ../../rst/cli/ansible-inventory.rst:164 +#: ../../rst/cli/ansible-playbook.rst:265 ../../rst/cli/ansible-pull.rst:284 +#: ../../rst/cli/ansible-vault.rst:359 ../../rst/cli/ansible.rst:264 msgid ":file:`~/.ansible.cfg` -- User config file, overrides the default config if present" msgstr ":file:`~/.ansible.cfg` -- å˜åœ¨ã™ã‚‹å ´åˆã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆè¨å®šã‚’上書ãã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/cli/ansible-config.rst:213 ../../rst/cli/ansible-console.rst:261 -#: ../../rst/cli/ansible-doc.rst:144 ../../rst/cli/ansible-galaxy.rst:911 -#: ../../rst/cli/ansible-inventory.rst:166 -#: ../../rst/cli/ansible-playbook.rst:267 ../../rst/cli/ansible-pull.rst:283 -#: ../../rst/cli/ansible-vault.rst:362 ../../rst/cli/ansible.rst:266 +#: ../../rst/cli/ansible-config.rst:213 ../../rst/cli/ansible-console.rst:262 +#: ../../rst/cli/ansible-doc.rst:144 ../../rst/cli/ansible-galaxy.rst:914 +#: ../../rst/cli/ansible-inventory.rst:167 +#: ../../rst/cli/ansible-playbook.rst:268 ../../rst/cli/ansible-pull.rst:287 +#: ../../rst/cli/ansible-vault.rst:362 ../../rst/cli/ansible.rst:267 msgid "Author" msgstr "作æˆè€…" -#: ../../rst/cli/ansible-config.rst:215 ../../rst/cli/ansible-console.rst:263 -#: ../../rst/cli/ansible-doc.rst:146 ../../rst/cli/ansible-galaxy.rst:913 -#: ../../rst/cli/ansible-inventory.rst:168 -#: ../../rst/cli/ansible-playbook.rst:269 ../../rst/cli/ansible-pull.rst:285 -#: ../../rst/cli/ansible-vault.rst:364 ../../rst/cli/ansible.rst:268 +#: ../../rst/cli/ansible-config.rst:215 ../../rst/cli/ansible-console.rst:264 +#: ../../rst/cli/ansible-doc.rst:146 ../../rst/cli/ansible-galaxy.rst:916 +#: ../../rst/cli/ansible-inventory.rst:169 +#: ../../rst/cli/ansible-playbook.rst:270 ../../rst/cli/ansible-pull.rst:289 +#: ../../rst/cli/ansible-vault.rst:364 ../../rst/cli/ansible.rst:269 msgid "Ansible was originally written by Michael DeHaan." msgstr "Ansible ã¯å½“åˆã€Michael DeHaan ã«ã‚ˆã£ã¦è¨˜è¿°ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/cli/ansible-config.rst:217 ../../rst/cli/ansible-console.rst:265 -#: ../../rst/cli/ansible-doc.rst:148 ../../rst/cli/ansible-galaxy.rst:915 -#: ../../rst/cli/ansible-inventory.rst:170 -#: ../../rst/cli/ansible-playbook.rst:271 ../../rst/cli/ansible-pull.rst:287 -#: ../../rst/cli/ansible-vault.rst:366 ../../rst/cli/ansible.rst:270 +#: ../../rst/cli/ansible-config.rst:217 ../../rst/cli/ansible-console.rst:266 +#: ../../rst/cli/ansible-doc.rst:148 ../../rst/cli/ansible-galaxy.rst:918 +#: ../../rst/cli/ansible-inventory.rst:171 +#: ../../rst/cli/ansible-playbook.rst:272 ../../rst/cli/ansible-pull.rst:291 +#: ../../rst/cli/ansible-vault.rst:366 ../../rst/cli/ansible.rst:271 msgid "See the `AUTHORS` file for a complete list of contributors." msgstr "貢献者ã®å®Œå…¨ãªä¸€è¦§ã¯ã€`AUTHORS` ファイルをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/cli/ansible-config.rst:221 ../../rst/cli/ansible-console.rst:269 -#: ../../rst/cli/ansible-doc.rst:152 ../../rst/cli/ansible-galaxy.rst:919 -#: ../../rst/cli/ansible-inventory.rst:174 -#: ../../rst/cli/ansible-playbook.rst:275 ../../rst/cli/ansible-pull.rst:291 -#: ../../rst/cli/ansible-vault.rst:370 ../../rst/cli/ansible.rst:274 +#: ../../rst/cli/ansible-config.rst:221 ../../rst/cli/ansible-console.rst:270 +#: ../../rst/cli/ansible-doc.rst:152 ../../rst/cli/ansible-galaxy.rst:922 +#: ../../rst/cli/ansible-inventory.rst:175 +#: ../../rst/cli/ansible-playbook.rst:276 ../../rst/cli/ansible-pull.rst:295 +#: ../../rst/cli/ansible-vault.rst:370 ../../rst/cli/ansible.rst:275 msgid "License" msgstr "ライセンス" -#: ../../rst/cli/ansible-config.rst:223 ../../rst/cli/ansible-console.rst:271 -#: ../../rst/cli/ansible-doc.rst:154 ../../rst/cli/ansible-galaxy.rst:921 -#: ../../rst/cli/ansible-inventory.rst:176 -#: ../../rst/cli/ansible-playbook.rst:277 ../../rst/cli/ansible-pull.rst:293 -#: ../../rst/cli/ansible-vault.rst:372 ../../rst/cli/ansible.rst:276 +#: ../../rst/cli/ansible-config.rst:223 ../../rst/cli/ansible-console.rst:272 +#: ../../rst/cli/ansible-doc.rst:154 ../../rst/cli/ansible-galaxy.rst:924 +#: ../../rst/cli/ansible-inventory.rst:177 +#: ../../rst/cli/ansible-playbook.rst:278 ../../rst/cli/ansible-pull.rst:297 +#: ../../rst/cli/ansible-vault.rst:372 ../../rst/cli/ansible.rst:277 msgid "Ansible is released under the terms of the GPLv3+ License." msgstr "Ansible ã¯ã€GPLv3 以é™ã®ãƒ©ã‚¤ã‚»ãƒ³ã‚¹ã®å¯¾è±¡ç¯„囲ã§ãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/cli/ansible-config.rst:226 ../../rst/cli/ansible-console.rst:274 -#: ../../rst/cli/ansible-doc.rst:157 ../../rst/cli/ansible-galaxy.rst:924 -#: ../../rst/cli/ansible-inventory.rst:179 -#: ../../rst/cli/ansible-playbook.rst:280 ../../rst/cli/ansible-pull.rst:296 -#: ../../rst/cli/ansible-vault.rst:375 ../../rst/cli/ansible.rst:279 +#: ../../rst/cli/ansible-config.rst:226 ../../rst/cli/ansible-console.rst:275 +#: ../../rst/cli/ansible-doc.rst:157 ../../rst/cli/ansible-galaxy.rst:927 +#: ../../rst/cli/ansible-inventory.rst:180 +#: ../../rst/cli/ansible-playbook.rst:281 ../../rst/cli/ansible-pull.rst:300 +#: ../../rst/cli/ansible-vault.rst:375 ../../rst/cli/ansible.rst:280 msgid "See also" msgstr "å‚ç…§æƒ…å ±" -#: ../../rst/cli/ansible-config.rst:228 ../../rst/cli/ansible-console.rst:276 -#: ../../rst/cli/ansible-doc.rst:159 ../../rst/cli/ansible-galaxy.rst:926 -#: ../../rst/cli/ansible-inventory.rst:181 -#: ../../rst/cli/ansible-playbook.rst:282 ../../rst/cli/ansible-pull.rst:298 -#: ../../rst/cli/ansible-vault.rst:377 ../../rst/cli/ansible.rst:281 +#: ../../rst/cli/ansible-config.rst:228 ../../rst/cli/ansible-console.rst:277 +#: ../../rst/cli/ansible-doc.rst:159 ../../rst/cli/ansible-galaxy.rst:929 +#: ../../rst/cli/ansible-inventory.rst:182 +#: ../../rst/cli/ansible-playbook.rst:283 ../../rst/cli/ansible-pull.rst:302 +#: ../../rst/cli/ansible-vault.rst:377 ../../rst/cli/ansible.rst:282 msgid ":manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`," msgstr ":manpage:`ansible(1)`〠:manpage:`ansible-config(1)`〠:manpage:`ansible-console(1)`〠:manpage:`ansible-doc(1)`〠:manpage:`ansible-galaxy(1)`〠:manpage:`ansible-inventory(1)`〠:manpage:`ansible-playbook(1)`〠:manpage:`ansible-pull(1)`〠:manpage:`ansible-vault(1)`" @@ -386,7 +386,7 @@ msgstr ":strong:`ansible è¨å®šã‚’表示ã—ã¾ã™ã€‚`" msgid "Config command line class" msgstr "è¨å®šã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚¯ãƒ©ã‚¹" -#: ../../rst/cli/ansible-config.rst:62 ../../rst/cli/ansible-galaxy.rst:62 +#: ../../rst/cli/ansible-config.rst:62 ../../rst/cli/ansible-galaxy.rst:65 #: ../../rst/cli/ansible-vault.rst:69 msgid "Actions" msgstr "アクション" @@ -457,75 +457,75 @@ msgstr "ansible-console" msgid ":strong:`REPL console for executing Ansible tasks.`" msgstr ":strong:`Ansible タスクを実行ã™ã‚‹ REPL コンソール`" -#: ../../rst/cli/ansible-console.rst:40 +#: ../../rst/cli/ansible-console.rst:41 msgid "A REPL that allows for running ad-hoc tasks against a chosen inventory from a nice shell with built-in tab completion (based on dominis' ansible-shell)." msgstr "(dominis ã® ansible-shell ã«åŸºã¥ã) 組ã¿è¾¼ã¿ã®ã‚¿ãƒ–補完機能を備ãˆãŸå„ªã‚ŒãŸã‚·ã‚§ãƒ«ã‹ã‚‰é¸æŠžã—ãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«å¯¾ã—ã¦ã€ã‚¢ãƒ‰ãƒ›ãƒƒã‚¯ã‚¿ã‚¹ã‚¯ã‚’実行ã§ãるよã†ã«ã™ã‚‹ REPL。" -#: ../../rst/cli/ansible-console.rst:44 +#: ../../rst/cli/ansible-console.rst:45 msgid "It supports several commands, and you can modify its configuration at runtime:" msgstr "ã“ã‚Œã¯è¤‡æ•°ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’サãƒãƒ¼ãƒˆã—ã€èµ·å‹•æ™‚ã«ãã®è¨å®šã‚’変更ã§ãã¾ã™ã€‚" -#: ../../rst/cli/ansible-console.rst:47 +#: ../../rst/cli/ansible-console.rst:48 msgid "`cd [pattern]`: change host/group (you can use host patterns eg.: app*.dc*:!app01*)" msgstr "`cd [pattern]`: ホスト/グループを変更ã™ã‚‹ (app*.dc*:!app01* ãªã©ã®ãƒ›ã‚¹ãƒˆãƒ‘ターンを使用ã§ãã¾ã™)" -#: ../../rst/cli/ansible-console.rst:48 +#: ../../rst/cli/ansible-console.rst:49 msgid "`list`: list available hosts in the current path" msgstr "`list`: ç¾åœ¨ã®ãƒ‘スã§åˆ©ç”¨å¯èƒ½ãªãƒ›ã‚¹ãƒˆã‚’一覧表示ã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:49 +#: ../../rst/cli/ansible-console.rst:50 msgid "`list groups`: list groups included in the current path" msgstr "`list groups`: ç¾åœ¨ã®ãƒ‘スã«å«ã¾ã‚Œã‚‹ã‚°ãƒ«ãƒ¼ãƒ—を一覧表示ã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:50 +#: ../../rst/cli/ansible-console.rst:51 msgid "`become`: toggle the become flag" msgstr "`become`: become フラグを切り替ãˆã‚‹" -#: ../../rst/cli/ansible-console.rst:51 +#: ../../rst/cli/ansible-console.rst:52 msgid "`!`: forces shell module instead of the ansible module (!yum update -y)" msgstr "`!`: Ansible モジュールã®ä»£ã‚ã‚Šã«ã‚·ã‚§ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’強制的ã«å®Ÿè¡Œã™ã‚‹ (!yum update -y)" -#: ../../rst/cli/ansible-console.rst:52 +#: ../../rst/cli/ansible-console.rst:53 msgid "`verbosity [num]`: set the verbosity level" msgstr "`verbosity [num]`: 詳細レベルをè¨å®šã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:53 +#: ../../rst/cli/ansible-console.rst:54 msgid "`forks [num]`: set the number of forks" msgstr "`forks [num]`: フォークã®æ•°ã‚’è¨å®šã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:54 +#: ../../rst/cli/ansible-console.rst:55 msgid "`become_user [user]`: set the become_user" msgstr "`become_user [user]`: become_user ã‚’è¨å®šã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:55 +#: ../../rst/cli/ansible-console.rst:56 msgid "`remote_user [user]`: set the remote_user" msgstr "`remote_user [user]`: remote_user ã‚’è¨å®šã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:56 +#: ../../rst/cli/ansible-console.rst:57 msgid "`become_method [method]`: set the privilege escalation method" msgstr "`become_method [method]`: 権é™æ˜‡æ ¼æ–¹æ³•ã‚’è¨å®šã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:57 +#: ../../rst/cli/ansible-console.rst:58 msgid "`check [bool]`: toggle check mode" msgstr "`check [bool]`: ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’切り替ãˆã‚‹" -#: ../../rst/cli/ansible-console.rst:58 +#: ../../rst/cli/ansible-console.rst:59 msgid "`diff [bool]`: toggle diff mode" msgstr "`diff [bool]`: diff モードを切り替ãˆã‚‹" -#: ../../rst/cli/ansible-console.rst:59 +#: ../../rst/cli/ansible-console.rst:60 msgid "`timeout [integer]`: set the timeout of tasks in seconds (0 to disable)" msgstr "`timeout [integer]`: タスクã®ã‚¿ã‚¤ãƒ アウトを秒å˜ä½ã§è¨å®šã™ã‚‹ (無効ã«ã™ã‚‹ã«ã¯ 0)" -#: ../../rst/cli/ansible-console.rst:60 +#: ../../rst/cli/ansible-console.rst:61 msgid "`help [command/module]`: display documentation for the command or module" msgstr "`help [command/module]`: コマンドã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントを表示ã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:61 +#: ../../rst/cli/ansible-console.rst:62 msgid "`exit`: exit ansible-console" msgstr "`exit`: ansible-console を終了ã™ã‚‹" -#: ../../rst/cli/ansible-console.rst:132 ../../rst/cli/ansible-playbook.rst:138 +#: ../../rst/cli/ansible-console.rst:133 ../../rst/cli/ansible-playbook.rst:139 msgid "one-step-at-a-time: confirm each task before running" msgstr "one-step-at-a-time: 実行å‰ã«å„タスクを確èªã—ã¾ã™ã€‚" @@ -586,374 +586,378 @@ msgid ":strong:`Perform various Role and Collection related operations.`" msgstr ":strong:`ãƒãƒ¼ãƒ«ãŠã‚ˆã³ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«é–¢ã™ã‚‹æ§˜ã€…ãªæ“作を実行ã—ã¾ã™ã€‚`" #: ../../rst/cli/ansible-galaxy.rst:33 -msgid "command to manage Ansible roles in shared repositories, the default of which is Ansible Galaxy *https://galaxy.ansible.com*." -msgstr "共有リãƒã‚¸ãƒˆãƒªãƒ¼ã® Ansible ãƒãƒ¼ãƒ«ã‚’管ç†ã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ (デフォルト㯠Ansible Galaxy *https://galaxy.ansible.com* ã§ã™)。" +msgid "Command to manage Ansible roles and collections." +msgstr "Ansible ã®ãƒãƒ¼ãƒ«ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’管ç†ã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:70 +#: ../../rst/cli/ansible-galaxy.rst:35 +msgid "None of the CLI tools are designed to run concurrently with themselves. Use an external scheduler and/or locking to ensure there are no clashing operations." +msgstr "CLI ツールã¯ã€ãã®ãƒ„ール自体ã¨åŒæ™‚ã«å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ã¯è¨è¨ˆã•ã‚Œã¦ã„ã¾ã›ã‚“。外部スケジューラーやãƒãƒƒã‚¯ã‚’使用ã—ã¦ã€æ“作ãŒç«¶åˆã—ãªã„よã†ã«ã—ã¾ã™ã€‚" + +#: ../../rst/cli/ansible-galaxy.rst:73 msgid "collection" msgstr "コレクション" -#: ../../rst/cli/ansible-galaxy.rst:72 +#: ../../rst/cli/ansible-galaxy.rst:75 msgid "Perform the action on an Ansible Galaxy collection. Must be combined with a further action like init/install as listed below." msgstr "Ansible Galaxy コレクションã§ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã‚’実行ã—ã¾ã™ã€‚以下ã§ç¤ºã™ã‚ˆã†ã«ã€init/install ãªã©ã®è¿½åŠ アクションã¨çµ„ã¿åˆã‚ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:84 +#: ../../rst/cli/ansible-galaxy.rst:87 msgid "collection download" msgstr "collection download" -#: ../../rst/cli/ansible-galaxy.rst:94 ../../rst/cli/ansible-galaxy.rst:281 +#: ../../rst/cli/ansible-galaxy.rst:97 ../../rst/cli/ansible-galaxy.rst:284 msgid "Clear the existing server response cache." msgstr "æ—¢å˜ã®ã‚µãƒ¼ãƒãƒ¼ã®å¿œç”ã‚ャッシュを消去ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:98 ../../rst/cli/ansible-galaxy.rst:301 +#: ../../rst/cli/ansible-galaxy.rst:101 ../../rst/cli/ansible-galaxy.rst:304 msgid "Do not use the server response cache." msgstr "サーãƒãƒ¼ã®å¿œç”ã‚ャッシュを使用ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/cli/ansible-galaxy.rst:102 ../../rst/cli/ansible-galaxy.rst:309 +#: ../../rst/cli/ansible-galaxy.rst:105 ../../rst/cli/ansible-galaxy.rst:312 msgid "Include pre-release versions. Semantic versioning pre-releases are ignored by default" msgstr "リリースå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å«ã‚ã¾ã™ã€‚セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã®ãƒ—レリリースã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ç„¡è¦–ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:106 ../../rst/cli/ansible-galaxy.rst:160 -#: ../../rst/cli/ansible-galaxy.rst:203 ../../rst/cli/ansible-galaxy.rst:248 -#: ../../rst/cli/ansible-galaxy.rst:321 ../../rst/cli/ansible-galaxy.rst:382 -#: ../../rst/cli/ansible-galaxy.rst:439 ../../rst/cli/ansible-galaxy.rst:512 -#: ../../rst/cli/ansible-galaxy.rst:553 ../../rst/cli/ansible-galaxy.rst:590 -#: ../../rst/cli/ansible-galaxy.rst:623 ../../rst/cli/ansible-galaxy.rst:672 -#: ../../rst/cli/ansible-galaxy.rst:721 ../../rst/cli/ansible-galaxy.rst:762 -#: ../../rst/cli/ansible-galaxy.rst:803 ../../rst/cli/ansible-galaxy.rst:844 +#: ../../rst/cli/ansible-galaxy.rst:109 ../../rst/cli/ansible-galaxy.rst:163 +#: ../../rst/cli/ansible-galaxy.rst:206 ../../rst/cli/ansible-galaxy.rst:251 +#: ../../rst/cli/ansible-galaxy.rst:324 ../../rst/cli/ansible-galaxy.rst:385 +#: ../../rst/cli/ansible-galaxy.rst:442 ../../rst/cli/ansible-galaxy.rst:515 +#: ../../rst/cli/ansible-galaxy.rst:556 ../../rst/cli/ansible-galaxy.rst:593 +#: ../../rst/cli/ansible-galaxy.rst:626 ../../rst/cli/ansible-galaxy.rst:675 +#: ../../rst/cli/ansible-galaxy.rst:724 ../../rst/cli/ansible-galaxy.rst:765 +#: ../../rst/cli/ansible-galaxy.rst:806 ../../rst/cli/ansible-galaxy.rst:847 msgid "The time to wait for operations against the galaxy server, defaults to 60s." msgstr "galaxy サーãƒãƒ¼ã«å¯¾ã™ã‚‹æ“作を待機ã™ã‚‹æ™‚間。デフォルト㯠60s ã§ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:110 ../../rst/cli/ansible-galaxy.rst:164 -#: ../../rst/cli/ansible-galaxy.rst:207 ../../rst/cli/ansible-galaxy.rst:252 -#: ../../rst/cli/ansible-galaxy.rst:325 ../../rst/cli/ansible-galaxy.rst:386 -#: ../../rst/cli/ansible-galaxy.rst:443 ../../rst/cli/ansible-galaxy.rst:516 -#: ../../rst/cli/ansible-galaxy.rst:557 ../../rst/cli/ansible-galaxy.rst:594 -#: ../../rst/cli/ansible-galaxy.rst:627 ../../rst/cli/ansible-galaxy.rst:676 -#: ../../rst/cli/ansible-galaxy.rst:725 ../../rst/cli/ansible-galaxy.rst:766 -#: ../../rst/cli/ansible-galaxy.rst:807 ../../rst/cli/ansible-galaxy.rst:848 +#: ../../rst/cli/ansible-galaxy.rst:113 ../../rst/cli/ansible-galaxy.rst:167 +#: ../../rst/cli/ansible-galaxy.rst:210 ../../rst/cli/ansible-galaxy.rst:255 +#: ../../rst/cli/ansible-galaxy.rst:328 ../../rst/cli/ansible-galaxy.rst:389 +#: ../../rst/cli/ansible-galaxy.rst:446 ../../rst/cli/ansible-galaxy.rst:519 +#: ../../rst/cli/ansible-galaxy.rst:560 ../../rst/cli/ansible-galaxy.rst:597 +#: ../../rst/cli/ansible-galaxy.rst:630 ../../rst/cli/ansible-galaxy.rst:679 +#: ../../rst/cli/ansible-galaxy.rst:728 ../../rst/cli/ansible-galaxy.rst:769 +#: ../../rst/cli/ansible-galaxy.rst:810 ../../rst/cli/ansible-galaxy.rst:851 msgid "The Ansible Galaxy API key which can be found at https://galaxy.ansible.com/me/preferences." msgstr "https://galaxy.ansible.com/me/preferences ã§è¦‹ã¤ã‹ã‚‹ Ansible Galaxy API ã‚ー。" -#: ../../rst/cli/ansible-galaxy.rst:114 ../../rst/cli/ansible-galaxy.rst:168 -#: ../../rst/cli/ansible-galaxy.rst:211 ../../rst/cli/ansible-galaxy.rst:256 -#: ../../rst/cli/ansible-galaxy.rst:333 ../../rst/cli/ansible-galaxy.rst:390 -#: ../../rst/cli/ansible-galaxy.rst:447 ../../rst/cli/ansible-galaxy.rst:524 -#: ../../rst/cli/ansible-galaxy.rst:561 ../../rst/cli/ansible-galaxy.rst:598 -#: ../../rst/cli/ansible-galaxy.rst:631 ../../rst/cli/ansible-galaxy.rst:680 -#: ../../rst/cli/ansible-galaxy.rst:729 ../../rst/cli/ansible-galaxy.rst:770 -#: ../../rst/cli/ansible-galaxy.rst:811 ../../rst/cli/ansible-galaxy.rst:852 +#: ../../rst/cli/ansible-galaxy.rst:117 ../../rst/cli/ansible-galaxy.rst:171 +#: ../../rst/cli/ansible-galaxy.rst:214 ../../rst/cli/ansible-galaxy.rst:259 +#: ../../rst/cli/ansible-galaxy.rst:336 ../../rst/cli/ansible-galaxy.rst:393 +#: ../../rst/cli/ansible-galaxy.rst:450 ../../rst/cli/ansible-galaxy.rst:527 +#: ../../rst/cli/ansible-galaxy.rst:564 ../../rst/cli/ansible-galaxy.rst:601 +#: ../../rst/cli/ansible-galaxy.rst:634 ../../rst/cli/ansible-galaxy.rst:683 +#: ../../rst/cli/ansible-galaxy.rst:732 ../../rst/cli/ansible-galaxy.rst:773 +#: ../../rst/cli/ansible-galaxy.rst:814 ../../rst/cli/ansible-galaxy.rst:855 msgid "Ignore SSL certificate validation errors." msgstr "SSL 証明書ã®æ¤œè¨¼ã‚¨ãƒ©ãƒ¼ã‚’無視ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:118 +#: ../../rst/cli/ansible-galaxy.rst:121 msgid "Don't download collection(s) listed as dependencies." msgstr "ä¾å˜é–¢ä¿‚ã¨ã—ã¦ãƒªã‚¹ãƒˆã•ã‚Œã¦ã„るコレクションã¯ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/cli/ansible-galaxy.rst:122 +#: ../../rst/cli/ansible-galaxy.rst:125 msgid "The directory to download the collections to." msgstr "コレクションをダウンãƒãƒ¼ãƒ‰ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:126 +#: ../../rst/cli/ansible-galaxy.rst:129 msgid "A file containing a list of collections to be downloaded." msgstr "ダウンãƒãƒ¼ãƒ‰ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€è¦§ã‚’å«ã‚€ãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:130 ../../rst/cli/ansible-galaxy.rst:176 -#: ../../rst/cli/ansible-galaxy.rst:219 ../../rst/cli/ansible-galaxy.rst:260 -#: ../../rst/cli/ansible-galaxy.rst:357 ../../rst/cli/ansible-galaxy.rst:398 -#: ../../rst/cli/ansible-galaxy.rst:463 ../../rst/cli/ansible-galaxy.rst:532 -#: ../../rst/cli/ansible-galaxy.rst:569 ../../rst/cli/ansible-galaxy.rst:602 -#: ../../rst/cli/ansible-galaxy.rst:639 ../../rst/cli/ansible-galaxy.rst:684 -#: ../../rst/cli/ansible-galaxy.rst:733 ../../rst/cli/ansible-galaxy.rst:778 -#: ../../rst/cli/ansible-galaxy.rst:819 ../../rst/cli/ansible-galaxy.rst:880 +#: ../../rst/cli/ansible-galaxy.rst:133 ../../rst/cli/ansible-galaxy.rst:179 +#: ../../rst/cli/ansible-galaxy.rst:222 ../../rst/cli/ansible-galaxy.rst:263 +#: ../../rst/cli/ansible-galaxy.rst:360 ../../rst/cli/ansible-galaxy.rst:401 +#: ../../rst/cli/ansible-galaxy.rst:466 ../../rst/cli/ansible-galaxy.rst:535 +#: ../../rst/cli/ansible-galaxy.rst:572 ../../rst/cli/ansible-galaxy.rst:605 +#: ../../rst/cli/ansible-galaxy.rst:642 ../../rst/cli/ansible-galaxy.rst:687 +#: ../../rst/cli/ansible-galaxy.rst:736 ../../rst/cli/ansible-galaxy.rst:781 +#: ../../rst/cli/ansible-galaxy.rst:822 ../../rst/cli/ansible-galaxy.rst:883 msgid "The Galaxy API server URL" msgstr "Galaxy API サーãƒãƒ¼ URL" -#: ../../rst/cli/ansible-galaxy.rst:141 +#: ../../rst/cli/ansible-galaxy.rst:144 msgid "collection init" msgstr "collection init" -#: ../../rst/cli/ansible-galaxy.rst:143 ../../rst/cli/ansible-galaxy.rst:491 +#: ../../rst/cli/ansible-galaxy.rst:146 ../../rst/cli/ansible-galaxy.rst:494 msgid "Creates the skeleton framework of a role or collection that complies with the Galaxy metadata format. Requires a role or collection name. The collection name must be in the format ``<namespace>.<collection>``." msgstr "Galaxy メタデータ形å¼ã«æº–æ‹ ã™ã‚‹ãƒãƒ¼ãƒ«ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚¹ã‚±ãƒ«ãƒˆãƒ³ãƒ•ãƒ¬ãƒ¼ãƒ ワークを作æˆã—ã¾ã™ã€‚ãƒãƒ¼ãƒ«ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åãŒå¿…è¦ã§ã™ã€‚コレクションå㯠``<namespace>.<collection>`` ã®å½¢å¼ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:152 +#: ../../rst/cli/ansible-galaxy.rst:155 msgid "The path to a collection skeleton that the new collection should be based upon." msgstr "æ–°ã—ã„コレクションã®åŸºã¨ãªã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚¹ã‚±ãƒ«ãƒˆãƒ³ã¸ã®ãƒ‘ス。" -#: ../../rst/cli/ansible-galaxy.rst:156 +#: ../../rst/cli/ansible-galaxy.rst:159 msgid "The path in which the skeleton collection will be created. The default is the current working directory." msgstr "スケルトンコレクションãŒä½œæˆã•ã‚Œã‚‹ãƒ‘ス。デフォルトã¯ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:172 ../../rst/cli/ansible-galaxy.rst:215 -#: ../../rst/cli/ansible-galaxy.rst:337 ../../rst/cli/ansible-galaxy.rst:528 -#: ../../rst/cli/ansible-galaxy.rst:856 +#: ../../rst/cli/ansible-galaxy.rst:175 ../../rst/cli/ansible-galaxy.rst:218 +#: ../../rst/cli/ansible-galaxy.rst:340 ../../rst/cli/ansible-galaxy.rst:531 +#: ../../rst/cli/ansible-galaxy.rst:859 msgid "Force overwriting an existing role or collection" msgstr "æ—¢å˜ã®ãƒãƒ¼ãƒ«ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸Šæ›¸ãを強制ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:187 +#: ../../rst/cli/ansible-galaxy.rst:190 msgid "collection build" msgstr "collection build" -#: ../../rst/cli/ansible-galaxy.rst:189 +#: ../../rst/cli/ansible-galaxy.rst:192 msgid "Build an Ansible Galaxy collection artifact that can be stored in a central repository like Ansible Galaxy. By default, this command builds from the current working directory. You can optionally pass in the collection input path (where the ``galaxy.yml`` file is)." msgstr "Ansible Galaxy ãªã©ã®ä¸å¤®ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«æ ¼ç´ã§ãã‚‹ Ansible Galaxy コレクションアーティファクトを構築ã—ã¾ã™ã€‚デフォルトã§ã¯ã€ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã¯ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰æ§‹ç¯‰ã•ã‚Œã¾ã™ã€‚å¿…è¦ã«å¿œã˜ã¦ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å…¥åŠ›ãƒ‘スを渡ã™ã“ã¨ãŒã§ãã¾ã™ (``galaxy.yml`` ファイルã®å ´æ‰€ã§ã™)。" -#: ../../rst/cli/ansible-galaxy.rst:199 +#: ../../rst/cli/ansible-galaxy.rst:202 msgid "The path in which the collection is built to. The default is the current working directory." msgstr "コレクションãŒæ§‹ç¯‰ã•ã‚Œã‚‹ãƒ‘ス。デフォルトã¯ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:230 +#: ../../rst/cli/ansible-galaxy.rst:233 msgid "collection publish" msgstr "collection publish" -#: ../../rst/cli/ansible-galaxy.rst:232 +#: ../../rst/cli/ansible-galaxy.rst:235 msgid "Publish a collection into Ansible Galaxy. Requires the path to the collection tarball to publish." msgstr "コレクションを Ansible Galaxy ã«å…¬é–‹ã—ã¾ã™ã€‚公開ã™ã‚‹ã«ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ tarball ã¸ã®ãƒ‘スãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:240 +#: ../../rst/cli/ansible-galaxy.rst:243 msgid "The time to wait for the collection import process to finish." msgstr "コレクションã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆãƒ—ãƒã‚»ã‚¹ãŒå®Œäº†ã™ã‚‹ã®ã‚’å¾…ã¤æ™‚間。" -#: ../../rst/cli/ansible-galaxy.rst:244 +#: ../../rst/cli/ansible-galaxy.rst:247 msgid "Don't wait for import validation results." msgstr "インãƒãƒ¼ãƒˆã®æ¤œè¨¼çµæžœã‚’å¾…ã¡ã¾ã›ã‚“。" -#: ../../rst/cli/ansible-galaxy.rst:271 +#: ../../rst/cli/ansible-galaxy.rst:274 msgid "collection install" msgstr "collection install" -#: ../../rst/cli/ansible-galaxy.rst:285 +#: ../../rst/cli/ansible-galaxy.rst:288 msgid "Disable GPG signature verification when installing collections from a Galaxy server" msgstr "Galaxy サーãƒãƒ¼ã‹ã‚‰ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã™ã‚‹éš›ã« GPG ç½²åã®æ¤œè¨¼ã‚’無効ã«ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:289 +#: ../../rst/cli/ansible-galaxy.rst:292 msgid "Force overwriting an existing collection and its dependencies." msgstr "æ—¢å˜ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŠã‚ˆã³ãã®ä¾å˜é–¢ä¿‚を強制的ã«ä¸Šæ›¸ãã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:293 ../../rst/cli/ansible-galaxy.rst:419 +#: ../../rst/cli/ansible-galaxy.rst:296 ../../rst/cli/ansible-galaxy.rst:422 msgid "A status code to ignore during signature verification (for example, NO_PUBKEY). Provide this option multiple times to ignore a list of status codes. Descriptions for the choices can be seen at L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes)." msgstr "ç½²åã®æ¤œè¨¼ä¸ã«ç„¡è¦–ã™ã‚‹ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚³ãƒ¼ãƒ‰ (例: NO_PUBKEY)。ã“ã®ã‚ªãƒ—ションを複数回指定ã—ã¦ã€ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚³ãƒ¼ãƒ‰ã®ä¸€è¦§ã‚’無視ã—ã¾ã™ã€‚é¸æŠžè‚¢ã®èª¬æ˜Žã¯ L (https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) ã§ç¢ºèªã§ãã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:297 ../../rst/cli/ansible-galaxy.rst:423 +#: ../../rst/cli/ansible-galaxy.rst:300 ../../rst/cli/ansible-galaxy.rst:426 msgid "The keyring used during signature verification" msgstr "ç½²åã®æ¤œè¨¼ä¸ã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚ーリング" -#: ../../rst/cli/ansible-galaxy.rst:305 +#: ../../rst/cli/ansible-galaxy.rst:308 msgid "Install collection artifacts (tarballs) without contacting any distribution servers. This does not apply to collections in remote Git repositories or URLs to remote tarballs." msgstr "é…信サーãƒãƒ¼ã«å•ã„åˆã‚ã›ãšã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚¢ãƒ¼ãƒ†ã‚£ãƒ•ã‚¡ã‚¯ãƒˆ (tarball) をインストールã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆ Git リãƒã‚¸ãƒˆãƒªãƒ¼å†…ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚„ã€ãƒªãƒ¢ãƒ¼ãƒˆã® tarball ã¸ã® URL ã«ã¯é©ç”¨ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/cli/ansible-galaxy.rst:313 +#: ../../rst/cli/ansible-galaxy.rst:316 msgid "The number of signatures that must successfully verify the collection. This should be a positive integer or -1 to signify that all signatures must be used to verify the collection. Prepend the value with + to fail if no valid signatures are found for the collection (e.g. +all)." msgstr "コレクションをæ£å¸¸ã«æ¤œè¨¼ã™ã‚‹å¿…è¦ã®ã‚ã‚‹ç½²åã®æ•°ã€‚ã“ã®å€¤ãŒæ•´æ•°ã¾ãŸã¯ -1 ã®å ´åˆã€ã™ã¹ã¦ã®ç½²åをコレクションã®æ¤œè¨¼ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚コレクションã«æœ‰åŠ¹ãªç½²åãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã«å¤±æ•—ã™ã‚‹ã«ã¯ã€å€¤ã®å…ˆé ã« + ã‚’è¿½åŠ ã—ã¾ã™ (例: +all）。" -#: ../../rst/cli/ansible-galaxy.rst:317 +#: ../../rst/cli/ansible-galaxy.rst:320 msgid "An additional signature source to verify the authenticity of the MANIFEST.json before installing the collection from a Galaxy server. Use in conjunction with a positional collection name (mutually exclusive with --requirements-file)." msgstr "Galaxy サーãƒãƒ¼ã‹ã‚‰ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã™ã‚‹å‰ã«ã€MANIFEST.json ã®ä¿¡é ¼æ€§ã‚’検証ã™ã‚‹è¿½åŠ ã®ç½²åソース。ä½ç½®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã¨ä½µç”¨ã—ã¾ã™ (--requirements-file ã¨ã¯ç›¸äº’ã«æŽ’ä»–çš„)。" -#: ../../rst/cli/ansible-galaxy.rst:329 +#: ../../rst/cli/ansible-galaxy.rst:332 msgid "Upgrade installed collection artifacts. This will also update dependencies unless --no-deps is provided" msgstr "インストールã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚¢ãƒ¼ãƒ†ã‚£ãƒ•ã‚¡ã‚¯ãƒˆã‚’アップグレードã—ã¾ã™ã€‚--no-deps ãŒæä¾›ã•ã‚Œã¦ã„ã‚‹å ´åˆã‚’除ãä¾å˜é–¢ä¿‚ã‚‚æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:341 +#: ../../rst/cli/ansible-galaxy.rst:344 msgid "Ignore errors during installation and continue with the next specified collection. This will not ignore dependency conflict errors." msgstr "インストール時ã«ã‚¨ãƒ©ãƒ¼ã‚’無視ã—ã€æ¬¡ã®æŒ‡å®šã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ç¶šè¡Œã—ã¾ã™ã€‚ä¾å˜é–¢ä¿‚ã®ç«¶åˆã‚¨ãƒ©ãƒ¼ã¯ç„¡è¦–ã—ã¾ã›ã‚“。" -#: ../../rst/cli/ansible-galaxy.rst:345 +#: ../../rst/cli/ansible-galaxy.rst:348 msgid "Don't download collections listed as dependencies." msgstr "ä¾å˜é–¢ä¿‚ã¨ã—ã¦ä¸€è¦§è¡¨ç¤ºã•ã‚Œã¦ã„るコレクションã¯ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/cli/ansible-galaxy.rst:349 +#: ../../rst/cli/ansible-galaxy.rst:352 msgid "The path to the directory containing your collections." msgstr "コレクションをå«ã‚€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¸ã®ãƒ‘ス。" -#: ../../rst/cli/ansible-galaxy.rst:353 +#: ../../rst/cli/ansible-galaxy.rst:356 msgid "A file containing a list of collections to be installed." msgstr "インストールã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€è¦§ã‚’å«ã‚€ãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:368 +#: ../../rst/cli/ansible-galaxy.rst:371 msgid "collection list" msgstr "collection list" -#: ../../rst/cli/ansible-galaxy.rst:370 ../../rst/cli/ansible-galaxy.rst:615 +#: ../../rst/cli/ansible-galaxy.rst:373 ../../rst/cli/ansible-galaxy.rst:618 msgid "List installed collections or roles" msgstr "インストール済ã¿ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚’一覧表示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:378 +#: ../../rst/cli/ansible-galaxy.rst:381 msgid "Format to display the list of collections in." msgstr "コレクションã®ä¸€è¦§ã‚’表示ã™ã‚‹å½¢å¼ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:394 ../../rst/cli/ansible-galaxy.rst:455 +#: ../../rst/cli/ansible-galaxy.rst:397 ../../rst/cli/ansible-galaxy.rst:458 msgid "One or more directories to search for collections in addition to the default COLLECTIONS_PATHS. Separate multiple paths with ':'." msgstr "デフォルト㮠COLLECTIONS_PATHS ã«åŠ ãˆã¦ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’検索ã™ã‚‹ 1 ã¤ä»¥ä¸Šã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã€‚複数ã®ãƒ‘スã¯ã€ã€Œ:ã€ã§åŒºåˆ‡ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:409 +#: ../../rst/cli/ansible-galaxy.rst:412 msgid "collection verify" msgstr "collection verify" -#: ../../rst/cli/ansible-galaxy.rst:427 +#: ../../rst/cli/ansible-galaxy.rst:430 msgid "Validate collection integrity locally without contacting server for canonical manifest hash." msgstr "通常ã®ãƒžãƒ‹ãƒ•ã‚§ã‚¹ãƒˆãƒãƒƒã‚·ãƒ¥ã®ãŸã‚ã«ã‚µãƒ¼ãƒãƒ¼ã«å•ã„åˆã‚ã›ã‚‹ã“ã¨ãªãã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®æ•´åˆæ€§ã‚’ãƒãƒ¼ã‚«ãƒ«ã§æ¤œè¨¼ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:431 +#: ../../rst/cli/ansible-galaxy.rst:434 msgid "The number of signatures that must successfully verify the collection. This should be a positive integer or all to signify that all signatures must be used to verify the collection. Prepend the value with + to fail if no valid signatures are found for the collection (e.g. +all)." msgstr "コレクションをæ£å¸¸ã«æ¤œè¨¼ã™ã‚‹å¿…è¦ã®ã‚ã‚‹ç½²åã®æ•°ã€‚ã“ã®å€¤ãŒæ•´æ•°ã¾ãŸã¯ all ã®å ´åˆã€ã™ã¹ã¦ã®ç½²åをコレクションã®æ¤œè¨¼ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚コレクションã«æœ‰åŠ¹ãªç½²åãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã«å¤±æ•—ã™ã‚‹ã«ã¯ã€å€¤ã®å…ˆé ã« + ã‚’è¿½åŠ ã—ã¾ã™ (例: +all）。" -#: ../../rst/cli/ansible-galaxy.rst:435 +#: ../../rst/cli/ansible-galaxy.rst:438 msgid "An additional signature source to verify the authenticity of the MANIFEST.json before using it to verify the rest of the contents of a collection from a Galaxy server. Use in conjunction with a positional collection name (mutually exclusive with --requirements-file)." msgstr "Galaxy サーãƒãƒ¼ã‹ã‚‰ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®æ®‹ã‚Šã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„を検証ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã™ã‚‹å‰ã«ã€MANIFEST.json ã®ä¿¡é ¼æ€§ã‚’検証ã™ã‚‹è¿½åŠ ã®ç½²åソース。ä½ç½®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã¨ä½µç”¨ã—ã¾ã™ (--requirements-file ã¨ã¯ç›¸äº’ã«æŽ’ä»–çš„)。" -#: ../../rst/cli/ansible-galaxy.rst:451 +#: ../../rst/cli/ansible-galaxy.rst:454 msgid "Ignore errors during verification and continue with the next specified collection." msgstr "検証時ã®ã‚¨ãƒ©ãƒ¼ã‚’無視ã—ã€æ¬¡ã®æŒ‡å®šã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ç¶šè¡Œã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:459 +#: ../../rst/cli/ansible-galaxy.rst:462 msgid "A file containing a list of collections to be verified." msgstr "検証ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€è¦§ã‚’å«ã‚€ãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:475 +#: ../../rst/cli/ansible-galaxy.rst:478 msgid "role" msgstr "ãƒãƒ¼ãƒ«" -#: ../../rst/cli/ansible-galaxy.rst:477 +#: ../../rst/cli/ansible-galaxy.rst:480 msgid "Perform the action on an Ansible Galaxy role. Must be combined with a further action like delete/install/init as listed below." msgstr "Ansible Galaxy ãƒãƒ¼ãƒ«ã§æ“作を実行ã—ã¾ã™ã€‚以下ã®ã‚ˆã†ã« delete/install/init ãªã©ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã¨çµ„ã¿åˆã‚ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:489 +#: ../../rst/cli/ansible-galaxy.rst:492 msgid "role init" msgstr "role init" -#: ../../rst/cli/ansible-galaxy.rst:500 +#: ../../rst/cli/ansible-galaxy.rst:503 msgid "The path in which the skeleton role will be created. The default is the current working directory." msgstr "スケルトンãƒãƒ¼ãƒ«ãŒä½œæˆã•ã‚Œã‚‹ãƒ‘ス。デフォルトã¯ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:504 ../../rst/cli/ansible-galaxy.rst:799 +#: ../../rst/cli/ansible-galaxy.rst:507 ../../rst/cli/ansible-galaxy.rst:802 msgid "Don't query the galaxy API when creating roles" msgstr "ãƒãƒ¼ãƒ«ã®ä½œæˆæ™‚ã« galaxy API ã«ã‚¯ã‚¨ãƒªãƒ¼ã‚’実行ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/cli/ansible-galaxy.rst:508 +#: ../../rst/cli/ansible-galaxy.rst:511 msgid "The path to a role skeleton that the new role should be based upon." msgstr "æ–°ã—ã„ãƒãƒ¼ãƒ«ã®åŸºã¨ãªã‚‹ãƒãƒ¼ãƒ«ã‚¹ã‚±ãƒ«ãƒˆãƒ³ã¸ã®ãƒ‘ス。" -#: ../../rst/cli/ansible-galaxy.rst:520 +#: ../../rst/cli/ansible-galaxy.rst:523 msgid "Initialize using an alternate role type. Valid types include: 'container', 'apb' and 'network'." msgstr "別ã®ãƒãƒ¼ãƒ«ã‚¿ã‚¤ãƒ—を使用ã—ã¦åˆæœŸåŒ–ã—ã¾ã™ã€‚有効ãªã‚¿ã‚¤ãƒ—ã«ã¯ã€ã€Œcontainerã€ã€ã€Œapbã€ã€ãŠã‚ˆã³ã€Œnetworkã€ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:543 +#: ../../rst/cli/ansible-galaxy.rst:546 msgid "role remove" msgstr "role remove" -#: ../../rst/cli/ansible-galaxy.rst:545 +#: ../../rst/cli/ansible-galaxy.rst:548 msgid "removes the list of roles passed as arguments from the local system." msgstr "ãƒãƒ¼ã‚«ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã‹ã‚‰å¼•æ•°ã¨ã—ã¦æ¸¡ã•ã‚ŒãŸãƒãƒ¼ãƒ«ã®ä¸€è¦§ã‚’削除ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:565 ../../rst/cli/ansible-galaxy.rst:635 -#: ../../rst/cli/ansible-galaxy.rst:774 ../../rst/cli/ansible-galaxy.rst:815 -#: ../../rst/cli/ansible-galaxy.rst:872 +#: ../../rst/cli/ansible-galaxy.rst:568 ../../rst/cli/ansible-galaxy.rst:638 +#: ../../rst/cli/ansible-galaxy.rst:777 ../../rst/cli/ansible-galaxy.rst:818 +#: ../../rst/cli/ansible-galaxy.rst:875 msgid "The path to the directory containing your roles. The default is the first writable one configured via DEFAULT_ROLES_PATH: {{ ANSIBLE_HOME ~ \"/roles:/usr/share/ansible/roles:/etc/ansible/roles\" }}" msgstr "ãƒãƒ¼ãƒ«ã‚’å«ã‚€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¸ã®ãƒ‘スã§ã™ã€‚デフォルト㯠DEFAULT_ROLES_PATH: {{ ANSIBLE_HOME ~ \"/roles:/usr/share/ansible/roles:/etc/ansible/roles\" }} ã§è¨å®šã•ã‚Œã‚‹æœ€åˆã®æ›¸ãè¾¼ã¿å¯èƒ½ãªãƒ•ã‚¡ã‚¤ãƒ«ã§ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:580 +#: ../../rst/cli/ansible-galaxy.rst:583 msgid "role delete" msgstr "role delete" -#: ../../rst/cli/ansible-galaxy.rst:582 +#: ../../rst/cli/ansible-galaxy.rst:585 msgid "Delete a role from Ansible Galaxy." msgstr "Ansible Galaxy ã‹ã‚‰ãƒãƒ¼ãƒ«ã‚’削除ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:613 +#: ../../rst/cli/ansible-galaxy.rst:616 msgid "role list" msgstr "role list" -#: ../../rst/cli/ansible-galaxy.rst:650 +#: ../../rst/cli/ansible-galaxy.rst:653 msgid "role search" msgstr "role search" -#: ../../rst/cli/ansible-galaxy.rst:652 +#: ../../rst/cli/ansible-galaxy.rst:655 msgid "searches for roles on the Ansible Galaxy server" msgstr "Ansible Galaxy サーãƒãƒ¼ã§ãƒãƒ¼ãƒ«ã‚’検索ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:660 +#: ../../rst/cli/ansible-galaxy.rst:663 msgid "GitHub username" msgstr "GitHub ユーザーå" -#: ../../rst/cli/ansible-galaxy.rst:664 +#: ../../rst/cli/ansible-galaxy.rst:667 msgid "list of galaxy tags to filter by" msgstr "フィルタリングã™ã‚‹ galaxy ã‚¿ã‚°ã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:668 +#: ../../rst/cli/ansible-galaxy.rst:671 msgid "list of OS platforms to filter by" msgstr "フィルタリングã™ã‚‹ OS プラットフォームã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:695 +#: ../../rst/cli/ansible-galaxy.rst:698 msgid "role import" msgstr "role import" -#: ../../rst/cli/ansible-galaxy.rst:697 +#: ../../rst/cli/ansible-galaxy.rst:700 msgid "used to import a role into Ansible Galaxy" msgstr "Ansible Galaxy ã«ãƒãƒ¼ãƒ«ã‚’インãƒãƒ¼ãƒˆã™ã‚‹ã®ã«ä½¿ç”¨ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:705 +#: ../../rst/cli/ansible-galaxy.rst:708 msgid "The name of a branch to import. Defaults to the repository's default branch (usually master)" msgstr "インãƒãƒ¼ãƒˆã™ã‚‹ãƒ–ランãƒã®åå‰ã€‚デフォルトã§ã¯ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãƒ–ランム(通常㯠master) ã«è¨å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:709 +#: ../../rst/cli/ansible-galaxy.rst:712 msgid "Don't wait for import results." msgstr "インãƒãƒ¼ãƒˆã®çµæžœã‚’å¾…ã¡ã¾ã›ã‚“。" -#: ../../rst/cli/ansible-galaxy.rst:713 +#: ../../rst/cli/ansible-galaxy.rst:716 msgid "The name the role should have, if different than the repo name" msgstr "ãƒãƒ¼ãƒ«ã«ä»˜ä¸Žã™ã¹ãåå‰ (リãƒã‚¸ãƒˆãƒªãƒ¼åã¨ã¯ç•°ãªã‚‹å ´åˆ)" -#: ../../rst/cli/ansible-galaxy.rst:717 +#: ../../rst/cli/ansible-galaxy.rst:720 msgid "Check the status of the most recent import request for given github_user/github_repo." msgstr "指定ã—㟠github_user/github_repo ã®ã€æœ€æ–°ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆè¦æ±‚ステータスを確èªã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:744 +#: ../../rst/cli/ansible-galaxy.rst:747 msgid "role setup" msgstr "role setup" -#: ../../rst/cli/ansible-galaxy.rst:746 +#: ../../rst/cli/ansible-galaxy.rst:749 msgid "Setup an integration from Github or Travis for Ansible Galaxy roles" msgstr "Ansible Galaxy ãƒãƒ¼ãƒ«ã® Github ã¾ãŸã¯ Travis ã‹ã‚‰ã®çµ±åˆã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:754 +#: ../../rst/cli/ansible-galaxy.rst:757 msgid "List all of your integrations." msgstr "ã™ã¹ã¦ã®çµ±åˆã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:758 +#: ../../rst/cli/ansible-galaxy.rst:761 msgid "Remove the integration matching the provided ID value. Use --list to see ID values." msgstr "指定㮠ID 値ã«ä¸€è‡´ã™ã‚‹ã‚¤ãƒ³ãƒ†ã‚°ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã‚’削除ã—ã¾ã™ã€‚ID ã®å€¤ã‚’表示ã™ã‚‹ã«ã¯ --list を使用ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:789 +#: ../../rst/cli/ansible-galaxy.rst:792 msgid "role info" msgstr "role info" -#: ../../rst/cli/ansible-galaxy.rst:791 +#: ../../rst/cli/ansible-galaxy.rst:794 msgid "prints out detailed information about an installed role as well as info available from the galaxy API." msgstr "インストールã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã«é–¢ã™ã‚‹è©³ç´°æƒ…å ±ã¨ã€galaxy API ã§åˆ©ç”¨å¯èƒ½ãªæƒ…å ±ã‚’å‡ºåŠ›ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:830 +#: ../../rst/cli/ansible-galaxy.rst:833 msgid "role install" msgstr "role install" -#: ../../rst/cli/ansible-galaxy.rst:840 +#: ../../rst/cli/ansible-galaxy.rst:843 msgid "Force overwriting an existing role and its dependencies." msgstr "æ—¢å˜ã®ãƒãƒ¼ãƒ«ã¨ãã®ä¾å˜é–¢ä¿‚を強制的ã«ä¸Šæ›¸ãã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:860 +#: ../../rst/cli/ansible-galaxy.rst:863 msgid "Use tar instead of the scm archive option when packaging the role." msgstr "ãƒãƒ¼ãƒ«ã‚’パッケージ化ã™ã‚‹éš›ã«ã€scm アーカイブオプションã®ä»£ã‚ã‚Šã« tar を使用ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:864 +#: ../../rst/cli/ansible-galaxy.rst:867 msgid "Ignore errors and continue with the next specified role." msgstr "エラーを無視ã—ã¦ã€æ¬¡ã«æŒ‡å®šã—ãŸãƒãƒ¼ãƒ«ã§ç¶šè¡Œã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-galaxy.rst:868 +#: ../../rst/cli/ansible-galaxy.rst:871 msgid "Don't download roles listed as dependencies." msgstr "ä¾å˜é–¢ä¿‚ã¨ã—ã¦ãƒªã‚¹ãƒˆã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã¯ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/cli/ansible-galaxy.rst:876 +#: ../../rst/cli/ansible-galaxy.rst:879 msgid "A file containing a list of roles to be installed." msgstr "インストールã™ã‚‹ãƒãƒ¼ãƒ«ã®ä¸€è¦§ã‚’å«ã‚€ãƒ•ã‚¡ã‚¤ãƒ«ã€‚" @@ -965,44 +969,44 @@ msgstr "ansible-inventory" msgid ":strong:`None`" msgstr ":strong:`None`" -#: ../../rst/cli/ansible-inventory.rst:36 +#: ../../rst/cli/ansible-inventory.rst:37 msgid "used to display or dump the configured inventory as Ansible sees it" msgstr "Ansible ãŒèªè˜ã—ã¦ã„るよã†ã«ã€è¨å®šã—ãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’表示ã¾ãŸã¯ãƒ€ãƒ³ãƒ—ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-inventory.rst:52 +#: ../../rst/cli/ansible-inventory.rst:53 msgid "When doing an --list, represent in a way that is optimized for export,not as an accurate representation of how Ansible has processed it" msgstr "--list を実行ã™ã‚‹å ´åˆã¯ã€Ansible ãŒå‡¦ç†ã™ã‚‹æ–¹æ³•ã‚’æ£ç¢ºã«ç¤ºã™ã®ã§ã¯ãªãã€ã‚¨ã‚¯ã‚¹ãƒãƒ¼ãƒˆç”¨ã«æœ€é©åŒ–ã•ã‚Œã‚‹æ–¹æ³•ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-inventory.rst:57 +#: ../../rst/cli/ansible-inventory.rst:58 msgid "create inventory graph, if supplying pattern it must be a valid group name" msgstr "インベントリーグラフを作æˆã—ã¾ã™ (パターンを指定ã—ã¦ã„ã‚‹å ´åˆã¯ã€æœ‰åŠ¹ãªã‚°ãƒ«ãƒ¼ãƒ—åã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)。" -#: ../../rst/cli/ansible-inventory.rst:62 +#: ../../rst/cli/ansible-inventory.rst:63 msgid "Output specific host info, works as inventory script" msgstr "特定ã®ãƒ›ã‚¹ãƒˆæƒ…å ±ã‚’å‡ºåŠ›ã—ã¾ã™ (インベントリースクリプトã¨ã—ã¦æ©Ÿèƒ½ã—ã¾ã™)。" -#: ../../rst/cli/ansible-inventory.rst:67 +#: ../../rst/cli/ansible-inventory.rst:68 msgid "Output all hosts info, works as inventory script" msgstr "å…¨ãƒ›ã‚¹ãƒˆæƒ…å ±å‡ºåŠ›ã—ã¾ã™ (インベントリースクリプトã¨ã—ã¦æ©Ÿèƒ½ã—ã¾ã™)。" -#: ../../rst/cli/ansible-inventory.rst:72 -#: ../../rst/cli/ansible-inventory.rst:127 +#: ../../rst/cli/ansible-inventory.rst:73 +#: ../../rst/cli/ansible-inventory.rst:128 msgid "==SUPPRESS==" msgstr "==SUPPRESS==" -#: ../../rst/cli/ansible-inventory.rst:77 +#: ../../rst/cli/ansible-inventory.rst:78 msgid "When doing --list, send the inventory to a file instead of to the screen" msgstr "--list を実行ã™ã‚‹å ´åˆã¯ã€ç”»é¢ã®ä»£ã‚ã‚Šã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’ファイルã«é€ä¿¡ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-inventory.rst:87 +#: ../../rst/cli/ansible-inventory.rst:88 msgid "Use TOML format instead of default JSON, ignored for --graph" msgstr "デフォルト㮠JSON ã®ä»£ã‚ã‚Šã« TOML å½¢å¼ã‚’使用ã—ã¾ã™ (--graph ã§ã¯ç„¡è¦–ã•ã‚Œã¾ã™)。" -#: ../../rst/cli/ansible-inventory.rst:92 +#: ../../rst/cli/ansible-inventory.rst:93 msgid "Add vars to graph display, ignored unless used with --graph" msgstr "グラフ表示ã«å¤‰æ•°ã‚’è¿½åŠ ã—ã¾ã™ã€‚--graph ã¨ä½µç”¨ã—ãªã„é™ã‚Šç„¡è¦–ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-inventory.rst:137 +#: ../../rst/cli/ansible-inventory.rst:138 msgid "Use YAML format instead of default JSON, ignored for --graph" msgstr "デフォルト㮠JSON ã®ä»£ã‚ã‚Šã« YAML å½¢å¼ã‚’使用ã—ã¾ã™ã€‚--graph ã¯ç„¡è¦–ã•ã‚Œã¾ã™ã€‚" @@ -1014,35 +1018,35 @@ msgstr "ansible-playbook" msgid ":strong:`Runs Ansible playbooks, executing the defined tasks on the targeted hosts.`" msgstr ":strong:`ターゲットã®ãƒ›ã‚¹ãƒˆã§å®šç¾©ã—ãŸã‚¿ã‚¹ã‚¯ã‚’実行ã—㦠Ansible Playbook を実行ã—ã¾ã™ã€‚`" -#: ../../rst/cli/ansible-playbook.rst:41 +#: ../../rst/cli/ansible-playbook.rst:42 msgid "the tool to run *Ansible playbooks*, which are a configuration and multinode deployment system. See the project home page (https://docs.ansible.com) for more information." msgstr "è¨å®šãŠã‚ˆã³ãƒžãƒ«ãƒãƒŽãƒ¼ãƒ‰ã®ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã‚·ã‚¹ãƒ†ãƒ ã§ã‚ã‚‹ *Ansible Playbook* を実行ã™ã‚‹ãƒ„ール。詳細ã¯ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã®ãƒ›ãƒ¼ãƒ ページ (https://docs.ansible.com) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/cli/ansible-playbook.rst:78 +#: ../../rst/cli/ansible-playbook.rst:79 msgid "clear the fact cache for every host in inventory" msgstr "インベントリー内ã®ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã®ãƒ•ã‚¡ã‚¯ãƒˆã‚ャッシュを消去ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:83 +#: ../../rst/cli/ansible-playbook.rst:84 msgid "run handlers even if a task fails" msgstr "タスクãŒå¤±æ•—ã—ã¦ã‚‚ãƒãƒ³ãƒ‰ãƒ©ãƒ¼ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:93 +#: ../../rst/cli/ansible-playbook.rst:94 msgid "list all available tags" msgstr "利用å¯èƒ½ãªã‚¿ã‚°ã‚’ã™ã¹ã¦è¡¨ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:98 +#: ../../rst/cli/ansible-playbook.rst:99 msgid "list all tasks that would be executed" msgstr "実行ã™ã‚‹ã‚¿ã‚¹ã‚¯ã‚’ã™ã¹ã¦è¡¨ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:118 ../../rst/cli/ansible-pull.rst:124 +#: ../../rst/cli/ansible-playbook.rst:119 ../../rst/cli/ansible-pull.rst:128 msgid "only run plays and tasks whose tags do not match these values" msgstr "ã‚¿ã‚°ãŒã“れらã®å€¤ã¨ä¸€è‡´ã—ãªã„プレイã¨ã‚¿ã‚¹ã‚¯ã®ã¿ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:133 +#: ../../rst/cli/ansible-playbook.rst:134 msgid "start the playbook at the task matching this name" msgstr "ã“ã®åå‰ã«ä¸€è‡´ã™ã‚‹ã‚¿ã‚¹ã‚¯ã§ Playbook を開始ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-playbook.rst:228 ../../rst/cli/ansible-pull.rst:244 +#: ../../rst/cli/ansible-playbook.rst:229 ../../rst/cli/ansible-pull.rst:248 msgid "only run plays and tasks tagged with these values" msgstr "ãれらã®å€¤ã§ã‚¿ã‚°ä»˜ã‘ã•ã‚ŒãŸãƒ—レイã¨ã‚¿ã‚¹ã‚¯ã®ã¿ã‚’実行ã—ã¾ã™ã€‚" @@ -1054,63 +1058,67 @@ msgstr "ansible-pull" msgid ":strong:`pulls playbooks from a VCS repo and executes them for the local host`" msgstr ":strong:`VCS リãƒã‚¸ãƒˆãƒªãƒ¼ã‹ã‚‰ Playbooks ã‚’å–å¾—ã—ã€ãƒãƒ¼ã‚«ãƒ«ãƒ›ã‚¹ãƒˆã§å®Ÿè¡Œã—ã¾ã™ã€‚`" -#: ../../rst/cli/ansible-pull.rst:40 +#: ../../rst/cli/ansible-pull.rst:41 msgid "Used to pull a remote copy of ansible on each managed node, each set to run via cron and update playbook source via a source repository. This inverts the default *push* architecture of ansible into a *pull* architecture, which has near-limitless scaling potential." msgstr "å„管ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã§ ansible ã®ãƒªãƒ¢ãƒ¼ãƒˆã‚³ãƒ”ーをå–å¾—ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚å„セット㯠cron を介ã—ã¦å®Ÿè¡Œã•ã‚Œã€ã‚½ãƒ¼ã‚¹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã‚’介ã—㦠Playbook ソースを更新ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ansible ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® *push* アーã‚テクãƒãƒ£ãƒ¼ãŒ *pull* アーã‚テクãƒãƒ£ãƒ¼ã«å転ã—ã¾ã™ã€‚ã“ã‚Œã«ã¯ã€ã‚¹ã‚±ãƒ¼ãƒªãƒ³ã‚°ã®å¯èƒ½æ€§ãŒã»ã¼ç„¡é™ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:45 +#: ../../rst/cli/ansible-pull.rst:46 +msgid "None of the CLI tools are designed to run concurrently with themselves, you should use an external scheduler and/or locking to ensure there are no clashing operations." +msgstr "ã©ã® CLI ツールもåŒæ™‚ã«å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ã¯è¨è¨ˆã•ã‚Œã¦ã„ã¾ã›ã‚“。外部スケジューラーやãƒãƒƒã‚¯ã‚’使用ã—ã¦ã€æ“作ãŒç«¶åˆã—ãªã„よã†ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/cli/ansible-pull.rst:49 msgid "The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible-pull. This is useful both for extreme scale-out as well as periodic remediation. Usage of the 'fetch' module to retrieve logs from ansible-pull runs would be an excellent way to gather and analyze remote logs from ansible-pull." msgstr "セットアップ Playbook ã¯ã€cron é »åº¦ã€ãƒã‚®ãƒ³ã‚°ã®å ´æ‰€ã€ãŠã‚ˆã³ãƒ‘ラメーターを ansible-pull ã«å¤‰æ›´ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€æ€¥ãªã‚¹ã‚±ãƒ¼ãƒ«ã‚¢ã‚¦ãƒˆã¨å®šæœŸçš„ãªä¿®å¾©ã«ã‚‚便利ã§ã™ã€‚ansible-pull ã‹ã‚‰ãƒã‚°ã‚’å–å¾—ã™ã‚‹ãŸã‚ã«ã€Œfetchã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã“ã¨ã¯ã€ansible-pull ã‹ã‚‰ãƒã‚°ã‚’åŽé›†ã—ã€åˆ†æžã™ã‚‹ãŸã‚ã®å„ªã‚ŒãŸæ–¹æ³•ã§ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:59 +#: ../../rst/cli/ansible-pull.rst:63 msgid "adds the hostkey for the repo url if not already added" msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ URL ã®ãƒ›ã‚¹ãƒˆã‚ーãŒè¿½åŠ ã•ã‚Œã¦ã„ãªã„å ´åˆã¯ãƒ›ã‚¹ãƒˆã‚ãƒ¼ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:79 +#: ../../rst/cli/ansible-pull.rst:83 msgid "modified files in the working repository will be discarded" msgstr "作æ¥ãƒªãƒã‚¸ãƒˆãƒªãƒ¼å†…ã®å¤‰æ›´ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã¯ç ´æ£„ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:94 +#: ../../rst/cli/ansible-pull.rst:98 msgid "Do a full clone, instead of a shallow one." msgstr "簡易クãƒãƒ¼ãƒ³ã§ã¯ãªãã€å®Œå…¨ãªã‚¯ãƒãƒ¼ãƒ³ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:109 +#: ../../rst/cli/ansible-pull.rst:113 msgid "purge checkout after playbook run" msgstr "Playbook ã®å®Ÿè¡Œå¾Œã«ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã‚’パージã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:139 +#: ../../rst/cli/ansible-pull.rst:143 msgid "submodules will track the latest changes. This is equivalent to specifying the --remote flag to git submodule update" msgstr "サブモジュールã§ã¯æœ€æ–°ã®å¤‰æ›´ã‚’追跡ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€--remote フラグを git サブモジュール更新ã«æŒ‡å®šã™ã‚‹ã®ã¨åŒã˜ã§ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:154 +#: ../../rst/cli/ansible-pull.rst:158 msgid "verify GPG signature of checked out commit, if it fails abort running the playbook. This needs the corresponding VCS module to support such an operation" msgstr "ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ãŸã‚³ãƒŸãƒƒãƒˆã® GPG ç½²åを確èªã—ã¾ã™ã€‚Playbook ã®å®Ÿè¡Œã‚’ä¸æ–ã§ããªã„å ´åˆã«ã€ã“ã®ã‚ˆã†ãªæ“作をサãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€å¯¾å¿œã™ã‚‹ VCS モジュールãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:164 +#: ../../rst/cli/ansible-pull.rst:168 msgid "branch/tag/commit to checkout. Defaults to behavior of repository module." msgstr "ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã™ã‚‹ãƒ–ランãƒã€ã‚¿ã‚°ã€ã¾ãŸã¯ã‚³ãƒŸãƒƒãƒˆã€‚デフォルトã¯ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å‹•ä½œã§ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:184 +#: ../../rst/cli/ansible-pull.rst:188 msgid "URL of the playbook repository" msgstr "Playbook リãƒã‚¸ãƒˆãƒªãƒ¼ã® URL" -#: ../../rst/cli/ansible-pull.rst:194 +#: ../../rst/cli/ansible-pull.rst:198 msgid "absolute path of repository checkout directory (relative paths are not supported)" msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã®çµ¶å¯¾ãƒ‘ス (相対パスã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã›ã‚“)" -#: ../../rst/cli/ansible-pull.rst:204 +#: ../../rst/cli/ansible-pull.rst:208 msgid "run the playbook even if the repository could not be updated" msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’æ›´æ–°ã§ããªã‹ã£ãŸå ´åˆã§ã‚‚ã€Playbook を実行ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:229 +#: ../../rst/cli/ansible-pull.rst:233 msgid "Repository module name, which ansible will use to check out the repo. Choices are ('git', 'subversion', 'hg', 'bzr'). Default is git." msgstr "Ansible ãŒãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã‚’ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã™ã‚‹ã®ã«ä½¿ç”¨ã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å (「gitã€ã€ã€Œsubversionã€ã€ã€Œhgã€ã€ã€Œbzrã€)。デフォルト㯠git ã§ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:234 +#: ../../rst/cli/ansible-pull.rst:238 msgid "only run the playbook if the repository has been updated" msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ãŒæ›´æ–°ã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã®ã¿ Playbook を実行ã—ã¾ã™ã€‚" -#: ../../rst/cli/ansible-pull.rst:239 +#: ../../rst/cli/ansible-pull.rst:243 msgid "sleep for random interval (between 0 and n number of seconds) before starting. This is a useful way to disperse git requests" msgstr "開始å‰ã®ãƒ©ãƒ³ãƒ€ãƒ ãªé–“éš” (0 ～ n 秒間) をスリープ状態ã«ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€git è¦æ±‚を分散ã•ã›ã‚‹ãŸã‚ã®ä¾¿åˆ©ãªæ–¹æ³•ã§ã™ã€‚" @@ -1159,7 +1167,7 @@ msgstr "æš—å·åŒ–用ã¾ãŸã¯å¾©å·ç”¨ã®å‡ºåŠ›ãƒ•ã‚¡ã‚¤ãƒ«å。標準出力 (s #: ../../rst/cli/ansible-vault.rst:145 msgid "edit" -msgstr "edit" +msgstr "編集" #: ../../rst/cli/ansible-vault.rst:147 msgid "open and decrypt an existing vaulted file in an editor, that will be encrypted again when closed" @@ -1232,4 +1240,7 @@ msgstr "rekey ã®æ–°ã—ã„ Vault パスワードファイル" #~ msgid "directory to checkout repository to" #~ msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼" +#~ msgid "command to manage Ansible roles in shared repositories, the default of which is Ansible Galaxy *https://galaxy.ansible.com*." +#~ msgstr "共有リãƒã‚¸ãƒˆãƒªãƒ¼ã® Ansible ãƒãƒ¼ãƒ«ã‚’管ç†ã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ (デフォルト㯠Ansible Galaxy *https://galaxy.ansible.com* ã§ã™)。" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/collections_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/collections_guide.po index 976a06c8..7065afab 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/collections_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/collections_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/collections_guide/collections_downloading.rst:4 msgid "Downloading collections" @@ -296,15 +296,15 @@ msgstr "``type: git`` ã§ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã™ã‚‹å ´åˆã€` msgid "You can also add roles to a ``requirements.yml`` file, under the ``roles`` key. The values follow the same format as a requirements file used in older Ansible releases." msgstr "``roles``ã‚ーã®ä¸‹ã«ã‚ã‚‹``requirements.yml``ファイルã«ãƒãƒ¼ãƒ«ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã®å€¤ã¯ã€å¤ã„ Ansible リリースã§ä½¿ç”¨ã•ã‚Œã‚‹è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã¨åŒã˜å½¢å¼ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:67 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:68 msgid "To install both roles and collections at the same time with one command, run the following:" msgstr "1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã§ã€ãƒãƒ¼ãƒ«ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’åŒæ™‚ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:73 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:74 msgid "Running ``ansible-galaxy collection install -r`` or ``ansible-galaxy role install -r`` will only install collections, or roles respectively." msgstr "``ansible-galaxy collection install -r`` ã¾ãŸã¯ ``ansible-galaxy role install -r`` を実行ã™ã‚‹ã¨ã€ãã‚Œãžã‚Œã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¾ãŸã¯ãƒãƒ¼ãƒ«ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:76 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:77 msgid "Installing both roles and collections from the same requirements file will not work when specifying a custom collection or role install path. In this scenario the collections will be skipped and the command will process each like ``ansible-galaxy role install`` would." msgstr "カスタムコレクションã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãƒ‘スを指定ã™ã‚‹å ´åˆã€åŒã˜è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ãƒãƒ¼ãƒ«ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸¡æ–¹ã‚’インストールã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。今回ã®ä¾‹ã§ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¯çœç•¥ã•ã‚Œã€ã‚³ãƒžãƒ³ãƒ‰ã¯ ``ansible-galaxy role install`` ã®ã‚ˆã†ã«å‡¦ç†ã•ã‚Œã¾ã™ã€‚" @@ -628,6 +628,10 @@ msgstr "ã“ã‚Œã¯ã€ãƒãƒ¼ãƒ«ã¨åŒæ§˜ã«ã€``my_namespace.my_collection`` ã® ` msgid "Playbook names, like other collection resources, have a restricted set of valid characters. Names can contain only lowercase alphanumeric characters, plus _ and must start with an alpha character. The dash ``-`` character is not valid for playbook names in collections. Playbooks whose names contain invalid characters are not addressable: this is a limitation of the Python importer that is used to load collection resources." msgstr "ä»–ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªã‚½ãƒ¼ã‚¹ãªã©ã® Playbook åã§ã¯ã€æœ‰åŠ¹ãªæ–‡å—ã®ã‚»ãƒƒãƒˆãŒåˆ¶é™ã•ã‚Œã¦ã„ã¾ã™ã€‚åå‰ã«ã¯ã€å°æ–‡å—ã®è‹±æ•°å—㨠_ ã®ã¿ã‚’å«ã‚ã‚‹ã“ã¨ãŒã§ãã€ã‚¢ãƒ«ãƒ•ã‚¡ãƒ™ãƒƒãƒˆè¨˜å·ã§é–‹å§‹ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ダッシュ ``-`` ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã® Playbook åã«ã¯æœ‰åŠ¹ã§ã¯ã‚ã‚Šã¾ã›ã‚“。åå‰ã«ç„¡åŠ¹ãªæ–‡å—ãŒå«ã¾ã‚Œã‚‹Playbookã«ã‚¢ãƒ‰ãƒ¬ã‚¹ã‚’指定ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。ã“ã‚Œã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªã‚½ãƒ¼ã‚¹ã®èªã¿è¾¼ã¿ã«ä½¿ç”¨ã•ã‚Œã‚‹ Python インãƒãƒ¼ã‚¿ãƒ¼ã®åˆ¶é™ã§ã™ã€‚" +#: ../../rst/collections_guide/collections_using_playbooks.rst:119 +msgid "Playbooks in collections do not support 'adjacent' plugins, all plugins must be in the collection specific directories." +msgstr "コレクション内㮠Playbook ã¯ã€Œéš£æŽ¥ã™ã‚‹ã€ãƒ—ラグインをサãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。ã™ã¹ã¦ã®ãƒ—ラグインã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å›ºæœ‰ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + #: ../../rst/collections_guide/collections_verifying.rst:4 msgid "Verifying collections" msgstr "コレクションã®æ¤œè¨¼" diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/command_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/command_guide.po index 8ce33709..58ce627c 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/command_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/command_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/command_guide/cheatsheet.rst:5 msgid "Ansible CLI cheatsheet" @@ -80,6 +80,10 @@ msgstr "コマンドラインツールã®ä½¿ç”¨" msgid "Most users are familiar with `ansible` and `ansible-playbook`, but those are not the only utilities Ansible provides. Below is a complete list of Ansible utilities. Each page contains a description of the utility and a listing of supported parameters." msgstr "ã»ã¨ã‚“ã©ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€`ansible` ãŠã‚ˆã³ `ansible-playbook` ã«ç²¾é€šã—ã¦ã„ã¾ã™ãŒã€ã“れらã¯ã€Ansible ãŒæä¾›ã™ã‚‹å”¯ä¸€ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã§ã¯ã‚ã‚Šã¾ã›ã‚“。以下ã¯ã€Ansible ユーティリティーã®å®Œå…¨ãªãƒªã‚¹ãƒˆã§ã™ã€‚å„ページã«ã¯ã€ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®èª¬æ˜Žã¨ã€ã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ãƒ‘ラメーター一覧ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" +#: ../../rst/command_guide/command_line_tools.rst:10 +msgid "You should not run most Ansible CLI tools in parallel against the same targets." +msgstr "ã»ã¨ã‚“ã©ã® Ansible CLI ツールをåŒã˜ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã«å¯¾ã—ã¦ä¸¦è¡Œã—ã¦å®Ÿè¡Œã—ãªã„ã§ãã ã•ã„。" + #: ../../rst/command_guide/index.rst:5 msgid "Using Ansible command line tools" msgstr "Ansible コマンドラインツールã®ä½¿ç”¨" diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/community.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/community.po index 0e3044f2..f634ad2b 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/community.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/community.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/community/advanced_index.rst:5 msgid "Advanced Contributor Guide" @@ -376,38 +376,38 @@ msgid "If the module changes the system state, check the actual system state usi msgstr "モジュールãŒã‚·ã‚¹ãƒ†ãƒ 状態を変更ã—ãŸå ´åˆã¯ã€å°‘ãªãã¨ã‚‚ 1 ã¤ã®ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦å®Ÿéš›ã®ã‚·ã‚¹ãƒ†ãƒ 状態を確èªã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãƒ•ã‚¡ã‚¤ãƒ«ã‚’変更ã—ãŸå ´åˆã¯ã€ãƒ†ã‚¹ãƒˆã‚¿ã‚¹ã‚¯ã®å‰å¾Œã« :ref:`stat <ansible_collections.ansible.builtin.stat_module>` モジュールã§ãƒã‚§ãƒƒã‚¯ã‚µãƒ ã‚’ãƒã‚§ãƒƒã‚¯ã—ã€ãƒ•ã‚¡ã‚¤ãƒ«ãŒå¤‰æ›´ã•ã‚ŒãŸã“ã¨ã‚’確èªã§ãã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_about.rst:131 -msgid "Run the same task with ``check_mode: yes`` if check-mode is supported by the module. Check with other modules that the actual system state has not been changed." -msgstr "check-mode ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``check_mode: yes`` ã§åŒã˜ã‚¿ã‚¹ã‚¯ã‚’実行ã—ã¾ã™ã€‚実際ã®ã‚·ã‚¹ãƒ†ãƒ 状態ãŒå¤‰æ›´ã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ç¢ºèªã—ã¦ãã ã•ã„。" +msgid "Run the same task with ``check_mode: true`` if check-mode is supported by the module. Check with other modules that the actual system state has not been changed." +msgstr "check-mode ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``check_mode: true`` ã§åŒã˜ã‚¿ã‚¹ã‚¯ã‚’実行ã—ã¾ã™ã€‚実際ã®ã‚·ã‚¹ãƒ†ãƒ 状態ãŒå¤‰æ›´ã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ç¢ºèªã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_about.rst:132 -msgid "Cover cases when the module must fail. Use the ``ignore_errors: yes`` option and check the returned message with the ``assert`` module." -msgstr "モジュールãŒå¤±æ•—ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ケースをカãƒãƒ¼ã—ã¾ã™ã€‚``ignore_errors: yes`` オプションを使用ã—ã¦ã€``assert`` モジュールã§è¿”ã•ã‚ŒãŸãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’確èªã—ã¾ã™ã€‚" +msgid "Cover cases when the module must fail. Use the ``ignore_errors: true`` option and check the returned message with the ``assert`` module." +msgstr "モジュールãŒå¤±æ•—ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ケースをカãƒãƒ¼ã—ã¾ã™ã€‚``ignore_errors: true`` オプションを使用ã—ã¦ã€``assert`` モジュールã§è¿”ã•ã‚ŒãŸãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’確èªã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_about.rst:134 msgid "Example:" msgstr "例:" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:150 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:149 msgid "Here is a summary:" msgstr "以下ã¯è¦ç´„ã§ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:152 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:151 msgid "Cover options and their sensible combinations." msgstr "オプションã¨ãã®é©åˆ‡ãªçµ„ã¿åˆã‚ã›ã‚’ã‚«ãƒãƒ¼ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:153 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:152 msgid "Check returned values." msgstr "戻り値を確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:154 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:153 msgid "Cover check-mode if supported." msgstr "サãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ check-mode ã‚’ã‚«ãƒãƒ¼ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:155 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:154 msgid "Check a system state using other modules." msgstr "ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦ã‚·ã‚¹ãƒ†ãƒ ã®çŠ¶æ…‹ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_about.rst:156 +#: ../../rst/community/collection_contributors/collection_integration_about.rst:155 msgid "Check when a module must fail and error messages." msgstr "モジュールã«éšœå®³ãŒç™ºç”Ÿã™ã‚‹ã‚¿ã‚¤ãƒŸãƒ³ã‚°ã¨ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’確èªã—ã¾ã™ã€‚" @@ -420,8 +420,8 @@ msgid "This section covers the following cases:" msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ä»¥ä¸‹ã‚’ã‚«ãƒãƒ¼ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:8 -msgid "There are no integration tests for a collection / group of modules in a collection at all." -msgstr "コレクション内ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³/グループã®çµ±åˆãƒ†ã‚¹ãƒˆã¯ã„ã£ã•ã„ã‚ã‚Šã¾ã›ã‚“。" +msgid "There are no integration tests for a collection or group of modules in a collection at all." +msgstr "コレクションやコレクション内ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«å¯¾ã™ã‚‹çµ±åˆãƒ†ã‚¹ãƒˆã¯ã„ã£ã•ã„ã‚ã‚Šã¾ã›ã‚“。" #: ../../rst/community/collection_contributors/collection_integration_add.rst:9 msgid "You are adding a new module and you want to include integration tests." @@ -474,7 +474,7 @@ msgstr "モジュールã®çµ±åˆãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:30 #: ../../rst/community/collection_contributors/collection_integration_updating.rst:84 msgid ":ref:`Run the tests<collection_run_integration_tests>`." -msgstr ":ref:`テストを実行ã—ã¾ã™<collection_run_integration_tests>`。" +msgstr ":ref:`Run the tests<collection_run_integration_tests>`。" #: ../../rst/community/collection_contributors/collection_integration_add.rst:31 msgid "Fix the code and tests as needed, run the tests again, and repeat the cycle until they pass." @@ -489,8 +489,8 @@ msgid "Clone the collection to the ``~/ansible_collections/community.abstract`` msgstr "コレクションをãƒãƒ¼ã‚«ãƒ«ãƒžã‚·ãƒ³ã® ``~/ansible_collections/community.abstract`` ディレクトリーã«ã‚¯ãƒãƒ¼ãƒ³ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:39 -msgid "From the ``~/ansble_collections/community.abstract`` directory, create directories for the ``setup`` target:" -msgstr "``~/ansble_collections/community.abstract`` ディレクトリーã‹ã‚‰ã€``setup`` ターゲットã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’作æˆã—ã¾ã™ã€‚" +msgid "From the ``~/ansible_collections/community.abstract`` directory, create directories for the ``setup`` target:" +msgstr "``~/ansible_collections/community.abstract`` ディレクトリーã‹ã‚‰ã€``setup`` ターゲットã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’作æˆã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:45 msgid "Write all the tasks needed to prepare the environment, install, and run the service." @@ -513,8 +513,8 @@ msgid "Add the target for the module you are testing." msgstr "テストã—ã¦ã„るモジュールã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚’è¿½åŠ ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:66 -msgid "Let's say the module is called ``abstact_service_info``. Create the following directory structure in the target:" -msgstr "モジュール㌠``abstact_service_info`` ã¨å‘¼ã°ã‚Œã‚‹ã¨ã—ã¾ã™ã€‚ターゲットã«ä»¥ä¸‹ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼æ§‹é€ を作æˆã—ã¾ã™ã€‚" +msgid "Let's say the module is called ``abstract_service_info``. Create the following directory structure in the target:" +msgstr "モジュール㌠``abstract_service_info`` ã¨å‘¼ã°ã‚Œã‚‹ã¨ã—ã¾ã™ã€‚ターゲットã«ä»¥ä¸‹ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼æ§‹é€ を作æˆã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:73 msgid "Add all of the needed subdirectories. For example, if you are going to use defaults and files, add the ``defaults`` and ``files`` directories, and so on. The approach is the same as when you are creating a role." @@ -549,7 +549,7 @@ msgid "If there are any issues with connectivity (for example, the service is no msgstr "接続ã«å•é¡ŒãŒã‚ã‚‹ (ãŸã¨ãˆã°ã€ã‚µãƒ¼ãƒ“スãŒæŽ¥ç¶šã‚’許å¯ã—ãªã„ãªã©) å ´åˆã‚„ã€ã‚³ãƒ¼ãƒ‰ã«å•é¡ŒãŒã‚ã‚‹å ´åˆã«ã¯ã€ãƒ—レイã¯å¤±æ•—ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:107 -msgid "Examine the output to see at which step the failure occurred. Investigate the reason, fix, and run again. Repeat the cycle until the test passes." +msgid "Examine the output to see at which step the failure occurred. Investigate the reason, fix it, and run again. Repeat the cycle until the test passes." msgstr "出力を調ã¹ã¦ã€éšœå®³ãŒç™ºç”Ÿã—ãŸã‚¹ãƒ†ãƒƒãƒ—を確èªã—ã¾ã™ã€‚ç†ç”±ã‚’調ã¹ã¦ä¿®æ£ã—ã€å†å®Ÿè¡Œã—ã¦ãã ã•ã„。テストã«åˆæ ¼ã™ã‚‹ã¾ã§ã“ã®ã‚µã‚¤ã‚¯ãƒ«ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:109 @@ -633,7 +633,7 @@ msgid "Then, create the following directories for the ``postgresql_info`` target msgstr "続ã„ã¦ã€``postgresql_info`` ターゲットã«ä»¥ä¸‹ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’作æˆã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:204 -msgid "To make the ``setup_postgresql_db`` target running before the ``postgresql_info`` target as a dependency, create the ``tests/integration/targets/postgresql_info/meta/main.yml`` file and add the following code to it:" +msgid "To make the ``setup_postgresql_db`` target run before the ``postgresql_info`` target as a dependency, create the ``tests/integration/targets/postgresql_info/meta/main.yml`` file and add the following code to it:" msgstr "``setup_postgresql_db`` ターゲットをä¾å˜é–¢ä¿‚ã¨ã—㦠``postgresql_info`` ターゲットã®å‰ã«å®Ÿè¡Œã™ã‚‹ã«ã¯ã€``tests/integration/targets/postgresql_info/meta/main.yml`` ファイルを作æˆã—ã€ä»¥ä¸‹ã®ã‚³ãƒ¼ãƒ‰ã‚’è¿½åŠ ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:211 @@ -657,16 +657,16 @@ msgid "The tests should pass. If we look at the output, we should see something msgstr "テストã¯åˆæ ¼ã™ã‚‹ã¯ãšã§ã™ã€‚出力を見るã¨ã€æ¬¡ã®ã‚ˆã†ã«ãªã£ã¦ã„ã‚‹ã¯ãšã§ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_add.rst:250 -msgid "If your tests fail when you are working on your project, examine the output to see at which step the failure occurred. Investigate the reason, fix, and run again. Repeat the cycle until the test passes. If the test succeeds, write more tests. Refer to the :ref:`Recommendations on coverage<collection_integration_recommendations>` section for details." -msgstr "プãƒã‚¸ã‚§ã‚¯ãƒˆã§ä½œæ¥ä¸ã«ãƒ†ã‚¹ãƒˆã«å¤±æ•—ã—ãŸå ´åˆã¯ã€å‡ºåŠ›ã‚’調ã¹ã¦ã€éšœå®³ãŒç™ºç”Ÿã—ãŸã‚¹ãƒ†ãƒƒãƒ—を確èªã—ã¾ã™ã€‚ç†ç”±ã‚’調ã¹ã¦ä¿®æ£ã—ã€å†å®Ÿè¡Œã—ã¦ãã ã•ã„。テストã«åˆæ ¼ã™ã‚‹ã¾ã§ã“ã®ã‚µã‚¤ã‚¯ãƒ«ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚テストã«åˆæ ¼ã—ãŸã‚‰ã€ã•ã‚‰ã«ãƒ†ã‚¹ãƒˆã‚’作æˆã—ã¦ãã ã•ã„。詳細ã¯ã€:ref:`ã‚«ãƒãƒ¬ãƒ¼ã‚¸ã«é–¢ã™ã‚‹æŽ¨å¥¨äº‹é …<collection_integration_recommendations>` セクションをå‚ç…§ã—ã¦ãã ã•ã„。" +msgid "If your tests fail when you are working on your project, examine the output to see at which step the failure occurred. Investigate the reason, fix it, and run again. Repeat the cycle until the test passes. If the test succeeds, write more tests. Refer to the :ref:`Recommendations on coverage<collection_integration_recommendations>` section for details." +msgstr "プãƒã‚¸ã‚§ã‚¯ãƒˆã§ä½œæ¥ä¸ã«ãƒ†ã‚¹ãƒˆã«å¤±æ•—ã—ãŸå ´åˆã¯ã€å‡ºåŠ›ã‚’調ã¹ã¦ã€éšœå®³ãŒç™ºç”Ÿã—ãŸã‚¹ãƒ†ãƒƒãƒ—を確èªã—ã¾ã™ã€‚ç†ç”±ã‚’調ã¹ã¦ä¿®æ£ã—ã€å†å®Ÿè¡Œã—ã¦ãã ã•ã„。テストã«åˆæ ¼ã™ã‚‹ã¾ã§ã“ã®ã‚µã‚¤ã‚¯ãƒ«ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚テストã«åˆæ ¼ã—ãŸã‚‰ã€ã•ã‚‰ã«ãƒ†ã‚¹ãƒˆã‚’作æˆã—ã¦ãã ã•ã„。詳細ã¯ã€:ref:`Recommendations on coverage<collection_integration_recommendations>` セクションをå‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_running.rst:4 msgid "Running integration tests" msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œ" #: ../../rst/community/collection_contributors/collection_integration_running.rst:6 -msgid "In the following examples, we will use ``Docker`` to run integration tests locally. Ensure you have :ref:`collection_prepare_environment` first." -msgstr "以下ã®ä¾‹ã§ã¯ã€``Docker`` を使用ã—ã¦ã€ãƒãƒ¼ã‚«ãƒ«ã§çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚最åˆã« :ref:`collection_prepare_environment` ãŒã‚ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" +msgid "In the following examples, we will use ``Docker`` to run integration tests locally. Ensure you :ref:`collection_prepare_environment` first." +msgstr "以下ã®ä¾‹ã§ã¯ã€``Docker`` を使用ã—ã¦ã€ãƒãƒ¼ã‚«ãƒ«ã§çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚最åˆã« :ref:`collection_prepare_environment` を確èªã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_running.rst:8 msgid "We assume that you are in the ``~/ansible_collections/NAMESPACE/COLLECTION`` directory." @@ -681,6 +681,7 @@ msgid "The ``target_name`` is a test role directory containing the tests. For ex msgstr "``target_name`` ã¯ã€ãƒ†ã‚¹ãƒˆã‚’å«ã‚€ãƒ†ã‚¹ãƒˆãƒãƒ¼ãƒ«ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ã™ã€‚ãŸã¨ãˆã°ã€å¤‰æ›´ã—ãŸãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ãŒ ``tests/integration/targets/postgresql_info/`` ディレクトリーã«ä¿å˜ã•ã‚Œã€``fedora34`` コンテナーイメージを使用ã™ã‚‹å ´åˆã€ã‚³ãƒžãƒ³ãƒ‰ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_running.rst:22 +#: ../../rst/community/create_pr_quick_start.rst:130 #: ../../rst/community/create_pr_quick_start.rst:191 msgid "You can use the ``-vv`` or ``-vvv`` argument if you need more detailed output." msgstr "より詳細ãªå‡ºåŠ›ãŒå¿…è¦ãªå ´åˆã¯ã€``-vv`` 引数ã¾ãŸã¯ ``-vvv`` 引数を使用ã§ãã¾ã™ã€‚" @@ -694,7 +695,7 @@ msgid "See the :ref:`list of supported container images <test_container_images>` msgstr ":ref:`サãƒãƒ¼ãƒˆå¯¾è±¡ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã‚¤ãƒ¡ãƒ¼ã‚¸ã®ä¸€è¦§<test_container_images>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_running.rst:28 -msgid "In some cases, for example, for platform independent tests, the ``default`` test image is required. Use the ``--docker default`` or just ``--docker`` option without specifying a distribution in this case." +msgid "In some cases, for example, for platform-independent tests, the ``default`` test image is required. Use the ``--docker default`` or just ``--docker`` option without specifying a distribution in this case." msgstr "å ´åˆã«ã‚ˆã£ã¦ã¯ã€ãŸã¨ãˆã°ã€ãƒ—ラットフォームã«ä¾å˜ã—ãªã„テストã§ã¯ã€``default`` テストイメージãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚今回ã®å ´åˆã¯ã€ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションを指定ã›ãšã«ã€``--docker default`` オプションã¾ãŸã¯å˜ã« ``--docker`` オプションを使用ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_running.rst:32 @@ -794,7 +795,7 @@ msgid "The test tasks are stored in the ``tests/integration/targets/<target_name msgstr "テストタスク㯠``tests/integration/targets/<target_name>/tasks`` ディレクトリーã«ä¿å˜ã•ã‚Œã¦ã„ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:8 -msgid "The ``main.yml`` file holds test tasks and includes other test files. Look for a suitable test file to integrate your tests or create and include / import a separate test file. You can use one of the existing test files as a draft." +msgid "The ``main.yml`` file holds test tasks and includes other test files. Look for a suitable test file to integrate your tests or create and include or import a separate test file. You can use one of the existing test files as a draft." msgstr "``main.yml`` ファイルã¯ã€ãƒ†ã‚¹ãƒˆã‚¿ã‚¹ã‚¯ã‚’ä¿æŒã—ã€ä»–ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’å«ã¿ã¾ã™ã€‚テストã®çµ±åˆã«é©åˆ‡ãªãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’探ã™ã‹ã€åˆ¥ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã—ã€è¿½åŠ ã¾ãŸã¯ã‚¤ãƒ³ãƒãƒ¼ãƒˆã—ã¾ã™ã€‚æ—¢å˜ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã® 1 ã¤ã‚’ドラフトã¨ã—ã¦ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:13 @@ -810,7 +811,7 @@ msgid ":ref:`Determine if integration tests for the module exist<collection_inte msgstr ":ref:`モジュールã®çµ±åˆãƒ†ã‚¹ãƒˆãŒå˜åœ¨ã™ã‚‹ã‹ã©ã†ã‹ã‚’判別ã—ã¾ã™<collection_integration_prepare>`. å˜åœ¨ã—ãªã„å ´åˆã¯ã€:ref:`collection_creating_integration_tests` セクションをå‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:18 -msgid "Add a task which reproduces the bug to an appropriate file within the ``tests/integration/targets/<target_name>/tasks`` directory." +msgid "Add a task that reproduces the bug to an appropriate file within the ``tests/integration/targets/<target_name>/tasks`` directory." msgstr "``tests/integration/targets/<target_name>/tasks`` ディレクトリー内ã®é©åˆ‡ãªãƒ•ã‚¡ã‚¤ãƒ«ã«ã€ãƒã‚°ã‚’å†ç¾ã™ã‚‹ã‚¿ã‚¹ã‚¯ã‚’è¿½åŠ ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:19 @@ -818,8 +819,8 @@ msgid ":ref:`Run the tests<collection_run_integration_tests>`. The newly added t msgstr ":ref:`テストを実行ã—ã¾ã™<collection_run_integration_tests>`。新ã—ãè¿½åŠ ã•ã‚ŒãŸã‚¿ã‚¹ã‚¯ã¯å¤±æ•—ã™ã‚‹ã¯ãšã§ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:20 -msgid "If they do not fail, re-check if your environment / test task satisfies the conditions described in the ``Steps to Reproduce`` section of the issue." -msgstr "失敗ã—ãªã„å ´åˆã¯ã€ãŠä½¿ã„ã®ç’°å¢ƒ / テストタスクãŒå•é¡Œã® ``å•é¡Œã®å†ç¾æ‰‹é †`` セクションã§èª¬æ˜Žã•ã‚Œã¦ã„ã‚‹æ¡ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’å†ç¢ºèªã—ã¦ãã ã•ã„。" +msgid "If they do not fail, re-check if your environment or test task satisfies the conditions described in the ``Steps to Reproduce`` section of the issue." +msgstr "失敗ã—ãªã„å ´åˆã¯ã€ãŠä½¿ã„ã®ç’°å¢ƒã¾ãŸã¯ãƒ†ã‚¹ãƒˆã‚¿ã‚¹ã‚¯ãŒå•é¡Œã® ``Steps to Reproduce`` セクションã§èª¬æ˜Žã•ã‚Œã¦ã„ã‚‹æ¡ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’å†ç¢ºèªã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:21 msgid "If you reproduce the bug and tests fail, change the code." @@ -876,8 +877,8 @@ msgid "The process described in this section also applies when you want to add i msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã™ã‚‹ãƒ—ãƒã‚»ã‚¹ã¯ã€æ—¢å˜ã®æ©Ÿèƒ½ã«çµ±åˆãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã—ãŸã„ãŒã€çµ±åˆãƒ†ã‚¹ãƒˆãŒãªã„å ´åˆã«ã‚‚é©ç”¨ã•ã‚Œã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:77 -msgid "If you have not already implemented the new feature, you can start with writing the integration tests for it. Of course they will not work as the code does not yet exist, but it can help you improve your implementation design before you start writing any code." -msgstr "æ–°ã—ã„機能をã¾ã 実装ã—ã¦ã„ãªã„å ´åˆã¯ã€ãれ用ã®çµ±åˆãƒ†ã‚¹ãƒˆã‚’作æˆã™ã‚‹ã“ã¨ã‹ã‚‰é–‹å§‹ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚当然ã€ã‚³ãƒ¼ãƒ‰ãŒã¾ã å˜åœ¨ã—ã¦ã„ãªã„ãŸã‚ã€ã“れらã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“ãŒã€ã‚³ãƒ¼ãƒ‰ã‚’書ã始ã‚ã‚‹å‰ã«ã€å®Ÿè£…è¨è¨ˆã‚’改善ã™ã‚‹ä¸Šã§å½¹ç«‹ã¡ã¾ã™ã€‚" +msgid "If you have not already implemented the new feature, you can start by writing the integration tests for it. They will not work as the code does not yet exist, but they can help you improve your implementation design before you start writing any code." +msgstr "æ–°ã—ã„機能をã¾ã 実装ã—ã¦ã„ãªã„å ´åˆã¯ã€ãれ用ã®çµ±åˆãƒ†ã‚¹ãƒˆã‚’作æˆã™ã‚‹ã“ã¨ã‹ã‚‰é–‹å§‹ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚コードãŒã¾ã å˜åœ¨ã—ã¦ã„ãªã„ãŸã‚ã€ã“れらã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“ãŒã€ã‚³ãƒ¼ãƒ‰ã‚’書ã始ã‚ã‚‹å‰ã«ã€å®Ÿè£…è¨è¨ˆã‚’改善ã™ã‚‹ä¸Šã§å½¹ç«‹ã¡ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_integration_updating.rst:79 msgid "When adding new features, the process of adding tests consists of the following steps:" @@ -919,17 +920,17 @@ msgstr "コレクションリãƒã‚¸ãƒˆãƒªãƒ¼ã‚’ ``~/ansible_collections/communit msgid "First, we look at the ``tests/integration/targets/<target_name>/tasks/main.yml`` file. In this particular case, the file imports other files from the ``tasks`` directory. The ``postgresql_user_general.yml`` file looks like an appropriate one to add our tests." msgstr "ã¾ãšã€``tests/integration/targets/<target_name>/tasks/main.yml`` ファイルを見ã¦ã¿ã¾ã—ょã†ã€‚ã“ã®ç‰¹å®šã®ä¾‹ã§ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã¯ ``tasks`` ディレクトリーã‹ã‚‰ä»–ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’インãƒãƒ¼ãƒˆã—ã¾ã™ã€‚``postgresql_user_general.yml`` ファイルã¯ã€ãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã™ã‚‹ã®ã«é©ã—ãŸãƒ•ã‚¡ã‚¤ãƒ«ã®ã‚ˆã†ã§ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_integration_updating.rst:152 +#: ../../rst/community/collection_contributors/collection_integration_updating.rst:150 msgid "Then we :ref:`run the tests<collection_run_integration_tests>` with ``postgresql_user`` passed as a test target." msgstr "次ã«ã€ãƒ†ã‚¹ãƒˆã‚¿ãƒ¼ã‚²ãƒƒãƒˆã¨ã—ã¦æ¸¡ã•ã‚ŒãŸ ``postgresql_user`` 㧠:ref:`テストを実行ã—ã¾ã™<collection_run_integration_tests>`。" -#: ../../rst/community/collection_contributors/collection_integration_updating.rst:154 +#: ../../rst/community/collection_contributors/collection_integration_updating.rst:152 msgid "In reality, we would alternate the tasks above with the same tasks run with the ``check_mode: yes`` option to be sure our option works as expected in check-mode as well. See :ref:`Recommendations on coverage<collection_integration_recommendations>` for details." msgstr "実際ã«ã¯ã€ä¸Šè¨˜ã®ã‚¿ã‚¹ã‚¯ã¨ ``check_mode: yes`` オプションã§å®Ÿè¡Œã™ã‚‹åŒã˜ã‚¿ã‚¹ã‚¯ã‚’交互ã«å®Ÿè¡Œã—ã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã§ã‚‚ã“ã®ã‚ªãƒ—ションãŒæœŸå¾…通りã«å‹•ä½œã™ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚。詳細ã¯ã€:ref:`ã‚«ãƒãƒ¬ãƒ¼ã‚¸ã«é–¢ã™ã‚‹æŽ¨å¥¨äº‹é …<collection_integration_recommendations>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/collection_contributors/collection_integration_updating.rst:156 -msgid "If we expect a task to fail, we use the ``ignore_errors: yes`` option and check that the task actually failed and returned the message we expect:" -msgstr "タスクãŒå¤±æ•—ã™ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹å ´åˆã¯ã€``ignore_errors: yes`` オプションを使用ã—ã¦ã€ã‚¿ã‚¹ã‚¯ãŒå®Ÿéš›ã«å¤±æ•—ã—ã€äºˆæƒ³ã•ã‚Œã‚‹ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’è¿”ã™ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/community/collection_contributors/collection_integration_updating.rst:154 +msgid "If we expect a task to fail, we use the ``ignore_errors: true`` option and check that the task actually failed and returned the message we expect:" +msgstr "タスクãŒå¤±æ•—ã™ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹å ´åˆã¯ã€``ignore_errors: true`` オプションを使用ã—ã¦ã€ã‚¿ã‚¹ã‚¯ãŒå®Ÿéš›ã«å¤±æ•—ã—ã€äºˆæƒ³ã•ã‚Œã‚‹ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’è¿”ã™ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_release_with_branches.rst:4 msgid "Releasing collections with release branches" @@ -961,300 +962,319 @@ msgid "The new version is assumed to be ``X.0.0``." msgstr "æ–°è¦ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ ``X.0.0`` ã§ã‚ã‚‹ã¨æƒ³å®šã•ã‚Œã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_release_with_branches.rst:25 -msgid "If you are going to release the ``community.general`` and ``community.network`` collections, create new ``backport-X`` and ``needs_backport_to_stable_X`` labels in the corresponding repositories. Copy the styles and descriptions from the corresponding existing labels." -msgstr "``community.general`` ãŠã‚ˆã³ ``community.network`` コレクションをリリースã™ã‚‹å ´åˆã¯ã€å¯¾å¿œã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«æ–°ã—ã„ ``backport-X`` ãŠã‚ˆã³ ``needs_backport_to_stable_X`` ラベルを作æˆã—ã¾ã™ã€‚対応ã™ã‚‹æ—¢å˜ãƒ©ãƒ™ãƒ«ã‹ã‚‰ã‚¹ã‚¿ã‚¤ãƒ«ãŠã‚ˆã³èª¬æ˜Žã‚’コピーã—ã¾ã™ã€‚" +msgid "Make sure that ``galaxy.yml`` contains the correct version number ``X.0.0``. If that is not the case, create a PR to update it. This will make sanity tests fail for all deprecations that have to be removed in ``X.0.0``, so this is potentially a lot of work and should have been done weeks before the major release." +msgstr "``galaxy.yml`` ã«ã¯ã€æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· ``X.0.0`` ãŒå«ã¾ã‚Œã‚‹ã‚ˆã†ã«ã—ã¦ãã ã•ã„。æ£ã—ããªã„å ´åˆã«ã¯ã€PR を作æˆã—ã¦æ›´æ–°ã—ã¦ãã ã•ã„。ã“ã‚Œã«ã‚ˆã‚Šã€``X.0.0`` ã§å‰Šé™¤ã™ã‚‹å¿…è¦ã®ã‚ã‚‹éžæŽ¨å¥¨ã‚¢ã‚¤ãƒ†ãƒ ã™ã¹ã¦ã«ãŠã„ã¦ã€ã‚µãƒ‹ãƒ†ã‚£ãƒ¼ãƒ†ã‚¹ãƒˆã§ Fail ã¨ãªã‚Šã¾ã™ã€‚ãã®ãŸã‚ã€ä½œæ¥é‡ãŒå¤šããªã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã€ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã®æ•°é€±é–“å‰ã«å®Ÿè¡Œã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_release_with_branches.rst:27 +msgid "Check the collection for deprecations that are planned for removal in the major release that were not reported by the sanity tests. Use past changelogs or run ``grep -r `X.0.0` plugins/`` in the repository." +msgstr "サニティーテストã§ãƒ¬ãƒãƒ¼ãƒˆã•ã‚Œãšã€ã¾ãŸãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ãŒäºˆå®šã•ã‚Œã¦ã„ã‚‹ã€éžæŽ¨å¥¨ã‚¢ã‚¤ãƒ†ãƒ ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’確èªã—ã¾ã™ã€‚éŽåŽ»ã®å¤‰æ›´ãƒã‚°ã‚’使用ã™ã‚‹ã‹ã€ãƒ¬ãƒã‚¸ãƒˆãƒªãƒ¼ã§ `grep -r `X.0.0` plugins/` を実行ã—ã¾ã™ã€‚" + +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:29 +msgid "If you are going to release the ``community.general`` and ``community.network`` collections, create a new ``backport-X`` label in the corresponding repositories. Copy the styles and descriptions from the corresponding existing labels." +msgstr "``community.general`` ãŠã‚ˆã³ ``community.network`` コレクションをリリースã™ã‚‹å ´åˆã¯ã€å¯¾å¿œã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«æ–°ã—ã„ ``backport-X`` ラベルを作æˆã—ã¾ã™ã€‚対応ã™ã‚‹æ—¢å˜ãƒ©ãƒ™ãƒ«ã‹ã‚‰ã‚¹ã‚¿ã‚¤ãƒ«ãŠã‚ˆã³èª¬æ˜Žã‚’コピーã—ã¾ã™ã€‚" + +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:31 msgid "Ensure you are in a default branch in your local fork. These examples use ``main``." msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒ•ã‚©ãƒ¼ã‚¯ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ–ランãƒã«ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ã“れらã®ä¾‹ã§ã¯ã€``main`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:35 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:39 #: ../../rst/community/collection_contributors/collection_release_without_branches.rst:32 msgid "Update your local fork:" msgstr "ãƒãƒ¼ã‚«ãƒ«ã®ãƒ•ã‚©ãƒ¼ã‚¯ã‚’æ›´æ–°ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:43 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:47 #: ../../rst/community/collection_contributors/collection_release_without_branches.rst:22 msgid "Creating the release branch" msgstr "リリースブランãƒã®ä½œæˆ" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:45 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:49 msgid "Create a branch ``stable-X``. Replace ``X`` with a correct number and push it to the **upstream** repository, NOT to the ``origin``.:" msgstr "ブランム``stable-X`` を作æˆã—ã¾ã™ã€‚``X`` ã‚’æ£ã—ã„番å·ã«ç½®ãæ›ãˆã€``origin`` ã§ã¯ãªã **upstream** リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:53 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:57 msgid "Create and checkout to another branch from the ``main`` branch:" msgstr "``main`` ブランãƒã‹ã‚‰åˆ¥ã®ãƒ–ランãƒã‚’作æˆã—ã€ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:60 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:64 msgid "Update the version in ``galaxy.yml`` in the branch to the next **expected** version, for example, ``X.1.0``." msgstr "ブランãƒã® ``galaxy.yml`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ã€æ¬¡ã« **想定ã•ã‚Œã‚‹** ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«æ›´æ–°ã—ã¾ã™ (例: ``X.1.0``)。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:64 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:144 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:68 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:166 msgid "Creating the changelogs" msgstr "changelog ã®ä½œæˆ" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:66 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:70 msgid "Replace ``changelogs/changelog.yml`` with:" msgstr "``changelogs/changelog.yml`` を以下ã«ç½®ãæ›ãˆã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:74 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:78 msgid "Remove all changelog fragments from ``changelogs/fragments/``. Removing the changelog fragments ensures that every major release has a changelog describing changes since the last major release." msgstr "ã™ã¹ã¦ã® changelog フラグメントを ``changelogs/fragments/`` ã‹ã‚‰å‰Šé™¤ã—ã¾ã™ã€‚changelog フラグメントを削除ã™ã‚‹ã¨ã€ã™ã¹ã¦ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã«ã€æœ€å¾Œã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ä»¥é™ã®å¤‰æ›´ã‚’説明ã™ã‚‹ changelog ãŒç¢ºå®Ÿã«å«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:76 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:80 msgid "Add and commit all the changes made. Push the branch to the ``origin`` repository." msgstr "åŠ ãˆã‚‰ã‚ŒãŸå¤‰æ›´ã‚’ã™ã¹ã¦è¿½åŠ ã—ã€ã‚³ãƒŸãƒƒãƒˆã—ã¾ã™ã€‚ブランãƒã‚’ ``origin`` リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:78 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:82 msgid "Create a pull request in the collection repository. If CI tests pass, merge the pull request since the ``main`` branch is expecting changes for the next minor/major versions" msgstr "コレクションリãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ルè¦æ±‚を作æˆã—ã¾ã™ã€‚CI テストã«åˆæ ¼ã—ãŸå ´åˆã¯ã€``main`` ブランãƒãŒæ¬¡ã®ãƒžã‚¤ãƒŠãƒ¼/メジャーãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®å¤‰æ›´ã‚’想定ã—ã¦ã„ã‚‹ã®ã§ã€ãƒ—ルè¦æ±‚をマージã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:80 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:84 msgid "Switch to the ``stable-X`` branch." msgstr "``stable-X`` ブランãƒã«åˆ‡ã‚Šæ›¿ãˆã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:82 -msgid "In the ``stable-X`` branch, ensure that ``galaxy.yml`` contains the correct version number ``X.0.0``. If not, update it." -msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã«æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· ``X.0.0`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚å«ã¾ã‚Œã¦ã„ãªã„å ´åˆã¯ã€æ›´æ–°ã—ã¾ã™ã€‚" +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:86 +msgid "In the ``stable-X`` branch, verify that ``galaxy.yml`` contains the correct version number ``X.0.0``." +msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã«æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· ``X.0.0`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:84 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:88 +msgid "In the ``stable-X`` branch, ensure that ``changelogs/changelog.yml`` contains a correct ancestor's version:" +msgstr "``stable-X``ブランãƒã§ã€``changelogs/changelog.yml`` ã«æ£ã—ã„祖先ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" + +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:96 msgid "In the ``stable-X`` branch, add a changelog fragment ``changelogs/fragments/X.0.0.yml`` with the content:" msgstr "``stable-X`` ブランãƒã«ã€ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’å«ã‚€ changelog フラグメント ``changelogs/fragments/X.0.0.yml`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:93 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:106 #: ../../rst/community/collection_contributors/collection_release_without_branches.rst:60 -#: ../../rst/community/documentation_contributions.rst:143 -#: ../../rst/community/documentation_contributions.rst:196 +#: ../../rst/community/documentation_contributions.rst:157 +#: ../../rst/community/documentation_contributions.rst:210 msgid "For example:" msgstr "例:" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:100 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:113 msgid "In the ``stable-X`` branch, generate the changelogs:" msgstr "``stable-X`` ブランãƒã§ã€changelog を生æˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:107 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:120 msgid "In the ``stable-X`` branch, verify that the ``CHANGELOG.rst`` looks as expected." msgstr "``stable-X`` ブランãƒã§ã€``CHANGELOG.rst`` ãŒæƒ³å®šé€šã‚Šã«è¡¨ç¤ºã•ã‚Œã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:109 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:122 msgid "In the ``stable-X`` branch, update ``README.md`` so that the changelog link points to ``/tree/stable-X/`` and no longer to ``/tree/main/``, and change badges respectively, for example, in case of AZP, add ``?branchName=stable-X`` to the AZP CI badge (https://dev.azure.com/ansible/community.xxx/_apis/build/status/CI?branchName=stable-X)." msgstr "``stable-X`` ブランãƒã§ã€changelog リンク㌠``/tree/main/`` ã§ã¯ãªã ``/tree/stable-X/`` ã‚’ãƒã‚¤ãƒ³ãƒˆã™ã‚‹ã‚ˆã†ã« ``README.md`` ã‚’æ›´æ–°ã—ã€ãã‚Œãžã‚Œãƒãƒƒã‚¸ã‚’変更ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€AZP ã®å ´åˆã¯ã€AZP CI ãƒãƒƒã‚¸ã« ``?branchName=stable-X`` ã‚’è¿½åŠ ã—ã¾ã™ (https://dev.azure.com/ansible/community.xxx/_apis/build/status/CI?branchName=stable-X)。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:111 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:124 msgid "In the ``stable-X`` branch, add, commit, and push changes to ``README.md``, ``CHANGELOG.rst`` and ``changelogs/changelog.yaml``, and potentially deleted/archived fragments to the **upstream** repository, NOT to the ``origin``." msgstr "``stable-X`` ブランãƒã§ã€``README.md``ã€``CHANGELOG.rst``ã€ãŠã‚ˆã³ ``changelogs/changelog.yaml`` ã«å¤‰æ›´ã‚’è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã€å‰Šé™¤/アーカイブã•ã‚ŒãŸå¯èƒ½æ€§ã®ã‚るフラグメント㯠``origin`` ã§ã¯ãªãã€**アップストリーム** リãƒã‚¸ãƒˆãƒªãƒ¼ã«è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:115 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:171 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:128 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:193 msgid "Publishing the collection" msgstr "コレクションã®å…¬é–‹" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:117 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:130 msgid "In the ``stable-X`` branch, add an annotated tag to the last commit with the collection version ``X.0.0``. Pushing this tag to the ``upstream`` repository will make Zuul publish the collection on `Ansible Galaxy <https://galaxy.ansible.com/>`_." msgstr "``stable-X`` ブランãƒã§ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``X.0.0`` ã§æœ€å¾Œã®ã‚³ãƒŸãƒƒãƒˆã«ã‚¢ãƒŽãƒ†ãƒ¼ã‚·ãƒ§ãƒ³ä»˜ãã‚¿ã‚°ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã®ã‚¿ã‚°ã‚’ ``upstream`` リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã™ã‚‹ã¨ã€Zuul ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ `Ansible Galaxy <https://galaxy.ansible.com/>`_ ã§å…¬é–‹ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:126 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:260 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:313 -#: ../../rst/community/collection_contributors/collection_release_without_branches.rst:107 -msgid "Wait until the new version is published on the collection's `Ansible Galaxy <https://galaxy.ansible.com/>`_ page. It will appear in a list of tarballs available to download." -msgstr "コレクション㮠`Ansible Galaxy <https://galaxy.ansible.com/>`_ ページã§æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒå…¬é–‹ã•ã‚Œã‚‹ã¾ã§å¾…ã¡ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰å¯èƒ½ãª tarball ã®ãƒªã‚¹ãƒˆã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:139 +msgid "If the collection uses `Zuul <https://github.com/ansible/zuul-config/blob/master/README.rst>`_ for publishing its releases, wait until the new version is published on the collection's `Ansible Galaxy <https://galaxy.ansible.com/>`_ page. It will appear in a list of tarballs available to download." +msgstr "コレクション㮠`Zuul <https://github.com/ansible/zuul-config/blob/master/README.rst>`_ を使用ã—ã¦ãã®ãƒªãƒªãƒ¼ã‚¹ã‚’æ›´æ–°ã™ã‚‹å ´åˆã«ã€æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® `Ansible Galaxy <https://galaxy.ansible.com/>`_ ページã«å…¬é–‹ã•ã‚Œã‚‹ã®ã‚’å¾…ã¡ã¾ã™ã€‚ダウンãƒãƒ¼ãƒ‰å¯èƒ½ãª tarball ã®ãƒªã‚¹ãƒˆã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:128 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:184 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:141 +msgid "If the release tarball did not appear within several hours after pushing the tag, try to re-tag the release commit and push the tag again. In the ``stable-X`` branch being at the release commit:" +msgstr "タグをプッシュã—ã¦ã‹ã‚‰æ•°æ™‚間以内ã«ãƒªãƒªãƒ¼ã‚¹ tarball ãŒè¡¨ç¤ºã•ã‚Œãªã‹ã£ãŸå ´åˆã¯ã€ãƒªãƒªãƒ¼ã‚¹ã‚³ãƒŸãƒƒãƒˆã«å†åº¦ã‚¿ã‚°ã‚’付ã‘ã¦ã€ã‚‚ã†ä¸€åº¦ã‚¿ã‚°ã‚’プッシュã—ã¦ã¿ã¦ãã ã•ã„。リリースコミットã®ã‚ã‚‹ ``stable-X`` ブランãƒã§ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:151 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:206 msgid "Add a GitHub release for the new tag. The title should be the version and content, such as - ``See https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst for all changes``." msgstr "æ–°è¦ã‚¿ã‚°ã® GitHub ãƒªãƒªãƒ¼ã‚¹ã‚’è¿½åŠ ã—ã¾ã™ã€‚タイトルã¯ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŠã‚ˆã³ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã«ãªã‚Šã¾ã™ (ãŸã¨ãˆã°ã€``ã™ã¹ã¦ã®å¤‰æ›´ã«ã¤ã„ã¦ã¯ https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst ã‚’å‚ç…§ã—ã¦ãã ã•ã„``)。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:131 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:186 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:270 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:317 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:153 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:208 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:292 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:339 msgid "Announce the release through the `Bullhorn Newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_." msgstr "`Bullhorn ニュースレター <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã§ãƒªãƒªãƒ¼ã‚¹ã‚’公開ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:133 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:155 msgid "Announce the release in the pinned release issue/community pinboard of the collection and in the ``#ansible-community`` `Matrix/Libera.Chat IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_." msgstr "コレクションã®å›ºå®šã•ã‚ŒãŸãƒªãƒªãƒ¼ã‚¹ã® issue/コミュニティーピンボード㨠``#ansible-community`` `Matrix/Libera.Chat IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_ ã§ãƒªãƒªãƒ¼ã‚¹ã‚’発表ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:135 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:157 msgid "In the ``stable-X`` branch, update the version in ``galaxy.yml`` to the next **expected** version, for example, ``X.1.0``. Add, commit and push to the **upstream** repository." msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’次㮠**想定** ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«æ›´æ–°ã—ã¾ã™ (例: ``X.1.0``)。**アップストリーム** リãƒã‚¸ãƒˆãƒªãƒ¼ã«è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:139 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:161 msgid "Releasing minor collection versions" msgstr "マイナーコレクションãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒªãƒªãƒ¼ã‚¹" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:141 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:163 msgid "The new version is assumed to be ``X.Y.0``. All changes that should go into it are expected to be previously backported from the default branch to the ``stable-X`` branch." msgstr "æ–°è¦ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ ``X.Y.0`` ã§ã‚ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚æ–°è¦ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å…¥ã‚Œã‚‰ã‚Œã‚‹ã¹ãã™ã¹ã¦ã®å¤‰æ›´ã¯ã€ä»¥å‰ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãƒ–ランãƒã‹ã‚‰ ``stable-X`` ブランãƒã¸ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:146 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:168 msgid "In the ``stable-X`` branch, make sure that ``galaxy.yml`` contains the correct version number ``X.Y.0``. If not, update it." msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã«æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· ``X.Y.0`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚å«ã¾ã‚Œã¦ã„ãªã„å ´åˆã¯ã€æ›´æ–°ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:148 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:170 msgid "In the ``stable-X`` branch, add a changelog fragment ``changelogs/fragments/X.Y.0.yml`` with content:" msgstr "``stable-X`` ブランãƒã«ã€ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’å«ã‚€ changelog フラグメント ``changelogs/fragments/X.Y.0.yml`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:158 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:180 msgid "In the ``stable-X`` branch, run:" msgstr "``stable-X`` ブランãƒã§ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:165 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:297 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:187 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:319 msgid "In the ``stable-X`` branch, verify that ``CHANGELOG.rst`` looks as expected." msgstr "``stable-X`` ブランãƒã§ã€``CHANGELOG.rst`` ãŒæƒ³å®šé€šã‚Šã«è¡¨ç¤ºã•ã‚Œã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:167 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:299 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:189 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:321 msgid "In the ``stable-X`` branch, add, commit, and push changes to ``CHANGELOG.rst`` and ``changelogs/changelog.yaml``, and potentially deleted/archived fragments to the **upstream** repository, NOT to the origin." msgstr "``stable-X`` ブランãƒã§ã€``CHANGELOG.rst`` ãŠã‚ˆã³ ``changelogs/changelog.yaml`` ã«å¤‰æ›´ã‚’è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã€å‰Šé™¤/アーカイブã•ã‚ŒãŸå¯èƒ½æ€§ã®ã‚るフラグメントã¯ã€å…ƒã®ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã§ã¯ãªãã€**アップストリーム** リãƒã‚¸ãƒˆãƒªãƒ¼ã«è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:173 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:195 msgid "In the ``stable-X`` branch, add an annotated tag to the last commit with the collection version ``X.Y.0``. Pushing this tag to the ``upstream`` repository will make Zuul publish the collection on `Ansible Galaxy <https://galaxy.ansible.com/>`_." msgstr "``stable-X`` ブランãƒã§ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``X.Y.0`` ã§æœ€å¾Œã®ã‚³ãƒŸãƒƒãƒˆã«ã‚¢ãƒŽãƒ†ãƒ¼ã‚·ãƒ§ãƒ³ä»˜ãã‚¿ã‚°ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã®ã‚¿ã‚°ã‚’ ``upstream`` リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã™ã‚‹ã¨ã€Zuul ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ `Ansible Galaxy <https://galaxy.ansible.com/>`_ ã§å…¬é–‹ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:182 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:204 msgid "Wait until the new version is published on the collection's `Ansible Galaxy <https://galaxy.ansible.com/>`_ page. The published version will appear in a list of tarballs available to download." msgstr "コレクション㮠`Ansible Galaxy <https://galaxy.ansible.com/>`_ ページã§æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒå…¬é–‹ã•ã‚Œã‚‹ã¾ã§å¾…ã¡ã¾ã™ã€‚公開ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰å¯èƒ½ãª tarball ã®ãƒªã‚¹ãƒˆã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:188 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:210 msgid "Announce the release in the pinned release issue/community pinboard of the collection and in the ``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_. Additionally, you can announce it using GitHub's Releases system." msgstr "コレクションã®å›ºå®šã•ã‚ŒãŸãƒªãƒªãƒ¼ã‚¹ã® issue/コミュニティーピンボード㨠``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_ ã§ãƒªãƒªãƒ¼ã‚¹ã‚’発表ã—ã¾ã™ã€‚ã•ã‚‰ã«ã€GitHub ã®ãƒªãƒªãƒ¼ã‚¹ã‚·ã‚¹ãƒ†ãƒ を使用ã—ã¦ã€ç™ºè¡¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:190 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:212 msgid "In the ``stable-X`` branch, update the version in ``galaxy.yml`` to the next **expected** version, for example, if you have released ``X.1.0``, the next expected version could be ``X.2.0``. Add, commit and push to the **upstream** repository." msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’次㮠**想定** ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«æ›´æ–°ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``X.1.0`` をリリースã—ã¦ã„ã‚‹å ´åˆã¯ã€æ¬¡ã®æƒ³å®šã•ã‚Œã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ ``X.2.0`` ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚**アップストリーム** リãƒã‚¸ãƒˆãƒªãƒ¼ã«è¿½åŠ ã€ã‚³ãƒŸãƒƒãƒˆã€ãŠã‚ˆã³ãƒ—ッシュã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:192 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:214 msgid "Checkout to the ``main`` branch." msgstr "``main`` ブランãƒã«ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:194 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:216 msgid "In the ``main`` branch:" msgstr "``main`` ブランãƒã§ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:196 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:218 msgid "If more minor versions are released before the next major version, update the version in ``galaxy.yml`` to ``X.(Y+1).0`` as well. Create a dedicated pull request and merge." msgstr "次ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®å‰ã«ã•ã‚‰ã«ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹å ´åˆã¯ã€``galaxy.yml`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ ``X.(Y+1).0`` ã«ã‚‚æ›´æ–°ã—ã¾ã™ã€‚専用ã®ãƒ—ルリクエストを作æˆã—ã¦ãƒžãƒ¼ã‚¸ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:198 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:220 msgid "If the next version will be a new major version, create a pull request where you update the version in ``galaxy.yml`` to ``(X+1).0.0``. Note that the sanity tests will most likely fail since there will be deprecations with removal scheduled for ``(X+1).0.0``, which are flagged by the tests." msgstr "次ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒæ–°ã—ã„メジャーãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ãªã‚‹å ´åˆã¯ã€``galaxy.yml`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ ``(X+1).0.0`` ã«æ›´æ–°ã™ã‚‹ãƒ—ルリクエストを作æˆã—ã¾ã™ã€‚テストã«ã‚ˆã£ã¦ãƒ•ãƒ©ã‚°ãŒä»˜ã‘られã¦ã„ã‚‹ ``(X+1).0.0`` ã®å‰Šé™¤ãŒäºˆå®šã•ã‚Œã¦ã„ã‚‹éžæŽ¨å¥¨äº‹é …ãŒã‚ã‚‹ãŸã‚ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¯å¤±æ•—ã™ã‚‹å¯èƒ½æ€§ãŒé«˜ã„ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:200 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:222 msgid "For every such deprecation, decide:" msgstr "ã“ã®ã‚ˆã†ãªã™ã¹ã¦ã®éžæŽ¨å¥¨ã«ã¤ã„ã¦ã€ä»¥ä¸‹ã‚’決定ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:202 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:224 msgid "Whether to remove them now. For example you remove the complete ``modules/plugins`` or you remove redirects." msgstr "今ã™ãã“れらを削除ã™ã‚‹ã‹ã©ã†ã‹ã€‚ãŸã¨ãˆã°ã€å®Œå…¨ãª ``modules/plugins`` を削除ã™ã‚‹ã‹ã€ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã‚’削除ã™ã‚‹ã‹ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:203 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:225 msgid "Whether to add ignore entries to the corresponding ``tests/sanity/ignore-*.txt`` file and create issues, for example for removed features in ``modules/plugins``." msgstr "ignore エントリーを対応ã™ã‚‹ ``tests/sanity/ignore-*.txt`` ファイルã«è¿½åŠ ã—ã€``modules/plugins`` ã§å‰Šé™¤ã•ã‚ŒãŸæ©Ÿèƒ½ãªã©ã® issue を作æˆã™ã‚‹ã‹ã©ã†ã‹ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:205 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:227 msgid "Once the CI tests pass, merge the pull request. Make sure that this pull request is merged not too much later after the release for ``version_added`` sanity tests not to expect the wrong version for the new feature pull request." msgstr "CI テストã«åˆæ ¼ã—ãŸã‚‰ã€ãƒ—ルリクエストをマージã—ã¾ã™ã€‚ã“ã®ãƒ—ルリクエストã¯ã€æ–°æ©Ÿèƒ½ã®ãƒ—ルリクエストã«å¯¾ã—ã¦é–“é•ã£ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’期待ã—ãªã„よã†ã«ã€``version_added`` サニティーテスト用ã®ãƒªãƒªãƒ¼ã‚¹å¾Œã‚ã¾ã‚Šæ™‚é–“ãŒçµŒãŸãªã„ã†ã¡ã«ãƒžãƒ¼ã‚¸ã•ã‚Œã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:210 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:232 msgid "It makes sense to already do some removals in the days before the release. These removals must happen in the main branch and must not be backported." msgstr "リリースå‰ã®æ•°æ—¥é–“ã«ã™ã§ã«ã„ãã¤ã‹ã®å‰Šé™¤ã‚’è¡Œã†ã“ã¨ã¯ç†ã«ã‹ãªã£ã¦ã„ã¾ã™ã€‚ã“れらã®å‰Šé™¤ã¯ãƒ¡ã‚¤ãƒ³ãƒ–ランãƒã§è¡Œã‚れる必è¦ãŒã‚ã‚Šã€ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã•ã‚Œã¦ã¯ãªã‚Šã¾ã›ã‚“。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:214 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:236 msgid "Releasing patch versions" msgstr "パッãƒãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒªãƒªãƒ¼ã‚¹" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:216 -msgid "The new version is assumed to be ``X.Y.Z``, and the previous patch version is assumed to be ``X.Y.z`` with ``z < Z``. ``z`` is frequently``0`` snce patch releases are uncommon." +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:238 +msgid "The new version is assumed to be ``X.Y.Z``, and the previous patch version is assumed to be ``X.Y.z`` with ``z < Z``. ``z`` is frequently``0`` since patch releases are uncommon." msgstr "æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ ``X.Y.Z`` ã§ã€ä»¥å‰ã®ãƒ‘ッãƒãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ ``z < Z`` ã®ã‚ã‚‹ ``X.Y.z`` ã§ã‚ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚パッãƒãƒªãƒªãƒ¼ã‚¹ãŒä¸€èˆ¬çš„ã§ã¯ã„ã“ã¨ã‹ã‚‰ã€``z`` ã¯ã€å¤šãã®å ´åˆ ``0`` ã§ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:219 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:241 msgid "Releasing when more minor versions are expected" msgstr "è¿½åŠ ã®ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒäºˆæƒ³ã•ã‚Œã‚‹å ´åˆã®ãƒªãƒªãƒ¼ã‚¹" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:221 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:243 msgid "Checkout the ``X.Y.z`` tag." msgstr "``X.Y.z`` ã‚¿ã‚°ã‚’ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:223 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:245 msgid "Update ``galaxy.yml`` so that the version is ``X.Y.Z``. Add and commit." msgstr "ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒ ``X.Y.Z`` ã«ãªã‚‹ã‚ˆã†ã« ``galaxy.yml`` ã‚’æ›´æ–°ã—ã¾ã™ã€‚è¿½åŠ ã—ã¦ã‚³ãƒŸãƒƒãƒˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:225 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:247 msgid "Cherry-pick all changes from ``stable-X`` that were added after ``X.Y.z`` and should go into ``X.Y.Z``." msgstr "``X.Y.z`` ã®å¾Œã«è¿½åŠ ã•ã‚Œã€``X.Y.Z`` ã«ç§»å‹•ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ ``stable-X`` ã‹ã‚‰ã®å¤‰æ›´ã‚’ã™ã¹ã¦å…¥å¿µã«é¸ã³ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:227 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:249 #: ../../rst/community/collection_contributors/collection_release_without_branches.rst:51 msgid "Add a changelog fragment ``changelogs/fragments/X.Y.Z.yml`` with content:" msgstr "以下ã®å†…容をå«ã‚€ changelog フラグメント ``changelogs/fragments/X.Y.Z.yml`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:236 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:258 msgid "Add to git and commit." msgstr "git ãŠã‚ˆã³ commit ã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:238 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:260 msgid "Generate the changelogs." msgstr "changelog を生æˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:244 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:266 msgid "Verify that ``CHANGELOG.rst`` looks as expected." msgstr "``CHANGELOG.rst`` ãŒæƒ³å®šã©ãŠã‚Šã«è¡¨ç¤ºã•ã‚Œã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:246 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:268 msgid "Add and commit changes to ``CHANGELOG.rst`` and ``changelogs/changelog.yaml``, and potentially deleted/archived fragments." msgstr "``CHANGELOG.rst`` ãŠã‚ˆã³ ``changelogs/changelog.yaml``ã€ãã—ã¦å‰Šé™¤/アーカイブã•ã‚ŒãŸå¯èƒ½æ€§ã®ã‚るフラグメントã«ã€å¤‰æ›´ã‚’è¿½åŠ ãŠã‚ˆã³ã‚³ãƒŸãƒƒãƒˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:248 -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:301 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:270 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:323 msgid "**Publishing the collection**" msgstr "**コレクションã®å…¬é–‹**" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:251 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:273 msgid "Add an annotated tag to the last commit with the collection version ``X.Y.Z``. Pushing this tag to the ``upstream`` repository will make Zuul publish the collection on `Ansible Galaxy <https://galaxy.ansible.com/>`_." msgstr "コレクションãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``X.Y.Z`` ã§ã€æœ€å¾Œã®ã‚³ãƒŸãƒƒãƒˆã«ã‚¢ãƒŽãƒ†ãƒ¼ã‚·ãƒ§ãƒ³ä»˜ãã‚¿ã‚°ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã®ã‚¿ã‚°ã‚’ ``upstream`` リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã™ã‚‹ã¨ã€Zuul ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ `Ansible Galaxy <https://galaxy.ansible.com/>`_ ã§å…¬é–‹ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:262 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:282 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:335 +#: ../../rst/community/collection_contributors/collection_release_without_branches.rst:107 +msgid "Wait until the new version is published on the collection's `Ansible Galaxy <https://galaxy.ansible.com/>`_ page. It will appear in a list of tarballs available to download." +msgstr "コレクション㮠`Ansible Galaxy <https://galaxy.ansible.com/>`_ ページã§æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒå…¬é–‹ã•ã‚Œã‚‹ã¾ã§å¾…ã¡ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰å¯èƒ½ãª tarball ã®ãƒªã‚¹ãƒˆã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:284 msgid "Add a GitHub release for the new tag. The title should be the version and content, such as - ``See https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst for all changes``." msgstr "æ–°è¦ã‚¿ã‚°ã® GitHub ãƒªãƒªãƒ¼ã‚¹ã‚’è¿½åŠ ã—ã¾ã™ã€‚タイトルã¯ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŠã‚ˆã³ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã«ãªã‚Šã¾ã™ (ãŸã¨ãˆã°ã€``ã™ã¹ã¦ã®å¤‰æ›´ã«ã¤ã„ã¦ã¯ https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst ã‚’å‚ç…§ã—ã¦ãã ã•ã„``)。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:266 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:288 msgid "The data for this release is only contained in a tag, and not in a branch, in particular not in ``stable-X``. This is deliberate, since the next minor release ``X.(Y+1).0`` already contains the changes for ``X.Y.Z`` as well, since these were cherry-picked from ``stable-X``." msgstr "ã“ã®ãƒªãƒªãƒ¼ã‚¹ã®ãƒ‡ãƒ¼ã‚¿ã¯ã‚¿ã‚°ã«ã®ã¿å«ã¾ã‚Œã€ãƒ–ランãƒã«ã¯å«ã¾ã‚Œã¾ã›ã‚“ (特㫠``stable-X`` ã«ã¯å«ã¾ã‚Œã¾ã›ã‚“)。次ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ ``X.(Y+1).0`` ã«ã¯ ``X.Y.Z`` ã®å¤‰æ›´ã‚‚ã™ã§ã«å«ã¾ã‚Œã¦ã„ã‚‹ãŸã‚ (ã“れら㯠``stable-X`` ã‹ã‚‰å…¥å¿µã«é¸ã°ã‚Œã¦ã„ã‚‹ãŸã‚)ã€ã“ã‚Œã¯æ„図的ãªã‚‚ã®ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:272 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:294 msgid "Announce the release in the pinned release issue/community pinboard of the collection and in the ``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`." msgstr "コレクションã®å›ºå®šã•ã‚ŒãŸãƒªãƒªãƒ¼ã‚¹ã® issue/コミュニティーピンボード㨠``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>` ã§ãƒªãƒªãƒ¼ã‚¹ã‚’発表ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:276 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:298 msgid "Releasing when no more minor versions are expected" msgstr "ã•ã‚‰ãªã‚‹ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒãªã„ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹å ´åˆã®ãƒªãƒªãƒ¼ã‚¹" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:278 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:300 msgid "In the ``stable-X`` branch, make sure that ``galaxy.yml`` contains the correct version number ``X.Y.Z``. If not, update it!" msgstr "``stable-X`` ブランãƒã§ã€``galaxy.yml`` ã«æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· ``X.Y.Z`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚å«ã¾ã‚Œã¦ã„ãªã„å ´åˆã¯ã€æ›´æ–°ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:280 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:302 msgid "In the ``stable-X`` branch, add a changelog fragment ``changelogs/fragments/X.Y.Z.yml`` with content:" msgstr "``stable-X`` ブランãƒã«ã€ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’å«ã‚€ changelog フラグメント ``changelogs/fragments/X.Y.Z.yml`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:290 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:312 msgid "Generate the changelogs in the ``stable-X`` branch." msgstr "``stable-X`` ブランãƒã« changelog を生æˆã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:304 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:326 msgid "In the ``stable-X`` branch, add an annotated tag to the last commit with the collection version ``X.Y.Z``. Pushing this tag to the ``upstream`` repository will make Zuul publish the collection on `Ansible Galaxy <https://galaxy.ansible.com/>`_." msgstr "``stable-X`` ブランãƒã§ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``X.Y.Z`` ã§æœ€å¾Œã®ã‚³ãƒŸãƒƒãƒˆã«ã‚¢ãƒŽãƒ†ãƒ¼ã‚·ãƒ§ãƒ³ä»˜ãã‚¿ã‚°ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã®ã‚¿ã‚°ã‚’ ``upstream`` リãƒã‚¸ãƒˆãƒªãƒ¼ã«ãƒ—ッシュã™ã‚‹ã¨ã€Zuul ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ `Ansible Galaxy <https://galaxy.ansible.com/>`_ ã§å…¬é–‹ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:315 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:337 msgid "Add a GitHub release for the new tag. Title should be the version and content, such as: ``See https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst for all changes``." msgstr "æ–°è¦ã‚¿ã‚°ã® GitHub ãƒªãƒªãƒ¼ã‚¹ã‚’è¿½åŠ ã—ã¾ã™ã€‚タイトルã¯ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŠã‚ˆã³ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã«ãªã‚Šã¾ã™ (ãŸã¨ãˆã°ã€``ã™ã¹ã¦ã®å¤‰æ›´ã«ã¤ã„ã¦ã¯ https://github.com/ansible-collections/community.xxx/blob/stable-X/CHANGELOG.rst ã‚’å‚ç…§ã—ã¦ãã ã•ã„``)。" -#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:319 +#: ../../rst/community/collection_contributors/collection_release_with_branches.rst:341 msgid "Announce the release in the pinned issue/community pinboard of the collection and in the ``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_." msgstr "コレクションã®å›ºå®šã•ã‚ŒãŸãƒªãƒªãƒ¼ã‚¹ã® issue/コミュニティーピンボード㨠``#ansible-community`` `Matrix/IRC channel <https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat>`_ ã§ãƒªãƒªãƒ¼ã‚¹ã‚’発表ã—ã¾ã™ã€‚" @@ -1504,7 +1524,7 @@ msgstr "é‡å¤§ãªå¤‰æ›´ãŒå°Žå…¥ã•ã‚Œã‚‹å ´åˆã¯ã€ãƒªãƒªãƒ¼ã‚¹ãƒ–ランãƒã§ #: ../../rst/community/collection_contributors/collection_releasing.rst:100 msgid "See :ref:`collection_release_with_branches` for details." -msgstr "詳ã—ãã¯ã€:ref:`collection_release_with_branches` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "詳細ã¯ã€:ref:`collection_release_with_branches` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:4 msgid "Review checklist for collection PRs" @@ -1523,7 +1543,7 @@ msgid "When users report bugs, verify the behavior reported. Remember always to msgstr "ユーザーãŒãƒã‚°ã‚’å ±å‘Šã—ãŸã‚‰ã€å ±å‘Šã•ã‚ŒãŸå‹•ä½œã‚’確èªã—ã¦ãã ã•ã„。フィードãƒãƒƒã‚¯ã¯ä¸å¯§ã«è¡Œã£ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:13 -msgid "Did the user made a mistake in the code they put in the Steps to reproduce issue's section? We often see user errors reported as bugs." +msgid "Did the user make a mistake in the code they put in the Steps to Reproduce issue section? We often see user errors reported as bugs." msgstr "issue セクションをå†ç¾ã™ã‚‹ãŸã‚ã®ã‚¹ãƒ†ãƒƒãƒ—ã§ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒå…¥åŠ›ã—ãŸã‚³ãƒ¼ãƒ‰ã«é–“é•ã„ã¯ã‚ã‚Šã¾ã›ã‚“ã‹ã€‚ユーザーãŒã‚¨ãƒ©ãƒ¼ã‚’ãƒã‚°ã¨ã—ã¦å ±å‘Šã™ã‚‹ã“ã¨ã‚‚多ãã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:14 @@ -1535,11 +1555,11 @@ msgid "Is there a minimal reproducer? If not, ask the reporter to reduce the com msgstr "リプãƒãƒ‡ãƒ¥ãƒ¼ã‚µãƒ¼ã¯æœ€å°é™ã§ã™ã‹ã€‚ãã†ã§ãªã„å ´åˆã€å ±å‘Šè€…ã« issue を特定ã™ã‚‹ãŸã‚ã«å˜ç´”化ã™ã‚‹ã‚ˆã†ä¾é ¼ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:16 -msgid "Is the issue a consequence of wrong-configured environment?" -msgstr "ã“ã® issue ã¯ã€èª¤ã£ã¦è¨å®šã•ã‚ŒãŸç’°å¢ƒã®çµæžœã§ã™ã‹ã€‚" +msgid "Is the issue a consequence of a misconfigured environment?" +msgstr "ã“ã®å•é¡Œã¯ã€èª¤ã£ãŸç’°å¢ƒè¨å®šã®çµæžœãªã®ã§ã—ょã†ã‹?" #: ../../rst/community/collection_contributors/collection_reviewing.rst:17 -msgid "If it seems to be real bug, does the behaviour still exist in the most recent release or the development branch?" +msgid "If it seems to be a real bug, does the behaviour still exist in the most recent release or the development branch?" msgstr "実際ã®ãƒã‚°ã¨æ€ã‚ã‚Œã‚‹å ´åˆã€æœ€æ–°ã®ãƒªãƒªãƒ¼ã‚¹ã¾ãŸã¯é–‹ç™ºãƒ–ランãƒã§ã‚‚åŒæ§˜ã®å‹•ä½œãŒè¦‹ã‚‰ã‚Œã¾ã™ã‹ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:18 @@ -1551,11 +1571,11 @@ msgid "Reviewing suggested changes" msgstr "推奨ã•ã‚Œã‚‹å¤‰æ›´ã®ç¢ºèª" #: ../../rst/community/collection_contributors/collection_reviewing.rst:24 -msgid "When reviewing PRs, verify the suggested changes first. Do not:" -msgstr "PR を確èªã™ã‚‹éš›ã«ã¯ã€ã¾ãšæ案ã•ã‚ŒãŸå¤‰æ›´ã‚’検証ã—ã¦ãã ã•ã„。以下ã¯å›žé¿ã—ã¦ãã ã•ã„。" +msgid "When reviewing PRs, verify that the suggested changes do not:" +msgstr "PR を確èªã™ã‚‹ã¨ãã¯ã€æ案ã•ã‚ŒãŸå¤‰æ›´ãŒæ¬¡ã®ã“ã¨ã‚’è¡Œã£ã¦ã„ãªã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:26 -msgid "Unnecessarily break backwards compatibility." +msgid "Unnecessarily break backward compatibility." msgstr "後方互æ›æ€§ã‚’ä¸ç”¨æ„ã«æãªã†ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:27 @@ -1579,7 +1599,7 @@ msgid "Other standards to check for in a PR include:" msgstr "PR ã§ç¢ºèªã™ã‚‹ãã®ä»–ã®åŸºæº–ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:35 -msgid "A pull request MUST NOT contain a mix of bugfixes and new features that are not tightly related. If yes, ask the author to split the pull request into separate PRs." +msgid "A pull request MUST NOT contain a mix of bug fixes and new features that are not tightly related. If yes, ask the author to split the pull request into separate PRs." msgstr "プルè¦æ±‚ã«ã€å¯†æŽ¥ã«é–¢é€£ã—ãªã„ãƒã‚°ä¿®æ£ã¨æ–°æ©Ÿèƒ½ã®çµ„ã¿åˆã‚ã›ã‚’å«ã‚ã¦ã¯ãªã‚Šã¾ã›ã‚“。å«ã¾ã‚Œã‚‹å ´åˆã€ä½œæˆè€…ã«ãƒ—ルè¦æ±‚を別㮠PR ã«åˆ†å‰²ã™ã‚‹ã‚ˆã†ã«ä¾é ¼ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:36 @@ -1623,7 +1643,7 @@ msgid "Modules and plugins from ansible-core use ``ansible.builtin.`` as an FQCN msgstr "言åŠã•ã‚Œã¦ã„ã‚‹å ´åˆã€ansible-core ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŠã‚ˆã³ãƒ—ラグイン㯠``ansible.builtin.`` ã‚’ FQCN プレフィックスã¨ã—ã¦ä½¿ç”¨ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:48 -msgid "When a new option, module, plugin, or return value is added, the corresponding documentation or return sections use ``version_added:`` containing the *collection* version which they will be first released in." +msgid "When a new option, module, plugin, or return value is added, the corresponding documentation or return sections use ``version_added:`` containing the *collection* version in which they will be first released." msgstr "æ–°ã—ã„オプションã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãƒ—ラグインã€ã¾ãŸã¯æˆ»ã‚Šå€¤ãŒè¿½åŠ ã•ã‚Œã‚‹ã¨ã€å¯¾å¿œã™ã‚‹ãƒ‰ã‚ュメントã¾ãŸã¯æˆ»ã‚Šå€¤ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€æœ€åˆã«ãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹ *collection* ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å«ã‚€ ``version_added:`` ãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_reviewing.rst:50 @@ -1679,7 +1699,7 @@ msgid "The pull request does not contain merge commits. See the GitHub warnings msgstr "プルè¦æ±‚ã«ã¯ãƒžãƒ¼ã‚¸ã‚³ãƒŸãƒƒãƒˆãŒå«ã¾ã‚Œã¾ã›ã‚“。プルè¦æ±‚ã®ä¸‹éƒ¨ã«ã‚ã‚‹ GitHub ã®è¦å‘Šã‚’å‚ç…§ã—ã¦ãã ã•ã„。マージコミットãŒå˜åœ¨ã™ã‚‹å ´åˆã¯ã€ä½œæˆè€…ã«ãƒ—ルè¦æ±‚ブランãƒã‚’リベースã™ã‚‹ã‚ˆã†ä¾é ¼ã—ã¦ãã ã•ã„。" #: ../../rst/community/collection_contributors/collection_reviewing.rst:73 -msgid "If the pull request contains breaking changes, ask the author and the collection maintainers if it really is needed, and there is a way not to introduce breaking changes. If breaking changes are present, they MUST only appear in the next major release and MUST NOT appear in a minor or patch release. The only exception is breaking changes caused by security fixes that are absolutely necessary to fix the security issue." +msgid "If the pull request contains breaking changes, ask the author and the collection maintainers if it really is needed, and if there is a way not to introduce breaking changes. If breaking changes are present, they MUST only appear in the next major release and MUST NOT appear in a minor or patch release. The only exception is breaking changes caused by security fixes that are absolutely necessary to fix the security issue." msgstr "プルè¦æ±‚ã«äº’æ›æ€§ã‚’æãªã†å¤‰æ›´ç‚¹ãŒå«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ä½œæˆè€…やコレクションメンテナーã«æœ¬å½“ã«å¿…è¦ãªå¤‰æ›´ã‹ã€äº’æ›æ€§ã‚’æãªã†å¤‰æ›´ã‚’å°Žå…¥ã›ãšã«ã™ã‚€æ–¹æ³•ã¯ãªã„ã‹ç¢ºèªã—ã¦ãã ã•ã„。互æ›æ€§ã‚’æãªã†å¤‰æ›´ãŒå˜åœ¨ã™ã‚‹å ´åˆã¯ã€å¿…ãšæ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã«ã®ã¿è¨˜è¼‰ã—ã€ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ãŸã¯ãƒ‘ッãƒãƒªãƒªãƒ¼ã‚¹ã«ã¯è¨˜è¼‰ã—ãªã„ã§ãã ã•ã„。セã‚ュリティーå•é¡Œã®ä¿®æ£ã«çµ¶å¯¾çš„ã«å¿…è¦ãªã‚»ã‚ュリティー修æ£ãŒåŽŸå› ã®å ´åˆã®ã¿ä¾‹å¤–ã¨ã—ã¾ã™ã€‚" #: ../../rst/community/collection_contributors/collection_test_pr_locally.rst:5 @@ -1973,200 +1993,212 @@ msgid "Creating changelog fragments" msgstr "changelog フラグメントã®ä½œæˆ" #: ../../rst/community/collection_development_process.rst:49 +msgid "Most changelogs should emphasize the impact of the change on the end user of the feature or collection, unless the change impacts developers directly. Consider what the user needs to know about this change and write the changelog to convey that detail." +msgstr "ã»ã¨ã‚“ã©ã®å¤‰æ›´å±¥æ´ã¯ã€ãã®å¤‰æ›´ãŒé–‹ç™ºè€…ã«ç›´æŽ¥å½±éŸ¿ã‚’åŠã¼ã™å ´åˆã‚’除ãã€ãã®æ©Ÿèƒ½ã‚„コレクションã®å¤‰æ›´ãŒã‚¨ãƒ³ãƒ‰ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ä¸Žãˆã‚‹å½±éŸ¿ã‚’強調ã™ã¹ãã§ã™ã€‚ユーザーãŒã“ã®å¤‰æ›´ã«ã¤ã„ã¦ä½•ã‚’知る必è¦ãŒã‚ã‚‹ã®ã‹ã‚’考ãˆã€ãã®è©³ç´°ã‚’ä¼ãˆã‚‹ãŸã‚ã«å¤‰æ›´å±¥æ´ã‚’書ãã¾ã™ã€‚" + +#: ../../rst/community/collection_development_process.rst:51 msgid "Changelogs help users and developers keep up with changes to Ansible collections. Many collections build changelogs for each release from fragments. For collections that use this model, you **must** add a changelog fragment to any PR that changes functionality or fixes a bug." msgstr "changelog ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¨é–‹ç™ºè€…㌠Ansible コレクションã¸ã®å¤‰æ›´ã«å¯¾å¿œã™ã‚‹ä¸Šã§å½¹ã«ç«‹ã¡ã¾ã™ã€‚多ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¯ã€ãƒªãƒªãƒ¼ã‚¹ã”ã¨ã«ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‹ã‚‰ changelog を作æˆã—ã¾ã™ã€‚ã“ã®ãƒ¢ãƒ‡ãƒ«ã‚’使用ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®å ´åˆã¯ã€æ©Ÿèƒ½ã‚’変更ã—ãŸã‚Šã€ãƒã‚°ã‚’ä¿®æ£ã—ãŸã‚Šã™ã‚‹ã™ã¹ã¦ã®ãƒ—ルè¦æ±‚ã« changelog フラグメントを **è¿½åŠ ã™ã‚‹å¿…è¦** ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:51 +#: ../../rst/community/collection_development_process.rst:53 #: ../../rst/community/development_process.rst:151 msgid "You do not need a changelog fragment for PRs that:" msgstr "次ã®ã‚ˆã†ãª PR ã«ã¯ changelog フラグメントã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/community/collection_development_process.rst:53 +#: ../../rst/community/collection_development_process.rst:55 #: ../../rst/community/development_process.rst:153 msgid "add new modules and plugins, because Ansible tooling does that automatically;" msgstr "Ansible ツールã¯è‡ªå‹•çš„ã«å®Ÿè¡Œã•ã‚Œã‚‹ãŸã‚ã€æ–°ã—ã„モジュールãŠã‚ˆã³ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:54 +#: ../../rst/community/collection_development_process.rst:56 #: ../../rst/community/development_process.rst:154 msgid "contain only documentation changes." msgstr "ドã‚ュメントã®å¤‰æ›´ã®ã¿ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:57 +#: ../../rst/community/collection_development_process.rst:59 #: ../../rst/community/development_process.rst:157 msgid "Some collections require a changelog fragment for every pull request. They use the ``trivial:`` section for entries mentioned above that will be skipped when building a release changelog." msgstr "一部ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ãƒ—ルè¦æ±‚ã”ã¨ã« changelog フラグメントãŒå¿…è¦ã§ã™ã€‚上記ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã«ã¤ã„㦠``trivial:`` セクションを使用ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒªãƒªãƒ¼ã‚¹ã®å¤‰æ›´ãƒã‚°ã®æ§‹ç¯‰æ™‚ã«ã‚¹ã‚ップã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:60 +#: ../../rst/community/collection_development_process.rst:62 #: ../../rst/community/development_process.rst:160 msgid "More precisely:" msgstr "具体的ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:62 +#: ../../rst/community/collection_development_process.rst:64 #: ../../rst/community/development_process.rst:162 msgid "Every bugfix PR must have a changelog fragment. The only exception are fixes to a change that has not yet been included in a release." msgstr "ã™ã¹ã¦ã®ãƒã‚°ä¿®æ£ãƒ—ルè¦æ±‚ã«ã¯ changelog フラグメントãŒå¿…è¦ã§ã™ã€‚唯一ã®ä¾‹å¤–ã¯ã€ãƒªãƒªãƒ¼ã‚¹ã«å«ã¾ã‚Œã¦ã„ãªã„変更ã®ä¿®æ£ã§ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:63 +#: ../../rst/community/collection_development_process.rst:65 #: ../../rst/community/development_process.rst:163 msgid "Every feature PR must have a changelog fragment." msgstr "ã™ã¹ã¦ã®æ©Ÿèƒ½ã®ãƒ—ルè¦æ±‚ã«ã¯ changelog フラグメントãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:64 +#: ../../rst/community/collection_development_process.rst:66 #: ../../rst/community/development_process.rst:164 msgid "New modules and plugins (including jinja2 filter and test plugins) must have ``version_added`` entries set correctly in their documentation, and do not need a changelog fragment. The tooling detects new modules and plugins by their ``version_added`` values and announces them in the next release's changelog automatically." msgstr "(jinja2 フィルター㨠test プラグインãªã©) æ–°ã—ã„モジュールãŠã‚ˆã³ãƒ—ラグインã«ã¯ã€ãƒ‰ã‚ュメント㫠``version_added`` エントリーをæ£ã—ãè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€changelog フラグメントã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。ツールã¯ã€æ–°ã—ã„モジュールãŠã‚ˆã³ãƒ—ラグインをãã® ``version_added`` 値ã«ã‚ˆã£ã¦æ¤œå‡ºã—ã€æ¬¡ã®ãƒªãƒªãƒ¼ã‚¹ã® changelog ã§è‡ªå‹•çš„ã«é€šçŸ¥ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:66 +#: ../../rst/community/collection_development_process.rst:68 #: ../../rst/community/development_process.rst:166 msgid "We build short summary changelogs for minor releases as well as for major releases. If you backport a bugfix, include a changelog fragment with the backport PR." msgstr "マイナーリリースã¨ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã®ä¸¡æ–¹ã«ã€çŸã„概è¦ã‚’示ã—㟠changelog を作æˆã—ã¾ã™ã€‚ãƒã‚°ä¿®æ£ã‚’ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã™ã‚‹å ´åˆã«ã¯ã€ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã® PR ã« changelog ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ãã ã•ã„。" -#: ../../rst/community/collection_development_process.rst:71 +#: ../../rst/community/collection_development_process.rst:73 #: ../../rst/community/development_process.rst:171 msgid "Creating a changelog fragment" msgstr "changelog フラグメントã®ä½œæˆ" -#: ../../rst/community/collection_development_process.rst:73 +#: ../../rst/community/collection_development_process.rst:75 #: ../../rst/community/development_process.rst:173 msgid "A basic changelog fragment is a ``.yaml`` or ``.yml`` file placed in the ``changelogs/fragments/`` directory. Each file contains a yaml dict with keys like ``bugfixes`` or ``major_changes`` followed by a list of changelog entries of bugfixes or features. Each changelog entry is rst embedded inside of the yaml file which means that certain constructs would need to be escaped so they can be interpreted by rst and not by yaml (or escaped for both yaml and rst if you prefer). Each PR **must** use a new fragment file rather than adding to an existing one, so we can trace the change back to the PR that introduced it." msgstr "基本的㪠changelog フラグメント㯠``changelogs/fragments/`` ディレクトリーã«ã‚ã‚‹ ``.yaml`` ã¾ãŸã¯ ``.yml`` ファイルã§ã™ã€‚ãã‚Œãžã‚Œã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€``bugfixes``ã€``major_changes`` ãªã©ã®ã‚ーをæŒã¤ yaml ディクショナリーãŒå«ã¾ã‚Œã¦ãŠã‚Šã€ãã®å¾Œã«ãƒã‚°ä¿®æ£ã¾ãŸã¯æ©Ÿèƒ½ã® changelog エントリーã®ä¸€è¦§ãŒç¶šãã¾ã™ã€‚ãã‚Œãžã‚Œã® changelog エントリー㯠yaml ファイルã«çµ„ã¿è¾¼ã¾ã‚Œã¦ã„ã‚‹ rst ã§ã™ã€‚ã¤ã¾ã‚Šã€ç‰¹å®šã®æ§‹æˆã¯ã€yaml ã§ã¯ãªã rst ã§è§£é‡ˆã§ãるよã†ã«ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (yaml 㨠rst ã®ä¸¡æ–¹ã«ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã•ã‚Œã¦ã„ã‚‹ã“ã¨ãŒæœ›ã¾ã—ã„å ´åˆã¯ã€ä¸¡æ–¹ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã—ã¾ã™)。å„プルè¦æ±‚ã¯ã€æ—¢å˜ã®ã‚‚ã®ã«è¿½åŠ ã™ã‚‹ã®ã§ã¯ãªãã€æ–°ã—ã„フラグメントファイルを **使用ã™ã‚‹å¿…è¦** ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€å¤‰æ›´ã‚’åŠ ãˆãŸãƒ—ルè¦æ±‚ã¾ã§ã•ã‹ã®ã¼ã£ã¦ã€å¤‰æ›´ã‚’追跡ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:75 +#: ../../rst/community/collection_development_process.rst:77 msgid "PRs which add a new module or plugin do not necessarily need a changelog fragment. See :ref:`community_changelogs`. Also see :ref:`changelogs_how_to_format` for the precise format changelog fragments should have." msgstr "æ–°ã—ã„モジュールã¾ãŸã¯ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ã‚’è¿½åŠ ã™ã‚‹ãƒ—ルè¦æ±‚ã¯å¿…ãšã—ã‚‚ changelog フラグメントを必è¦ã¨ã—ã¾ã›ã‚“。:ref:`community_changelogs` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ã¾ãŸã€changelog フラグメントã«å¿…è¦ãªæ£ç¢ºãªå½¢å¼ã«ã¤ã„ã¦ã¯ã€:ref:`changelogs_how_to_format` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/collection_development_process.rst:77 +#: ../../rst/community/collection_development_process.rst:79 #: ../../rst/community/development_process.rst:177 msgid "To create a changelog entry, create a new file with a unique name in the ``changelogs/fragments/`` directory of the corresponding repository. The file name should include the PR number and a description of the change. It must end with the file extension ``.yaml`` or ``.yml``. For example: ``40696-user-backup-shadow-file.yaml``" msgstr "changelog エントリーを作æˆã™ã‚‹ã«ã¯ã€å¯¾å¿œã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã® ``changelogs/fragments/`` ディレクトリーã«ä¸€æ„ã®åå‰ã‚’æŒã¤æ–°ã—ã„ファイルを作æˆã—ã¾ã™ã€‚ファイルåã«ã¯ã€PR 番å·ã¨å¤‰æ›´ã®èª¬æ˜Žã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ファイル拡張å ``.yaml`` ã¾ãŸã¯ ``.yml`` ã§çµ‚了ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (例: ``40696-user-backup-shadow-file.yaml``)。" -#: ../../rst/community/collection_development_process.rst:79 +#: ../../rst/community/collection_development_process.rst:81 #: ../../rst/community/development_process.rst:179 msgid "A single changelog fragment may contain multiple sections but most will only contain one section. The toplevel keys (bugfixes, major_changes, and so on) are defined in the `config file <https://github.com/ansible/ansible/blob/devel/changelogs/config.yaml>`_ for our `release note tool <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelogs.rst>`_. Here are the valid sections and a description of each:" msgstr "1 ã¤ã® changelog フラグメントã«ã¯è¤‡æ•°ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ãŒå«ã¾ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ãŒã€ã»ã¨ã‚“ã©ã®å ´åˆã¯ã‚»ã‚¯ã‚·ãƒ§ãƒ³ãŒ 1 ã¤ã—ã‹å«ã¾ã‚Œã¦ã„ã¾ã›ã‚“。最上ä½ã‚ー (bugfixesã€major_changes ãªã©) ã¯ã€`リリースノートツール <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelogs.rst>`_ ã® `è¨å®šãƒ•ã‚¡ã‚¤ãƒ« <https://github.com/ansible/ansible/blob/devel/changelogs/config.yaml>`__ ã§å®šç¾©ã•ã‚Œã¦ã„ã¾ã™ã€‚有効ãªã‚»ã‚¯ã‚·ãƒ§ãƒ³ã¨ãã®èª¬æ˜Žã‚’以下ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:88 +#: ../../rst/community/collection_development_process.rst:90 #: ../../rst/community/development_process.rst:188 msgid "**breaking_changes**" msgstr "**breaking_changes**" -#: ../../rst/community/collection_development_process.rst:82 +#: ../../rst/community/collection_development_process.rst:84 #: ../../rst/community/development_process.rst:182 msgid "MUST include changes that break existing playbooks or roles. This includes any change to existing behavior that forces users to update tasks. Breaking changes means the user MUST make a change when they update. Breaking changes MUST only happen in a major release of the collection. Write in present tense and clearly describe the new behavior that the end user must now follow. Displayed in both the changelogs and the :ref:`Porting Guides <porting_guides>`." msgstr "æ—¢å˜ã® Playbook ã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚’ç ´æã•ã›ã‚‹å¤‰æ›´ã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ã‚¿ã‚¹ã‚¯ã®æ›´æ–°ã‚’強制ã™ã‚‹æ—¢å˜ã®å‹•ä½œã®å¤‰æ›´ãŒã™ã¹ã¦å«ã¾ã‚Œã¾ã™ã€‚互æ›æ€§ã‚’失ã‚ã›ã‚‹å¤‰æ›´ã¨ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæ›´æ–°æ™‚ã«å¤‰æ›´ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚互æ›æ€§ã‚’失ã‚ã›ã‚‹å¤‰æ›´ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã§ã®ã¿å®Ÿè¡Œã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ç¾åœ¨å½¢ã§æ›¸ãã€ã‚¨ãƒ³ãƒ‰ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒå¾“ã‚ãªã‘ã‚Œã°ãªã‚‰ãªããªã£ãŸæ–°ã—ã„動作ã«ã¤ã„ã¦æ˜Žç¢ºã«è¨˜è¿°ã—ã¦ãã ã•ã„。changelog 㨠:ref:`移æ¤ã‚¬ã‚¤ãƒ‰ <porting_guides>` ã®ä¸¡æ–¹ã«è¡¨ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:96 +#: ../../rst/community/collection_development_process.rst:98 #: ../../rst/community/development_process.rst:196 msgid "**major_changes**" msgstr "**major_changes**" -#: ../../rst/community/collection_development_process.rst:91 +#: ../../rst/community/collection_development_process.rst:93 #: ../../rst/community/development_process.rst:191 msgid "Major changes to ansible-core or a collection. SHOULD NOT include individual module or plugin changes. MUST include non-breaking changes that impact all or most of a collection (for example, updates to support a new SDK version across the collection). Major changes mean the user can CHOOSE to make a change when they update but do not have to. Could be used to announce an important upcoming EOL or breaking change in a future release. (ideally 6 months in advance, if known. See `this example <https://github.com/ansible-collections/community.general/blob/stable-1/CHANGELOG.rst#v1313>`_). Write in present tense and describe what is new. Optionally, include a 'Previously...\" sentence to help the user identify where old behavior should now change. Displayed in both the changelogs and the :ref:`Porting Guides <porting_guides>`." msgstr "ansible-core ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¸ã®ä¸»ãªå¤‰æ›´ç‚¹ã€‚個別ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„プラグインã®å¤‰æ›´ã‚’å«ã‚ãªã„ã§ãã ã•ã„。コレクションã™ã¹ã¦ã¾ãŸã¯å¤§åŠã«å½±éŸ¿ã™ã‚‹ä¸æ–ãªã—ã®å¤‰æ›´ (ãŸã¨ãˆã°ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å…¨ä½“ã§æ–°ã—ã„ SDK ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’サãƒãƒ¼ãƒˆã™ã‚‹æ›´æ–°ãªã©) ã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚主ãªå¤‰æ›´ç‚¹ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæ›´æ–°æ™‚ã«å¤‰æ›´ã‚’è¡Œã†ã“ã¨ã‚’é¸æŠžã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ãŒã€å¿…ãšã—も変更ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。é‡è¦ãªä»Šå¾Œã® EOL ã¾ãŸã¯å°†æ¥ã®ãƒªãƒªãƒ¼ã‚¹ã§ã®é‡å¤§ãªå¤‰æ›´ã‚’発表ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ (ã‚ã‹ã£ã¦ã„ã‚‹å ´åˆã¯ã€ç†æƒ³çš„ã«ã¯ 6 カ月å‰ã€‚`ã“ã¡ã‚‰ã®ä¾‹ <https://github.com/ansible-collections/community.general/blob/stable-1/CHANGELOG.rst#v1313>`_ ã‚’å‚ç…§)。ç¾åœ¨å½¢ã§æ›¸ãã€æ–°æ©Ÿèƒ½ã«ã¤ã„ã¦èª¬æ˜Žã—ã¦ãã ã•ã„。オプションã§ã€ã€Œä»¥å‰ã®....ã€ã¨ã„ã†æ–‡ã‚’å«ã‚ã¦ã€å¤ã„動作を変更ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´æ‰€ã‚’ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒç‰¹å®šã§ãるよã†ã«ã—ã¾ã™ã€‚changelog 㨠:ref:`移æ¤ã‚¬ã‚¤ãƒ‰ <porting_guides>` ã®ä¸¡æ–¹ã«è¡¨ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:105 +#: ../../rst/community/collection_development_process.rst:107 #: ../../rst/community/development_process.rst:205 msgid "**minor_changes**" msgstr "**minor_changes**" -#: ../../rst/community/collection_development_process.rst:99 +#: ../../rst/community/collection_development_process.rst:101 msgid "Minor changes to ansible-core, modules, or plugins. This includes new parameters added to modules, or non-breaking behavior changes to existing parameters, such as adding new values to choices[]. Minor changes are enhancements, not bug fixes. Write in present tense." msgstr "ansible-coreã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ã¾ãŸã¯ãƒ—ラグインã¸ã®ãƒžã‚¤ãƒŠãƒ¼ãªå¤‰æ›´ã€‚ã“ã‚Œã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«è¿½åŠ ã•ã‚ŒãŸæ–°ã—ã„パラメーターやã€choices[] ã«æ–°ã—ã„å€¤ã‚’è¿½åŠ ã™ã‚‹ãªã©ã€æ—¢å˜ã®ãƒ‘ラメーターã«å¯¾ã™ã‚‹ä¸æ–ã®ãªã„動作ã®å¤‰æ›´ãŒå«ã¾ã‚Œã¾ã™ã€‚マイナーãªå¤‰æ›´ã¯æ©Ÿèƒ½æ‹¡å¼µã§ã‚ã‚Šã€ãƒã‚°ä¿®æ£ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ç¾åœ¨å½¢ã§æ›¸ã„ã¦ãã ã•ã„。" -#: ../../rst/community/collection_development_process.rst:114 +#: ../../rst/community/collection_development_process.rst:116 #: ../../rst/community/development_process.rst:214 msgid "**deprecated_features**" msgstr "**deprecated_features**" -#: ../../rst/community/collection_development_process.rst:108 +#: ../../rst/community/collection_development_process.rst:110 msgid "Features that have been deprecated and are scheduled for removal in a future release. Write in past tense. Include an alternative, where available, for the feature being deprecated. Displayed in both the changelogs and the :ref:`Porting Guides <porting_guides>`." msgstr "éžæŽ¨å¥¨ã¨ãªã‚Šã€ä»Šå¾Œã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã®æ©Ÿèƒ½ã€‚éŽåŽ»å½¢ã§æ›¸ã„ã¦ãã ã•ã„。å¯èƒ½ãªå ´åˆã¯ã€éžæŽ¨å¥¨ã¨ãªã£ãŸæ©Ÿèƒ½ã®ä»£æ›¿æ©Ÿèƒ½ã‚’è¿½åŠ ã—ã¦ãã ã•ã„。changelog 㨠:ref:`移æ¤ã‚¬ã‚¤ãƒ‰ <porting_guides>` ã®ä¸¡æ–¹ã«è¡¨ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:123 +#: ../../rst/community/collection_development_process.rst:125 #: ../../rst/community/development_process.rst:223 msgid "**removed_features**" msgstr "**removed_features**" -#: ../../rst/community/collection_development_process.rst:117 +#: ../../rst/community/collection_development_process.rst:119 msgid "Features that were previously deprecated and are now removed. Write in past tense. Include an alternative, where available, for the feature being deprecated. Displayed in both the changelogs and the :ref:`Porting Guides <porting_guides>`." msgstr "以å‰ã«éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾åœ¨ã¯å‰Šé™¤ã•ã‚ŒãŸæ©Ÿèƒ½ã€‚éŽåŽ»å½¢ã§æ›¸ã„ã¦ãã ã•ã„。å¯èƒ½ãªå ´åˆã¯ã€éžæŽ¨å¥¨ã¨ãªã£ãŸæ©Ÿèƒ½ã®ä»£æ›¿æ©Ÿèƒ½ã‚’è¿½åŠ ã—ã¦ãã ã•ã„。changelog 㨠:ref:`移æ¤ã‚¬ã‚¤ãƒ‰ <porting_guides>` ã®ä¸¡æ–¹ã«è¡¨ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:132 +#: ../../rst/community/collection_development_process.rst:134 #: ../../rst/community/development_process.rst:232 msgid "**security_fixes**" msgstr "**security_fixes**" -#: ../../rst/community/collection_development_process.rst:126 +#: ../../rst/community/collection_development_process.rst:128 msgid "Fixes that address CVEs or resolve security concerns. MUST use security_fixes for any CVEs. Write in present tense. Include links to CVE information." msgstr "CVE ã«å¯¾å‡¦ã™ã‚‹ã‹ã€ã‚»ã‚ュリティー上ã®æ‡¸å¿µã‚’解決ã™ã‚‹ä¿®æ£ã€‚CVE ã«ã¯ security_fixes を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ç¾åœ¨å½¢ã§æ›¸ã„ã¦ãã ã•ã„。CVE æƒ…å ±ã¸ã®ãƒªãƒ³ã‚¯ã‚’å«ã‚ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:141 +#: ../../rst/community/collection_development_process.rst:143 #: ../../rst/community/development_process.rst:241 msgid "**bugfixes**" msgstr "**bugfixes**" -#: ../../rst/community/collection_development_process.rst:135 +#: ../../rst/community/collection_development_process.rst:137 msgid "Fixes that resolve issues. SHOULD NOT be used for minor enhancements (use ``minor_change`` instead). Write in past tense to describe the problem and present tense to describe the fix." msgstr "issue を解決ã™ã‚‹ãŸã‚ã®ä¿®æ£ã§ã™ã€‚マイナーãªæ©Ÿèƒ½å¼·åŒ–ã«ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„ (代ã‚ã‚Šã« ``minor_change`` を使用)。å•é¡Œã®èª¬æ˜Žã¯éŽåŽ»å½¢ã§ã€ä¿®æ£ã®èª¬æ˜Žã¯ç¾åœ¨å½¢ã§æ›¸ã„ã¦ãã ã•ã„。" -#: ../../rst/community/collection_development_process.rst:151 +#: ../../rst/community/collection_development_process.rst:152 #: ../../rst/community/development_process.rst:250 msgid "**known_issues**" msgstr "**known_issues**" -#: ../../rst/community/collection_development_process.rst:144 +#: ../../rst/community/collection_development_process.rst:146 msgid "Known issues that are currently not fixed or will not be fixed. Write in present tense to describe the problem and in imperative tense to describe any available workaround." msgstr "ç¾åœ¨ä¿®æ£ã•ã‚Œã¦ã„ãªã„ã€ã¾ãŸã¯ä¿®æ£ã•ã‚Œã‚‹äºˆå®šã®ãªã„既知ã®å•é¡Œã€‚å•é¡Œã®èª¬æ˜Žã¯ç¾åœ¨å½¢ã§ã€åˆ©ç”¨å¯èƒ½ãªå›žé¿ç–ã®èª¬æ˜Žã¯å‘½ä»¤å½¢ã§æ›¸ã„ã¦ãã ã•ã„。" -#: ../../rst/community/collection_development_process.rst:153 +#: ../../rst/community/collection_development_process.rst:162 +msgid "**trivial**" +msgstr "**trivial**" + +#: ../../rst/community/collection_development_process.rst:155 +msgid "Changes where a formal release changelog entry isn't required. ``trivial`` changelog fragments are excluded from the published changelog output and may be used for changes such as housekeeping, documentation and test only changes. You can use ``trivial`` for collections that require a changelog fragment for each pull request." +msgstr "æ£å¼ãªãƒªãƒªãƒ¼ã‚¹ã®å¤‰æ›´ãƒã‚°ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ãŒä¸è¦ãªå¤‰æ›´ã€‚``trivial`` ã®å¤‰æ›´ãƒã‚°ã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã¯ã€å…¬é–‹ã•ã‚Œã‚‹å¤‰æ›´ãƒã‚°ã®å‡ºåŠ›ã‹ã‚‰é™¤å¤–ã•ã‚Œã€ãƒã‚¦ã‚¹ã‚ーピングã€ãƒ‰ã‚ュメントã€ãƒ†ã‚¹ãƒˆã®ã¿ã®å¤‰æ›´ãªã©ã®å¤‰æ›´ã«ä½¿ç”¨ã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚プルリクエストã”ã¨ã«å¤‰æ›´ãƒã‚°ã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆãŒå¿…è¦ãªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã« ``trivial`` を使用ã§ãã¾ã™ã€‚" + +#: ../../rst/community/collection_development_process.rst:164 #: ../../rst/community/development_process.rst:252 msgid "Each changelog entry must contain a link to its issue between parentheses at the end. If there is no corresponding issue, the entry must contain a link to the PR itself." msgstr "å„ changelog エントリーã«ã¯ã€æœ€å¾Œã«æ‹¬å¼§å†…ã«ã€ãã® issue ã¸ã®ãƒªãƒ³ã‚¯ãŒå«ã¾ã‚Œã¦ã„ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。対応ã™ã‚‹ issue ãŒãªã„å ´åˆã¯ã€ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã«ãƒ—ルè¦æ±‚自体ã¸ã®ãƒªãƒ³ã‚¯ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:155 -msgid "Most changelog entries are ``bugfixes`` or ``minor_changes``. You can also use ``trivial`` for any collection that requires a changelog fragment for each pull request. ``trivial`` changelog fragments are excluded from the changelog output." -msgstr "ã»ã¨ã‚“ã©ã® changelog エントリーã¯ã€``bugfixes`` ã¾ãŸã¯ ``minor_changes`` ã§ã™ã€‚プルè¦æ±‚ã”ã¨ã« changelog フラグメントを必è¦ã¨ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã« ``trivial`` を使用ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚``trivial`` changelog フラグメント㯠changelog 出力ã‹ã‚‰é™¤å¤–ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/community/collection_development_process.rst:166 +msgid "Most changelog entries are ``bugfixes`` or ``minor_changes``." +msgstr "ã»ã¨ã‚“ã©ã® changelog エントリーã¯ã€``bugfixes`` ã¾ãŸã¯ ``minor_changes`` ã§ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:159 +#: ../../rst/community/collection_development_process.rst:170 #: ../../rst/community/development_process.rst:261 msgid "Changelog fragment entry format" msgstr "changelog フラグメントã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼å½¢å¼" -#: ../../rst/community/collection_development_process.rst:161 +#: ../../rst/community/collection_development_process.rst:172 #: ../../rst/community/development_process.rst:263 msgid "When writing a changelog entry, use the following format:" msgstr "changelog エントリーを作æˆã™ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®å½¢å¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:167 +#: ../../rst/community/collection_development_process.rst:178 #: ../../rst/community/development_process.rst:269 msgid "The scope is usually a module or plugin name or group of modules or plugins, for example, ``lookup plugins``. While module names can (and should) be mentioned directly (``foo_module``), plugin names should always be followed by the type (``foo inventory plugin``)." msgstr "範囲ã¯é€šå¸¸ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã®åå‰ã€ã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã®ã‚°ãƒ«ãƒ¼ãƒ—ã§ã™ (例: ``lookup plugins``)。モジュールåã¯ç›´æŽ¥è¨€åŠã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ (ãã—ã¦è¨€åŠã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™) (``foo_module``) ãŒã€ãƒ—ラグインåã®å¾Œã«ã¯å¸¸ã«ã‚¿ã‚¤ãƒ—ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (``foo inventory plugin``)。" -#: ../../rst/community/collection_development_process.rst:169 +#: ../../rst/community/collection_development_process.rst:180 #: ../../rst/community/development_process.rst:271 msgid "For changes that are not really scoped (for example, which affect a whole collection), use the following format:" msgstr "スコープ指定ãƒãƒ¼ãƒ«ãŒãªã„変更 (コレクション全体ã«å½±éŸ¿ã™ã‚‹ãªã©) ã«ã¤ã„ã¦ã¯ã€ä»¥ä¸‹ã®å½¢å¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:176 +#: ../../rst/community/collection_development_process.rst:187 #: ../../rst/community/development_process.rst:278 msgid "Here are some examples:" msgstr "以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:196 +#: ../../rst/community/collection_development_process.rst:207 msgid "You can find more example changelog fragments in the `changelog directory <https://github.com/ansible-collections/community.general/tree/main/changelogs/fragments>`_ for the community.general development branch." msgstr "changelog フラグメントã®ã•ã‚‰ãªã‚‹ä¾‹ã¯ã€community.general 開発ブランãƒã® `changelog ディレクトリー <https://github.com/ansible-collections/community.general/tree/main/changelogs/fragments>`_ ã«ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:198 +#: ../../rst/community/collection_development_process.rst:209 #: ../../rst/community/development_process.rst:300 msgid "After you have written the changelog fragment for your PR, commit the file and include it with the pull request." msgstr "プルè¦æ±‚用㫠changelog フラグメントを作æˆã—ãŸã‚‰ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚’コミットã—ã€ãƒ—ルè¦æ±‚ã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/collection_development_process.rst:202 +#: ../../rst/community/collection_development_process.rst:213 msgid "Changelog fragment entry format for new jinja2 plugins, roles, and playbooks" msgstr "æ–°ã—ã„ jinja2 プラグインã€ãƒãƒ¼ãƒ«ã€ãŠã‚ˆã³ Playbook ã®å¤‰æ›´ãƒã‚° フラグメントエントリーã®å½¢å¼" -#: ../../rst/community/collection_development_process.rst:204 +#: ../../rst/community/collection_development_process.rst:215 msgid "While new modules and plugins that are not jinja2 filter or test plugins are mentioned automatically in the generated changelog, jinja2 filter and test plugins, roles, and playbooks are not. To make sure they are mentioned, a changelog fragment in a specific format is needed:" msgstr "生æˆã•ã‚ŒãŸ changelog ã«ã¯ã€jinja2 フィルターã¾ãŸã¯ãƒ†ã‚¹ãƒˆãƒ—ラグインã§ã¯ãªã„æ–°ã—ã„モジュールã¨ãƒ—ラグインãŒè‡ªå‹•çš„ã«è¨˜è¼‰ã•ã‚Œã¾ã™ãŒã€jinja2 フィルターã¨ãƒ†ã‚¹ãƒˆãƒ—ラグインã€ãƒãƒ¼ãƒ«ã€ãŠã‚ˆã³ Playbook ã¯è¨˜è¼‰ã•ã‚Œã¾ã›ã‚“。ãれらãŒç¢ºå®Ÿã«è¨€åŠã•ã‚Œã‚‹ã‚ˆã†ã«ã™ã‚‹ã«ã¯ã€ç‰¹å®šã®å½¢å¼ã® changelog フラグメントãŒå¿…è¦ã§ã™ã€‚" @@ -2383,355 +2415,371 @@ msgid "`Ansible Development List <https://groups.google.com/forum/#!forum/ansibl msgstr "`Ansible Development リスト <https://groups.google.com/forum/#!forum/ansible-devel>`_ã¯ã€Ansibleモジュールã®é–‹ç™ºï¼ˆä¸»ã«Python）ã€Ansibleコアコードã®ãƒã‚°ã®ä¿®æ£ã€å°†æ¥ã®æ©Ÿèƒ½è¨è¨ˆã«ã¤ã„ã¦ã®è³ªå•ã€ã¾ãŸã¯Ansibleã®æ©Ÿèƒ½æ‹¡å¼µã¾ãŸã¯é€²è¡Œä¸ã®æ©Ÿèƒ½ã¤ã„ã¦ã®è°è«–用ã§ã™ã€‚" #: ../../rst/community/communication.rst:25 -msgid "`Ansible Lockdown List <https://groups.google.com/forum/#!forum/ansible-lockdown>`_ is for all things related to Ansible Lockdown projects, including DISA STIG automation and CIS Benchmarks." -msgstr "`Ansible Lockdown リスト <https://groups.google.com/forum/#!forum/ansible-lockdown>`_ ã¯ã€DISA STIG オートメーションや CIS ベンãƒãƒžãƒ¼ã‚¯ãªã©ã€Ansible Lockdown プãƒã‚¸ã‚§ã‚¯ãƒˆã«é–¢é€£ã™ã‚‹ã‚‚ã®ã‚’対象ã¨ã—ã¦ã„ã¾ã™ã€‚" +msgid "`Ansible Outreach List <https://groups.google.com/forum/#!forum/ansible-outreach>`_ help with promoting Ansible and `Ansible Meetups <https://www.meetup.com/topics/ansible/>`_" +msgstr "`Ansible Outreach List <https://groups.google.com/forum/#!forum/ansible-outreach>`_ ã¯ã€Ansible ãŠã‚ˆã³ `Ansible Meetups <https://www.meetup.com/topics/ansible/>`_ ã®ãƒ—ãƒãƒ¢ãƒ¼ã‚·ãƒ§ãƒ³ã‚’支æ´ã—ã¾ã™ã€‚" #: ../../rst/community/communication.rst:26 -msgid "`Ansible Outreach List <https://groups.google.com/forum/#!forum/ansible-outreach>`_ help with promoting Ansible and `Ansible Meetups <https://ansible.meetup.com/>`_" -msgstr "`Ansible Outreach リスト <https://groups.google.com/forum/#!forum/ansible-outreach>`_ ã¯ã€Ansible ãŠã‚ˆã³ `Ansible Meetups <https://ansible.meetup.com/>`_ ã®ãƒ—ãƒãƒ¢ãƒ¼ã‚·ãƒ§ãƒ³ã‚’支æ´ã—ã¾ã™ã€‚" - -#: ../../rst/community/communication.rst:27 msgid "`Ansible Project List <https://groups.google.com/forum/#!forum/ansible-project>`_ is for sharing Ansible tips, answering questions about playbooks and roles, and general user discussion." msgstr "`Ansible Project リスト <https://groups.google.com/forum/#!forum/ansible-project>`_ ã¯ã€Ansible ã®ãƒ’ントを共有ã—ãŸã‚Šã€Playbookã‚„ãƒãƒ¼ãƒ«ã«é–¢ã™ã‚‹è³ªå•ã«ç”ãˆãŸã‚Šã€ä¸€èˆ¬çš„ãªãƒ¦ãƒ¼ã‚¶ãƒ¼ãƒ‡ã‚£ã‚¹ã‚«ãƒƒã‚·ãƒ§ãƒ³ã‚’è¡Œã†ãŸã‚ã®ã‚‚ã®ã§ã™ã€‚" -#: ../../rst/community/communication.rst:28 +#: ../../rst/community/communication.rst:27 msgid "`Molecule Discussions <https://github.com/ansible-community/molecule/discussions>`_ is designed to aid with the development and testing of Ansible roles with Molecule." msgstr "`Molecule Discussions <https://github.com/ansible-community/molecule/discussions>`_ ã¯ã€Molecule を使用ã—㟠Ansible ãƒãƒ¼ãƒ«ã®é–‹ç™ºã¨ãƒ†ã‚¹ãƒˆã‚’支æ´ã™ã‚‹ãŸã‚ã®ã‚‚ã®ã§ã™ã€‚" -#: ../../rst/community/communication.rst:30 +#: ../../rst/community/communication.rst:29 msgid "The Ansible mailing lists are hosted on Google, but you do not need a Google account to subscribe. To subscribe to a group from a non-Google account, send an email to the subscription address requesting the subscription. For example: ``ansible-devel+subscribe@googlegroups.com``." msgstr "Ansibleメーリングリストã¯Googleã§ãƒ›ã‚¹ãƒˆã•ã‚Œã¦ã„ã¾ã™ãŒã€ã‚µãƒ–スクライブã™ã‚‹ãŸã‚ã«Googleアカウントã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。 Google 以外ã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‹ã‚‰ã‚°ãƒ«ãƒ¼ãƒ—をサブスクライブã™ã‚‹ã«ã¯ã€ã‚µãƒ–スクリプションをä¾é ¼ã™ã‚‹ãƒ¡ãƒ¼ãƒ«ã‚’サブスクリプションã®ã‚¢ãƒ‰ãƒ¬ã‚¹ (例: ``ansible-devel+subscribe@googlegroups.com``) ã«é€ä¿¡ã—ã¾ã™ã€‚" -#: ../../rst/community/communication.rst:35 +#: ../../rst/community/communication.rst:34 msgid "Real-time chat" msgstr "リアルタイムãƒãƒ£ãƒƒãƒˆ" -#: ../../rst/community/communication.rst:37 +#: ../../rst/community/communication.rst:36 msgid "For real-time interactions, conversations in the Ansible community happen over two chat protocols: Matrix and IRC. We maintain a bridge between Matrix and IRC, so you can choose whichever protocol you prefer. All channels exist in both places. Join a channel any time to ask questions, participate in a Working Group meeting, or just say hello." msgstr "リアルタイムã®å¯¾è©±ã®å ´åˆã€Ansibleコミュニティã§ã®ä¼šè©±ã¯ã€Matrixã¨IRCã®2ã¤ã®ãƒãƒ£ãƒƒãƒˆãƒ—ãƒãƒˆã‚³ãƒ«ã‚’介ã—ã¦è¡Œã‚ã‚Œã¾ã™ã€‚ Matrixã¨IRCã®é–“ã®ãƒ–リッジをç¶æŒã—ã¦ã„ã‚‹ãŸã‚ã€ãŠå¥½ã¿ã®ãƒ—ãƒãƒˆã‚³ãƒ«ã‚’é¸æŠžã§ãã¾ã™ã€‚ã™ã¹ã¦ã®ãƒãƒ£ãƒ³ãƒãƒ«ã¯ä¸¡æ–¹ã®å ´æ‰€ã«å˜åœ¨ã—ã¾ã™ã€‚ã„ã¤ã§ã‚‚ãƒãƒ£ãƒ³ãƒãƒ«ã«å‚åŠ ã—ã¦ã€è³ªå•ã—ãŸã‚Šã€ãƒ¯ãƒ¼ã‚ンググループã®ä¼šè°ã«å‚åŠ ã—ãŸã‚Šã€æŒ¨æ‹¶ã—ãŸã‚Šã§ãã¾ã™ã€‚" -#: ../../rst/community/communication.rst:40 +#: ../../rst/community/communication.rst:39 msgid "Ansible community on Matrix" msgstr "Matrix上ã®Ansibleコミュニティ" -#: ../../rst/community/communication.rst:42 +#: ../../rst/community/communication.rst:41 msgid "To join the community using Matrix, you need two things:" msgstr "Matrixを使用ã—ã¦ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ã«å‚åŠ ã™ã‚‹ã«ã¯ã€æ¬¡ã®2ã¤ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/community/communication.rst:44 +#: ../../rst/community/communication.rst:43 msgid "a Matrix account (from `Matrix.org <https://app.element.io/#/register>`_ or any other Matrix homeserver)" msgstr "マトリックスアカウント（`Matrix.org <https://app.element.io/#/register>`_ã¾ãŸã¯ãã®ä»–ã®Matrixホームサーãƒãƒ¼ã‹ã‚‰ï¼‰" -#: ../../rst/community/communication.rst:45 +#: ../../rst/community/communication.rst:44 msgid "a `Matrix client <https://matrix.org/clients/>`_ (we recommend `Element Webchat <https://app.element.io>`_)" msgstr "`Matrix client <https://matrix.org/clients/>`_ (`Element Webchat <https://app.element.io>`_を推奨ã—ã¾ã™)" -#: ../../rst/community/communication.rst:47 +#: ../../rst/community/communication.rst:46 msgid "The Ansible community maintains its own Matrix homeserver at ``ansible.im``, however public registration is currently unavailable." msgstr "Ansibleコミュニティã¯ã€``ansible.im``ã§ç‹¬è‡ªã®Matrixホームサーãƒãƒ¼ã‚’ç¶æŒã—ã¦ã„ã¾ã™ã€‚ãŸã ã—ã€ç¾åœ¨ã€å…¬é–‹ç™»éŒ²ã¯åˆ©ç”¨ã§ãã¾ã›ã‚“。" -#: ../../rst/community/communication.rst:49 +#: ../../rst/community/communication.rst:48 msgid "Matrix chat supports:" msgstr "Matrixãƒãƒ£ãƒƒãƒˆã¯ä»¥ä¸‹ã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ï¼š" -#: ../../rst/community/communication.rst:51 +#: ../../rst/community/communication.rst:50 msgid "persistence (when you log on, you see all messages since you last logged off)" msgstr "永続性（ãƒã‚°ã‚ªãƒ³ã™ã‚‹ã¨ã€æœ€å¾Œã«ãƒã‚°ã‚ªãƒ•ã—ã¦ã‹ã‚‰ã®ã™ã¹ã¦ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ï¼‰" -#: ../../rst/community/communication.rst:52 -msgid "edits (so you can fix your typos)" -msgstr "編集（タイプミスを修æ£ã§ãã¾ã™ï¼‰" +#: ../../rst/community/communication.rst:51 +msgid "edits (Lets you fix typos and so on. **NOTE** Each edit you make on Matrix re-sends the message to IRC. Please try to avoid multiple edits!)" +msgstr "編集 (タイプミスãªã©ã‚’ä¿®æ£ã§ãã¾ã™ã€‚**注記** Matrix ã§ç·¨é›†ã‚’è¡Œã†ãŸã³ã«ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒ IRC ã«å†é€ä¿¡ã•ã‚Œã¾ã™ã€‚何度も編集ã—ãªã„よã†ã«ã—ã¦ãã ã•ã„!)" -#: ../../rst/community/communication.rst:53 +#: ../../rst/community/communication.rst:52 msgid "replies to individual users" msgstr "個々ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¸ã®è¿”ä¿¡" -#: ../../rst/community/communication.rst:54 +#: ../../rst/community/communication.rst:53 msgid "reactions/emojis" msgstr "åå¿œ/絵文å—" -#: ../../rst/community/communication.rst:55 +#: ../../rst/community/communication.rst:54 msgid "bridging to IRC" msgstr "IRCã¸ã®ãƒ–リッジ" -#: ../../rst/community/communication.rst:56 +#: ../../rst/community/communication.rst:55 msgid "no line limits" msgstr "行制é™ãªã—" -#: ../../rst/community/communication.rst:57 +#: ../../rst/community/communication.rst:56 msgid "images" msgstr "images" -#: ../../rst/community/communication.rst:59 -msgid "The room links in the :ref:`general_channels` will take you directly to the relevant rooms. For more information, see the community-hosted `Matrix FAQ <https://hackmd.io/@ansible-community/community-matrix-faq>`_." -msgstr ":ref:`general_channels` ã®ãƒãƒ£ãƒƒãƒˆãƒ«ãƒ¼ãƒ ã®ãƒªãƒ³ã‚¯ã‹ã‚‰ã€é–¢é€£ã™ã‚‹ãƒãƒ£ãƒƒãƒˆãƒ«ãƒ¼ãƒ ã«ç›´æŽ¥ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚詳細ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãŒãƒ›ã‚¹ãƒˆã™ã‚‹ `Matrix FAQ <https://hackmd.io/@ansible-community/community-matrix-faq>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/community/communication.rst:58 +msgid "The room links in the :ref:`general_channels` or in the :ref:`working_group_list` list will take you directly to the relevant rooms." +msgstr ":ref:`general_channels`ã¾ãŸã¯:ref:`working_group_list` リストã®ãƒ«ãƒ¼ãƒ リンクã‹ã‚‰é–¢é€£ã™ã‚‹ãƒ«ãƒ¼ãƒ ã«ç›´æŽ¥ç§»å‹•ã§ãã¾ã™ã€‚" + +#: ../../rst/community/communication.rst:60 +msgid "If there is no appropriate room for your community, please create it." +msgstr "コミュニティーã«é©åˆ‡ãªãƒ«ãƒ¼ãƒ ãŒãªã„å ´åˆã¯ã€ä½œæˆã—ã¦ãã ã•ã„。" #: ../../rst/community/communication.rst:62 +msgid "For more information, see the community-hosted `Matrix FAQ <https://hackmd.io/@ansible-community/community-matrix-faq>`_." +msgstr "詳細ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãŒãƒ›ã‚¹ãƒˆã™ã‚‹ `Matrix FAQ <https://hackmd.io/@ansible-community/community-matrix-faq>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/community/communication.rst:65 msgid "Ansible community on IRC" msgstr "IRCã®Ansibleコミュニティ" -#: ../../rst/community/communication.rst:64 +#: ../../rst/community/communication.rst:67 msgid "The Ansible community maintains several IRC channels on `irc.libera.chat <https://libera.chat/>`_. To join the community using IRC, you need one thing:" msgstr "Ansibleコミュニティã¯ã€`irc.libera.chat <https://libera.chat/>`_ã«ã„ãã¤ã‹ã®IRCãƒãƒ£ãƒ³ãƒãƒ«ã‚’ç¶æŒã—ã¦ã„ã¾ã™ã€‚IRCを使用ã—ã¦ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ã«å‚åŠ ã™ã‚‹ã«ã¯ã€æ¬¡ã®1ã¤ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/community/communication.rst:66 +#: ../../rst/community/communication.rst:69 msgid "an IRC client" msgstr "IRCクライアント" -#: ../../rst/community/communication.rst:68 +#: ../../rst/community/communication.rst:71 msgid "IRC chat supports:" msgstr "IRCãƒãƒ£ãƒƒãƒˆã¯ä»¥ä¸‹ã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ï¼š" -#: ../../rst/community/communication.rst:70 -msgid "no persistence (you only see messages when you are logged on, unless you add a bouncer)" +#: ../../rst/community/communication.rst:73 +msgid "no persistence (you only see messages when you are logged on unless you add a bouncer)" msgstr "永続性ãªã—（ãƒã‚¦ãƒ³ã‚µãƒ¼ã‚’è¿½åŠ ã—ãªã„é™ã‚Šã€ãƒã‚°ã‚ªãƒ³ã—ãŸã¨ãã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã—ã‹è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“）" -#: ../../rst/community/communication.rst:71 +#: ../../rst/community/communication.rst:74 msgid "simple text interface" msgstr "シンプルãªãƒ†ã‚ストインターフェース" -#: ../../rst/community/communication.rst:72 +#: ../../rst/community/communication.rst:75 msgid "bridging from Matrix" msgstr "Matrixã‹ã‚‰ã®ãƒ–リッジ" -#: ../../rst/community/communication.rst:74 +#: ../../rst/community/communication.rst:77 msgid "Our IRC channels may require you to register your IRC nickname. If you receive an error when you connect or when posting a message, see `libera.chat's Nickname Registration guide <https://libera.chat/guides/registration>`_ for instructions. To find all ``ansible`` specific channels on the libera.chat network, use the following command in your IRC client:" msgstr "ã“ã® IRC ãƒãƒ£ãƒ³ãƒãƒ«ã§ã¯ã€IRCã®ãƒ‹ãƒƒã‚¯ãƒãƒ¼ãƒ ã®ç™»éŒ²ãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚接続時ã¾ãŸã¯ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®æŠ•ç¨¿æ™‚ã«ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å ´åˆã¯ã€ã€Œ`libera.chat's Nickname Registration ガイド <https://libera.chat/guides/registration>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。libera.chatãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã®``ansible``固有ã®ãƒãƒ£ãƒãƒ«ã‚’ã™ã¹ã¦ã‚’見ã¤ã‘ã‚‹ã«ã¯ã€IRCクライアントã§æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/community/communication.rst:80 +#: ../../rst/community/communication.rst:83 msgid "as described in the `libera.chat docs <https://libera.chat/guides/findingchannels>`_." msgstr "`libera.chat ドã‚ュメント <https://libera.chat/guides/findingchannels>`_ ã«è¨˜è¼‰ã®ã¨ãŠã‚Šã€‚" -#: ../../rst/community/communication.rst:82 +#: ../../rst/community/communication.rst:85 msgid "Our channels record history on the Matrix side. The channel history can be viewed in a browser - all channels will report an appropriate link to ``chat.ansible.im`` in their Chanserv entrymsg upon joining the room. Alternatively, a URL of the form ``https://chat.ansible.im/#/room/# {IRC channel name}:libera.chat`` will also work, for example - for the #ansible-docs channel it would be `https://app.element.io/#/room/#ansible-docs:libera.chat`." msgstr "ãƒãƒ£ãƒ³ãƒãƒ«ã¯ Matrix å´ã§å±¥æ´ã‚’記録ã—ã¾ã™ã€‚ãƒãƒ£ãƒ³ãƒãƒ«å±¥æ´ã¯ãƒ–ラウザーã§è¡¨ç¤ºã§ãã¾ã™ã€‚å…¨ãƒãƒ£ãƒ³ãƒãƒ«ã§ã¯ã€Chanserv entrymsg ã« ``chat.ansible.im`` ã¸ã®é©åˆ‡ãªãƒªãƒ³ã‚¯ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã¾ãŸã¯ã€#ansible-docs ãƒãƒ£ãƒ³ãƒãƒ«ã®å ´åˆã¯ ``https://chat.ansible.im/#/room/# {IRC channel name}:libera.chat``ã€#ansible-docs ãƒãƒ£ãƒ³ãƒãƒ«ã®å ´åˆã¯ `https://app.element.io/#/room/#ansible-docs:libera.chat` ãŒä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/community/communication.rst:87 +#: ../../rst/community/communication.rst:90 msgid "General channels" msgstr "一般的ãªãƒãƒ£ãƒ³ãƒãƒ«" -#: ../../rst/community/communication.rst:89 +#: ../../rst/community/communication.rst:92 msgid "The clickable links will take you directly to the relevant Matrix room in your browser; room/channel information is also given for use in other clients:" msgstr "クリックå¯èƒ½ãªãƒªãƒ³ã‚¯ã‚’クリックã™ã‚‹ã¨ã€ãƒ–ラウザã§é–¢é€£ã™ã‚‹Matrixルームã«ç›´æŽ¥ç§»å‹•ã—ã¾ã™ã€‚ãƒãƒ£ãƒƒãƒˆãƒ«ãƒ¼ãƒ /ãƒãƒ£ãƒ³ãƒãƒ«æƒ…å ±ã¯ã€ä»–ã®ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«ã‚‚æä¾›ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/communication.rst:91 +#: ../../rst/community/communication.rst:94 msgid "`Community social room and posting news for the Bullhorn newsletter <https://matrix.to:/#/#social:ansible.com>`_ - ``Matrix: #social:ansible.com | IRC: #ansible-social``" msgstr "`Community social room and posting news for the Bullhorn newsletter <https://matrix.to:/#/#social:ansible.com>`_ - ``Matrix: #social:ansible.com | IRC: #ansible-social``" -#: ../../rst/community/communication.rst:92 +#: ../../rst/community/communication.rst:95 msgid "`General usage and support questions <https://matrix.to:/#/#users:ansible.com>`_ - ``Matrix: #users:ansible.com | IRC: #ansible``" msgstr "`General usage and support questions <https://matrix.to:/#/#users:ansible.com>`_ - ``Matrix: #users:ansible.com | IRC: #ansible``" -#: ../../rst/community/communication.rst:93 +#: ../../rst/community/communication.rst:96 msgid "`Discussions on developer topics and code related to features or bugs <https://matrix.to/#/#devel:ansible.com>`_ - ``Matrix: #devel:ansible.com | IRC: #ansible-devel``" msgstr "`Discussions on developer topics and code related to features or bugs <https://matrix.to/#/#devel:ansible.com>`_ - ``Matrix: #devel:ansible.com | IRC: #ansible-devel``" -#: ../../rst/community/communication.rst:94 +#: ../../rst/community/communication.rst:97 msgid "`Discussions on community and collections related topics <https://matrix.to:/#/#community:ansible.com>`_ - ``Matrix: #community:ansible.com | IRC: #ansible-community``" msgstr "`Discussions on community and collections related topics <https://matrix.to:/#/#community:ansible.com>`_ - ``Matrix: #community:ansible.com | IRC: #ansible-community``" -#: ../../rst/community/communication.rst:96 +#: ../../rst/community/communication.rst:99 msgid "`For public community meetings <https://matrix.to/#/#meeting:ansible.im>`_ - ``Matrix: #meeting:ansible.im | IRC: #ansible-meeting``" msgstr "`For public community meetings <https://matrix.to/#/#meeting:ansible.im>`_ - ``Matrix: #meeting:ansible.im | IRC: #ansible-meeting``" -#: ../../rst/community/communication.rst:96 +#: ../../rst/community/communication.rst:99 msgid "We will generally announce these on one or more of the above mailing lists. See the `meeting schedule and agenda page <https://github.com/ansible/community/blob/main/meetings/README.md>`_" msgstr "通常ã¯ã€ä¸Šè¨˜ã®ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆã§å‘ŠçŸ¥ã•ã‚Œã¾ã™ã€‚`meeting schedule and agenda page <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/communication.rst:101 +#: ../../rst/community/communication.rst:104 msgid "Working groups" msgstr "ワーã‚ンググループ" -#: ../../rst/community/communication.rst:103 +#: ../../rst/community/communication.rst:106 msgid "Many of our community `Working Groups <https://github.com/ansible/community/wiki#working-groups>`_ meet in chat. If you want to get involved in a working group, join the Matrix room or IRC channel where it meets or comment on the agenda." msgstr "Ansible コミュニティー㮠`Working Groups <https://github.com/ansible/community/wiki#working-groups>`_ ã®å¤šããŒã€ãƒãƒ£ãƒƒãƒˆã§æ´»å‹•ã—ã¦ã„ã¾ã™ã€‚ワーã‚ンググループã«å‚åŠ ã—ãŸã„å ´åˆã¯ã€ãã®ãƒ¯ãƒ¼ã‚ンググループãŒæ´»å‹•ã—ã¦ã„ã‚‹Matrixã®ãƒãƒ£ãƒƒãƒˆãƒ«ãƒ¼ãƒ ã¾ãŸã¯IRCãƒãƒ£ãƒ³ãƒãƒ«ã«å‚åŠ ã—ãŸã‚Šã€è°é¡Œã«ã‚³ãƒ¡ãƒ³ãƒˆã—ãŸã‚Šã—ã¦ãã ã•ã„。" -#: ../../rst/community/communication.rst:105 +#: ../../rst/community/communication.rst:108 +msgid "`AAP Configuration as Code <https://github.com/redhat-cop/controller_configuration/wiki/AAP-Configuration-as-Code>`_ - Matrix: `#aap_config_as_code:ansible.com <https://matrix.to/#/#aap_config_as_code:ansible.com>`_" +msgstr "`AAP Configuration as Code <https://github.com/redhat-cop/controller_configuration/wiki/AAP-Configuration-as-Code>`_ - マトリックス: `#aap_config_as_code:ansible.com <https://matrix.to/#/#aap_config_as_code:ansible.com>`_" + +#: ../../rst/community/communication.rst:109 msgid "`Amazon (AWS) Working Group <https://github.com/ansible/community/wiki/AWS>`_ - Matrix: `#aws:ansible.com <https://matrix.to:/#/#aws:ansible.com>`_ | IRC: ``#ansible-aws``" msgstr "`Amazon (AWS) Working Group <https://github.com/ansible/community/wiki/AWS>`_ - Matrix: `#aws:ansible.com <https://matrix.to:/#/#aws:ansible.com>`_ | IRC: ``#ansible-aws``" -#: ../../rst/community/communication.rst:106 -msgid "`Ansible Lockdown Working Group <https://github.com/ansible/community/wiki/Lockdown>`_ (`Security playbooks/roles <https://github.com/ansible/ansible-lockdown>`_) - Matrix: `#lockdown:ansible.com <https://matrix.to:/#/#lockdown:ansible.com>`_ | IRC: ``#ansible-lockdown``" -msgstr "`Ansible Lockdown Working Group <https://github.com/ansible/community/wiki/Lockdown>`_ (`Security playbooks/roles <https://github.com/ansible/ansible-lockdown>`_) - Matrix: `#lockdown:ansible.com <https://matrix.to:/#/#lockdown:ansible.com>`_ | IRC: ``#ansible-lockdown``" - -#: ../../rst/community/communication.rst:107 +#: ../../rst/community/communication.rst:110 msgid "`AWX Working Group <https://github.com/ansible/awx>`_ - Matrix: `#awx:ansible.com <https://matrix.to:/#/#awx:ansible.com>`_ | IRC: ``#ansible-awx``" msgstr "`AWX Working Group <https://github.com/ansible/awx>`_ - Matrix: `#awx:ansible.com <https://matrix.to:/#/#awx:ansible.com>`_ | IRC: ``#ansible-awx``" -#: ../../rst/community/communication.rst:108 +#: ../../rst/community/communication.rst:111 msgid "`Azure Working Group <https://github.com/ansible/community/wiki/Azure>`_ - Matrix: `#azure:ansible.com <https://matrix.to:/#/#azure:ansible.com>`_ | IRC: ``#ansible-azure``" msgstr "`Azure Working Group <https://github.com/ansible/community/wiki/Azure>`_ - Matrix: `#azure:ansible.com <https://matrix.to:/#/#azure:ansible.com>`_ | IRC: ``#ansible-azure``" -#: ../../rst/community/communication.rst:109 +#: ../../rst/community/communication.rst:112 msgid "`Community Working Group <https://github.com/ansible/community/wiki/Community>`_ (including Meetups) - Matrix: `#community:ansible.com <https://matrix.to:/#/#community:ansible.com>`_ | IRC: ``#ansible-community``" msgstr "`Community Working Group <https://github.com/ansible/community/wiki/Community>`_ (Meetups ã‚’å«ã‚€) - Matrix: `#community:ansible.com <https://matrix.to:/#/#community:ansible.com>`_ | IRC: ``#ansible-community``" -#: ../../rst/community/communication.rst:110 +#: ../../rst/community/communication.rst:113 msgid "`Container Working Group <https://github.com/ansible/community/wiki/Container>`_ - Matrix: `#container:ansible.com <https://matrix.to:/#/#container:ansible.com>`_ | IRC: ``#ansible-container``" msgstr "`Container Working Group <https://github.com/ansible/community/wiki/Container>`_ - Matrix: `#container:ansible.com <https://matrix.to:/#/#container:ansible.com>`_ | IRC: ``#ansible-container``" -#: ../../rst/community/communication.rst:111 +#: ../../rst/community/communication.rst:114 msgid "`Contributor Experience Working Group <https://github.com/ansible/community/wiki/Contributor-Experience>`_ - Matrix: `#community:ansible.com <https://matrix.to:/#/#community:ansible.com>`_ | IRC: ``#ansible-community``" msgstr "`Contributor Experience Working Group <https://github.com/ansible/community/wiki/Contributor-Experience>`_ - Matrix: `#community:ansible.com <https://matrix.to:/#/#community:ansible.com>`_ | IRC: ``#ansible-community``" -#: ../../rst/community/communication.rst:112 +#: ../../rst/community/communication.rst:115 msgid "`DigitalOcean Working Group <https://github.com/ansible/community/wiki/Digital-Ocean>`_ - Matrix: `#digitalocean:ansible.im <https://matrix.to:/#/#digitalocean:ansible.im>`_ | IRC: ``#ansible-digitalocean``" msgstr "`DigitalOcean Working Group <https://github.com/ansible/community/wiki/Digital-Ocean>`_ - Matrix: `#digitalocean:ansible.im <https://matrix.to:/#/#digitalocean:ansible.im>`_ | IRC: ``#ansible-digitalocean``" -#: ../../rst/community/communication.rst:113 +#: ../../rst/community/communication.rst:116 msgid "`Diversity Working Group <https://github.com/ansible/community/wiki/Diversity>`_ - Matrix: `#diversity:ansible.com <https://matrix.to:/#/#diversity:ansible.com>`_ | IRC: ``#ansible-diversity``" msgstr "`Diversity Working Group <https://github.com/ansible/community/wiki/Diversity>`_ - Matrix: `#diversity:ansible.com <https://matrix.to:/#/#diversity:ansible.com>`_ | IRC: ``#ansible-diversity``" -#: ../../rst/community/communication.rst:114 +#: ../../rst/community/communication.rst:117 msgid "`Docker Working Group <https://github.com/ansible/community/wiki/Docker>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" msgstr "`Docker Working Group <https://github.com/ansible/community/wiki/Docker>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" -#: ../../rst/community/communication.rst:115 +#: ../../rst/community/communication.rst:118 msgid "`Documentation Working Group <https://github.com/ansible/community/wiki/Docs>`_ - Matrix: `#docs:ansible.com <https://matrix.to:/#/#docs:ansible.com>`_ | IRC: ``#ansible-docs``" msgstr "`Documentation Working Group <https://github.com/ansible/community/wiki/Docs>`_ - Matrix: `#docs:ansible.com <https://matrix.to:/#/#docs:ansible.com>`_ | IRC: ``#ansible-docs``" -#: ../../rst/community/communication.rst:116 +#: ../../rst/community/communication.rst:119 msgid "`Galaxy Working Group <https://github.com/ansible/community/wiki/Galaxy>`_ - Matrix: `#galaxy:ansible.com <https://matrix.to:/#/#galaxy:ansible.com>`_ | IRC: ``#ansible-galaxy``" msgstr "`Galaxy Working Group <https://github.com/ansible/community/wiki/Galaxy>`_ - Matrix: `#galaxy:ansible.com <https://matrix.to:/#/#galaxy:ansible.com>`_ | IRC: ``#ansible-galaxy``" -#: ../../rst/community/communication.rst:117 +#: ../../rst/community/communication.rst:120 msgid "`JBoss Working Group <https://github.com/ansible/community/wiki/JBoss>`_ - Matrix: `#jboss:ansible.com <https://matrix.to:/#/#jboss:ansible.com>`_ | IRC: ``#ansible-jboss``" msgstr "`JBoss Working Group <https://github.com/ansible/community/wiki/JBoss>`_ - Matrix: `#jboss:ansible.com <https://matrix.to:/#/#jboss:ansible.com>`_ | IRC: ``#ansible-jboss``" -#: ../../rst/community/communication.rst:118 +#: ../../rst/community/communication.rst:121 msgid "`Kubernetes Working Group <https://github.com/ansible/community/wiki/Kubernetes>`_ - Matrix: `#kubernetes:ansible.com <https://matrix.to:/#/#kubernetes:ansible.com>`_ | IRC: ``#ansible-kubernetes``" msgstr "`Kubernetes Working Group <https://github.com/ansible/community/wiki/Kubernetes>`_ - Matrix: `#kubernetes:ansible.com <https://matrix.to:/#/#kubernetes:ansible.com>`_ | IRC: ``#ansible-kubernetes``" -#: ../../rst/community/communication.rst:119 +#: ../../rst/community/communication.rst:122 msgid "`Linode Working Group <https://github.com/ansible/community/wiki/Linode>`_ - Matrix: `#linode:ansible.com <https://matrix.to:/#/#linode:ansible.com>`_ | IRC: ``#ansible-linode``" msgstr "`Linode Working Group <https://github.com/ansible/community/wiki/Linode>`_ - Matrix: `#linode:ansible.com <https://matrix.to:/#/#linode:ansible.com>`_ | IRC: ``#ansible-linode``" -#: ../../rst/community/communication.rst:120 +#: ../../rst/community/communication.rst:123 msgid "`Molecule Working Group <https://github.com/ansible/community/wiki/Molecule>`_ (`testing platform for Ansible playbooks and roles <https://molecule.readthedocs.io>`_) - Matrix: `#molecule:ansible.im <https://matrix.to:/#/#molecule:ansible.im>`_ | IRC: ``#ansible-molecule``" msgstr "`Molecule Working Group <https://github.com/ansible/community/wiki/Molecule>`_ (`testing platform for Ansible playbooks and roles <https://molecule.readthedocs.io>`_) - Matrix: `#molecule:ansible.im <https://matrix.to:/#/#molecule:ansible.im>`_ | IRC: ``#ansible-molecule``" -#: ../../rst/community/communication.rst:121 +#: ../../rst/community/communication.rst:124 +msgid "`MySQL Working Group <https://github.com/ansible-collections/community.mysql/wiki/MySQL-Working-Group>`_ - Matrix: `#mysql:ansible.com <https://matrix.to:/#/#mysql:ansible.com>`_" +msgstr "`MySQL Working Group <https://github.com/ansible-collections/community.mysql/wiki/MySQL-Working-Group>`_ - マトリックス: `#mysql:ansible.com <https://matrix.to:/#/#mysql:ansible.com>`_" + +#: ../../rst/community/communication.rst:125 msgid "`Network Working Group <https://github.com/ansible/community/wiki/Network>`_ - Matrix: `#network:ansible.com <https://matrix.to:/#/#network:ansible.com>`_ | IRC: ``#ansible-network``" msgstr "`Network Working Group <https://github.com/ansible/community/wiki/Network>`_ - Matrix: `#network:ansible.com <https://matrix.to:/#/#network:ansible.com>`_ | IRC: ``#ansible-network``" -#: ../../rst/community/communication.rst:122 +#: ../../rst/community/communication.rst:126 msgid "`PostgreSQL Working Group <https://github.com/ansible-collections/community.postgresql/wiki/PostgreSQL-Working-Group>`_ - Matrix: `#postgresql:ansible.com <https://matrix.to:/#/#postgresql:ansible.com>`_" msgstr "`PostgreSQL Working Group <https://github.com/ansible-collections/community.postgresql/wiki/PostgreSQL-Working-Group>`_ - Matrix: `#postgresql:ansible.com <https://matrix.to:/#/#postgresql:ansible.com>`_" -#: ../../rst/community/communication.rst:123 +#: ../../rst/community/communication.rst:127 msgid "`Remote Management Working Group <https://github.com/ansible/community/issues/409>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" msgstr "`Remote Management Working Group <https://github.com/ansible/community/issues/409>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" -#: ../../rst/community/communication.rst:124 +#: ../../rst/community/communication.rst:128 +msgid "`Security Automation Working Group <https://github.com/ansible/community/wiki/Security-Automation>`_ - Matrix: `#security-automation:ansible.com <https://matrix.to/#/#security-automation:ansible.com>`_ | IRC: ``#ansible-security``" +msgstr "`Security Automation Working Group <https://github.com/ansible/community/wiki/Security-Automation>`_ - マトリックス: `#security-automation:ansible.com <https://matrix.to/#/#security-automation:ansible.com>`_ | IRC: ``#ansible-security``" + +#: ../../rst/community/communication.rst:129 +msgid "`Storage Working Group <https://github.com/ansible/community/wiki/Storage>`_ - Matrix: `#storage:ansible.com <https://matrix.to/#/#storage:ansible.com>`_ | IRC: ``#ansible-storage``" +msgstr "`Storage Working Group <https://github.com/ansible/community/wiki/Storage>`_ - マトリックス: `#storage:ansible.com <https://matrix.to/#/#storage:ansible.com>`_ | IRC: ``#ansible-storage``" + +#: ../../rst/community/communication.rst:130 msgid "`Testing Working Group <https://github.com/ansible/community/wiki/Testing>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" msgstr "`Testing Working Group <https://github.com/ansible/community/wiki/Testing>`_ - Matrix: `#devel:ansible.com <https://matrix.to:/#/#devel:ansible.com>`_ | IRC: ``#ansible-devel``" -#: ../../rst/community/communication.rst:125 +#: ../../rst/community/communication.rst:131 msgid "`VMware Working Group <https://github.com/ansible/community/wiki/VMware>`_ - Matrix: `#vmware:ansible.com <https://matrix.to:/#/#vmware:ansible.com>`_ | IRC: ``#ansible-vmware``" msgstr "`VMware Working Group <https://github.com/ansible/community/wiki/VMware>`_ - Matrix: `#vmware:ansible.com <https://matrix.to:/#/#vmware:ansible.com>`_ | IRC: ``#ansible-vmware``" -#: ../../rst/community/communication.rst:126 +#: ../../rst/community/communication.rst:132 msgid "`Windows Working Group <https://github.com/ansible/community/wiki/Windows>`_ - Matrix: `#windows:ansible.com <https://matrix.to:/#/#windows:ansible.com>`_ | IRC: ``#ansible-windows``" msgstr "`Windows Working Group <https://github.com/ansible/community/wiki/Windows>`_ - Matrix: `#windows:ansible.com <https://matrix.to:/#/#windows:ansible.com>`_ | IRC: ``#ansible-windows``" -#: ../../rst/community/communication.rst:127 +#: ../../rst/community/communication.rst:133 msgid "`Ansible developer tools Group <https://github.com/ansible/community/wiki/Ansible-developer-tools>`_ - Matrix: `#devtools:ansible.com <https://matrix.to/#/#devtools:ansible.com>`_ | IRC: ``#ansible-devtools``" msgstr "`Ansible developer tools Group <https://github.com/ansible/community/wiki/Ansible-developer-tools>`_ - Matrix: `#devtools:ansible.com <https://matrix.to/#/#devtools:ansible.com>`_ | IRC: ``#ansible-devtools``" -#: ../../rst/community/communication.rst:129 +#: ../../rst/community/communication.rst:135 msgid "Want to `form a new Working Group <https://github.com/ansible/community/blob/main/WORKING-GROUPS.md>`_?" -msgstr "`form a new Working Group <https://github.com/ansible/community/blob/main/WORKING-GROUPS.md>`_ ã§ã™ã‹?" +msgstr "`æ–°ã—ã„ワーã‚ンググループ <https://github.com/ansible/community/blob/main/WORKING-GROUPS.md>`ã‚’å½¢æˆ_ã—ã¾ã™ã‹?" -#: ../../rst/community/communication.rst:132 +#: ../../rst/community/communication.rst:138 msgid "Regional and Language-specific channels" msgstr "地域ãŠã‚ˆã³è¨€èªžå›ºæœ‰ã®ãƒãƒ£ãƒ³ãƒãƒ«" -#: ../../rst/community/communication.rst:134 +#: ../../rst/community/communication.rst:140 msgid "Comunidad Ansible en español - Matrix: `#espanol:ansible.im <https://matrix.to:/#/#espanol:ansible.im>`_ | IRC: ``#ansible-es``" msgstr "スペイン語ã®Ansibleコミュニティー - Matrix: `#espanol:ansible.im <https://matrix.to:/#/#espanol:ansible.im>`_ | IRC: ``#ansible-es``" -#: ../../rst/community/communication.rst:135 +#: ../../rst/community/communication.rst:141 msgid "Communauté française d'Ansible - Matrix: `#francais:ansible.im <https://matrix.to:/#/#francais:ansible.im>`_ | IRC: ``#ansible-fr``" msgstr "フランス語ã®Ansibleコミュニティー - Matrix: `#francais:ansible.im <https://matrix.to:/#/#francais:ansible.im>`_ | IRC: ``#ansible-fr``" -#: ../../rst/community/communication.rst:136 +#: ../../rst/community/communication.rst:142 msgid "Communauté suisse d'Ansible - Matrix: `#suisse:ansible.im <https://matrix.to:/#/#suisse:ansible.im>`_ | IRC: ``#ansible-zh``" msgstr "スイスã®Ansibleコミュニティー - Matrix: `#suisse:ansible.im <https://matrix.to:/#/#suisse:ansible.im>`_ | IRC: ``#ansible-zh``" -#: ../../rst/community/communication.rst:137 +#: ../../rst/community/communication.rst:143 msgid "European Ansible Community - Matrix: `#europe:ansible.im <https://matrix.to:/#/#europe:ansible.im>`_ | IRC: ``#ansible-eu``" msgstr "ヨーãƒãƒƒãƒ‘ã®Ansibleコミュニティー - Matrix: `#europe:ansible.im <https://matrix.to:/#/#europe:ansible.im>`_ | IRC: ``#ansible-eu``" -#: ../../rst/community/communication.rst:140 +#: ../../rst/community/communication.rst:146 msgid "Meetings on chat" msgstr "ãƒãƒ£ãƒƒãƒˆã§ã®ä¼šè°" -#: ../../rst/community/communication.rst:142 +#: ../../rst/community/communication.rst:148 msgid "The Ansible community holds regular meetings on various topics on Matrix/IRC, and anyone who is interested is invited to participate. For more information about Ansible meetings, consult the `meeting schedule and agenda page <https://github.com/ansible/community/blob/main/meetings/README.md>`_." msgstr "Ansible コミュニティーã¯ã€Matrix/IRCã§ã•ã¾ã–ã¾ãªãƒˆãƒ”ックã«é–¢ã™ã‚‹å®šæœŸçš„ãªãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚’é–‹ã„ã¦ãŠã‚Šã€èˆˆå‘³ã®ã‚る人ã¯èª°ã§ã‚‚å‚åŠ ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚Ansible ミーティングã®è©³ç´°ã¯ã€`meeting schedule and agenda page <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/communication.rst:145 +#: ../../rst/community/communication.rst:151 msgid "Ansible Community Topics" msgstr "Ansible コミュニティーã®ãƒˆãƒ”ック" -#: ../../rst/community/communication.rst:147 +#: ../../rst/community/communication.rst:153 msgid "The `Ansible Community Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ uses the `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ to asynchronously discuss with the Community and vote on Community topics in corresponding issues." msgstr "`Ansible Community Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ ã¯ã€`community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ を使用ã—ã¦ã€å¯¾å¿œã™ã‚‹ issue ã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã®ãƒˆãƒ”ックã«ã¤ã„ã¦ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã§éžåŒæœŸã«è©±ã—åˆã„ã€æŠ•ç¥¨ã—ã¾ã™ã€‚" -#: ../../rst/community/communication.rst:149 +#: ../../rst/community/communication.rst:155 msgid "Create a new issue in the `repository <https://github.com/ansible-community/community-topics/issues>`_ if you want to discuss an idea that impacts any of the following:" msgstr "以下ã®ã„ãšã‚Œã‹ã«å½±éŸ¿ã‚’与ãˆã‚‹ã‚¢ã‚¤ãƒ‡ã‚¢ã«ã¤ã„ã¦è©±ã—åˆã„ãŸã„å ´åˆã¯ã€`リãƒã‚¸ãƒˆãƒªãƒ¼ <https://github.com/ansible-community/community-topics/issues>`_ ã§æ–°ã—ã„ issue を作æˆã—ã¾ã™ã€‚" -#: ../../rst/community/communication.rst:151 -#: ../../rst/community/steering/community_steering_committee.rst:73 +#: ../../rst/community/communication.rst:157 +#: ../../rst/community/steering/community_steering_committee.rst:75 msgid "Ansible Community" msgstr "Ansible コミュニティー" -#: ../../rst/community/communication.rst:152 +#: ../../rst/community/communication.rst:158 msgid "Community collection best practices and `requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_" msgstr "コミュニティーコレクションã®ãƒ™ã‚¹ãƒˆãƒ—ラクティス㨠`è¦ä»¶ <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_" -#: ../../rst/community/communication.rst:153 +#: ../../rst/community/communication.rst:159 msgid "`Community collection inclusion policy <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_" -msgstr "`コミュニティーコレクションã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒãƒªã‚·ãƒ¼ <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_" +msgstr "`Community collection inclusion policy <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_" -#: ../../rst/community/communication.rst:154 +#: ../../rst/community/communication.rst:160 msgid "`The Community governance <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_" msgstr "`The Community governance <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_" -#: ../../rst/community/communication.rst:155 +#: ../../rst/community/communication.rst:161 msgid "Other proposals of importance that need the Committee or overall Ansible community attention" msgstr "Committee ã¾ãŸã¯ Ansible コミュニティー全体ã®æ³¨æ„ã‚’å¿…è¦ã¨ã™ã‚‹ãã®ä»–ã®é‡è¦ãªæ案" -#: ../../rst/community/communication.rst:158 +#: ../../rst/community/communication.rst:164 msgid "Ansible Automation Platform support questions" msgstr "Ansible Automation Platform サãƒãƒ¼ãƒˆã«é–¢ã™ã‚‹è³ªå•" -#: ../../rst/community/communication.rst:160 +#: ../../rst/community/communication.rst:166 msgid "Red Hat Ansible `Automation Platform <https://www.ansible.com/products/automation-platform>`_ is a subscription that contains support, certified content, and tooling for Ansible including content management, a controller, UI and REST API." msgstr "Red Hat Ansible `Automation Platform <https://www.ansible.com/products/automation-platform>`_ ã¯ã€ã‚³ãƒ³ãƒ†ãƒ³ãƒ„管ç†ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã€UI ãŠã‚ˆã³ REST API ãªã©ã® Ansible ã®ã‚µãƒãƒ¼ãƒˆã€èªå®šã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã€ãŠã‚ˆã³ãƒ„ールãŒå«ã¾ã‚Œã‚‹ã‚µãƒ–スクリプションã§ã™ã€‚" -#: ../../rst/community/communication.rst:162 +#: ../../rst/community/communication.rst:168 msgid "If you have a question about Ansible Automation Platform, visit `Red Hat support <https://access.redhat.com/products/red-hat-ansible-automation-platform/>`_ rather than using a chat channel or the general project mailing list." msgstr "Ansible Automation Platform ã«é–¢ã™ã‚‹ã”質å•ã¯ã€ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¾ãŸã¯ä¸€èˆ¬çš„ãªãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆã§ã¯ãªãã€`Red Hat サãƒãƒ¼ãƒˆ <https://access.redhat.com/products/red-hat-ansible-automation-platform/>`_ ã«ãŠå•ã„åˆã‚ã›ãã ã•ã„。" -#: ../../rst/community/communication.rst:165 +#: ../../rst/community/communication.rst:171 msgid "The Bullhorn" msgstr "The Bullhorn" -#: ../../rst/community/communication.rst:167 +#: ../../rst/community/communication.rst:173 msgid "**The Bullhorn** is our newsletter for the Ansible contributor community. Please `subscribe <https://eepurl.com/gZmiEP>`_ to receive it." msgstr "**The Bullhorn** ã¯ã€Ansible コントリビューターコミュニティーå‘ã‘ã®ãƒ‹ãƒ¥ãƒ¼ã‚¹ãƒ¬ã‚¿ãƒ¼ã§ã™ã€‚ニュースレターをå—ä¿¡ã™ã‚‹ã«ã¯ã€`サブスクライブ <https://eepurl.com/gZmiEP>`_ ã—ã¦ãã ã•ã„。" -#: ../../rst/community/communication.rst:169 +#: ../../rst/community/communication.rst:175 msgid "If you have any content you would like to share, please `contribute/suggest it <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ for upcoming releases." msgstr "共有ã—ãŸã„コンテンツãŒã‚ã‚‹å ´åˆã¯ã€ä»Šå¾Œã®ãƒªãƒªãƒ¼ã‚¹ç”¨ã« `æä¾›/æ案 <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã—ã¦ãã ã•ã„。" -#: ../../rst/community/communication.rst:171 +#: ../../rst/community/communication.rst:177 msgid "If you have any questions, please reach out to us at ``the-bullhorn@redhat.com``." msgstr "ã”ä¸æ˜Žãªç‚¹ãŒã”ã–ã„ã¾ã—ãŸã‚‰ã€``the-bullhorn@redhat.com`` ã¾ã§ãŠå•ã„åˆã‚ã›ãã ã•ã„。" -#: ../../rst/community/communication.rst:173 +#: ../../rst/community/communication.rst:179 msgid "Read past issues on the official Bullhorn's `wiki page <https://github.com/ansible/community/wiki/News#the-bullhorn>`_." msgstr "éŽåŽ»ã® issue ã«ã¤ã„ã¦ã¯ã€Bullhorn ã®å…¬å¼ã® `wiki ページ <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã‚’ãŠèªã¿ãã ã•ã„。" @@ -2961,7 +3009,7 @@ msgid "Contributor path" msgstr "コントリビューターパス" #: ../../rst/community/contributor_path.rst:5 -msgid "This section describes the contributor journey from the beginning to becoming a leader who helps shape the future of Ansible. You can use this path as a roadmap for your long-term participation." +msgid "This section describes the contributor's journey from the beginning to becoming a leader who helps shape the future of Ansible. You can use this path as a roadmap for your long-term participation." msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューター㌠Ansible ã®æœªæ¥ã‚’å½¢æˆã™ã‚‹ãƒªãƒ¼ãƒ€ãƒ¼ã«ãªã‚‹ã¾ã§ã®é“ã®ã‚Šã‚’最åˆã‹ã‚‰èª¬æ˜Žã—ã¾ã™ã€‚ã“ã®ãƒ‘スã¯ã€å‚åŠ è€…ã®é•·æœŸçš„ãƒãƒ¼ãƒ‰ãƒžãƒƒãƒ—ã¨ã—ã¦ä½¿ç”¨ã§ãã¾ã™ã€‚" #: ../../rst/community/contributor_path.rst:7 @@ -2986,7 +3034,7 @@ msgstr "以下ã¯ã€è²¢çŒ®å…ˆã¨ãªã‚‹ä¸€éƒ¨ã® Ansible エコシステムã®ã‚³ #: ../../rst/community/contributor_path.rst:24 msgid "`Ansible Core <https://docs.ansible.com/ansible-core/devel/index.html>`_" -msgstr "`Ansible Lint <https://docs.ansible.com/ansible-lint/index.html>`_" +msgstr "`Ansible Core <https://docs.ansible.com/ansible-core/devel/index.html>`_" #: ../../rst/community/contributor_path.rst:25 msgid "`Collections <https://docs.ansible.com/ansible/latest/user_guide/collections_using.html>`_" @@ -2994,7 +3042,7 @@ msgstr "`Collections <https://docs.ansible.com/ansible/latest/user_guide/collect #: ../../rst/community/contributor_path.rst:26 msgid "`AWX <https://github.com/ansible/awx>`_" -msgstr "`network bugs project <https://github.com/ansible/ansible/projects/20>`_" +msgstr "`AWX <https://github.com/ansible/awx>`_" #: ../../rst/community/contributor_path.rst:27 msgid "`Galaxy <https://galaxy.ansible.com/>`_" @@ -3025,7 +3073,7 @@ msgid "Code development requires the most technical knowledge. Let's sort out wh msgstr "コード開発ã«ã¯ã€æœ€ã‚‚技術的ãªçŸ¥è˜ãŒå¿…è¦ã§ã™ã€‚Ansible 開発者ãŒå¦ã¶å¿…è¦ã®ã‚る内容を分類ã—ã¦ã¿ã¾ã—ょã†ã€‚" #: ../../rst/community/contributor_path.rst:42 -msgid "You should understand at least *basics* of the following tools:" +msgid "You should understand at least the *basics* of the following tools:" msgstr "å°‘ãªãã¨ã‚‚以下ã®ãƒ„ール㮠*基本* ã‚’ç†è§£ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/contributor_path.rst:44 @@ -3041,16 +3089,16 @@ msgid "`GitHub collaborative development model through forks and pull requests < msgstr "`GitHub collaborative development model through forks and pull requests <https://docs.github.com/en/github/collaborating-with-pull-requests/getting-started/about-collaborative-development-models>`_" #: ../../rst/community/contributor_path.rst:48 -msgid "You can learn these tools more in depth when working on your first contributions." +msgid "You can learn these tools more in-depth when working on your first contributions." msgstr "最åˆã®è²¢çŒ®æ™‚ã«ã€ã“れらã®ãƒ„ールã®è©³ç´°ã‚’å¦ç¿’ã§ãã¾ã™ã€‚" #: ../../rst/community/contributor_path.rst:51 -msgid "Each Ansible project has its own set of contributor guidelines. Familarize yourself with these as you prepare your first contributions." +msgid "Each Ansible project has its own set of contributor guidelines. Familiarize yourself with these as you prepare your first contributions." msgstr "å„ Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã«ã¯ã€ç‹¬è‡ªã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターガイドラインãŒä¸€å¼ã‚ã‚Šã¾ã™ã€‚最åˆã®è²¢çŒ®ã‚’準備ã™ã‚‹éš›ã«ã€ã“れらã®ã‚¬ã‚¤ãƒ‰ã‚’把æ¡ã—ã¦ãã ã•ã„。" #: ../../rst/community/contributor_path.rst:53 msgid ":ref:`Ansible Core development <developer_guide>`." -msgstr ":ref:`Ansible Core development <developer_guide>`" +msgstr ":ref:`Ansible Core development <developer_guide>`。" #: ../../rst/community/contributor_path.rst:54 msgid ":ref:`Ansible collection development <developing_collections>` and the collection-level contributor guidelines in the collection repository." @@ -3061,92 +3109,116 @@ msgid "Making your first contribution" msgstr "åˆã‚ã¦è²¢çŒ®ã™ã‚‹" #: ../../rst/community/contributor_path.rst:60 -msgid "You can find some ideas on how you can contribute in :ref:`how_can_i_help` and the `collection repository <https://github.com/ansible-collections/>`_ ``README`` and ``CONTRIBUTING`` files. To make your first experience as smooth as possible, read the repository documentation carefully, then ask the repository maintainers for guidance if you have any questions." -msgstr ":ref:`how_can_i_help`ã€`collection repository <https://github.com/ansible-collections/>`_ ``README``ã€ãŠã‚ˆã³ ``CONTRIBUTING`` ファイルã§ã€è²¢çŒ®ã«é–¢ã™ã‚‹ã‚¢ã‚¤ãƒ‡ã‚¢ã‚’見ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã§ãã‚‹ã ã‘スムーズã«é€²ã‚ã‚‹ãŸã‚ã«ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ãƒ‰ã‚ュメントを慎é‡ã«èªã¿ã€è³ªå•ãŒã‚ã‚‹å ´åˆã¯ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«åŠ©è¨€ã‚’求ã‚ã¦ãã ã•ã„。" +msgid "You can find some ideas on how you can contribute in :ref:`how_can_i_help`." +msgstr "ã©ã®ã‚ˆã†ã«è²¢çŒ®ã§ãã‚‹ã‹ã«ã¤ã„ã¦ã¯ã€:ref:`how_can_i_help` ã«ã„ãã¤ã‹ã®ã‚¢ã‚¤ãƒ‡ã‚¢ãŒæŽ²è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" #: ../../rst/community/contributor_path.rst:62 -msgid "You can also look for GitHub issues labeled with the ``easyfix``, ``good_first_issue``, and ``docs`` labels. Add a comment on the GitHub issue to say you are looking at it and to ask for help if you need it." -msgstr "``easyfix``ã€``good_first_issue``ã€``docs`` ã§ãƒ©ãƒ™ãƒ«ä»˜ã‘ã•ã‚ŒãŸ GitHub issue を見ã¤ã‘ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚GitHub issue ã«é–²è¦§ã—ãŸã“ã¨ã‚’示ã™ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã€å¿…è¦ã«å¿œã˜ã¦åŠ©è¨€ã‚’ä¾é ¼ã—ã¦ãã ã•ã„。" +msgid "If you are interested in contributing to collections, take a look at :ref:`collection contributions<collections_contributions>` and the `collection repository <https://github.com/ansible-collections/>`_'s ``README`` and ``CONTRIBUTING`` files. To make your first experience as smooth as possible, read the repository documentation carefully, then ask the repository maintainers for guidance if you have any questions." +msgstr "コレクションã¸ã®è²¢çŒ®ã«é–¢å¿ƒãŒã‚ã‚‹å ´åˆã¯ã€:ref:`collection contributions<collections_contributions>` ã¨`collection repository <https://github.com/ansible-collections/>`_ ã®``README`` ã¨``CONTRIBUTING`` ファイルをå‚ç…§ã—ã¦ãã ã•ã„。最åˆã®è²¢çŒ®ã‚’ã§ãã‚‹ã ã‘スムーズã«é€²ã‚ã‚‹ãŸã‚ã«ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ãƒ‰ã‚ュメントを慎é‡ã«èªã¿ã€è³ªå•ãŒã‚ã‚‹å ´åˆã¯ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«åŠ©è¨€ã‚’求ã‚ã¦ãã ã•ã„。" + +#: ../../rst/community/contributor_path.rst:64 +msgid "Take a look at GitHub issues labeled with the ``easyfix`` and ``good_first_issue`` labels for:" +msgstr "``easyfix``ã¨``good_first_issue`` ã§ãƒ©ãƒ™ãƒ«ä»˜ã‘ã•ã‚ŒãŸ GitHub ã®å•é¡Œã‚’見ã¦ãã ã•ã„。" + +#: ../../rst/community/contributor_path.rst:66 +#, python-format +msgid "`Ansible collections repositories <https://github.com/search?q=user%3Aansible-collections+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" +msgstr "`Ansible collections repositories <https://github.com/search?q=user%3Aansible-collections+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" + +#: ../../rst/community/contributor_path.rst:67 +#: ../../rst/community/how_can_I_help.rst:67 +#, python-format +msgid "`All other Ansible projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" +msgstr "`All other Ansible projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" -#: ../../rst/community/contributor_path.rst:65 +#: ../../rst/community/contributor_path.rst:69 +msgid "Issues labeled with the ``docs`` label in `Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_ and `other <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_ Ansible projects can be also good to start with." +msgstr "`Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_ ã¨`other <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_ Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã§ã€``docs`` ã®ãƒ©ãƒ™ãƒ«ãŒä»˜ã„ãŸå•é¡Œã‹ã‚‰å§‹ã‚ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" + +#: ../../rst/community/contributor_path.rst:71 +#: ../../rst/community/how_can_I_help.rst:69 +msgid "When you choose an issue to work on, add a comment directly on the GitHub issue to say you are looking at it and let others know to avoid conflicting work. You can also ask for help in a comment if you need it." +msgstr "作æ¥ã™ã‚‹å•é¡Œã‚’é¸æŠžã™ã‚‹å ´åˆã¯ã€GitHub ã®å•é¡Œã«ç›´æŽ¥ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ã€ãã®å•é¡Œã‚’見ã¦ã„ã‚‹ã“ã¨ã‚’ä¼ãˆã€ç«¶åˆã™ã‚‹ä½œæ¥ã‚’é¿ã‘ã‚‹ãŸã‚ã«ä»–ã®äººã«çŸ¥ã‚‰ã›ã¦ãã ã•ã„。必è¦ã«å¿œã˜ã¦ã€ã‚³ãƒ¡ãƒ³ãƒˆã§ã‚µãƒãƒ¼ãƒˆã‚’求ã‚ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" + +#: ../../rst/community/contributor_path.rst:75 msgid "Continue to contribute" msgstr "継続的ã«è²¢çŒ®ã™ã‚‹" -#: ../../rst/community/contributor_path.rst:67 +#: ../../rst/community/contributor_path.rst:77 msgid "We don't expect everybody to know everything. Start small, think big. When you contribute regularly, your proficiency and judgment in the related area will improve quickly and, along with this, the importance of your presence in the project." msgstr "誰もãŒã™ã¹ã¦ã‚’知ã£ã¦ã„ã‚‹ã¨ã¯é™ã‚Šã¾ã›ã‚“。å°ã•ã始ã‚ã¦ã€å¤§ãã考ãˆã¦ãã ã•ã„。定期的ã«è²¢çŒ®ã™ã‚‹ã¨ã€é–¢é€£åˆ†é‡Žã§ã®ç¿’熟度ã¨åˆ¤æ–力ãŒæ€¥é€Ÿã«å‘上ã—ã€ãã‚Œã«ä¼´ã„ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã§ã®å˜åœ¨ã®é‡è¦æ€§ã‚‚高ã¾ã‚Šã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:69 +#: ../../rst/community/contributor_path.rst:79 msgid "See :ref:`communication` for ways to communicate and engage with the Ansible community, including working group meetings, accessing the Bullhorn news bulletin, and upcoming contributor summits." msgstr "ワーã‚ンググループã®ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã€Bullhorn ãƒ‹ãƒ¥ãƒ¼ã‚¹é€Ÿå ±ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã€ä»Šå¾Œã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターサミットãªã©ã€Ansible コミュニティーã¨ã®ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ãŠã‚ˆã³ä¸‰è§’方法ã«ã¤ã„ã¦ã¯ã€:ref:`communication` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/contributor_path.rst:73 +#: ../../rst/community/contributor_path.rst:83 msgid "Teach others" msgstr "ä»–ã®äººã«æ•™ãˆã‚‹" -#: ../../rst/community/contributor_path.rst:75 -msgid "Share your experience with other contributors through `improving documentation <ommunity_documentation_contributions>`, answering question from other contributors and users on `Matrix/Libera.Chat IRC <communicate>`, giving advice in issues and pull requests, and discussing the `Community Topics <https://github.com/ansible-community/community-topics/issues>`_." -msgstr "`improving documentation <ommunity_documentation_contributions>` を通ã˜ã¦ä»–ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã¨çµŒé¨“を共有ã—ãŸã‚Šã€`Matrix/Libera.Chat IRC <communicate>` ã§ä»–ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターやユーザーã‹ã‚‰ã®è³ªå•ã«ç”ãˆãŸã‚Šã§ãã¾ã™ã€‚ã¾ãŸã€issue やプルè¦æ±‚ã«å¯¾ã—ã¦åŠ©è¨€ã—ãŸã‚Šã€`Community Topics <https://github.com/ansible-community/community-topics/issues>`_ ã«ã¤ã„ã¦è°è«–ã—ãŸã‚Šã‚‚ã§ãã¾ã™ã€‚" +#: ../../rst/community/contributor_path.rst:85 +msgid "Share your experience with other contributors through :ref:`improving documentation<community_documentation_contributions>`, answering questions from other contributors and users on :ref:`Matrix/Libera.Chat IRC<communication>`, giving advice on issues and pull requests, and discussing `Community Topics <https://github.com/ansible-community/community-topics/issues>`_." +msgstr ":ref:`improving documentation<community_documentation_contributions>` を通ã˜ã¦ä»–ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã¨çµŒé¨“を共有ã—ãŸã‚Šã€:ref:`Matrix/Libera.Chat IRC<communication>` ã§ä»–ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターやユーザーã‹ã‚‰ã®è³ªå•ã«ç”ãˆãŸã‚Šã§ãã¾ã™ã€‚ã¾ãŸã€issue やプルè¦æ±‚ã«å¯¾ã—ã¦åŠ©è¨€ã—ãŸã‚Šã€`Community Topics <https://github.com/ansible-community/community-topics/issues>`_ ã«ã¤ã„ã¦è°è«–ã—ãŸã‚Šã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:78 -#: ../../rst/community/how_can_I_help.rst:67 +#: ../../rst/community/contributor_path.rst:88 +#: ../../rst/community/how_can_I_help.rst:75 msgid "Become a collection maintainer" msgstr "コレクションメンテナーã«ãªã‚‹" -#: ../../rst/community/contributor_path.rst:80 +#: ../../rst/community/contributor_path.rst:90 msgid "If you are a code contributor to a collection, you can get extended permissions in the repository and become a maintainer. A collection maintainer is a contributor trusted by the community who makes significant and regular contributions to the project and showed themselves as a specialist in the related area. See :ref:`maintainers` for details." msgstr "コレクションã®ã‚³ãƒ¼ãƒ‰ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã§ã‚ã‚‹å ´åˆã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã§æ‹¡å¼µãƒ‘ーミッションをå–å¾—ã—ã¦ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«ãªã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚コレクションメンテナーã¯ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã«ä¿¡é ¼ã•ã‚Œã‚‹ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã§ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã«å¤§ããã€å®šæœŸçš„ãªè²¢çŒ®ã‚’è¡Œã„ã€è©²å½“分野ã®å°‚門家ã¨ã—ã¦ã®åœ°ä½ã‚’示ã—ã¾ã™ã€‚詳細㯠:ref:`maintainers` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/contributor_path.rst:82 -msgid "For some collections that use the `collection bot <https://github.com/ansible-community/collection_bot>`_ , such as `community.general <https://github.com/ansible-collections/community.general>`_ and `community.network <https://github.com/ansible-collections/community.network>`_, you can have different levels of access and permissions." -msgstr "ã‚„ `community.general <https://github.com/ansible-collections/community.general>`_ ã‚„ `community.network <https://github.com/ansible-collections/community.network>`_ ãªã©ã® `collection bot <https://github.com/ansible-community/collection_bot>`_ を使用ã™ã‚‹ä¸€éƒ¨ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ç•°ãªã‚‹ãƒ¬ãƒ™ãƒ«ã®ã‚¢ã‚¯ã‚»ã‚¹ãŠã‚ˆã³ãƒ‘ーミッションをè¨å®šã§ãã¾ã™ã€‚" +#: ../../rst/community/contributor_path.rst:92 +msgid "For some collections that use the `collection bot <https://github.com/ansible-community/collection_bot>`_, such as `community.general <https://github.com/ansible-collections/community.general>`_ and `community.network <https://github.com/ansible-collections/community.network>`_, you can have different levels of access and permissions." +msgstr "`community.general <https://github.com/ansible-collections/community.general>`_ ã‚„ `community.network <https://github.com/ansible-collections/community.network>`_ ãªã©ã® `collection bot <https://github.com/ansible-community/collection_bot>`_ を使用ã™ã‚‹ä¸€éƒ¨ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ç•°ãªã‚‹ãƒ¬ãƒ™ãƒ«ã®ã‚¢ã‚¯ã‚»ã‚¹ãŠã‚ˆã³ãƒ‘ーミッションをè¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:84 -msgid "`module_maintainers` - The stage prior to becoming a collection maintainer. The file is usually a module or plugin. File maintainers have indirect commit rights." -msgstr "`module_maintainers` - コレクションメンテナーã«ãªã‚‹å‰ã®ã‚¹ãƒ†ãƒ¼ã‚¸ã€‚通常ã€ãƒ•ã‚¡ã‚¤ãƒ«ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã§ã™ã€‚ファイルメンテナーã«ã¯é–“接的ãªã‚³ãƒŸãƒƒãƒˆæ¨©é™ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/community/contributor_path.rst:94 +msgid ":ref:`module_maintainers` - The stage prior to becoming a collection maintainer. The file is usually a module or plugin. File maintainers have indirect commit rights." +msgstr ":ref:`module_maintainers` - コレクションメンテナーã«ãªã‚‹å‰ã®ã‚¹ãƒ†ãƒ¼ã‚¸ã€‚通常ã€ãƒ•ã‚¡ã‚¤ãƒ«ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã§ã™ã€‚ファイルメンテナーã«ã¯é–“接的ãªã‚³ãƒŸãƒƒãƒˆæ¨©é™ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:85 +#: ../../rst/community/contributor_path.rst:95 msgid "supershipit permissions - Similar to being a file maintainer but the scope where a maintainer has the indirect commit is the whole repository." msgstr "Supershipit パーミッション - ファイルメンテナーã«ä¼¼ã¦ã„ã¾ã™ãŒã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã®æŒã¤é–“接コミットã®ç¯„囲ã¯ãƒªãƒã‚¸ãƒˆãƒªãƒ¼å…¨ä½“ã«åŠã³ã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:86 -msgid "``triage`` - Access to the repository that allows contributors manage issues and pull requests." -msgstr "``triage`` - コントリビューターã«ã‚ˆã‚‹ issuee ãŠã‚ˆã³ãƒ—ルè¦æ±‚ã®ç®¡ç†ã‚’å¯èƒ½ã«ã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã€‚" +#: ../../rst/community/contributor_path.rst:96 +msgid "``triage`` - Access to the repository that allows contributors to manage issues and pull requests." +msgstr "``triage`` - コントリビューターã«ã‚ˆã‚‹ issue ãŠã‚ˆã³ãƒ—ルè¦æ±‚ã®ç®¡ç†ã‚’å¯èƒ½ã«ã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã€‚" -#: ../../rst/community/contributor_path.rst:87 +#: ../../rst/community/contributor_path.rst:97 msgid "``write`` access to the repository also known as ``commit``. In other words, become a committer. This access level allows contributors to merge pull requests to the development branch as well as perform all the other activities listed in the :ref:`maintainers`." msgstr "``commit`` ã¨ã‚‚呼ã°ã‚Œã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã¸ã® ``write`` アクセス。ã¤ã¾ã‚Šã€ã‚³ãƒŸãƒƒã‚¿ãƒ¼ã«ãªã‚Šã¾ã™ã€‚コントリビューターã¯ã“ã®ã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ã§ã€é–‹ç™ºãƒ–ランãƒã«ãƒ—ルè¦æ±‚をマージã§ãã€:ref:`maintainers` ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã‚‹ä»–ã®ã™ã¹ã¦ã®ã‚¢ã‚¯ãƒ†ã‚£ãƒ“ティーも実行ã§ãã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:89 +#: ../../rst/community/contributor_path.rst:99 msgid "For information about permission levels, see the `GitHub official documentation <https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization>`_." msgstr "パーミッションレベルã®è©³ç´°ã¯ã€`GitHub official documentation <https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/contributor_path.rst:92 +#: ../../rst/community/contributor_path.rst:102 msgid "Become a steering committee member" msgstr "Steering Committee メンãƒãƒ¼ã«ãªã‚‹" -#: ../../rst/community/contributor_path.rst:96 +#: ../../rst/community/contributor_path.rst:106 msgid "You do NOT have to be a programmer to become a steering committee member." msgstr "プãƒã‚°ãƒ©ãƒžãƒ¼ã§ãªãã¦ã‚‚ã€Steering Committee メンãƒãƒ¼ã«ãªã‚Œã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:98 -msgid "The :ref:`Steering Committee <community_steering_committee>` member status reflects the highest level of trust which allows contributors to lead the project through making very important `decisions <https://github.com/ansible-community/community-topics/issues>`_ for the Ansible project. The Committee members are the community leaders who shape the project's future and the future of automation in the IT world in general." +#: ../../rst/community/contributor_path.rst:108 +msgid "The :ref:`Steering Committee <community_steering_committee>` member status reflects the highest level of trust which allows contributors to lead the project by making very important `decisions <https://github.com/ansible-community/community-topics/issues>`_ for the Ansible project. The Committee members are the community leaders who shape the project's future and the future of automation in the IT world in general." msgstr ":ref:`Steering Committee <community_steering_committee>` メンãƒãƒ¼ã®ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã¯ã€æœ€é«˜ã®ä¿¡é ¼ãƒ¬ãƒ™ãƒ«ã‚’åæ˜ ã—ã¦ã„ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューター㯠Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã«ã¨ã£ã¦éžå¸¸ã«é‡è¦ãª `decisions <https://github.com/ansible-community/community-topics/issues>`_ を作æˆã—ã¦ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã‚’牽引ã§ãã¾ã™ã€‚Committee メンãƒãƒ¼ã¯ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã®ãƒªãƒ¼ãƒ€ãƒ¼ã§ã‚ã‚Šã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã®æœªæ¥ã¨ IT 全般ã«ãŠã‘る自動化ã®æœªæ¥ã‚’å½¢æˆã—ã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:100 +#: ../../rst/community/contributor_path.rst:110 msgid "To reach the status, as the current Committee members did before getting it, along with the things mentioned in this document, you should:" msgstr "ã“ã®ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã«é”ã™ã‚‹ã«ã¯ã€ç¾åœ¨ã® Cimmittee メンãƒãƒ¼ãŒãƒ¡ãƒ³ãƒãƒ¼ã«ãªã‚‹å‰ã«è¡Œã£ãŸã‚ˆã†ã«ã€ã“ã®ãƒ‰ã‚ュメントã«è¨˜è¼‰ã—ãŸå†…容ã®ä»–ã«ã‚‚以下を行ã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:102 +#: ../../rst/community/contributor_path.rst:112 msgid "Subscribe to, comment on, and vote on the `Community Topics <https://github.com/ansible-community/community-topics/issues>`_." msgstr "`Community Topics <https://github.com/ansible-community/community-topics/issues>`_ ã§ã‚µãƒ–スクライブã€ã‚³ãƒ¡ãƒ³ãƒˆã€è©•ä¾¡ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:103 +#: ../../rst/community/contributor_path.rst:113 msgid "Propose your topics." msgstr "トピックをæ案ã—ã¾ã™ã€‚" -#: ../../rst/community/contributor_path.rst:104 -msgid "If time permits, join the `Community meetings <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ Note this is **NOT** a requirement." +#: ../../rst/community/contributor_path.rst:114 +msgid "If time permits, join the `Community meetings <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_. Note this is **NOT** a requirement." msgstr "時間ãŒã‚ã‚Œã°ã€`Community meetings <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ ã«å‚åŠ ã—ã¾ã™ã€‚ã“ã‚Œã¯å¿…é ˆã§ã¯ **ã‚ã‚Šã¾ã›ã‚“**。" #: ../../rst/community/create_pr_quick_start.rst:5 @@ -3162,8 +3234,8 @@ msgid "These steps assume a Linux work environment with ``git`` installed." msgstr "以下ã®æ‰‹é †ã¯ã€``git`` ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ Linux ã®ä½œæ¥ç’°å¢ƒã‚’想定ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:19 -msgid "Install and start ``docker`` or ``podman`` with the ``docker`` executable shim. This insures tests run properly isolated and in the exact environments as in CI. The latest ``ansible-core`` development version also supports the ``podman`` CLI program." -msgstr "``docker`` 実行å¯èƒ½ãƒ•ã‚¡ã‚¤ãƒ« shim 㧠``docker`` ã¾ãŸã¯ ``podman`` をインストールãŠã‚ˆã³èµ·å‹•ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ†ã‚¹ãƒˆãŒé©åˆ‡ã«åˆ†é›¢ã•ã‚Œã€CI ã¨ã¾ã£ãŸãåŒã˜ç’°å¢ƒã§å®Ÿè¡Œã•ã‚Œã‚‹ã“ã¨ãŒä¿è¨¼ã•ã‚Œã¾ã™ã€‚最新㮠``ansible-core`` 開発ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€``podman`` CLI プãƒã‚°ãƒ©ãƒ もサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" +msgid "Install and start ``docker`` or ``podman``. This ensures tests run properly isolated and in the same environment as in CI." +msgstr "``docker`` ã¾ãŸã¯ ``podman`` をインストールã—ã¦èµ·å‹•ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€CI ã¨åŒã˜ç’°å¢ƒã§ã€æ£ã—ã分離ã—ã¦ãƒ†ã‚¹ãƒˆãŒå®Ÿè¡Œã•ã‚Œã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:21 msgid ":ref:`Install Ansible or ansible-core <installation_guide>`. You need the ``ansible-test`` utility which is provided by either of these packages." @@ -3210,7 +3282,7 @@ msgid "Change the code" msgstr "コードã®å¤‰æ›´" #: ../../rst/community/create_pr_quick_start.rst:95 -msgid "Do NOT mix several bugfixes or features that are not tightly-related in one pull request. Use separate pull requests for different changes." +msgid "Do NOT mix several bug fixes or features that are not tightly related in one pull request. Use separate pull requests for different changes." msgstr "1 ã¤ã®ãƒ—ルリクエストã«å¯†æŽ¥ã«é–¢é€£ã—ã¦ã„ãªã„複数ã®ãƒã‚°ä¿®æ£ã¾ãŸã¯æ©Ÿèƒ½ã‚’混在ã•ã›ãªã„ã§ãã ã•ã„。変更ã”ã¨ã«å€‹åˆ¥ã®ãƒ—ルリクエストを使用ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:97 @@ -3234,23 +3306,19 @@ msgid "The ``main.yml`` file holds test tasks and includes other test files. Loo msgstr "``main.yml`` ファイルã¯ã€ãƒ†ã‚¹ãƒˆã‚¿ã‚¹ã‚¯ã‚’ä¿æŒã—ã€ä»–ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’å«ã¿ã¾ã™ã€‚テストã®çµ±åˆã«é©åˆ‡ãªãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’探ã™ã‹ã€å°‚用ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã—ã¦è¿½åŠ ã—ã¾ã™ã€‚æ—¢å˜ã®ãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã® 1 ã¤ã‚’ドラフトã¨ã—ã¦ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:116 -msgid "When fixing a bug, write a task which reproduces the bug from the issue." -msgstr "ãƒã‚°ã‚’ä¿®æ£ã™ã‚‹éš›ã«ã€issue ã‹ã‚‰ãƒã‚°ã‚’å†ç¾ã™ã‚‹ã‚¿ã‚¹ã‚¯ã‚’作æˆã—ã¾ã™ã€‚" +msgid "When fixing a bug, write a task that reproduces the bug from the issue." +msgstr "ãƒã‚°ã‚’ä¿®æ£ã™ã‚‹éš›ã«ã€å•é¡Œã‹ã‚‰ãƒã‚°ã‚’å†ç¾ã™ã‚‹ã‚¿ã‚¹ã‚¯ã‚’作æˆã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:118 msgid "Put the reported case in the tests, then run integration tests with the following command:" msgstr "å ±å‘Šã•ã‚ŒãŸã‚±ãƒ¼ã‚¹ã‚’テストã«å…¥ã‚Œã¦ã‹ã‚‰ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã§çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:124 -msgid "For example, if the tests files you changed are stored in ``tests/integration/targets/test_mysql_user/``, the command is as follows:" +msgid "For example, if the test files you changed are stored in ``tests/integration/targets/test_mysql_user/``, the command is as follows:" msgstr "ãŸã¨ãˆã°ã€å¤‰æ›´ã—ãŸãƒ†ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ãŒ ``tests/integration/targets/test_mysql_user/`` ã«ä¿å˜ã•ã‚Œã¦ã„ã‚‹å ´åˆã€ã‚³ãƒžãƒ³ãƒ‰ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/community/create_pr_quick_start.rst:130 -msgid "You can use the ``-vv`` or ``-vvv`` argument, if you need more detailed output." -msgstr "より詳細ãªå‡ºåŠ›ãŒå¿…è¦ãªå ´åˆã¯ã€``-vv`` 引数ã¾ãŸã¯ ``-vvv`` 引数を使用ã§ãã¾ã™ã€‚" - #: ../../rst/community/create_pr_quick_start.rst:132 -msgid "In the examples above, the default test image is automatically downloaded and used to create and run a test container. Use the default test image for platform independent integration tests such as those for cloud modules." +msgid "In the examples above, the default test image is automatically downloaded and used to create and run a test container. Use the default test image for platform-independent integration tests such as those for cloud modules." msgstr "上記ã®ä¾‹ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ†ã‚¹ãƒˆã‚¤ãƒ¡ãƒ¼ã‚¸ãŒè‡ªå‹•çš„ã«ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã•ã‚Œã€ãƒ†ã‚¹ãƒˆã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®ä½œæˆã¨å®Ÿè¡Œã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚クラウドモジュールãªã©ã«å‘ã‘ãŸãƒ—ラットフォームã«ä¾å˜ã—ãªã„çµ±åˆãƒ†ã‚¹ãƒˆã«ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ†ã‚¹ãƒˆã‚¤ãƒ¡ãƒ¼ã‚¸ã‚’使用ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:135 @@ -3270,7 +3338,7 @@ msgid "If the bug has not appeared and the tests have passed successfully, ask t msgstr "ãƒã‚°ãŒç™ºç”Ÿã—ã¦ãŠã‚‰ãšã€ãƒ†ã‚¹ãƒˆãŒåˆæ ¼ã—ãŸå ´åˆã¯ã€ãƒ¬ãƒãƒ¼ã‚¿ãƒ¼ã«ã•ã‚‰ãªã‚‹è©³ç´°ã‚’æä¾›ã™ã‚‹ã‚ˆã†ä¾é ¼ã—ã¦ãã ã•ã„。ãƒã‚°ã§ã¯ãªã„å¯èƒ½æ€§ã€ã¾ãŸã¯ä½¿ç”¨ã•ã‚Œã¦ã„る特定ã®ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¾ãŸã¯ãƒ¬ãƒãƒ¼ã‚¿ãƒ¼ã®ãƒãƒ¼ã‚«ãƒ«ç’°å¢ƒè¨å®šã®è©³ç´°ã«é–¢é€£ã—ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:148 -msgid "The bug has appeared and the tests has failed as expected showing the reported symptoms." +msgid "The bug has appeared and the tests have failed as expected showing the reported symptoms." msgstr "ãƒã‚°ãŒç™ºç”Ÿã—ã€ãƒ†ã‚¹ãƒˆã¯äºˆæƒ³ã©ãŠã‚Šã«å¤±æ•—ã—ã€å ±å‘Šã•ã‚ŒãŸç—‡çŠ¶ãŒç¤ºã•ã‚Œã¾ã—ãŸã€‚" #: ../../rst/community/create_pr_quick_start.rst:151 @@ -3294,7 +3362,7 @@ msgid "Run ``flake8`` against a changed file:" msgstr "変更ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã«å¯¾ã—㦠``flake8`` を実行ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:167 -msgid "This shows unused imports, which is not shown by sanity tests, as well as other common issues. Optionally, you can use the ``--max-line-length=160`` command-line argument." +msgid "This shows unused imports, which are not shown by sanity tests, as well as other common issues. Optionally, you can use the ``--max-line-length=160`` command-line argument." msgstr "ã“ã‚Œã¯ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã«ã‚ˆã£ã¦è¡¨ç¤ºã•ã‚Œãªã„未使用ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã¨ã€ãã®ä»–ã®ä¸€èˆ¬çš„㪠issue を示ã—ã¦ã„ã¾ã™ã€‚オプションã§ã€``--max-line-length=160`` コマンドライン引数を使用ã§ãã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:170 @@ -3318,7 +3386,7 @@ msgid "There are two possible outcomes:" msgstr "考ãˆã‚‰ã‚Œã‚‹çµæžœã¯ 2 ã¤ã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:196 -msgid "They have failed. Look at the output of the command. Fix the problem place in the code and run again. Repeat the cycle until the tests pass." +msgid "They have failed. Look at the output of the command. Fix the problem in the code and run again. Repeat the cycle until the tests pass." msgstr "テストã«å¤±æ•—ã—ã¾ã—ãŸã€‚コマンドã®å‡ºåŠ›ã§ç¢ºèªã—ã¦ã¿ã¦ãã ã•ã„。コード内ã®å•é¡Œç®‡æ‰€ã‚’ä¿®æ£ã—ã€å†åº¦å®Ÿè¡Œã—ã¾ã™ã€‚テストã«åˆæ ¼ã™ã‚‹ã¾ã§ã“ã®ã‚µã‚¤ã‚¯ãƒ«ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:197 @@ -3366,8 +3434,8 @@ msgid "GitHub is tracking your fork, so it should see the new branch in it and a msgstr "GitHub ã¯ãƒ•ã‚©ãƒ¼ã‚¯ã‚’追跡ã—ã¦ã„ã‚‹ãŸã‚ã€ãƒ•ã‚©ãƒ¼ã‚¯å†…ã«æ–°ã—ã„ブランãƒãŒè¡¨ç¤ºã•ã‚Œã€ãƒ—ルリクエストã®ä½œæˆãŒè‡ªå‹•çš„ã«æ案ã•ã‚Œã¾ã™ã€‚GitHub ãŒæ案ã—ãªã„å ´åˆã‚‚ã‚ã‚‹ã®ã§ã€ãã®å ´åˆã¯ã”自身㧠`New pull request` ボタンを押ã—ã¦ãã ã•ã„。続ã„ã¦ã€guilabel:`Compare changes` タイトルã®ä¸‹ã«ã‚ã‚‹ `compare across forks` ã‚’é¸æŠžã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:237 -msgid "5.Choose your repository and the new branch you pushed in the right drop-down list. Confirm." -msgstr "5. リãƒã‚¸ãƒˆãƒªãƒ¼ã¨ãƒ—ッシュã—ãŸæ–°ã—ã„ブランãƒã‚’å³å´ã®ãƒ‰ãƒãƒƒãƒ—ダウンリストã‹ã‚‰é¸æŠžã—ã¾ã™ã€‚確èªã—ã¾ã™ã€‚" +msgid "Choose your repository and the new branch you pushed in the right drop-down list. Confirm." +msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ã¨ãƒ—ッシュã—ãŸæ–°ã—ã„ブランãƒã‚’å³å´ã®ãƒ‰ãƒãƒƒãƒ—ダウンリストã‹ã‚‰é¸æŠžã—ã¾ã™ã€‚確èªã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:239 msgid "Fill out the pull request template with all information you want to mention." @@ -3402,11 +3470,11 @@ msgid "Verify the CI tests pass that run automatically on Red Hat infrastructure msgstr "コミットã™ã‚‹ãŸã³ã«ã€Red Hat インフラストラクãƒãƒ£ãƒ¼ã§è‡ªå‹•çš„ã«å®Ÿè¡Œã•ã‚Œã‚‹ CI テストã«åˆæ ¼ã™ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:266 -msgid "You will see the CI status in the bottom of your pull request. If they are green and you think that you do not want to add more commits before someone should take a closer look at it, remove ``[WIP]`` from the title. Mention the issue reporter in a comment and let contributors know that the pull request is \"Ready for review\"." +msgid "You will see the CI status at the bottom of your pull request. If they are green and you think that you do not want to add more commits before someone should take a closer look at it, remove ``[WIP]`` from the title. Mention the issue reporter in a comment and let contributors know that the pull request is \"Ready for review\"." msgstr "プルè¦æ±‚ã®ä¸‹éƒ¨ã« CI ステータスãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ãれらãŒç·‘色ã§ã€ã‚³ãƒŸãƒƒãƒˆã‚’ã•ã‚‰ã«è¿½åŠ ã™ã‚‹å‰ã«ã€èª°ã‹ã«è©³ã—ã見ã¦ã‚‚らã„ãŸã„ã¨æ€ã†å ´åˆã¯ã€ã‚¿ã‚¤ãƒˆãƒ«ã‹ã‚‰ ``[WIP]`` を削除ã—ã¾ã™ã€‚コメント㫠issue レãƒãƒ¼ã‚¿ãƒ¼ã‚’記載ã—ã€ãƒ—ルリクエスト㌠\"Ready for review\" ã§ã‚ã‚‹ã“ã¨ã‚’コントリビューターã«çŸ¥ã‚‰ã›ã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:268 -msgid "Wait for reviews. You can also ask for review in the ``#ansible-community`` :ref:`Matrix/Libera.Chat IRC channel <communication_irc>`." +msgid "Wait for reviews. You can also ask for a review in the ``#ansible-community`` :ref:`Matrix/Libera.Chat IRC channel <communication_irc>`." msgstr "レビューを待ã¡ã¾ã™ã€‚``#ansible-community`` :ref:`Matrix/Libera.Chat IRC channel <communication_irc>` ã§ã‚‚レビューをä¾é ¼ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/community/create_pr_quick_start.rst:270 @@ -3450,12 +3518,12 @@ msgid "various GitHub `projects <https://github.com/ansible/ansible/projects>`_ msgstr "ã•ã¾ã–ã¾ãª GitHub `プãƒã‚¸ã‚§ã‚¯ãƒˆ <https://github.com/ansible/ansible/projects>`_ - 以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" #: ../../rst/community/development_process.rst:26 -msgid "the `2.12 release project <https://github.com/ansible/ansible/projects/43>`_" -msgstr "`2.12 リリースプãƒã‚¸ã‚§ã‚¯ãƒˆ <https://github.com/ansible/ansible/projects/43>`_" +msgid "the `2.15 release project <https://github.com/ansible/ansible/projects/46>`_" +msgstr "`2.15 release project <https://github.com/ansible/ansible/projects/46>`_" #: ../../rst/community/development_process.rst:27 -msgid "the `core documentation project <https://github.com/ansible/ansible/projects/27>`_" -msgstr "`コアドã‚ュメントプãƒã‚¸ã‚§ã‚¯ãƒˆ <https://github.com/ansible/ansible/projects/27>`_" +msgid "the `core documentation project <https://github.com/orgs/ansible/projects/94/views/1>`_" +msgstr "`core documentation project <https://github.com/orgs/ansible/projects/94/views/1>`_" #: ../../rst/community/development_process.rst:36 msgid "If you want to contribute a feature or fix a bug in ``ansible-core`` or in a collection, you must open a **pull request** (\"PR\" for short). GitHub provides a great overview of `how the pull request process works <https://help.github.com/articles/about-pull-requests/>`_ in general. The ultimate goal of any pull request is to get merged and become part of a collection or ``ansible-core``. Here's an overview of the PR lifecycle:" @@ -3770,8 +3838,8 @@ msgid "These instructions assume that:" msgstr "ã“れらã®æ‰‹é †ã¯ã€ä»¥ä¸‹ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/community/development_process.rst:333 -msgid "``stable-2.13`` is the targeted release branch for the backport" -msgstr "``stable-2.13`` ã¯ã€ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒªãƒªãƒ¼ã‚¹ãƒ–ランãƒã§ã™ã€‚" +msgid "``stable-2.14`` is the targeted release branch for the backport" +msgstr "``stable-2.14`` ã¯ã€ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒªãƒªãƒ¼ã‚¹ãƒ–ランãƒã§ã™ã€‚" #: ../../rst/community/development_process.rst:334 msgid "``https://github.com/ansible/ansible.git`` is configured as a ``git remote`` named ``upstream``. If you do not use a ``git remote`` named ``upstream``, adjust the instructions accordingly." @@ -3798,16 +3866,16 @@ msgid "Push your feature branch to your fork on GitHub:" msgstr "feature ブランãƒã‚’ GitHub ã®ãƒ•ã‚©ãƒ¼ã‚¯ã«ãƒ—ッシュã—ã¾ã™ã€‚" #: ../../rst/community/development_process.rst:358 -msgid "Submit the pull request for ``backport/2.13/[PR_NUMBER_FROM_DEVEL]`` against the ``stable-2.13`` branch" -msgstr "``stable-2.13`` ブランãƒã«ã€``backport/2.13/[PR_NUMBER_FROM_DEVEL]`` ã®ãƒ—ルè¦æ±‚ã‚’é€ä¿¡ã—ã¾ã™ã€‚" +msgid "Submit the pull request for ``backport/2.14/[PR_NUMBER_FROM_DEVEL]`` against the ``stable-2.14`` branch" +msgstr "``stable-2.14`` ブランãƒã«ã€``backport/2.14/[PR_NUMBER_FROM_DEVEL]`` ã®ãƒ—ルリクエストをé€ä¿¡ã—ã¾ã™ã€‚" #: ../../rst/community/development_process.rst:360 msgid "The Release Manager will decide whether to merge the backport PR before the next minor release. There isn't any need to follow up. Just ensure that the automated tests (CI) are green." msgstr "次ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ã§ã«ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã®ãƒ—ルè¦æ±‚をマージã™ã‚‹ã‹ã©ã†ã‹ã¯ãƒªãƒªãƒ¼ã‚¹ãƒžãƒãƒ¼ã‚¸ãƒ£ãƒ¼ãŒåˆ¤æ–ã—ã¾ã™ã€‚フォãƒãƒ¼ã‚¢ãƒƒãƒ—ã®å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。自動テスト (CI) ã«å•é¡ŒãŒç™ºç”Ÿã—ã¦ã„ãªã„ã“ã¨ã‚’確èªã™ã‚‹ã ã‘ã§ã™ã€‚" #: ../../rst/community/development_process.rst:364 -msgid "The branch name ``backport/2.13/[PR_NUMBER_FROM_DEVEL]`` is somewhat arbitrary but conveys meaning about the purpose of the branch. This branch name format is not required, but it can be helpful, especially when making multiple backport PRs for multiple stable branches." -msgstr "ブランãƒå ``backport/2.13/[PR_NUMBER_FROM_DEVEL]`` ã¯ã‚„ã‚„æ£æ„çš„ã§ã™ãŒã€ãƒ–ランãƒã®ç›®çš„ã«ã¤ã„ã¦ã®æ„味をä¼ãˆã¾ã™ã€‚ã“ã®ãƒ–ランãƒåã®å½¢å¼ã¯å¿…é ˆã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ç‰¹ã«è¤‡æ•°ã®å®‰å®šã—ãŸãƒ–ランãƒã«å¯¾ã—ã¦è¤‡æ•°ã®ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆãƒ—ルè¦æ±‚を作æˆã™ã‚‹å ´åˆã«å½¹ç«‹ã¡ã¾ã™ã€‚" +msgid "The branch name ``backport/2.14/[PR_NUMBER_FROM_DEVEL]`` is somewhat arbitrary but conveys meaning about the purpose of the branch. This branch name format is not required, but it can be helpful, especially when making multiple backport PRs for multiple stable branches." +msgstr "ブランãƒå ``backport/2.14/[PR_NUMBER_FROM_DEVEL]`` ã¯ä»»æ„ã§ã™ãŒã€ãƒ–ランãƒã®ç›®çš„ãŒã‚ã‹ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚ã“ã®ãƒ–ランãƒåã®å½¢å¼ã¯å¿…é ˆã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ç‰¹ã«è¤‡æ•°ã®å®‰å®šã—ãŸãƒ–ランãƒã«å¯¾ã—ã¦è¤‡æ•°ã®ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆãƒ—ルリクエストを作æˆã™ã‚‹å ´åˆã«å½¹ç«‹ã¡ã¾ã™ã€‚" #: ../../rst/community/development_process.rst:368 msgid "If you prefer, you can use CPython's cherry-picker tool (``pip install --user 'cherry-picker >= 1.3.2'``) to backport commits from devel to stable branches in Ansible. Take a look at the `cherry-picker documentation <https://pypi.org/p/cherry-picker#cherry-picking>`_ for details on installing, configuring, and using it." @@ -3886,203 +3954,234 @@ msgid "Keep an eye on your PR - the docs team may ask you for changes." msgstr "é€ä¿¡ã—㟠PR ã«æ³¨æ„を払ã„続ã‘ã¦ãã ã•ã„。ドã‚ュメントãƒãƒ¼ãƒ ã‹ã‚‰å¤‰æ›´ã‚’ä¾é ¼ã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/documentation_contributions.rst:39 -msgid "Reviewing open PRs and issues" -msgstr "PR ãŠã‚ˆã³å•é¡Œã®ç¢ºèª" +msgid "Reviewing or solving open issues" +msgstr "未解決ã®å•é¡Œã®ç¢ºèªã¾ãŸã¯è§£æ±º" #: ../../rst/community/documentation_contributions.rst:41 -#, python-format -msgid "You can also contribute by reviewing open documentation `issues <https://github.com/ansible/ansible/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Adocs>`_ and `PRs <https://github.com/ansible/ansible/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3Adocs>`_. To add a helpful review, please:" -msgstr "é–‹ã„ã¦ã„るドã‚ュメント㮠`å•é¡Œ (issue) <https://github.com/ansible/ansible/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Adocs>`_ ãŠã‚ˆã³ `プルè¦æ±‚ <https://github.com/ansible/ansible/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3Adocs>`_ を確èªã™ã‚‹ã“ã¨ã§è²¢çŒ®ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚å½¹ã«ç«‹ã¤ãƒ¬ãƒ“ãƒ¥ãƒ¼ã‚’è¿½åŠ ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "Review or solve open documentation issues for:" +msgstr "次ã®æœªè§£æ±ºã®ãƒ‰ã‚ュメントã®å•é¡Œã‚’確èªã¾ãŸã¯è§£æ±ºã—ã¾ã™ã€‚" #: ../../rst/community/documentation_contributions.rst:43 -msgid "Include a comment - \"looks good to me\" only helps if we know why." -msgstr "「looks good to me (ç§ã«ã¯è‰¯ã•ãã†ã«è¦‹ãˆã‚‹)ã€ã¨ã„ã†ã‚³ãƒ¡ãƒ³ãƒˆã¯ã€ä»–ã®äººã«ã‚‚ãã®ç†ç”±ãŒæ˜Žã‚‰ã‹ãªå ´åˆã«ã®ã¿ä½¿ç”¨ã—ã¦ãã ã•ã„。" +msgid "`Ansible projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_" +msgstr "`Ansible projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_" #: ../../rst/community/documentation_contributions.rst:44 -msgid "For issues, reproduce the problem." -msgstr "å•é¡Œã«ã¤ã„ã¦ã¯ã€å•é¡Œã‚’å†ç¾ã—ã¾ã™ã€‚" +msgid "`Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_" +msgstr "`Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Aissue&type=Issues>`_" + +#: ../../rst/community/documentation_contributions.rst:47 +msgid "Reviewing open PRs" +msgstr "Open ã¨ãªã£ã¦ã„ã‚‹ PR ã®ç¢ºèª" + +#: ../../rst/community/documentation_contributions.rst:49 +msgid "Review open documentation pull requests for:" +msgstr "以下㮠Open ã¨ãªã£ã¦ã„るドã‚ュメントプルリクエストを確èªã—ã¾ã™ã€‚" + +#: ../../rst/community/documentation_contributions.rst:51 +msgid "Ansible `projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Apr>`_" +msgstr "Ansible `projects <https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Adocs+state%3Aopen+type%3Apr>`_" + +#: ../../rst/community/documentation_contributions.rst:52 +msgid "Ansible `collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Apr>`_" +msgstr "Ansible `collections <https://github.com/search?q=user%3Aansible-collections+label%3Adocs+state%3Aopen+type%3Apr>`_" + +#: ../../rst/community/documentation_contributions.rst:54 +msgid "To add a helpful review, please:" +msgstr "役立ã¤ãƒ¬ãƒ“ãƒ¥ãƒ¼ã‚’è¿½åŠ ã™ã‚‹ã«ã¯ã€æ¬¡ã®æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。" + +#: ../../rst/community/documentation_contributions.rst:56 +msgid "Test the change if applicable." +msgstr "該当ã™ã‚‹å ´åˆã¯ã€å¤‰æ›´ã‚’テストã—ã¾ã™ã€‚" + +#: ../../rst/community/documentation_contributions.rst:57 +msgid "Think if it can be made better (including wording, structure, fixing typos and so on)." +msgstr "改善ã§ãã‚‹ã‹ã©ã†ã‹ã‚’考ãˆã¦ãã ã•ã„ (文言ã€æ§‹é€ ã€ã‚¿ã‚¤ãƒ—ミスã®ä¿®æ£ãªã©ã‚’å«ã‚€)。" + +#: ../../rst/community/documentation_contributions.rst:58 +msgid "Suggest improvements." +msgstr "改善内容をæ案ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:45 -msgid "For PRs, test the change." -msgstr "プルè¦æ±‚ã«ã¤ã„ã¦ã¯ã€å¤‰æ›´ã‚’テストã—ã¾ã™ã€‚" +#: ../../rst/community/documentation_contributions.rst:59 +msgid "Approve the change with the ``looks good to me`` comment." +msgstr "``looks good to me`` コメントã§å¤‰æ›´ã‚’承èªã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:48 +#: ../../rst/community/documentation_contributions.rst:62 msgid "Opening a new issue and/or PR" msgstr "æ–°ã—ã„å•é¡Œã¾ãŸã¯ PR ã‚’é–‹ã" -#: ../../rst/community/documentation_contributions.rst:50 +#: ../../rst/community/documentation_contributions.rst:64 msgid "If the problem you have noticed is too complex to fix with the ``Edit on GitHub`` option, and no open issue or PR already documents the problem, please open an issue and/or a PR on the correct underlying repo - ``ansible/ansible`` for most pages that are not plugin or module documentation. If the documentation page has no ``Edit on GitHub`` option, check if the page is for a module within a collection. If so, follow the link to the collection on Galaxy and select the ``repo`` button in the upper right corner to find the source repository for that collection and module. The Collection README file should contain information on how to contribute to that collection, or report issues." msgstr "æ°—ã¥ã„ãŸå•é¡ŒãŒè¤‡é›‘ã™ãŽã¦ ``Edit on GitHub`` オプションã§ã¯ä¿®æ£ã§ããšã€ãã®å•é¡ŒãŒå ±å‘Šã•ã‚Œã¦ã„ãªã‹ã£ãŸã‚Šã€ãƒ—ルè¦æ±‚ãŒä½œæˆã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€æ£ã—ã„基盤ã®ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã§å•é¡Œã¾ãŸã¯ãƒ—ルè¦æ±‚を作æˆã—ã¦ãã ã•ã„ (プラグインやモジュールã®ãƒ‰ã‚ュメント以外ã®ã»ã¨ã‚“ã©ã®ãƒšãƒ¼ã‚¸ã«ã¤ã„ã¦ã¯ã€``ansible/ansible`` ã§å•é¡Œã¾ãŸã¯ãƒ—ルè¦æ±‚を作æˆã—ã¦ãã ã•ã„)。ドã‚ュメントページ㫠``Edit on GitHub`` オプションãŒãªã„å ´åˆã¯ã€ãã®ãƒšãƒ¼ã‚¸ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ç”¨ã§ã‚ã‚‹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚ãã®å ´åˆã¯ã€Galaxy ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¸ã®ãƒªãƒ³ã‚¯ã«å¾“ã„ã€å³ä¸Šéš…ã® ``repo`` ボタンをé¸æŠžã—ã¦ã€ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚½ãƒ¼ã‚¹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã‚’見ã¤ã‘ã¦ãã ã•ã„。コレクション README ファイルã«ã¯ã€ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¸ã®è²¢çŒ®æ–¹æ³•ã€ã¾ãŸã¯å•é¡Œã‚’å ±å‘Šã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:52 +#: ../../rst/community/documentation_contributions.rst:66 msgid "A great documentation GitHub issue or PR includes:" msgstr "GitHub ã®å•é¡Œã‚„ PR ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ãªå†…å®¹ã‚’è¿½åŠ ã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:54 +#: ../../rst/community/documentation_contributions.rst:68 msgid "a specific title" msgstr "特定ã®ã‚¿ã‚¤ãƒˆãƒ«" -#: ../../rst/community/documentation_contributions.rst:55 +#: ../../rst/community/documentation_contributions.rst:69 msgid "a detailed description of the problem (even for a PR - it's hard to evaluate a suggested change unless we know what problem it's meant to solve)" msgstr "å•é¡Œã®è©³ç´°ãªèª¬æ˜Ž (何ãŒå•é¡Œãªã®ã‹åˆ†ã‹ã‚‰ãªã„ã¨å¤‰æ›´æ¡ˆã®è©•ä¾¡ãŒå›°é›£ã«ãªã‚‹ãŸã‚ã€ãƒ—ルè¦æ±‚ã®å ´åˆã§ã‚‚åŒæ§˜)" -#: ../../rst/community/documentation_contributions.rst:56 +#: ../../rst/community/documentation_contributions.rst:70 msgid "links to other information (related issues/PRs, external documentation, pages on docs.ansible.com, and so on)" msgstr "ãã®ä»–ã®æƒ…å ± (関連ã™ã‚‹å•é¡Œã‚„プルè¦æ±‚ã€å¤–部ドã‚ュメントã€docs.ansible.com ã®ãƒšãƒ¼ã‚¸ãªã©) ã¸ã®ãƒªãƒ³ã‚¯" -#: ../../rst/community/documentation_contributions.rst:60 +#: ../../rst/community/documentation_contributions.rst:74 msgid "Verifying your documentation PR" msgstr "ドã‚ュメントプルè¦æ±‚ã®ç¢ºèª" -#: ../../rst/community/documentation_contributions.rst:62 +#: ../../rst/community/documentation_contributions.rst:76 msgid "If you make multiple changes to the documentation on ``ansible/ansible``, or add more than a line to it, before you open a pull request, please:" msgstr "``ansible/ansible`` ã®ãƒ‰ã‚ュメントã«è¤‡æ•°ã®å¤‰æ›´ã‚’åŠ ãˆãŸã‚Šã€è¤‡æ•°ã®è¡Œã‚’è¿½åŠ ã—ãŸã‚Šã™ã‚‹å ´åˆã¯ã€ãƒ—ルè¦æ±‚を開始ã™ã‚‹å‰ã«ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:64 +#: ../../rst/community/documentation_contributions.rst:78 msgid "Check that your text follows our :ref:`style_guide`." msgstr "記述ã—ãŸå†…容ãŒã€:ref:`style_guide` ã«å¾“ã£ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:65 +#: ../../rst/community/documentation_contributions.rst:79 msgid "Test your changes for rST errors." msgstr "変更ã—ãŸå†…容㌠rST ã®ã‚¨ãƒ©ãƒ¼ã«ãªã£ã¦ã„ãªã„ã‹ãƒ†ã‚¹ãƒˆã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:66 +#: ../../rst/community/documentation_contributions.rst:80 msgid "Build the page, and preferably the entire documentation site, locally." msgstr "ページã€ã§ãã‚Œã°ãƒ‰ã‚ュメントサイト全体をãƒãƒ¼ã‚«ãƒ«ã§ãƒ“ルドã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:70 +#: ../../rst/community/documentation_contributions.rst:84 msgid "The following sections apply to documentation sourced from the ``ansible/ansible`` repo and does not apply to documentation from an individual collection. See the collection README file for details on how to contribute to that collection." msgstr "以下ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã¯ã€``ansible/ansible`` リãƒã‚¸ãƒˆãƒªãƒ¼ã‹ã‚‰å–å¾—ã—ãŸãƒ‰ã‚ュメントã«é©ç”¨ã•ã‚Œã€å€‹åˆ¥ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‹ã‚‰ã®ãƒ‰ã‚ュメントã«ã¯é©ç”¨ã•ã‚Œã¾ã›ã‚“。ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¸ã®è²¢çŒ®æ–¹æ³•ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® README ファイルをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:73 +#: ../../rst/community/documentation_contributions.rst:87 msgid "Setting up your environment to build documentation locally" msgstr "ãƒãƒ¼ã‚«ãƒ«ã«ãƒ‰ã‚ュメントをビルドã™ã‚‹ãŸã‚ã®ç’°å¢ƒè¨å®š" -#: ../../rst/community/documentation_contributions.rst:75 +#: ../../rst/community/documentation_contributions.rst:89 msgid "To build documentation locally, ensure you have a working :ref:`development environment <environment_setup>`." msgstr "ãƒãƒ¼ã‚«ãƒ«ã«ãƒ‰ã‚ュメントをビルドã™ã‚‹ã«ã¯ã€:ref:`development environment <environment_setup>` ãŒæœ‰åŠ¹ã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:77 +#: ../../rst/community/documentation_contributions.rst:91 msgid "To work with documentation on your local machine, you need to have python-3.9 or greater and install the `Ansible dependencies`_ and `documentation dependencies`_, which are listed in two files to make installation easier:" msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒžã‚·ãƒ³ã§ãƒ‰ã‚ュメントを使用ã™ã‚‹ã«ã¯ã€python-3.9 以é™ã‚’使用ã—ã¦ã€`Ansible dependencies`_ ãŠã‚ˆã³ `documentation dependencies`_ をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’容易ã«ã™ã‚‹ãŸã‚ã«ã€2 ã¤ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:87 +#: ../../rst/community/documentation_contributions.rst:101 msgid "The :file:`docs/docsite/requirements.txt` file allows a wide range of versions and may install new releases of required packages. New releases of these packages may cause problems with the Ansible docs build. If you want to install tested versions of these dependencies, use :file:`test/sanity/code-smell/docs-build.requirements.txt` instead, which matches the dependencies used by CI:" msgstr ":file:`docs/docsite/requirements.txt` ファイルã«ã‚ˆã‚Šã€å¹…広ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã§ãã€å¿…è¦ãªãƒ‘ッケージã®æ–°ã—ã„リリースをインストールã§ãã¾ã™ã€‚ã“れらã®ãƒ‘ッケージã®æ–°è¦ãƒªãƒªãƒ¼ã‚¹ã‚’インストールã™ã‚‹ã¨ã€Ansible ドã‚ュメントã®ãƒ“ルドã§å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®ä¾å˜é–¢ä¿‚ã®ãƒ†ã‚¹ãƒˆæ¸ˆã¿ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’インストールã™ã‚‹å ´åˆã¯ã€ä»£ã‚ã‚Šã« CI ã§ä½¿ç”¨ã•ã‚Œã‚‹ä¾å˜é–¢ä¿‚ã¨ä¸€è‡´ã™ã‚‹ :file:`test/sanity/code-smell/docs-build.requirements.txt` を使用ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:96 +#: ../../rst/community/documentation_contributions.rst:110 msgid "You can drop ``--user`` if you have set up a virtual environment (venv/virtenv)." msgstr "仮想環境 (venv/virtenv) ã‚’è¨å®šã—ã¦ã„ã‚‹å ´åˆã¯ã€``--user`` を削除ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:100 +#: ../../rst/community/documentation_contributions.rst:114 msgid "You may need to install these general pre-requisites separately on some systems: - ``gcc`` - ``libyaml`` - ``make`` - ``pyparsing`` - ``six`` On macOS with Xcode, you may need to install ``six`` and ``pyparsing`` with ``--ignore-installed`` to get versions that work with ``sphinx``." msgstr "ã“れらã®ä¸€èˆ¬çš„ãªå‰ææ¡ä»¶ã‚’ã€ä¸€éƒ¨ã®ã‚·ã‚¹ãƒ†ãƒ ã«å€‹åˆ¥ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ãªã„ã¨ã„ã‘ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ ( - ``gcc`` - ``libyaml`` - ``make`` - ``pyparsing`` - ``six``) Xcode を使用ã™ã‚‹ macOS ã§ã¯ã€``--ignore-installed`` 㧠``six`` ãŠã‚ˆã³ ``pyparsing`` を使用ã—ã¦ã€``sphinx`` ã¨é€£æºã™ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å–å¾—ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:110 +#: ../../rst/community/documentation_contributions.rst:124 msgid "After checking out ``ansible/ansible``, make sure the ``docs/docsite/rst`` directory has strict enough permissions. It should only be writable by the owner's account. If your default ``umask`` is not 022, you can use ``chmod go-w docs/docsite/rst`` to set the permissions correctly in your new branch. Optionally, you can set your ``umask`` to 022 to make all newly created files on your system (including those created by ``git clone``) have the correct permissions." msgstr "``ansible/ansible`` ã‚’ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ãŸã‚‰ã€``docs/docsite/rst`` ディレクトリーã«å分ãªãƒ‘ーミッションãŒä»˜ä¸Žã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚所有者ã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã®ã¿ãŒæ›¸ãè¾¼ã¿å¯èƒ½ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。デフォルト㮠``umask`` ㌠022 ã§ã¯ãªã„å ´åˆã¯ã€``chmod go-w docs/docsite/rst`` を使用ã—ã¦æ–°è¦ãƒ–ランãƒã«ãƒ‘ーミッションをæ£ã—ãè¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚å¿…è¦ã«å¿œã˜ã¦ã€``umask`` ã‚’ 022 ã«è¨å®šã—ã¦ã€ã‚·ã‚¹ãƒ†ãƒ ã§æ–°ã«ä½œæˆã•ã‚Œã‚‹ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ« (``git clone`` ãŒä½œæˆã—ãŸãƒ•ã‚¡ã‚¤ãƒ«ã‚’å«ã‚€) ã«æ£ã—ã„パーミッションをè¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:115 +#: ../../rst/community/documentation_contributions.rst:129 msgid "Testing the documentation locally" msgstr "ドã‚ュメントã®ãƒãƒ¼ã‚«ãƒ«ã§ã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/community/documentation_contributions.rst:117 +#: ../../rst/community/documentation_contributions.rst:131 msgid "To test an individual file for rST errors:" msgstr "rST エラーã«å¯¾ã—ã¦å€‹åˆ¥ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’テストã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:124 +#: ../../rst/community/documentation_contributions.rst:138 msgid "Building the documentation locally" msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®ãƒ‰ã‚ュメントã®ãƒ“ルド" -#: ../../rst/community/documentation_contributions.rst:126 +#: ../../rst/community/documentation_contributions.rst:140 msgid "Building the documentation is the best way to check for errors and review your changes. Once `rstcheck` runs with no errors, navigate to ``ansible/docs/docsite`` and then build the page(s) you want to review." msgstr "ドã‚ュメントã®ãƒ“ルドã¯ã€ã‚¨ãƒ©ãƒ¼ã¨å¤‰æ›´ã‚’確èªã™ã‚‹ã®ã«æœ€é©ãªæ–¹æ³•ã§ã™ã€‚エラーãªã—㧠`rstcheck` を実行ã—ãŸã‚‰ã€``ansible/docs/docsite`` ã«ç§»å‹•ã—ã€ç¢ºèªã™ã‚‹ãƒšãƒ¼ã‚¸ã‚’ビルドã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:130 +#: ../../rst/community/documentation_contributions.rst:144 msgid "If building on macOS with Python 3.8 or later, you must use Sphinx >= 2.2.2. See `#6803 <https://github.com/sphinx-doc/sphinx/pull/6879>`_ for details." msgstr "Python 3.8以é™ã‚’使用ã—ã¦macOSã§ãƒ“ルドã™ã‚‹å ´åˆã¯ã€Sphinx> = 2.2.2を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€`#6803 <https://github.com/sphinx-doc/sphinx/pull/6879>`_ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:135 +#: ../../rst/community/documentation_contributions.rst:149 msgid "Building a single rST page" msgstr "å˜ä¸€ã® rST ページã®ãƒ“ルド" -#: ../../rst/community/documentation_contributions.rst:137 +#: ../../rst/community/documentation_contributions.rst:151 msgid "To build a single rST file with the make utility:" msgstr "make ユーティリティーã§å˜ä¸€ã® RST ファイルをビルドã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:149 +#: ../../rst/community/documentation_contributions.rst:163 msgid "This process compiles all the links but provides minimal log output. If you're writing a new page or want more detailed log output, refer to the instructions on :ref:`build_with_sphinx-build`" msgstr "ã“ã®ãƒ—ãƒã‚»ã‚¹ã¯ã™ã¹ã¦ã®ãƒªãƒ³ã‚¯ã‚’コンパイルã—ã¾ã™ãŒã€ãƒã‚°å‡ºåŠ›ã¯æœ€å°é™ã«ãªã‚Šã¾ã™ã€‚æ–°ã—ã„ページを作æˆã™ã‚‹å ´åˆã‚„ã€ã‚ˆã‚Šè©³ç´°ãªãƒã‚°å‡ºåŠ›ãŒå¿…è¦ãªå ´åˆã¯ã€ã€Œ:ref:`build_with_sphinx-build`ã€ã®æ‰‹é †ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:153 +#: ../../rst/community/documentation_contributions.rst:167 msgid "``make htmlsingle`` adds ``rst/`` to the beginning of the path you provide in ``rst=``, so you can't type the filename with autocomplete. Here are the error messages you will see if you get this wrong:" msgstr "``make htmlsingle`` ã¯ã€``rst=`` ã§æä¾›ã•ã‚Œã‚‹ãƒ‘スã®å…ˆé ã« ``rst/`` ã‚’è¿½åŠ ã™ã‚‹ãŸã‚ã€è‡ªå‹•è£œå®Œã§ãƒ•ã‚¡ã‚¤ãƒ«åを入力ã™ã‚‹ã“ã¨ãŒã§ãã¾ã›ã‚“。ã“ã‚ŒãŒé–“é•ã£ã¦ã„ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:155 +#: ../../rst/community/documentation_contributions.rst:169 msgid "If you run ``make htmlsingle`` from the ``docs/docsite/rst/`` directory: ``make: *** No rule to make target `htmlsingle'. Stop.``" msgstr "``docs/docsite/rst/`` ディレクトリーã‹ã‚‰ ``make htmlsingle`` を実行ã—ãŸå ´åˆã¯ã€``make: *** No rule to make target `htmlsingle'. Stop.`` メッセージãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:156 +#: ../../rst/community/documentation_contributions.rst:170 msgid "If you run ``make htmlsingle`` from the ``docs/docsite/`` directory with the full path to your rST document: ``sphinx-build: error: cannot find files ['rst/rst/community/documentation_contributions.rst']``." msgstr "rST ドã‚ュメントã¸ã®å®Œå…¨ãƒ‘スを使用ã—㦠``docs/docsite/`` ディレクトリーã‹ã‚‰ ``make htmlsingle`` を実行ã—ãŸå ´åˆã¯ã€``sphinx-build: error: cannot find files ['rst/rst/community/documentation_contributions.rst']`` メッセージãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:160 +#: ../../rst/community/documentation_contributions.rst:174 msgid "Building all the rST pages" msgstr "ã™ã¹ã¦ã® rST ページã®ãƒ“ルド" -#: ../../rst/community/documentation_contributions.rst:162 +#: ../../rst/community/documentation_contributions.rst:176 msgid "To build all the rST files without any module documentation:" msgstr "モジュールã®ãƒ‰ã‚ュメント以外ã®ã™ã¹ã¦ã® rST ファイルをビルドã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:169 +#: ../../rst/community/documentation_contributions.rst:183 msgid "Building module docs and rST pages" msgstr "モジュールドã‚ュメント㨠rST ページã®ãƒ“ルド" -#: ../../rst/community/documentation_contributions.rst:171 +#: ../../rst/community/documentation_contributions.rst:185 msgid "To build documentation for a few modules included in ``ansible/ansible`` plus all the rST files, use a comma-separated list:" msgstr "``ansible/ansible`` ã«å«ã¾ã‚Œã‚‹ã„ãã¤ã‹ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ã™ã¹ã¦ã® rST ファイルを使用ã—ã¦ãƒ‰ã‚ュメントをビルドã™ã‚‹ã«ã¯ã€ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šãƒªã‚¹ãƒˆã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:177 +#: ../../rst/community/documentation_contributions.rst:191 msgid "To build all the module documentation plus all the rST files:" msgstr "ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントã¨ã™ã¹ã¦ã® rST ファイルをビルドã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:186 +#: ../../rst/community/documentation_contributions.rst:200 msgid "Building rST files with ``sphinx-build``" msgstr "``sphinx-build`` 㧠rST ファイルã®ãƒ“ルド" -#: ../../rst/community/documentation_contributions.rst:188 +#: ../../rst/community/documentation_contributions.rst:202 msgid "Advanced users can build one or more rST files with the sphinx utility directly. ``sphinx-build`` returns misleading ``undefined label`` warnings if you only build a single page, because it does not create internal links. However, ``sphinx-build`` returns more extensive syntax feedback, including warnings about indentation errors and ``x-string without end-string`` warnings. This can be useful, especially if you're creating a new page from scratch. To build a page or pages with ``sphinx-build``:" msgstr "上級ユーザーã¯ã€sphinx ユーティリティーを直接使用ã—㦠1 ã¤ä»¥ä¸Šã® rST ファイルをビルドã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚``sphinx-build`` ã¯ã€å†…部リンクãŒä½œæˆã•ã‚Œãªã„ãŸã‚ã€1 ページã®ã¿ã‚’ビルドã™ã‚‹å ´åˆã¯ã€èª¤è§£ã‚’æ‹›ã ``undefined label`` è¦å‘Šã‚’è¿”ã—ã¾ã™ã€‚ãŸã ã—ã€``sphinx-build`` ã¯ã€ã‚¤ãƒ³ãƒ‡ãƒ³ãƒˆã‚¨ãƒ©ãƒ¼ã‚„ ``x-string without end-string`` è¦å‘Šãªã©ã€ã‚ˆã‚Šåºƒç¯„ãªæ§‹æ–‡ã®ãƒ•ã‚£ãƒ¼ãƒ‰ãƒãƒƒã‚¯ã‚’è¿”ã—ã¾ã™ã€‚ã“ã‚Œã¯ç‰¹ã«ã€ã‚¼ãƒã‹ã‚‰æ–°ã—ã„ページを作æˆã—ã¦ã„ã‚‹å ´åˆã«å½¹ã«ç«‹ã¡ã¾ã™ã€‚``sphinx-build`` ã§ãƒšãƒ¼ã‚¸ã‚’ビルドã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:194 +#: ../../rst/community/documentation_contributions.rst:208 msgid "You can specify filenames, or ``–a`` for all files, or omit both to compile only new/changed files." msgstr "ファイルåを指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã—ã€ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã« ``–a`` を指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã‚‚ã—ãã¯ã€ä¸¡æ–¹ã‚’çœç•¥ã—ã¦æ–°ã—ã„ã¾ãŸã¯å¤‰æ›´ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã ã‘をコンパイルã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:203 +#: ../../rst/community/documentation_contributions.rst:217 msgid "Running the final tests" msgstr "最終テストã®å®Ÿè¡Œ" -#: ../../rst/community/documentation_contributions.rst:205 +#: ../../rst/community/documentation_contributions.rst:219 msgid "When you submit a documentation pull request, automated tests are run. Those same tests can be run locally. To do so, navigate to the repository's top directory and run:" msgstr "ドã‚ュメントã®ãƒ—ルè¦æ±‚ã‚’é€ä¿¡ã™ã‚‹ã¨ã€è‡ªå‹•ãƒ†ã‚¹ãƒˆãŒå®Ÿè¡Œã—ã¾ã™ã€‚åŒã˜ãƒ†ã‚¹ãƒˆã‚’ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã§ãã¾ã™ã€‚ã“れを行ã†ã«ã¯ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®æœ€ä¸Šä½ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ç§»å‹•ã—ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/documentation_contributions.rst:213 +#: ../../rst/community/documentation_contributions.rst:227 msgid "Unfortunately, leftover rST-files from previous document-generating can occasionally confuse these tests. It is therefore safest to run them on a clean copy of the repository, which is the purpose of ``make clean``. If you type these three lines one at a time and manually check the success of each, you do not need the ``&&``." msgstr "ãŸã ã—ã€ä»¥å‰ãƒ‰ã‚ュメントを生æˆã—ãŸæ™‚ã® rST ファイルãŒæ®‹ã£ã¦ã„ã‚‹ã¨ã€ã“ã®ãƒ†ã‚¹ãƒˆã‚’æ··ä¹±ã•ã›ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ãã®ãŸã‚ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ã‚¯ãƒªãƒ¼ãƒ³ã‚³ãƒ”ー上ã§å®Ÿè¡Œã™ã‚‹ã®ãŒæœ€ã‚‚安全ã§ã™ã€‚ã“ã‚ŒãŒã€``make clean`` ã®ç›®çš„ã§ã‚‚ã‚ã‚Šã¾ã™ã€‚ã“ã® 3 ã¤ã®è¡Œã‚’一度㫠1 è¡Œãšã¤å…¥åŠ›ã—ã¦ã€å„è¡ŒãŒæˆåŠŸã—ãŸã“ã¨ã‚’手動ã§ç¢ºèªã™ã‚‹å ´åˆã€``&&`` ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/community/documentation_contributions.rst:216 +#: ../../rst/community/documentation_contributions.rst:230 msgid "Joining the documentation working group" msgstr "ドã‚ュメントワーã‚ンググループã¸ã®å‚åŠ " -#: ../../rst/community/documentation_contributions.rst:218 +#: ../../rst/community/documentation_contributions.rst:232 msgid "The Documentation Working Group (DaWGs) meets weekly on Tuesdays in the Docs chat (using `Matrix <https://matrix.to/#/#docs:ansible.im>`_ or using IRC at `irc.libera.chat <https://libera.chat/>`_). For more information, including links to our agenda and a calendar invite, please visit the `working group page in the community repo <https://github.com/ansible/community/wiki/Docs>`_." msgstr "ドã‚ュメントワーã‚ンググループ (DaWGs)ã¯ã€Docs ãƒãƒ£ãƒƒãƒˆã§ã€æ¯Žé€±ç«æ›œæ—¥ã«é›†ã¾ã£ã¦ã„ã¾ã™(`Matrix <https://matrix.to/#/#docs:ansible.im>`_ã¾ãŸã¯`irc.libera.chat <https://libera.chat/>`_ã®IRCを使用)。è°é¡Œã¸ã®ãƒªãƒ³ã‚¯ã‚„ã€ã‚«ãƒ¬ãƒ³ãƒ€ãƒ¼ã®æ‹›å¾…状ãªã©ã®è©³ç´°ã¯ã€ã€Œ`working group page in the community repo <https://github.com/ansible/community/wiki/Docs>`_ã€ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/community/documentation_contributions.rst:221 +#: ../../rst/community/documentation_contributions.rst:235 msgid ":ref:`More about testing module documentation <testing_module_documentation>`" msgstr ":ref:`More about testing module documentation <testing_module_documentation>`" -#: ../../rst/community/documentation_contributions.rst:223 +#: ../../rst/community/documentation_contributions.rst:237 msgid ":ref:`More about documenting modules <module_documenting>`" msgstr ":ref:`モジュールã®ãƒ‰ã‚ュメント化ã®è©³ç´° <module_documenting>`" @@ -4116,20 +4215,20 @@ msgstr "Ansible ã®è©³ç´°æƒ…å ±:" #: ../../rst/community/getting_started.rst:28 msgid "`Read books <https://www.ansible.com/resources/ebooks>`_." -msgstr "`Read books <https://www.ansible.com/resources/ebooks>`" +msgstr "`Read books <https://www.ansible.com/resources/ebooks>`_。" #: ../../rst/community/getting_started.rst:29 #: ../../rst/community/how_can_I_help.rst:23 msgid "`Get certified <https://www.ansible.com/products/training-certification>`_." -msgstr "`Get certified <https://www.ansible.com/products/training-certification>`" +msgstr "`Get certified <https://www.ansible.com/products/training-certification>`_。" #: ../../rst/community/getting_started.rst:30 msgid "`Attend events <https://www.ansible.com/community/events>`_." -msgstr "`イベントã«å‚åŠ ã™ã‚‹ <https://www.ansible.com/community/events>`_。" +msgstr "`Attend events <https://www.ansible.com/community/events>`_。" #: ../../rst/community/getting_started.rst:31 msgid "`Review getting started guides <https://www.ansible.com/resources/get-started>`_." -msgstr "`スタートガイドを確èªã™ã‚‹ <https://www.ansible.com/resources/get-started>`_。" +msgstr "`Review getting started guides <https://www.ansible.com/resources/get-started>`_。" #: ../../rst/community/getting_started.rst:32 msgid "`Watch videos <https://www.ansible.com/resources/videos>`_ - includes Ansible Automates, AnsibleFest & webinar recordings." @@ -4268,38 +4367,47 @@ msgid "As you become more familiar with how Ansible works, you may be able to fi msgstr "Ansible ã®æ©Ÿèƒ½ã«ã¤ã„ã¦ç†è§£ãŒæ·±ã¾ã‚‹ã¨ã€å•é¡Œã‚’ä¿®æ£ã—ãŸã‚Šã€æ–°ã—ã„機能を自分ã§é–‹ç™ºã—ãŸã‚Šã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚Ansible ã§è¦‹ã¤ã‹ã£ãŸãƒã‚°ã®è§£æ±ºç–を見ã¤ã‘ãŸå ´åˆã‚„ã€è‡ªèº«ãŒä½œæˆã—ãŸæ–°æ©Ÿèƒ½ã‚’何百万人も㮠Ansible ユーザーã¨å…±æœ‰ã—ãŸã„å ´åˆã¯ã€:ref:`development process <community_development_process>` をよãèªã‚“ã§ã€ä½œæˆã—ãŸã‚³ãƒ¼ãƒ‰ã‚’ Ansible ã«å—ã‘入れã¦ã‚‚らã†æ–¹æ³•ã‚’å¦ã‚“ã§ãã ã•ã„。" #: ../../rst/community/how_can_I_help.rst:64 -msgid "Another good way to help is to review pull requests that other Ansible users have submitted. Ansible core keeps a full list of `open pull requests by file <https://ansible.sivel.net/pr/byfile.html>`_, so if a particular module or plugin interests you, you can easily keep track of all the relevant new pull requests and provide testing or feedback. Alternately, you can review the pull requests for any collections that interest you. Click :guilabel:`Issue tracker` on the collection documentation page to find the issues and PRs for that collection." -msgstr "もㆠ1 ã¤ã®å„ªã‚ŒãŸæ–¹æ³•ã¯ã€ä»–ã® Ansible ユーザーãŒé€ä¿¡ã—ãŸãƒ—ルè¦æ±‚を確èªã™ã‚‹ã“ã¨ã§ã™ã€‚Ansible コア㯠`open pull requests by file <https://ansible.sivel.net/pr/byfile.html>`_ ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã‚’ä¿æŒã—ã¦ã„ã‚‹ãŸã‚ã€èˆˆå‘³ã‚’æŒã£ãŸç‰¹å®šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã«é–¢é€£ã™ã‚‹æ–°è¦æ–°è¦ãƒ—ルè¦æ±‚ã‚’ç°¡å˜ã«è¿½è·¡ã—ã¦ã€ãƒ†ã‚¹ãƒˆã‚„フィードãƒãƒƒã‚¯ã‚’æä¾›ã§ãã¾ã™ã€‚ã¾ãŸã€èˆˆå‘³ã®ã‚るコレクションã®ãƒ—ルè¦æ±‚を確èªã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚コレクションã®ãƒ‰ã‚ュメントページ㧠:guilabel:`Issue tracker` をクリックã™ã‚‹ã¨ã€ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® issue ã¨ãƒ—ルè¦æ±‚を見ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "You can also get started with solving GitHub issues labeled with the ``easyfix`` and ``good_first_issue`` labels for:" +msgstr "``easyfix`` 㨠``good_first_issue`` ã®ãƒ©ãƒ™ãƒ«ãŒä»˜ã„㟠GitHub ã®å•é¡Œã®è§£æ±ºã‚’開始ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/community/how_can_I_help.rst:69 +#: ../../rst/community/how_can_I_help.rst:66 +#, python-format +msgid "`Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" +msgstr "`Ansible collections <https://github.com/search?q=user%3Aansible-collections+label%3Aeasyfix%2C%22good+first+issue%22+state%3Aopen&type=Issues>`_" + +#: ../../rst/community/how_can_I_help.rst:72 +msgid "Another good way to help is to review pull requests that other Ansible users have submitted. Ansible core keeps a full list of `open pull requests by file <https://ansible.sivel.net/pr/byfile.html>`_, so if a particular module or plugin interests you, you can easily keep track of all the relevant new pull requests and provide testing or feedback. Alternatively, you can review the pull requests for any collections that interest you. Click :guilabel:`Issue tracker` on the collection documentation page to find the issues and PRs for that collection." +msgstr "もㆠ1 ã¤ã®å„ªã‚ŒãŸæ–¹æ³•ã¯ã€ä»–ã® Ansible ユーザーãŒé€ä¿¡ã—ãŸãƒ—ルè¦æ±‚を確èªã™ã‚‹ã“ã¨ã§ã™ã€‚Ansible コア㯠`open pull requests by file <https://ansible.sivel.net/pr/byfile.html>`_ ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã‚’ä¿æŒã—ã¦ã„ã‚‹ãŸã‚ã€èˆˆå‘³ã‚’æŒã£ãŸç‰¹å®šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã«é–¢é€£ã™ã‚‹æ–°è¦æ–°è¦ãƒ—ルè¦æ±‚ã‚’ç°¡å˜ã«è¿½è·¡ã—ã¦ã€ãƒ†ã‚¹ãƒˆã‚„フィードãƒãƒƒã‚¯ã‚’æä¾›ã§ãã¾ã™ã€‚ã¾ãŸã¯ã€èˆˆå‘³ã®ã‚るコレクションã®ãƒ—ルè¦æ±‚を確èªã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚コレクションã®ãƒ‰ã‚ュメントページ㧠:guilabel:`Issue tracker` をクリックã™ã‚‹ã¨ã€ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® issue ã¨ãƒ—ルè¦æ±‚を見ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#: ../../rst/community/how_can_I_help.rst:77 msgid "Once you have learned about the development process and have contributed code to a collection, we encourage you to become a maintainer of that collection. There are hundreds of modules in dozens of Ansible collections, and the vast majority of them are written and maintained entirely by members of the Ansible community." msgstr "開発プãƒã‚»ã‚¹ã«ã¤ã„ã¦å¦ç¿’ã—ã€ã‚³ãƒ¼ãƒ‰ã‚’コレクションã«æä¾›ã—ãŸã‚‰ã€ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«ãªã‚‹ã‚ˆã†æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚Ansible ã«ã¯æ•°ç™¾ã‚‚ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã‚ã‚Šã€ãã®å¤§éƒ¨åˆ†ã¯ Ansible コミュニティーã®ãƒ¡ãƒ³ãƒãƒ¼ã«ã‚ˆã£ã¦å®Œå…¨ã«è¨˜è¿°ã•ã‚Œã€ç¶æŒã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/how_can_I_help.rst:71 +#: ../../rst/community/how_can_I_help.rst:79 msgid "See :ref:`collection maintainer guidelines <maintainers>` to learn more about the responsibilities of being an Ansible collection maintainer." msgstr "Ansible コレクションメンテナーã¨ã—ã¦ã®è²¬ä»»ã«ã¤ã„ã¦ã€è©³ç´°ã¯ :ref:`collection maintainer guidelines <maintainers>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/how_can_I_help.rst:76 +#: ../../rst/community/how_can_I_help.rst:84 msgid "Join a working group" msgstr "ワーã‚ンググループã¸ã®å‚åŠ " -#: ../../rst/community/how_can_I_help.rst:78 +#: ../../rst/community/how_can_I_help.rst:86 msgid "Working groups are a way for Ansible community members to self-organize around particular topics of interest. We have working groups around various topics. To join or create a working group, please read the :ref:`Ansible Working Groups<working_group_list>`." msgstr "ワーã‚ンググループã¯ã€Ansible コミュニティーã®ãƒ¡ãƒ³ãƒãƒ¼ãŒé–¢å¿ƒã®ã‚る特定ã®ãƒˆãƒ”ックã«ã¤ã„ã¦è‡ªå·±ç·¨æˆã™ã‚‹æ–¹æ³•ã§ã™ã€‚ã•ã¾ã–ã¾ãªãƒˆãƒ”ックã«é–¢ã™ã‚‹ãƒ¯ãƒ¼ã‚ンググループãŒã‚ã‚Šã¾ã™ã€‚ワーã‚ンググループã«å‚åŠ ã™ã‚‹ã‹ã€ã€Œ:ref:`Ansible ワーã‚ンググループ<working_group_list>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/how_can_I_help.rst:82 +#: ../../rst/community/how_can_I_help.rst:90 msgid "Teach Ansible to others" msgstr "Ansible を紹介ã™ã‚‹" -#: ../../rst/community/how_can_I_help.rst:84 +#: ../../rst/community/how_can_I_help.rst:92 msgid "We are working on a standardized `Ansible workshop <https://ansible.github.io/workshops/>`_ that can provide a good hands-on introduction to Ansible usage and concepts." msgstr "ç¾åœ¨ã€Ansible ã®ä½¿ç”¨æ–¹æ³•ã‚„概念をã—ã£ã‹ã‚Šã¨ãƒãƒ³ã‚ºã‚ªãƒ³ã§ç´¹ä»‹ã§ãる標準化ã•ã‚ŒãŸ `Ansible ワークショップ <https://ansible.github.io/workshops/>`_ ã«å–り組んã§ã„ã¾ã™ã€‚" -#: ../../rst/community/how_can_I_help.rst:87 +#: ../../rst/community/how_can_I_help.rst:95 msgid "Social media" msgstr "ソーシャルメディア" -#: ../../rst/community/how_can_I_help.rst:89 +#: ../../rst/community/how_can_I_help.rst:97 msgid "If you like Ansible and just want to spread the good word, feel free to share on your social media platform of choice, and let us know by using ``@ansible`` or ``#ansible``. We'll be looking for you." msgstr "Ansible ãŒå¥½ãã§ã€Ansible ã®è‰¯ã•ã‚’広ã‚ãŸã„æ–¹ã¯ã€ãŠå¥½ããªã‚½ãƒ¼ã‚·ãƒ£ãƒ«ãƒ¡ãƒ‡ã‚£ã‚¢ãƒ—ラットフォームã§æ°—軽ã«ã‚·ã‚§ã‚¢ã—ã¦ãã ã•ã„。コミュニティーメンãƒãƒ¼ãŒæ°—ãŒä»˜ãよã†ã«ã€``@ansible`` ã¾ãŸã¯ ``#ansible`` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" @@ -4320,7 +4428,7 @@ msgid "Welcome to the Ansible Community Guide!" msgstr "Ansible コミュニティーガイドã«ã‚ˆã†ã“ã!" #: ../../rst/community/index.rst:15 -msgid "The purpose of this guide is to teach you everything you need to know about being a contributing member of the Ansible community. All types of contributions are welcome and necessary to Ansible's continued success." +msgid "The purpose of this guide is to teach you everything you need to know about being a contributing member of the Ansible community. All types of contributions are welcome and necessary for Ansible's continued success." msgstr "本ガイドã®ç›®çš„ã¯ã€Ansible コミュニティーã«è²¢çŒ®ã™ã‚‹éš›ã«å¿…è¦ãªçŸ¥è˜ã‚’ã™ã¹ã¦èª¬æ˜Žã™ã‚‹ã“ã¨ã§ã™ã€‚ã‚らゆる種類ã®è²¢çŒ®ãŒã€Ansible ã®ç¶™ç¶šçš„ãªæˆåŠŸã«å¿…è¦ãªã‚‚ã®ã§ã‚ã‚Šã€æ“è¿Žã•ã‚Œã¾ã™ã€‚" #: ../../rst/community/maintainers.rst:5 @@ -4337,7 +4445,7 @@ msgstr "以下ã®æƒ…å ±ã«åŠ ãˆã¦ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ä»¥ä¸‹ã« #: ../../rst/community/maintainers.rst:18 msgid ":ref:`General Ansible community development practices <ansible_community_guide>`" -msgstr ":ref:`General Ansible community development practices <ansible_community_guide>`" +msgstr ":ref:`Ansible コミュニティー開発ã«é–¢ã™ã‚‹ä¸€èˆ¬çš„ãªãƒ—ラクティス <ansible_community_guide>`" #: ../../rst/community/maintainers.rst:19 msgid "Documentation on :ref:`module development <developing_modules>`" @@ -4368,7 +4476,7 @@ msgid "Subscribe to the collection repository they maintain (click :guilabel:`Wa msgstr "ç¶æŒã—ã¦ã„るコレクションリãƒã‚¸ãƒˆãƒªãƒ¼ã«ã‚µãƒ–スクライブã—ã¾ã™ (GitHub ã® :guilabel:`Watch > All activity` をクリック)。" #: ../../rst/community/maintainers_guidelines.rst:19 -msgid "Keep README, development guidelines, and other general collection :ref:`maintainer_documentation` relevant." +msgid "Keep README, development guidelines, and other general collections :ref:`maintainer_documentation` relevant." msgstr "READMEã€é–‹ç™ºã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã€ãŠã‚ˆã³ãã®ä»–ã®ä¸€èˆ¬çš„ãªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ :ref:`maintainer_documentation` ã‚’ç¶æŒã—ã¾ã™ã€‚" #: ../../rst/community/maintainers_guidelines.rst:20 @@ -4384,8 +4492,8 @@ msgid "Address or assign issues to appropriate contributors." msgstr "issue ã«å¯¾å‡¦ã™ã‚‹ã‹ã€é©åˆ‡ãªã‚³ãƒ³ãƒˆãƒªãƒ“ューターã«å‰²ã‚Šå½“ã¦ã¾ã™ã€‚" #: ../../rst/community/maintainers_guidelines.rst:23 -msgid "Release collections." -msgstr "コレクションをリリースã—ã¾ã™ã€‚" +msgid ":ref:`Release collections <Releasing>`." +msgstr ":ref:`Release collections <Releasing>`。" #: ../../rst/community/maintainers_guidelines.rst:24 msgid "Ensure that collections adhere to the `Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_," @@ -4416,7 +4524,7 @@ msgid "How to become a maintainer" msgstr "メンテナーã«ãªã‚‹æ–¹æ³•" #: ../../rst/community/maintainers_guidelines.rst:35 -msgid "A person interested in becoming a maintainer and satisfies the :ref:`requirements<maintainer_requirements>` may either self-nominate or be nominated by another maintainer." +msgid "A person interested in becoming a maintainer and satisfying the :ref:`requirements<maintainer_requirements>` may either self-nominate or be nominated by another maintainer." msgstr "メンテナーã«ãªã‚‹ã“ã¨ã«é–¢å¿ƒãŒã‚ã‚Šã€:ref:`requirements<maintainer_requirements>` を満ãŸã—ã¦ã„ã‚‹å ´åˆã¯ã€è‡ªå·±æŽ¨è–¦ã™ã‚‹ã‹ã€åˆ¥ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«æŽ¨è–¦ã—ã¦ã‚‚らã†ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/community/maintainers_guidelines.rst:37 @@ -4436,7 +4544,7 @@ msgid "Collection contributors and maintainers should also communicate through:" msgstr "コレクションã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターãŠã‚ˆã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã‚‚ã€ä»¥ä¸‹ã‚’通ã˜ã¦ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã‚’図る必è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/maintainers_guidelines.rst:47 -msgid ":ref:`communication_irc` appropriate to their collection, or if none exist, the general community and developer chat channels" +msgid ":ref:`communication_irc` appropriate to their collection, or if none exists, the general community and developer chat channels" msgstr "コレクションã«é©ã—ã¦ã„ã‚‹ :ref:`communication_irc`ã€ã¾ãŸã¯ä½•ã‚‚å˜åœ¨ã—ãªã„å ´åˆã¯ã€ä¸€èˆ¬çš„ãªã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã¨é–‹ç™ºè€…ã®ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒãƒ«" #: ../../rst/community/maintainers_guidelines.rst:48 @@ -4459,203 +4567,239 @@ msgstr "AnsibleFest ãŠã‚ˆã³ãƒãƒ¼ã‚«ãƒ«ã® Meetup" msgid "See :ref:`communication` for more details on these communication channels." msgstr "ã“れらã®é€šä¿¡ãƒãƒ£ãƒ³ãƒãƒ«ã®è©³ç´°ã¯ã€:ref:`communication` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:56 +#: ../../rst/community/maintainers_guidelines.rst:58 +msgid "Establishing working group communication" +msgstr "ワーã‚ンググループã®ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã®ç¢ºç«‹" + +#: ../../rst/community/maintainers_guidelines.rst:60 +msgid "Working groups depend on efficient, real-time communication. Project maintainers can use the following techniques to establish communication for working groups:" +msgstr "ワーã‚ンググループã¯ã€åŠ¹çŽ‡çš„ãªãƒªã‚¢ãƒ«ã‚¿ã‚¤ãƒ ã®ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚プãƒã‚¸ã‚§ã‚¯ãƒˆç®¡ç†è€…ã¯ã€æ¬¡ã®æ‰‹æ³•ã‚’使用ã—ã¦ãƒ¯ãƒ¼ã‚ンググループã®ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã‚’確立ã§ãã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:63 +msgid "Find an existing :ref:`working_group_list` that is similar to your project and join the conversation." +msgstr "ã”自身ã®ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã«ä¼¼ãŸæ—¢å˜ã® :ref:`working_group_list` を検索ã—ã¦ã€ä¼šè©±ã«å‚åŠ ã—ã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:64 +msgid "`Request <https://github.com/ansible/community/blob/main/WORKING-GROUPS.md>`_ a new working group for your project." +msgstr "プãƒã‚¸ã‚§ã‚¯ãƒˆã«å¯¾ã—ã¦æ–°ã—ã„ワーã‚ンググループを `リクエスト <https://github.com/ansible/community/blob/main/WORKING-GROUPS.md>`_ ã—ã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:65 +msgid "`Create <https://hackmd.io/@ansible-community/community-matrix-faq#How-do-I-create-a-public-community-room>`_ a public chat for your working group or `ask <https://github.com/ansible/community/issues/new>`_ the community team." +msgstr "作æ¥ã‚°ãƒ«ãƒ¼ãƒ—ã®å…¬é–‹ãƒãƒ£ãƒƒãƒˆã¾ãŸã¯`ask <https://github.com/ansible/community/issues/new>`_ コミュニティーãƒãƒ¼ãƒ ã‚’ `ä½œæˆ <https://hackmd.io/@ansible-community/community-matrix-faq#How-do-I-create-a-public-community-room>`_ ã—ã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:66 +msgid "Provide working group details and links to chat rooms in the contributor section of your project ``README.md``." +msgstr "プãƒã‚¸ã‚§ã‚¯ãƒˆ ``README.md`` ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターセクションã§ãƒ¯ãƒ¼ã‚ンググループã®è©³ç´°ã¨ãƒãƒ£ãƒƒãƒˆãƒ«ãƒ¼ãƒ ã¸ã®ãƒªãƒ³ã‚¯ã‚’æä¾›ã—ã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:67 +msgid "Encourage contributors to join the chats and add themselves to the working group." +msgstr "コントリビューターã«å¯¾ã—ã¦ãƒãƒ£ãƒƒãƒˆã¸ã®å‚åŠ ã‚„ã€ãƒ¯ãƒ¼ã‚ンググループã¸ã®å‚åŠ ã‚’æŽ¨å¥¨ã—ã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:69 +msgid "See the :ref:`Communication guide <communication_irc>` to learn more about real-time chat." +msgstr "リアルタムã®ãƒãƒ£ãƒƒãƒˆã«é–¢ã™ã‚‹æƒ…å ±ã¯ã€:ref:`Communication guide <communication_irc>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/community/maintainers_guidelines.rst:72 msgid "Community Topics" msgstr "コミュニティートピック" -#: ../../rst/community/maintainers_guidelines.rst:58 +#: ../../rst/community/maintainers_guidelines.rst:74 msgid "The Community and the `Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ asynchronously discuss and vote on the `Community Topics <https://github.com/ansible-community/community-topics/issues>`_ which impact the whole project or its parts including collections and packaging." msgstr "コミュニティー㨠`Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ ã¯ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆå…¨ä½“ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚„パッケージングをå«ã‚€éƒ¨åˆ†ã«å½±éŸ¿ã‚’与ãˆã‚‹ `Community Topics <https://github.com/ansible-community/community-topics/issues>`_ ã«ã¤ã„ã¦ã€éžåŒæœŸçš„ã«è°è«–ã—ã€æŠ•ç¥¨ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:60 +#: ../../rst/community/maintainers_guidelines.rst:76 msgid "Share your opinion and vote on the topics to help the community make the best decisions." msgstr "コミュニティーãŒæœ€é©ãªæ„æ€æ±ºå®šã‚’è¡Œã†ã“ã¨ãŒã§ãるよã†ã«ã€æ„見を共有ã—ã€ãƒˆãƒ”ックã«æŠ•ç¥¨ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:65 +#: ../../rst/community/maintainers_guidelines.rst:81 msgid "Contributor Summits" msgstr "コントリビューターサミット" -#: ../../rst/community/maintainers_guidelines.rst:68 -msgid "The quarterly Ansible Contributor Summit is a global event that provides our contributors a great opportunity to meet each other, communicate, share ideas, and see that there are other real people behind the messages on Matrix or Libera Chat IRC or GitHub. This gives a sense of community. Watch the `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ for information when the next contributor summit, invite contributors you know, and take part in the event together." -msgstr "å››åŠæœŸã”ã¨ã«é–‹å‚¬ã•ã‚Œã‚‹ Ansible コントリビューターサミットã¯ã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューターåŒå£«ãŒå‡ºä¼šã„ã€ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã‚’å–ã‚Šã€ã‚¢ã‚¤ãƒ‡ã‚¢ã‚’共有ã—ã€Matrix/Libera.Chat IRC ã¾ãŸã¯ GitHub ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®èƒŒå¾Œã«ä»–ã®å®Ÿåœ¨ã™ã‚‹äººç‰©ãŒã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹çµ¶å¥½ã®æ©Ÿä¼šã‚’æä¾›ã™ã‚‹ã‚°ãƒãƒ¼ãƒãƒ«ã‚¤ãƒ™ãƒ³ãƒˆã§ã™ã€‚ã“ã‚Œã§ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã®æ„Ÿè¦šã‚’å¾—ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚次ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターサミットã®é–‹å‚¬æƒ…å ±ã‚’ `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã§ç¢ºèªã—ã€çŸ¥ã‚Šåˆã„ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターを招待ã—ã¦ã€å…±ã«ã‚¤ãƒ™ãƒ³ãƒˆã«å‚åŠ ã—ã¦ãã ã•ã„。" +#: ../../rst/community/maintainers_guidelines.rst:83 +msgid "The quarterly Ansible Contributor Summit is a global event that provides our contributors a great opportunity to meet each other, communicate, share ideas, and see that there are other real people behind the messages on Matrix or Libera Chat IRC, or GitHub. This gives a sense of community. Watch the `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ for information when the next contributor summit, invite contributors you know, and take part in the event together." +msgstr "å››åŠæœŸã”ã¨ã«é–‹å‚¬ã•ã‚Œã‚‹ Ansible コントリビューターサミットã¯ã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューターåŒå£«ãŒå‡ºä¼šã„ã€ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã‚’å–ã‚Šã€ã‚¢ã‚¤ãƒ‡ã‚¢ã‚’共有ã—ã€Matrix ã‚„ Libera.Chat IRC ã¾ãŸã¯ GitHub ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®èƒŒå¾Œã«ä»–ã®å®Ÿåœ¨ã™ã‚‹äººç‰©ãŒã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹çµ¶å¥½ã®æ©Ÿä¼šã‚’æä¾›ã™ã‚‹ã‚°ãƒãƒ¼ãƒãƒ«ã‚¤ãƒ™ãƒ³ãƒˆã§ã™ã€‚ã“ã‚Œã§ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã®æ„Ÿè¦šã‚’å¾—ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚次ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターサミットã®é–‹å‚¬æƒ…å ±ã‚’ `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã§ç¢ºèªã—ã€çŸ¥ã‚Šåˆã„ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターを招待ã—ã¦ã€å…±ã«ã‚¤ãƒ™ãƒ³ãƒˆã«å‚åŠ ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:71 +#: ../../rst/community/maintainers_guidelines.rst:86 msgid "Weekly community Matrix/IRC meetings" msgstr "毎週ã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãƒžãƒˆãƒªãƒƒã‚¯ã‚¹/IRC ミーティング" -#: ../../rst/community/maintainers_guidelines.rst:73 -msgid "The Community and the Steering Committee come together at weekly meetings in the ``#ansible-community`` :ref:`Matrix/Libera.Chat <communication_irc>` channel to discuss important project-scale questions. See the `schedule <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ and join." -msgstr "コミュニティー㨠Steering Committee ã¯ã€``#ansible-community`` :ref:`Matrix/Libera.Chat <communication_irc>` ãƒãƒ£ãƒ³ãƒãƒ«ã§æ¯Žé€±ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚’è¡Œã„ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆè¦æ¨¡ã®é‡è¦ãªè³ªå•ã«ã¤ã„ã¦è©±ã—åˆã„ã¾ã™ã€‚`schedule <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ ã‚’å‚ç…§ã—ã¦å‚åŠ ã—ã¦ãã ã•ã„。" +#: ../../rst/community/maintainers_guidelines.rst:88 +msgid "The Community and the Steering Committee come together at weekly meetings in the ``#ansible-community`` `Libera.Chat IRC <https://docs.ansible.com/ansible/devel/community/communication.html#ansible-community-on-irc>`_ channel or in the bridged `#community:ansible.com <https://matrix.to/#/#community:ansible.com>`_ room on `Matrix <https://docs.ansible.com/ansible/devel/community/communication.html#ansible-community-on-matrix>`_ to discuss important project questions. Join us! Here is our `schedule <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_." +msgstr "コミュニティー㨠Steering Committee ã¯ã€`Matrix <https://docs.ansible.com/ansible/devel/community/communication.html#ansible-community-on-matrix>`_ ã«å«ã¾ã‚Œã‚‹ ``#ansible-community`` `Libera.Chat IRC <https://docs.ansible.com/ansible/devel/community/communication.html#ansible-community-on-irc>` ãƒãƒ£ãƒãƒ«ã¾ãŸã¯ãƒ–リッジã•ã‚ŒãŸ `#community:ansible.com <https://matrix.to/#/#community:ansible.com>` ルームã§æ¯Žé€±ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚’è¡Œã„ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆé–¢é€£ã®é‡è¦ãªè³ªå•ã«ã¤ã„ã¦è©±ã—åˆã„ã¾ã™ã®ã§ã€å‚åŠ ã—ã¦ãã ã•ã„。ã“ã¡ã‚‰ãŒ `スケジュール <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ ã§ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:76 +#: ../../rst/community/maintainers_guidelines.rst:91 msgid "Expanding the collection community" msgstr "コレクションコミュニティーã®æ‹¡å¤§" -#: ../../rst/community/maintainers_guidelines.rst:80 +#: ../../rst/community/maintainers_guidelines.rst:95 msgid "If you discover good ways to expand a community or make it more robust, edit this section with your ideas to share with other collection maintainers." msgstr "コミュニティーを拡大ã—ãŸã‚Šã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã‚’ã‚ˆã‚Šå …ç‰¢ã«ã™ã‚‹ãŸã‚ã®è‰¯ã„方法を見ã¤ã‘ãŸå ´åˆã¯ã€ä»–ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¨å…±æœ‰ã™ã‚‹ãŸã‚ã«ã€ã‚¢ã‚¤ãƒ‡ã‚¢ã‚’è¿½åŠ ã—ã¦ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’編集ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:82 +#: ../../rst/community/maintainers_guidelines.rst:97 msgid "Here are some ways you can expand the community around your collection:" msgstr "コレクションをä¸å¿ƒã«ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã‚’拡大ã™ã‚‹æ–¹æ³•ã¯ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:84 +#: ../../rst/community/maintainers_guidelines.rst:99 msgid "Give :ref:`newcomers a positive first experience <collection_new_contributors>`." msgstr ":ref:`æ–°å‚者ã®æœ€åˆã®ã‚¨ã‚¯ã‚¹ãƒšãƒªã‚¨ãƒ³ã‚¹ãŒãƒã‚¸ãƒ†ã‚£ãƒ–ãªã‚‚ã® <collection_new_contributors>` ã«ãªã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:85 +#: ../../rst/community/maintainers_guidelines.rst:100 +msgid "Invite contributors to join :ref:`real-time chats <wg_and_real_time_chat>` related to your project." +msgstr "コントリビューターã«å¯¾ã—ã¦ã€ã”自身ã®ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã«é–¢é€£ã™ã‚‹ :ref:`real-time chats <wg_and_real_time_chat>` ã¸ã®å‚åŠ ã‚’å‹Ÿã‚Šã¾ã™ã€‚" + +#: ../../rst/community/maintainers_guidelines.rst:101 msgid "Have :ref:`good documentation <maintainer_documentation>` with guidelines for new contributors." msgstr "æ–°ã—ã„コントリビューターã®ãŸã‚ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã®ã‚ã‚‹ :ref:`優れãŸãƒ‰ã‚ュメント <maintainer_documentation>` を用æ„ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:86 +#: ../../rst/community/maintainers_guidelines.rst:102 msgid "Make people feel welcome personally and individually." msgstr "一人ã²ã¨ã‚ŠãŒå€‹äººçš„ã«æ“è¿Žã•ã‚Œã¦ã„ã‚‹ã¨æ„Ÿã˜ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:87 +#: ../../rst/community/maintainers_guidelines.rst:103 msgid "Use labels to show easy fixes and leave non-critical easy fixes to newcomers and offer to mentor them." msgstr "ラベルを使用ã—ã¦ç°¡å˜ãªä¿®æ£ã‚’示ã—ã€é‡è¦ã§ã¯ãªã„ç°¡å˜ãªä¿®æ£ã‚’æ–°å‚者ã«ä»»ã›ã¦ã€å½¼ã‚‰ã‚’指導ã™ã‚‹ã“ã¨ã‚’æ案ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:88 +#: ../../rst/community/maintainers_guidelines.rst:104 msgid "Be responsive in issues, PRs and other communication." msgstr "issueã€ãƒ—ルè¦æ±‚ã€ãã®ä»–ã®ã‚³ãƒŸãƒ¥ãƒ‹ã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã«ã™ãã«å¯¾å¿œã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:89 +#: ../../rst/community/maintainers_guidelines.rst:105 msgid "Conduct PR days regularly." msgstr "定期的㫠PR ã®æ—¥ã‚’実施ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:90 +#: ../../rst/community/maintainers_guidelines.rst:106 msgid "Maintain a zero-tolerance policy towards behavior violating the :ref:`code_of_conduct`." msgstr ":ref:`code_of_conduct` ã«é•åã™ã‚‹å‹•ä½œã«å¯¾ã—ã¦ã‚¼ãƒãƒˆãƒ¬ãƒ©ãƒ³ã‚¹ãƒãƒªã‚·ãƒ¼ã‚’ç¶æŒã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:91 +#: ../../rst/community/maintainers_guidelines.rst:107 msgid "Put information about how people can register code of conduct violations in your ``README`` and ``CONTRIBUTING`` files." msgstr "``README`` ãŠã‚ˆã³ ``CONTRIBUTING`` ファイルã«ã€è¡Œå‹•è¦ç¯„é•åを登録ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦ã®æƒ…å ±ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:92 +#: ../../rst/community/maintainers_guidelines.rst:108 msgid "Include quick ways contributors can help and other documentation in your ``README``." msgstr "コントリビューターãŒæ”¯æ´ã§ãã‚‹ç°¡å˜ãªæ–¹æ³•ã‚„ã€ãã®ä»–ã®ãƒ‰ã‚ュメントを ``README`` ã«è¨˜è¼‰ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:93 +#: ../../rst/community/maintainers_guidelines.rst:109 msgid "Add and keep updated the ``CONTRIBUTORS`` and ``MAINTAINERS`` files." msgstr "``CONTRIBUTORS`` ファイルãŠã‚ˆã³ ``MAINTAINERS`` ãƒ•ã‚¡ã‚¤ãƒ«ã‚’è¿½åŠ ã—ã€æœ€æ–°ã®çŠ¶æ…‹ã«ã—ã¦ãŠãã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:94 +#: ../../rst/community/maintainers_guidelines.rst:110 msgid "Create a pinned issue to announce that the collection welcomes new maintainers and contributors." msgstr "固定ã•ã‚ŒãŸå•é¡Œã‚’作æˆã—ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒæ–°ã—ã„メンテナーã¨ã‚³ãƒ³ãƒˆãƒªãƒ“ューターをæ“è¿Žã—ã¦ã„ã‚‹ã“ã¨ã‚’発表ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:95 +#: ../../rst/community/maintainers_guidelines.rst:111 msgid "Look for new maintainers among active contributors." msgstr "アクティブãªã‚³ãƒ³ãƒˆãƒªãƒ“ューターã®ä¸ã‹ã‚‰ã€æ–°ã—ã„メンテナーを探ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:96 +#: ../../rst/community/maintainers_guidelines.rst:112 msgid "Announce that your collection welcomes new maintainers." msgstr "コレクションãŒæ–°ã—ã„メンテナーをæ“è¿Žã—ã¦ã„ã‚‹ã“ã¨ã‚’発表ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:97 +#: ../../rst/community/maintainers_guidelines.rst:113 msgid "Take part and congratulate new maintainers in Contributor Summits." msgstr "コントリビューターサミットã«å‚åŠ ã—ã€æ–°ã—ã„メンテナーをç¥ç¦ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:103 +#: ../../rst/community/maintainers_guidelines.rst:119 msgid "Encouraging new contributors" msgstr "æ–°ã—ã„コントリビューターを奨励ã™ã‚‹" -#: ../../rst/community/maintainers_guidelines.rst:105 -msgid "Easy fix items are the best way to attract and mentor new contributors. You should triage incoming issues to mark them with labels such as ``easyfix``, ``waiting_on_contributor``, and ``docs``. where appropriate. Do not fix these trivial non-critical bugs yourself. Instead, mentor a person who wants to contribute." +#: ../../rst/community/maintainers_guidelines.rst:121 +msgid "Easy-fix items are the best way to attract and mentor new contributors. You should triage incoming issues to mark them with labels such as ``easyfix``, ``waiting_on_contributor``, and ``docs``. where appropriate. Do not fix these trivial non-critical bugs yourself. Instead, mentor a person who wants to contribute." msgstr "ç°¡å˜ãªä¿®æ£é …ç›®ã¯ã€æ–°ã—ã„コントリビューターを引ã付ã‘ã¦æŒ‡å°Žã™ã‚‹ãŸã‚ã®æœ€è‰¯ã®æ–¹æ³•ã§ã™ã€‚å…¥ã£ã¦ãã‚‹ issue をトリアージã—ã¦ã€å¿…è¦ã«å¿œã˜ã¦ ``easyfix``ã€``waiting_on_contributor``ã€ãŠã‚ˆã³ ``docs`` ãªã©ã®ãƒ©ãƒ™ãƒ«ã§ãƒžãƒ¼ã‚¯ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®é‡è¦ã§ã¯ãªã„些細ãªãƒã‚°ã‚’自分ã§ä¿®æ£ã—ãªã„ã§ãã ã•ã„。代ã‚ã‚Šã«ã€è²¢çŒ®ã—ãŸã„人ã«æŒ‡å°Žã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:107 -msgid "For some easy fix issues, you could ask the issue reporter whether they want to fix the issue themselves providing the link to a quickstart guide for creating PRs." +#: ../../rst/community/maintainers_guidelines.rst:123 +msgid "For some easy-fix issues, you could ask the issue reporter whether they want to fix the issue themselves providing the link to a quick start guide for creating PRs." msgstr "ç°¡å˜ã«ä¿®æ£ã§ãã‚‹å•é¡Œã«ã¤ã„ã¦ã¯ã€PR を作æˆã™ã‚‹ãŸã‚ã®ã‚¯ã‚¤ãƒƒã‚¯ã‚¹ã‚¿ãƒ¼ãƒˆã‚¬ã‚¤ãƒ‰ã¸ã®ãƒªãƒ³ã‚¯ã‚’æä¾›ã—ã¦ã€issue を自分ã§ä¿®æ£ã™ã‚‹ã‹ã©ã†ã‹ã‚’ issue レãƒãƒ¼ã‚¿ãƒ¼ã«å°‹ãã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:109 -msgid "Conduct pull request days regularly. You could plan PR days, for example, in the last Friday of every month when you and other maintainers go through all open issues and pull requests focusing on old ones, asking people if you can help, and so on. If there are pull requests that look abandoned (for example, there is no response on your help offers since the previous PR day), announce that anyone else interested can complete the pull request." +#: ../../rst/community/maintainers_guidelines.rst:125 +msgid "Conduct pull request days regularly. You could plan PR days, for example, on the last Friday of every month when you and other maintainers go through all open issues and pull requests focusing on old ones, asking people if you can help, and so on. If there are pull requests that look abandoned (for example, there is no response on your help offers since the previous PR day), announce that anyone else interested can complete the pull request." msgstr "プルリクエストデーを定期的ã«å®Ÿæ–½ã—ã¦ãã ã•ã„。ãŸã¨ãˆã°ã€æ¯Žæœˆã®æœ€çµ‚金曜日㫠PR デーを計画ã—ã€ã‚ãªãŸã¨ä»–ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ãŒã™ã¹ã¦ã®æœªè§£æ±ºã® issue ã‚„å¤ã„ issue ã«ç„¦ç‚¹ã‚’当ã¦ãŸãƒ—ルリクエストã«ç›®ã‚’通ã—ã€æ‰‹ä¼ãˆã‚‹ã‹ã©ã†ã‹ã‚’人々ã«å°‹ãã‚‹ã€ãªã©ã¨ã„ã£ãŸã“ã¨ãŒè€ƒãˆã‚‰ã‚Œã¾ã™ã€‚ã‚‚ã—放置ã•ã‚Œã¦ã„るよã†ãªãƒ—ルリクエストãŒã‚れ㰠(ãŸã¨ãˆã°ã€å‰å›žã®PR デー以é™ã€ã‚ãªãŸãŒãƒ˜ãƒ«ãƒ—ã«å¯¾ã—ã¦åå¿œãŒãªã„å ´åˆãªã©)ã€èˆˆå‘³ã®ã‚る人ãªã‚‰èª°ã§ã‚‚ãã®ãƒ—ルリクエストを完了ã§ãるよã†ã«ã‚¢ãƒŠã‚¦ãƒ³ã‚¹ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:111 -msgid "Promote active contributors satisfying :ref:`requirements<maintainer_requirements>` to maintainers. Revise contributors activity regularly." -msgstr ":ref:`è¦ä»¶<maintainer_requirements>` を満ãŸã™ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ãªã‚³ãƒ³ãƒˆãƒªãƒ“ューターをメンテナーã«æ˜‡é€²ã•ã›ã¾ã™ã€‚コントリビューターã®æ´»å‹•ã‚’定期的ã«è¦‹ç›´ã—ã¾ã™ã€‚" +#: ../../rst/community/maintainers_guidelines.rst:127 +msgid "Promote active contributors satisfying :ref:`requirements<maintainer_requirements>` to maintainers. Revise contributors' activity regularly." +msgstr ":ref:`requirements<maintainer_requirements>` を満ãŸã™ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ãªã‚³ãƒ³ãƒˆãƒªãƒ“ューターをメンテナーã«æ˜‡é€²ã•ã›ã¾ã™ã€‚コントリビューターã®æ´»å‹•ã‚’定期的ã«è¦‹ç›´ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:113 +#: ../../rst/community/maintainers_guidelines.rst:129 msgid "If your collection found new maintainers, announce that fact in the `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ and during the next Contributor Summit congratulating and thanking them for the work done. You can mention all the people promoted since the previous summit. Remember to invite the other maintainers to the Summit in advance." msgstr "コレクションãŒæ–°ã—ã„メンテナーを見ã¤ã‘ãŸå ´åˆã¯ã€`Bullhorn ニュースレター <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ãŠã‚ˆã³æ¬¡å›žã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターサミットã§ãã®ã“ã¨ã‚’アナウンスã—ã€è²¢çŒ®ã—ã¦ãã‚ŒãŸã“ã¨ã‚’ç¥ç¦ã—ã€æ„Ÿè¬ã—ã¾ã™ã€‚å‰å›žã®ã‚µãƒŸãƒƒãƒˆä»¥é™ã«æ˜‡é€²ã—ãŸã™ã¹ã¦ã®äººã«è¨€åŠã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚事å‰ã«ä»–ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã‚’サミットã«æ‹›å¾…ã™ã‚‹ã“ã¨ã‚’忘れãªã„ã§ãã ã•ã„" -#: ../../rst/community/maintainers_guidelines.rst:115 +#: ../../rst/community/maintainers_guidelines.rst:131 msgid "Some other general guidelines to encourage contributors:" msgstr "コントリビューターを奨励ã™ã‚‹ãŸã‚ã®ä»–ã®ä¸€èˆ¬çš„ãªã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’以下ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:117 +#: ../../rst/community/maintainers_guidelines.rst:133 msgid "Welcome the author and thank them for the issue or pull request." msgstr "作æˆè€…ã‚’æ“è¿Žã—ã€issue ã¾ãŸã¯ãƒ—ルè¦æ±‚ã«è¬æ„を示ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:118 +#: ../../rst/community/maintainers_guidelines.rst:134 msgid "If there is a non-crucial easy-fix bug reported, politely ask the author to fix it themselves providing a link to :ref:`collection_quickstart`." msgstr "é‡è¦ã§ã¯ãªã„ç°¡å˜ã«ä¿®æ£ã§ãã‚‹ãƒã‚°ãŒå ±å‘Šã•ã‚ŒãŸå ´åˆã¯ã€ä½œæˆè€…ã«è‡ªåˆ†ã§ä¿®æ£ã™ã‚‹ã‚ˆã†ã«ä¸å¯§ã«ä¾é ¼ã—ã€:ref:`collection_quickstart` ã®ãƒªãƒ³ã‚¯ã‚’æä¾›ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:119 +#: ../../rst/community/maintainers_guidelines.rst:135 msgid "When suggesting changes, try to use questions, not statements." msgstr "変更をæ案ã™ã‚‹å ´åˆã¯ã€æ„見ã§ã¯ãªã質å•ã§å¯¾å¿œã™ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:120 +#: ../../rst/community/maintainers_guidelines.rst:136 msgid "When suggesting mandatory changes, do it as politely as possible providing documentation references." msgstr "å¿…é ˆã®å¤‰æ›´ã‚’æ案ã™ã‚‹å ´åˆã¯ã€å‚照ドã‚ュメントをæ示ã—ã¤ã¤ã€å¯èƒ½ãªé™ã‚Šä¸å¯§ã«è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:121 -msgid "If your suggestion is optional or a matter of personal preferences, please say it explicitly." +#: ../../rst/community/maintainers_guidelines.rst:137 +msgid "If your suggestion is optional or a matter of personal preference, please say it explicitly." msgstr "ä»»æ„ã®æ案やã€å€‹äººã®å¥½ã¿ã«ã‚ˆã‚‹æ案ã¯ã€ãã®æ—¨ã‚’明確ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:122 -msgid "When asking for adding tests or for complex code refactoring, say that the author is welcome to ask for clarifications and help if they need." +#: ../../rst/community/maintainers_guidelines.rst:138 +msgid "When asking for adding tests or for complex code refactoring, say that the author is welcome to ask for clarifications and help if they need it." msgstr "è¿½åŠ ãƒ†ã‚¹ãƒˆã‚„è¤‡é›‘ãªã‚³ãƒ¼ãƒ‰ãƒªãƒ•ã‚¡ã‚¯ã‚¿ãƒªãƒ³ã‚°ã‚’求ã‚ã‚‹å ´åˆã¯ã€ä½œæˆè€…ãŒã•ã‚‰ã«æ˜Žç¢ºãªèª¬æ˜Žã‚„助力をæä¾›ã§ãã‚‹ã“ã«è¨€åŠã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:123 +#: ../../rst/community/maintainers_guidelines.rst:139 msgid "If somebody suggests a good idea, mention it or put a thumbs up." msgstr "誰ã‹ãŒè‰¯ã„アイデアをæ案ã—ã¦ã„ã‚Œã°ã€ãƒ¡ãƒ³ã‚·ãƒ§ãƒ³ã¾ãŸã¯ã‚µãƒ ズアップを行ã„ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:124 +#: ../../rst/community/maintainers_guidelines.rst:140 msgid "After merging, thank the author and reviewers for their time and effort." msgstr "マージã—ãŸå¾Œã€æ™‚é–“ã¨æ‰‹é–“ã‚’ã‹ã‘ã¦å¯¾å¿œã—ãŸä½œæˆè€…ã¨ãƒ¬ãƒ“ュー担当者ã«è¬æ„を示ã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:126 +#: ../../rst/community/maintainers_guidelines.rst:142 msgid "See the :ref:`review_checklist` for a list of items to check before you merge a PR." msgstr "PR をマージã™ã‚‹å‰ã«ç¢ºèªã™ã‚‹é …目一覧ã¯ã€:ref:`review_checklist` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/maintainers_guidelines.rst:131 +#: ../../rst/community/maintainers_guidelines.rst:147 msgid "Maintaining good collection documentation" msgstr "優れãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ‰ã‚ュメントã®ç¶æŒ" -#: ../../rst/community/maintainers_guidelines.rst:133 +#: ../../rst/community/maintainers_guidelines.rst:149 msgid "Maintainers look after the collection documentation to ensure it matches the :ref:`style_guide`. This includes keeping the following documents accurate and updated regularly:" msgstr "メンテナーã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ‰ã‚ュメントを管ç†ã—ã¦ã€:ref:`style_guide` ã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚ã“ã‚Œã«ã¯ã€ä»¥ä¸‹ã®ãƒ‰ã‚ュメントをæ£ç¢ºã«ç¶æŒã—ã€å®šæœŸçš„ã«æ›´æ–°ã™ã‚‹ã“ã¨ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:135 +#: ../../rst/community/maintainers_guidelines.rst:151 msgid "Collection module and plugin documentation that adheres to the :ref:`Ansible documentation format <module_documenting>`." msgstr ":ref:`Ansible documentation format <module_documenting>` ã«æº–æ‹ ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ãƒ—ラグインドã‚ュメント。" -#: ../../rst/community/maintainers_guidelines.rst:136 +#: ../../rst/community/maintainers_guidelines.rst:152 msgid "Collection user guides that follow the :ref:`Collection documentation format <collections_doc_dir>`." msgstr ":ref:`Collection ã®ãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆå½¢å¼ <collections_doc_dir>` ã«å¾“ã†ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚¬ã‚¤ãƒ‰ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:137 +#: ../../rst/community/maintainers_guidelines.rst:153 msgid "Repository files that includes at least a ``README`` and ``CONTRIBUTING`` file." msgstr "å°‘ãªãã¨ã‚‚ ``README`` ãŠã‚ˆã³ ``CONTRIBUTING`` ファイルãŒå«ã¾ã‚Œã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:139 +#: ../../rst/community/maintainers_guidelines.rst:155 msgid "A good ``README`` includes a description of the collection, a link to the :ref:`code_of_conduct`, and details on how to contribute or a pointer to the ``CONTRIBUTING`` file. If your collection is a part of Ansible (is shipped with Ansible package), highlight that fact at the top of the collection's ``README``." msgstr "é©åˆ‡ãª ``README`` ã«ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®èª¬æ˜Žã€:ref:`code_of_conduct` ã¸ã®ãƒªãƒ³ã‚¯ã€ãŠã‚ˆã³è²¢çŒ®ã™ã‚‹æ–¹æ³•ã®è©³ç´°ã¾ãŸã¯ ``CONTRIBUTING`` ファイルã¸ã®ãƒã‚¤ãƒ³ã‚¿ãƒ¼ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚コレクション㌠Ansible ã®ä¸€éƒ¨ (Ansible パッケージã«åŒæ¢±) ã§ã‚ã‚‹å ´åˆã¯ã€ãã®äº‹å®Ÿã‚’コレクション㮠``README`` ã®ä¸Šéƒ¨ã§å¼·èª¿è¡¨ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:141 +#: ../../rst/community/maintainers_guidelines.rst:157 msgid "The ``CONTRIBUTING`` file includes all the details or links to the details on how a new or continuing contributor can contribute to this collection. The ``CONTRIBUTING`` file should include:" msgstr "``CONTRIBUTING`` ファイルã«ã¯ã€æ–°è¦ã¾ãŸã¯ç¶™ç¶šçš„ãªã‚³ãƒ³ãƒˆãƒªãƒ“ューターãŒã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«è²¢çŒ®ã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹ã™ã¹ã¦ã®è©³ç´°ã¾ãŸã¯è©³ç´°ã¸ã®ãƒªãƒ³ã‚¯ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚``CONTRIBUTING`` ファイルã«ã¯ä»¥ä¸‹ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/maintainers_guidelines.rst:143 -msgid "Information or links to new contributor guidelines, such as a quickstart on opening PRs." +#: ../../rst/community/maintainers_guidelines.rst:159 +msgid "Information or links to new contributor guidelines, such as a quick start on opening PRs." msgstr "PR を作æˆã™ã‚‹ãŸã‚ã®ã‚¯ã‚¤ãƒƒã‚¯ã‚¹ã‚¿ãƒ¼ãƒˆãªã©ã€æ–°ã—ã„コントリビューターガイドラインã®æƒ…å ±ã¾ãŸã¯ãƒªãƒ³ã‚¯å…ˆã€‚" -#: ../../rst/community/maintainers_guidelines.rst:144 +#: ../../rst/community/maintainers_guidelines.rst:160 msgid "Information or links to contributor requirements, such as unit and integration test requirements." msgstr "ユニットãŠã‚ˆã³çµ±åˆãƒ†ã‚¹ãƒˆã®è¦ä»¶ãªã©ã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã®è¦ä»¶ã®æƒ…å ±ã¾ãŸã¯ãƒªãƒ³ã‚¯å…ˆã€‚" -#: ../../rst/community/maintainers_guidelines.rst:146 +#: ../../rst/community/maintainers_guidelines.rst:162 msgid "You can optionally include a ``CONTRIBUTORS`` and ``MAINTAINERS`` file to list the collection contributors and maintainers." msgstr "オプションã§ã€``CONTRIBUTORS`` ãŠã‚ˆã³ ``MAINTAINERS`` ãƒ•ã‚¡ã‚¤ãƒ«ã‚’è¿½åŠ ã—ã¦ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターãŠã‚ˆã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã‚’一覧表示ã§ãã¾ã™ã€‚" @@ -4704,11 +4848,11 @@ msgid "Module maintainers" msgstr "モジュールメンテナー" #: ../../rst/community/maintainers_workflow.rst:33 -msgid "Module-scope maintainers exist in collections that have the `collection bot <https://github.com/ansible-community/collection_bot>`_, for example `community.general <https://github.com/ansible-collections/community.general>`_ and `community.network <https://github.com/ansible-collections/community.network>`_." +msgid "Module-scope maintainers exist in collections that have the `collection bot <https://github.com/ansible-community/collection_bot>`_, for example, `community.general <https://github.com/ansible-collections/community.general>`_ and `community.network <https://github.com/ansible-collections/community.network>`_." msgstr "モジュールスコープã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ã€`collection bot <https://github.com/ansible-community/collection_bot>`_ ã®ã‚るコレクションã«å˜åœ¨ã—ã¾ã™ (例: `community.general <https://github.com/ansible-collections/community.general>`_ ãŠã‚ˆã³ `community.network <https://github.com/ansible-collections/community.network>`_)。" #: ../../rst/community/maintainers_workflow.rst:37 -msgid "Being a module maintainer is the stage prior to becoming a collection maintainer. Module maintainers are contributors who are listed in ``.github/BOTMETA.yml``. The scope can be any file (for example, a module or plugin), directory, or repository. Because in most cases the scope is a module or group of modules, we call these contributors module maintainers. The collection bot notifies module maintainers when issues / pull requests related to files they maintain are created." +msgid "Being a module maintainer is the stage prior to becoming a collection maintainer. Module maintainers are contributors who are listed in ``.github/BOTMETA.yml``. The scope can be any file (for example, a module or plugin), directory, or repository. Because in most cases the scope is a module or group of modules, we call these contributors module maintainers. The collection bot notifies module maintainers when issues/pull requests related to files they maintain are created." msgstr "モジュールメンテナーã«ãªã‚‹ã“ã¨ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«ãªã‚‹å‰ã®æ®µéšŽã«ãªã‚Šã¾ã™ã€‚モジュールメンテナーã¯ã€``.github/BOTMETA.yml`` ã«ãƒªã‚¹ãƒˆã•ã‚Œã¦ã„るコントリビューターã§ã™ã€‚スコープã¯ã€ä»»æ„ã®ãƒ•ã‚¡ã‚¤ãƒ« (ãŸã¨ãˆã°ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグイン)ã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã€ã¾ãŸã¯ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã»ã¨ã‚“ã©ã®å ´åˆã€ã‚¹ã‚³ãƒ¼ãƒ—ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚°ãƒ«ãƒ¼ãƒ—ã§ã‚ã‚‹ãŸã‚ã€ã“れらã®ã‚³ãƒ³ãƒˆãƒªãƒ“ューターをモジュールメンテナーã¨å‘¼ã³ã¾ã™ã€‚コレクションボットã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ãŒç¶æŒã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã«é–¢é€£ã™ã‚‹ issue/プルリクエストãŒä½œæˆã•ã‚Œã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«é€šçŸ¥ã—ã¾ã™ã€‚" #: ../../rst/community/maintainers_workflow.rst:39 @@ -4724,8 +4868,8 @@ msgid "Releasing a collection" msgstr "コレクションã®ãƒªãƒªãƒ¼ã‚¹" #: ../../rst/community/maintainers_workflow.rst:50 -msgid "Collection maintainers are responsible for releasing new versions of a collection. Generally, releasing in the collections consists of:" -msgstr "コレクションã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’リリースã™ã‚‹è²¬ä»»ãŒã‚ã‚Šã¾ã™ã€‚通常ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã®ãƒªãƒªãƒ¼ã‚¹ã¯ã€ä»¥ä¸‹ã§æ§‹æˆã•ã‚Œã¾ã™ã€‚" +msgid "Collection maintainers are responsible for releasing new versions of a collection. Generally, releasing a collection consists of:" +msgstr "コレクションã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’リリースã™ã‚‹è²¬ä»»ãŒã‚ã‚Šã¾ã™ã€‚通常ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒªãƒªãƒ¼ã‚¹ã¯ã€ä»¥ä¸‹ã§æ§‹æˆã•ã‚Œã¾ã™ã€‚" #: ../../rst/community/maintainers_workflow.rst:52 msgid "Planning and announcement." @@ -4776,8 +4920,8 @@ msgid "Including a collection in Ansible" msgstr "Ansible ã¸ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®è¿½åŠ " #: ../../rst/community/maintainers_workflow.rst:79 -msgid "If a collection is not included in Ansible (not shipped with Ansible package), maintainers can submit the collection for inclusion by creating a discussion under `ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_. For more information, see the `repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_, and the `Ansible community package collections requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`." -msgstr "コレクション㌠Ansible ã«å«ã¾ã‚Œã¦ã„ãªã„ (Ansible パッケージã«åŒæ¢±ã•ã‚Œã¦ã„ãªã„) å ´åˆã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ã€`ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_ ã®ä¸‹ã«ãƒ‡ã‚£ã‚¹ã‚«ãƒƒã‚·ãƒ§ãƒ³ã‚’作æˆã—ã¦ã€ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’é€ä¿¡ã§ãã¾ã™ã€‚詳細ã¯ã€`repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_ ãŠã‚ˆã³ `Ansible コミュニティーã®ãƒ‘ッケージコレクションã®è¦ä»¶ <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "If a collection is not included in Ansible (not shipped with Ansible package), maintainers can submit the collection for inclusion by creating a discussion under the `ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_. For more information, see the `repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_, and the `Ansible community package collections requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`." +msgstr "コレクション㌠Ansible ã«å«ã¾ã‚Œã¦ã„ãªã„ (Ansible パッケージã«åŒæ¢±ã•ã‚Œã¦ã„ãªã„) å ´åˆã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¯ã€`ansible-collections/ansible-inclusion repository <https://github.com/ansible-collections/ansible-inclusion>`_ ã®ä¸‹ã«ãƒ‡ã‚£ã‚¹ã‚«ãƒƒã‚·ãƒ§ãƒ³ã‚’作æˆã—ã¦ã€ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’é€ä¿¡ã§ãã¾ã™ã€‚詳細ã¯ã€`repository's README <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_ ãŠã‚ˆã³ `Ansible community package collections requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/maintainers_workflow.rst:82 msgid "Stepping down as a collection maintainer" @@ -4788,7 +4932,7 @@ msgid "Times change, and so may your ability to continue as a collection maintai msgstr "時ã¯å¤‰ã‚ã‚Šã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã¨ã—ã¦ç¶šè¡Œã™ã‚‹èƒ½åŠ›ã‚‚変ã‚ã‚Šã¾ã™ã€‚辞任ã™ã‚‹éš›ã¯ä¸€è¨€ãŠçŸ¥ã‚‰ã›ãã ã•ã„。" #: ../../rst/community/maintainers_workflow.rst:86 -msgid "If you feel you don't have time to maintain your collection any more, you should:" +msgid "If you feel you don't have time to maintain your collection anymore, you should:" msgstr "コレクションをç¶æŒã™ã‚‹æ™‚é–“ãŒãªããªã£ãŸã¨æ„Ÿã˜ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/community/maintainers_workflow.rst:88 @@ -5113,7 +5257,7 @@ msgstr "ベータ版ã§ã¯ã€æ©Ÿèƒ½ã®æ出ã¯å—ã‘付ã‘ãªããªã‚Šã¾ã™ã€‚ #: ../../rst/community/release_managers.rst:47 msgid "Release candidates" -msgstr "Release Candidate (リリースã®å€™è£œ)" +msgstr "リリースã®å€™è£œ (Release Candidate)" #: ../../rst/community/release_managers.rst:49 msgid "In a release candidate, we've fixed all known blockers. Any remaining bugfixes are ones that we are willing to leave out of the release. At this point we need user testing to determine if there are any other blocker bugs lurking." @@ -5291,11 +5435,11 @@ msgid "If you are not sure whether a bug is in ansible-core or in a collection, msgstr "ãƒã‚°ãŒ ansible-core ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã©ã¡ã‚‰ã«ã‚ã‚‹ã‹ã‚ã‹ã‚‰ãªã„å ´åˆã¯ã€:ref:`mailing list or community chat channel first <communication>` ã«å‹•ä½œã‚’å ±å‘Šã§ãã¾ã™ã€‚" #: ../../rst/community/reporting_collections.rst:33 -msgid "Before you request a feature, check what is :ref:`planned for future Ansible Releases <roadmaps>`. The best way to get a feature into an Ansible collection is to :ref:`submit a pull request <community_pull_requests>`, either against ansible-core or against a collection. See also :ref:`ansible_collection_merge_requirements`." -msgstr "機能をリクエストã™ã‚‹å‰ã«ã€:ref:`今後㮠Ansible リリースã®äºˆå®š <roadmaps>` を確èªã—ã¦ãã ã•ã„。Ansible コレクションã«æ©Ÿèƒ½ã‚’å–り組むãŸã‚ã®æœ€è‰¯ã®æ–¹æ³•ã¯ã€ansible-core ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã„ãšã‚Œã‹ã«å¯¾ã—㦠:ref:`プルリクエストをé€ä¿¡ <community_pull_requests>` ã™ã‚‹ã“ã¨ã§ã™ã€‚:ref:`ansible_collection_merge_requirements` ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "Before you request a feature, check what is :ref:`planned for future Ansible Releases <roadmaps>`. The best way to get a feature into an Ansible collection is to :ref:`submit a pull request <community_pull_requests>`, either against ansible-core or against a collection. See also the :ref:`ansible_collection_merge_requirements`." +msgstr "機能をリクエストã™ã‚‹å‰ã«ã€:ref:`planned for future Ansible Releases <roadmaps>` を確èªã—ã¦ãã ã•ã„。Ansible コレクションã«æ©Ÿèƒ½ã‚’å–り組むãŸã‚ã®æœ€è‰¯ã®æ–¹æ³•ã¯ã€ansible-core ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã„ãšã‚Œã‹ã«å¯¾ã—㦠:ref:`submit a pull request <community_pull_requests>` ã™ã‚‹ã“ã¨ã§ã™ã€‚:ref:`ansible_collection_merge_requirements` ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/community/reporting_collections.rst:36 -msgid "You can also submit a feature request through opening an issue in the collection repository." +msgid "You can also submit a feature request by opening an issue in the collection repository." msgstr "コレクションリãƒã‚¸ãƒˆãƒªãƒ¼ã§ issue を作æˆã—ã€æ©Ÿèƒ½ãƒªã‚¯ã‚¨ã‚¹ãƒˆã‚’é€ä¿¡ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" #: ../../rst/community/steering/community_steering_committee.rst:5 @@ -5379,6 +5523,7 @@ msgstr "russoz" #: ../../rst/community/steering/community_steering_committee.rst:44 #: ../../rst/community/steering/community_steering_committee.rst:54 #: ../../rst/community/steering/community_steering_committee.rst:56 +#: ../../rst/community/steering/community_steering_committee.rst:58 msgid "2022" msgstr "2022" @@ -5397,7 +5542,7 @@ msgstr "acozine" #: ../../rst/community/steering/community_steering_committee.rst:48 #: ../../rst/community/steering/community_steering_committee.rst:50 #: ../../rst/community/steering/community_steering_committee.rst:52 -#: ../../rst/community/steering/community_steering_committee.rst:58 +#: ../../rst/community/steering/community_steering_committee.rst:60 #: ../../rst/community/steering/steering_committee_past_members.rst:19 msgid "2021" msgstr "2021" @@ -5475,234 +5620,242 @@ msgid "markuman" msgstr "markuman" #: ../../rst/community/steering/community_steering_committee.rst:58 +msgid "Maxwell G" +msgstr "Maxwell G" + +#: ../../rst/community/steering/community_steering_committee.rst:58 +msgid "gotmax23" +msgstr "gotmax23" + +#: ../../rst/community/steering/community_steering_committee.rst:60 msgid "Sorin Sbarnea" msgstr "Sorin Sbarnea" -#: ../../rst/community/steering/community_steering_committee.rst:58 +#: ../../rst/community/steering/community_steering_committee.rst:60 msgid "ssbarnea" msgstr "ssbarnea" -#: ../../rst/community/steering/community_steering_committee.rst:62 +#: ../../rst/community/steering/community_steering_committee.rst:64 msgid "John Barker (`gundalow <https://github.com/gundalow>`_) has been elected by the Committee as its :ref:`chairperson`." msgstr "John Barker (`gundalow <https://github.com/gundalow>`_) ã¯ã€Committee ã«ã‚ˆã‚Š :ref:`ãƒã‚§ã‚¢ãƒ‘ーソン` ã¨ã—ã¦é¸å‡ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:64 +#: ../../rst/community/steering/community_steering_committee.rst:66 msgid "Committee members are selected based on their active contribution to the Ansible Project and its community. See :ref:`community_steering_guidelines` to learn details." msgstr "Committee ã®ãƒ¡ãƒ³ãƒãƒ¼ã¯ã€Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã¨ãã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã¸ã®ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ãªè²¢çŒ®ã«åŸºã¥ã„ã¦é¸å‡ºã•ã‚Œã¾ã™ã€‚詳細ã¯ã€:ref:`community_steering_guidelines` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/community/steering/community_steering_committee.rst:67 +#: ../../rst/community/steering/community_steering_committee.rst:69 msgid "Creating new policy proposals & inclusion requests" msgstr "æ–°ã—ã„ãƒãƒªã‚·ãƒ¼ã®ãƒ—ãƒãƒãƒ¼ã‚¶ãƒ«ã¨ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã®ä½œæˆ" -#: ../../rst/community/steering/community_steering_committee.rst:69 +#: ../../rst/community/steering/community_steering_committee.rst:71 msgid "The Committee uses the `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ to asynchronously discuss with the Community and vote on Community topics in corresponding issues." msgstr "Committee 㯠`community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ を使用ã—ã¦ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã¨éžåŒæœŸã§è°è«–ã—ã€å¯¾å¿œã™ã‚‹ issue ã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã®ãƒˆãƒ”ックã«ã¤ã„ã¦æŠ•ç¥¨ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:71 +#: ../../rst/community/steering/community_steering_committee.rst:73 msgid "You can create a new issue in the `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ as a discussion topic if you want to discuss an idea that impacts any of the following:" msgstr "以下ã®ã„ãšã‚Œã‹ã«å½±éŸ¿ã‚’与ãˆã‚‹ã‚¢ã‚¤ãƒ‡ã‚¢ã«ã¤ã„ã¦è©±ã—åˆã„ãŸã„å ´åˆã¯ã€ãƒ‡ã‚£ã‚¹ã‚«ãƒƒã‚·ãƒ§ãƒ³ã®ãƒˆãƒ”ックã¨ã—ã¦ã€`community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ ã«æ–°ã—ã„ issue を作æˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:74 +#: ../../rst/community/steering/community_steering_committee.rst:76 msgid "Community collection best practices and requirements" msgstr "コミュニティーコレクションã®ãƒ™ã‚¹ãƒˆãƒ—ラクティスãŠã‚ˆã³è¦ä»¶" -#: ../../rst/community/steering/community_steering_committee.rst:75 +#: ../../rst/community/steering/community_steering_committee.rst:77 msgid "Community collection inclusion policy" msgstr "コミュニティーコレクションã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒãƒªã‚·ãƒ¼" -#: ../../rst/community/steering/community_steering_committee.rst:76 +#: ../../rst/community/steering/community_steering_committee.rst:78 msgid "The Community governance" msgstr "コミュニティーガãƒãƒŠãƒ³ã‚¹" -#: ../../rst/community/steering/community_steering_committee.rst:77 +#: ../../rst/community/steering/community_steering_committee.rst:79 msgid "Other proposals of importance that need the Committee's or overall Ansible community attention" msgstr "Committee ã¾ãŸã¯ Ansible コミュニティー全体ã®æ³¨æ„ã‚’å¿…è¦ã¨ã™ã‚‹ãã®ä»–ã®é‡è¦ãªæ案" -#: ../../rst/community/steering/community_steering_committee.rst:80 +#: ../../rst/community/steering/community_steering_committee.rst:82 msgid "To request changes to the inclusion policy and collection requirements:" msgstr "インクルージョンãƒãƒªã‚·ãƒ¼ãŠã‚ˆã³ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³è¦ä»¶ã®å¤‰æ›´ã‚’リクエストã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:82 +#: ../../rst/community/steering/community_steering_committee.rst:84 msgid "Submit a new pull request to the `ansible-collections/overview <https://github.com/ansible-collections/overview>`_ repository." msgstr "`ansible-collections/overview <https://github.com/ansible-collections/overview>`_ リãƒã‚¸ãƒˆãƒªãƒ¼ã«æ–°ã—ã„プルリクエストをé€ä¿¡ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:84 +#: ../../rst/community/steering/community_steering_committee.rst:86 msgid "Create a corresponding issue containing the rationale behind these changes in the `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ repository." msgstr "ã“れらã®å¤‰æ›´ã®èƒŒå¾Œã«ã‚ã‚‹ç†è«–çš„æ ¹æ‹ ã‚’å«ã‚€å¯¾å¿œã™ã‚‹ issue ã‚’ `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ リãƒã‚¸ãƒˆãƒªãƒ¼ã«ä½œæˆã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:86 +#: ../../rst/community/steering/community_steering_committee.rst:88 msgid "To submit new collections for inclusion into the Ansible package:" msgstr "Ansible パッケージã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ç”¨ã®æ–°ã—ã„コレクションをé€ä¿¡ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:88 +#: ../../rst/community/steering/community_steering_committee.rst:90 msgid "Submit the new collection inclusion requests through a new discussion in the `ansible-inclusion <https://github.com/ansible-collections/ansible-inclusion/discussions/new>`_ repository." msgstr "`ansible-inclusion <https://github.com/ansible-collections/ansible-inclusion/discussions/new>`_ リãƒã‚¸ãƒˆãƒªãƒ¼ã®æ–°ã—ã„ディスカッションを通ã˜ã¦ã€æ–°ã—ã„コレクションã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã‚’é€ä¿¡ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:90 +#: ../../rst/community/steering/community_steering_committee.rst:92 msgid "Depending on a topic you want to discuss with the Community and the Committee, as you prepare your proposal, please consider the requirements established by:" msgstr "コミュニティーãŠã‚ˆã³ Committee ã¨è©±ã—åˆã„ãŸã„トピックã«å¿œã˜ã¦ã€æ案を準備ã™ã‚‹éš›ã«ã€ä»¥ä¸‹ã«ã‚ˆã£ã¦ç¢ºç«‹ã•ã‚ŒãŸè¦ä»¶ã‚’考慮ã—ã¦ãã ã•ã„。" -#: ../../rst/community/steering/community_steering_committee.rst:92 +#: ../../rst/community/steering/community_steering_committee.rst:94 msgid ":ref:`code_of_conduct`." -msgstr ":ref:`code_of_conduct`." +msgstr ":ref:`code_of_conduct`。" -#: ../../rst/community/steering/community_steering_committee.rst:93 +#: ../../rst/community/steering/community_steering_committee.rst:95 msgid "`Ansible Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_." -msgstr "`Ansible Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_" +msgstr "`Ansible Collection Requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_。" -#: ../../rst/community/steering/community_steering_committee.rst:94 +#: ../../rst/community/steering/community_steering_committee.rst:96 msgid "`Ansible Collection Inclusion Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_." -msgstr "`Ansible Collection Inclusion Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_" +msgstr "`Ansible Collection Inclusion Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_。" -#: ../../rst/community/steering/community_steering_committee.rst:97 +#: ../../rst/community/steering/community_steering_committee.rst:99 msgid "Community topics workflow" msgstr "コミュニティーã®ãƒˆãƒ”ックワークフãƒãƒ¼" -#: ../../rst/community/steering/community_steering_committee.rst:99 +#: ../../rst/community/steering/community_steering_committee.rst:101 msgid "The Committee uses the `Community-topics workflow <https://github.com/ansible-community/community-topics/blob/main/community_topics_workflow.md>`_ to asynchronously discuss and vote on the `community-topics <https://github.com/ansible-community/community-topics/issues>`_." msgstr "Committee 㯠`Community-topics workflow <https://github.com/ansible-community/community-topics/blob/main/community_topics_workflow.md>`_ を使用ã—ã¦ã€`community-topics <https://github.com/ansible-community/community-topics/issues>`_ ã«ã¤ã„ã¦éžåŒæœŸçš„ã«è°è«–ã—ã€æŠ•ç¥¨ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:101 +#: ../../rst/community/steering/community_steering_committee.rst:103 msgid "The quorum, the minimum number of Committee members who must vote on a topic in order for a decision to be officially made, is half of the whole number of the Committee members. If the quorum number contains a fractional part, it is rounded up to the next whole number. For example, if there are thirteen members currently in the committee, the quorum will be seven." msgstr "æ£å¼ã«æ±ºå®šã‚’下ã™ãŸã‚ã«ãƒˆãƒ”ックã«æŠ•ç¥¨ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ Committee メンãƒãƒ¼ã®æœ€å°æ•°ã§ã‚るクォーラムã¯ã€Committee メンãƒãƒ¼ã®ç·æ•°ã®åŠåˆ†ã§ã™ã€‚クォーラム番å·ã«å°æ•°éƒ¨åˆ†ãŒå«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€æ¬¡ã®æ•´æ•°ã«åˆ‡ã‚Šä¸Šã’られã¾ã™ã€‚ãŸã¨ãˆã°ã€ç¾åœ¨ Committee ã« 13 人ã®ãƒ¡ãƒ³ãƒãƒ¼ãŒã„ã‚‹å ´åˆã€ã‚¯ã‚©ãƒ¼ãƒ©ãƒ 㯠7 人ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:103 +#: ../../rst/community/steering/community_steering_committee.rst:105 msgid "Votes must always have \"no change\" as an option." msgstr "投票ã«ã¯ã€ã‚ªãƒ—ションã¨ã—ã¦å¸¸ã« \"no change\" ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:105 +#: ../../rst/community/steering/community_steering_committee.rst:107 msgid "In case of equal numbers of votes for and against a topic, the chairperson's vote will break the tie. For example, if there are six votes for and six votes against a topic, and the chairperson's vote is among those six which are for the topic, the final decision will be positive. If the chairperson has not voted yet, other members ask them to vote." msgstr "トピックã«å¯¾ã™ã‚‹è³›æˆç¥¨ã¨å対票ãŒåŒæ•°ã®å ´åˆã¯ã€ãƒã‚§ã‚¢ãƒ‘ーソンã®ç¥¨ã«ã‚ˆã‚ŠåŒæ•°ã§ã¯ãªããªã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€ãƒˆãƒ”ックã«è³›æˆ 6 票ã€å対 6 票ãŒã‚ã‚Šã€ãƒã‚§ã‚¢ãƒ‘ーソンã®ç¥¨ãŒè³›æˆ 6 票ã®ä¸ã«ã‚ã‚‹å ´åˆã¯ã€æœ€çµ‚決定ã¯è³›æˆã¨ãªã‚Šã¾ã™ã€‚ãƒã‚§ã‚¢ãƒ‘ーソンãŒã¾ã 投票ã—ã¦ã„ãªã„å ´åˆã¯ã€ä»–ã®ãƒ¡ãƒ³ãƒãƒ¼ãŒæŠ•ç¥¨ã‚’ä¾é ¼ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:107 +#: ../../rst/community/steering/community_steering_committee.rst:109 msgid "For votes with more than two options, one choice must have at least half of the votes. If two choices happen to both have half of the votes, the chairperson's vote will break the tie. If no choice has at least half of the votes, the vote choices have to be adjusted so that a majority can be found for a choice in a new vote." msgstr "3 ã¤ä»¥ä¸Šã®ã‚ªãƒ—ションãŒã‚る投票ã®å ´åˆã€1 ã¤ã®é¸æŠžè‚¢ã«å°‘ãªãã¨ã‚‚åŠåˆ†ã®ç¥¨ãŒå¿…è¦ã§ã™ã€‚2 ã¤ã®é¸æŠžè‚¢ã®ä¸¡æ–¹ã«åŠåˆ†ã®ç¥¨ãŒã‚ã‚‹å ´åˆã€ãƒã‚§ã‚¢ãƒ‘ーソンã®ç¥¨ã«ã‚ˆã‚ŠåŒæ•°ç¥¨ã§ã¯ãªããªã‚Šã¾ã™ã€‚åŠåˆ†ä»¥ä¸Šã®ç¥¨ãŒã‚ã‚‹é¸æŠžè‚¢ãŒãªã„å ´åˆã¯ã€æ–°ã—ã„投票ã§ã€1 ã¤ã®é¸æŠžè‚¢ãŒéŽåŠæ•°ã¨ãªã‚‹ã‚ˆã†ã«ã€æŠ•ç¥¨ã®é¸æŠžè‚¢ã‚’調整ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:110 +#: ../../rst/community/steering/community_steering_committee.rst:112 msgid "Community topics triage" msgstr "コミュニティートピックã®ãƒˆãƒªã‚¢ãƒ¼ã‚¸" -#: ../../rst/community/steering/community_steering_committee.rst:112 +#: ../../rst/community/steering/community_steering_committee.rst:114 msgid "The Committee conducts a triage of `community topics <https://github.com/ansible-community/community-topics/issues>`_ periodically (every three to six months)." msgstr "委員会ã¯å®šæœŸçš„ã« `community topics <https://github.com/ansible-community/community-topics/issues>`_ ã®ãƒˆãƒªã‚¢ãƒ¼ã‚¸ (3 å¹´ã‹ã‚‰ 6 カ月ã¾ã§) を実施ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:114 +#: ../../rst/community/steering/community_steering_committee.rst:116 msgid "The triage goals are:" msgstr "トリアージã®ç›®æ¨™ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:116 +#: ../../rst/community/steering/community_steering_committee.rst:118 msgid "Sparking interest for forgotten topics." msgstr "アクセスã®ãªã„トピックã«å¯¾ã™ã‚‹é–¢å¿ƒã‚’集ã‚ã‚‹" -#: ../../rst/community/steering/community_steering_committee.rst:117 +#: ../../rst/community/steering/community_steering_committee.rst:119 msgid "Identifying and closing irrelevant topics, for example, when the reason of the topic does not exist anymore or the topic is out of the Committee responsibilities scope." msgstr "トピックã®å˜åœ¨æ„義ãŒãªããªã£ãŸå ´åˆã‚„ã€ãƒˆãƒ”ックã®å†…容ãŒå§”員会ã®è²¬ä»»ç¯„囲外ã¨ãªã£ãŸå ´åˆãªã©ã€é–¢é€£ã®ãªã„トピックを特定ã—ã¦çµ‚了ã™ã‚‹" -#: ../../rst/community/steering/community_steering_committee.rst:118 +#: ../../rst/community/steering/community_steering_committee.rst:120 msgid "Identifying and closing topics that the Community are not interested in discussing. As indicators, it can be absence of comments or no activity in comments, at least, for the last six months." msgstr "コミュニティーãŒè°è«–ã—ãªã„トピックを特定ã—ã¦çµ‚了ã™ã‚‹ã€‚éŽåŽ» 6ヶ月間コメントãŒãªã„å ´åˆã‚„ã€ã‚³ãƒ¡ãƒ³ãƒˆå†…ã§æ´»å‹•ãŒãªã„å ´åˆãªã©ã‚’目安ã¨ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:119 +#: ../../rst/community/steering/community_steering_committee.rst:121 msgid "Identifying and closing topics that were solved and implemented but not closed (in this case, such a topic can be closed on the spot with a comment that it has been implemented)." msgstr "解決済ã¿ã€å®Ÿè£…済ã¿ã§ã‚ã‚‹ã«ã‚‚拘らãšçµ‚了ã•ã‚Œã¦ã„ãªã„トピックを特定ã—ã¦çµ‚了ã™ã‚‹ (ã“ã®ã‚ˆã†ãªå ´åˆã«ã¯ã€å®Ÿè£…済ã¿ã¨ã‚³ãƒ¡ãƒ³ãƒˆã‚’ã¤ã‘ã¦ã€ãƒˆãƒ”ックをãã®å ´ã§çµ‚了ã§ãã‚‹ã‚‚ã®ã¨ã™ã‚‹)。" -#: ../../rst/community/steering/community_steering_committee.rst:120 +#: ../../rst/community/steering/community_steering_committee.rst:122 msgid "Identifying topics that have been in pending state for a long time, for example, when it is waiting for actions from someone for several months or when the topics were solved but not implemented." msgstr "数ヶ月間誰ã‹ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã‚’å¾…ã£ã¦ã„ã‚‹å ´åˆã‚„ã€ãƒˆãƒ”ックãŒè§£æ±ºã•ã‚Œã¦ã„ã‚‹ãŒã€å®Ÿè£…ã•ã‚Œã¦ã„ãªã„å ´åˆãªã©ã€é•·æœŸé–“ã€ä¿ç•™çŠ¶æ…‹ã®ãƒˆãƒ”ックを特定ã™ã‚‹ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:122 +#: ../../rst/community/steering/community_steering_committee.rst:124 msgid "A person starting the triage:" msgstr "トリアージを開始ã—ãŸäºº:" -#: ../../rst/community/steering/community_steering_committee.rst:124 +#: ../../rst/community/steering/community_steering_committee.rst:126 msgid "Identifies the topics mentioned above." msgstr "上記ã®ãƒˆãƒ”ックを特定ã™ã‚‹ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:125 +#: ../../rst/community/steering/community_steering_committee.rst:127 msgid "Creates a special triage topic containing an enumerated list of the topics-candidates for closing." msgstr "クãƒãƒ¼ã‚ºã™ã‚‹ãƒˆãƒ”ック候補ã®åˆ—挙リストをå«ã‚€ã€ç‰¹åˆ¥ãªãƒˆãƒªã‚¢ãƒ¼ã‚¸ãƒˆãƒ”ックを作æˆã™ã‚‹ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:126 +#: ../../rst/community/steering/community_steering_committee.rst:128 msgid "Establishes a vote date considering a number of topics, their complexity and comment-history size giving the Community sufficient time to go through and discuss them." msgstr "トピックã®æ•°ã€è¤‡é›‘ã•ã€ã‚³ãƒ¡ãƒ³ãƒˆå±¥æ´ã®ã‚µã‚¤ã‚ºã‚’考慮ã—ã¦æŠ•ç¥¨æ—¥ã‚’è¨å®šã—ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãŒæ¤œè¨Žã—ã¦è°è«–ã™ã‚‹ã®ã«å分ãªæ™‚é–“ã‚’è¨å®šã™ã‚‹ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:127 +#: ../../rst/community/steering/community_steering_committee.rst:129 msgid "The Community and the Committee vote on each topic-candidate listed in the triage topic whether to close it or keep it open." msgstr "コミュニティーãŠã‚ˆã³å§”員会ãŒãƒˆãƒªã‚¢ãƒ¼ã‚¸ãƒˆãƒ”ックã«å«ã¾ã‚Œã‚‹ãƒˆãƒ”ック候補ã”ã¨ã«ã€çµ‚了ã™ã‚‹ã‹ã€ã‚ªãƒ¼ãƒ—ンã®ã¾ã¾ã«ã™ã‚‹ã‹ã®æŠ•ç¥¨ã‚’è¡Œã†ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:130 +#: ../../rst/community/steering/community_steering_committee.rst:132 msgid "Collection inclusion requests workflow" msgstr "コレクションã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã®ãƒ¯ãƒ¼ã‚¯ãƒ•ãƒãƒ¼" -#: ../../rst/community/steering/community_steering_committee.rst:132 +#: ../../rst/community/steering/community_steering_committee.rst:134 msgid "When reviewing community collection `inclusion requests <https://github.com/ansible-collections/ansible-inclusion/discussions>`_, the Committee members check if a collection adheres to the `Community collection requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_." msgstr "コミュニティーコレクション㮠`インクルージョンリクエスト <https://github.com/ansible-collections/ansible-inclusion/discussions>`_ を確èªã™ã‚‹å ´åˆã€Committee メンãƒãƒ¼ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒ `コミュニティーã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³è¦ä»¶ <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst>`_ ã«æº–æ‹ ã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:134 +#: ../../rst/community/steering/community_steering_committee.rst:136 msgid "A Committee member who conducts the inclusion review copies the `Ansible community collection checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_ into a corresponding `discussion <https://github.com/ansible-collections/ansible-inclusion/discussions>`_." msgstr "インクルージョンã®ãƒ¬ãƒ“ューを実行ã™ã‚‹ Committee メンãƒãƒ¼ã¯ã€`Ansible コミュニティーã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒã‚§ãƒƒã‚¯ãƒªã‚¹ãƒˆ <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_ を対応ã™ã‚‹ `ディスカッション <https://github.com/ansible-collections/ansible-inclusion/discussions>`_ ã«ã‚³ãƒ”ーã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:136 +#: ../../rst/community/steering/community_steering_committee.rst:138 msgid "In the course of the review, the Committee member marks items as completed or leaves a comment saying whether the reviewer expects an issue to be addressed or whether it is optional (for example, it could be **MUST FIX:** <what> or **SHOULD FIX:** <what> under an item)." msgstr "レビューã®éŽç¨‹ã§ã€Committee ã®ãƒ¡ãƒ³ãƒãƒ¼ã¯é …ç›®ã«å®Œäº†ã®ãƒžãƒ¼ã‚¯ã‚’付ã‘ã‚‹ã‹ã€ãƒ¬ãƒ“ュー担当者㌠issue ã®è§£æ±ºã‚’期待ã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã€ã¾ãŸã¯ã‚ªãƒ—ションã§ã‚ã‚‹ã‹ã©ã†ã‹ã‚’コメントã§æ®‹ã—ã¾ã™ (ãŸã¨ãˆã°ã€é …ç›®ã®ä¸‹ã§ **MUST FIX:** <what> ã¾ãŸã¯ **SHOULD FIX:** <what> ã¨ãªã‚Šã¾ã™)。" -#: ../../rst/community/steering/community_steering_committee.rst:138 +#: ../../rst/community/steering/community_steering_committee.rst:140 msgid "For a collection to be included in the Ansible community package, the collection:" msgstr "Ansible コミュニティーパッケージã«å«ã‚るコレクションã«ã¯ä»¥ä¸‹ãŒé©ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:140 +#: ../../rst/community/steering/community_steering_committee.rst:142 msgid "MUST be reviewed and approved by at least two persons, where at least one person is a Steering Committee member." msgstr "2 人以上ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒãƒ¬ãƒ“ューã—ã¦æ‰¿èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãã®ã†ã¡ã®å°‘ãªãã¨ã‚‚ 1 人㯠Steering Committee メンãƒãƒ¼ã§ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:141 +#: ../../rst/community/steering/community_steering_committee.rst:143 msgid "For a Non-Steering Committee review to be counted for inclusion, it MUST be checked and approved by *another* Steering Committee member." msgstr "Steering Committee 以外ã®ãƒ¬ãƒ“ューãŒå«ã¾ã‚Œã‚‹ã¨èªã‚られるãŸã‚ã«ã¯ã€*別ã®* Steering Committee メンãƒãƒ¼ã«ã‚ˆã£ã¦ç¢ºèªãŠã‚ˆã³æ‰¿èªã•ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:142 +#: ../../rst/community/steering/community_steering_committee.rst:144 msgid "Reviewers must not be involved significantly in development of the collection. They must declare any potential conflict of interest (for example, being friends/relatives/coworkers of the maintainers/authors, being users of the collection, or having contributed to that collection recently or in the past)." msgstr "レビュー担当者ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®é–‹ç™ºã«å¤§ãã関係ã—ã¦ã¯ã„ã‘ã¾ã›ã‚“。レビュー担当者ã¯ã€ã‚らゆる潜在的ãªåˆ©å®³ã®å¯¾ç«‹ã‚’宣言ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (ãŸã¨ãˆã°ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼/作æˆè€…ã®å‹äººã€è¦ªæˆšã€åŒåƒšã§ã‚ã‚‹å ´åˆã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã§ã‚ã‚‹å ´åˆã€æœ€è¿‘ã¾ãŸã¯éŽåŽ»ã«ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«è²¢çŒ®ã—ãŸã“ã¨ãŒã‚ã‚‹å ´åˆãªã©)。" -#: ../../rst/community/steering/community_steering_committee.rst:144 +#: ../../rst/community/steering/community_steering_committee.rst:146 msgid "After the collection gets two or more Committee member approvals, a Committee member creates a `community topic <https://github.com/ansible-community/community-topics/issues>`_ linked to the corresponding inclusion request. The issue's description says that the collection has been approved by two or more Committee members and establishes a date (a week by default) when the inclusion decision will be considered made. This time period can be used to raise concerns." msgstr "コレクション㌠2 人以上㮠Committee メンãƒãƒ¼ã®æ‰¿èªã‚’å–å¾—ã—ãŸã‚‰ã€1 人㮠Committee メンãƒãƒ¼ãŒã€å¯¾å¿œã™ã‚‹ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã«ãƒªãƒ³ã‚¯ã•ã‚ŒãŸ `コミュニティートピック <https://github.com/ansible-community/community-topics/issues>`_ を作æˆã—ã¾ã™ã€‚issue ã®èª¬æ˜Žã«ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒ 2 人以上㮠Committee メンãƒãƒ¼ã«ã‚ˆã£ã¦æ‰¿èªã•ã‚Œã€ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ã®æ±ºå®šãŒè¡Œã‚れるã¨è¦‹ãªã•ã‚Œã‚‹æ—¥ä»˜ (デフォルトã§ã¯ 1 週間) ãŒè¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®æœŸé–“ã¯ã€æ‡¸å¿µã‚’æèµ·ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:146 +#: ../../rst/community/steering/community_steering_committee.rst:148 msgid "If no objections are raised up to the established date, the inclusion request is considered successfully resolved. In this case, a Committee member:" msgstr "è¨å®šã•ã‚ŒãŸæ—¥ä»˜ã¾ã§ç•°è°ãŒæèµ·ã•ã‚Œãªã‹ã£ãŸå ´åˆã€ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã¯æ£å¸¸ã«è§£æ±ºã•ã‚ŒãŸã¨è¦‹ãªã•ã‚Œã¾ã™ã€‚ã“ã®å ´åˆã€Committee ã®ãƒ¡ãƒ³ãƒãƒ¼ã¯ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:148 +#: ../../rst/community/steering/community_steering_committee.rst:150 msgid "Declares the decision in the topic and in the inclusion request." msgstr "トピックãŠã‚ˆã³ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ãƒªã‚¯ã‚¨ã‚¹ãƒˆã§æ±ºå®šã‚’宣言ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:149 +#: ../../rst/community/steering/community_steering_committee.rst:151 msgid "Moves the request to the ``Resolved reviews`` category." msgstr "リクエストを ``Resolved reviews`` カテゴリーã«ç§»å‹•ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:150 +#: ../../rst/community/steering/community_steering_committee.rst:152 msgid "Adds the collection to the ``ansible.in`` file in a corresponding directory of the `ansible-build-data repository <https://github.com/ansible-community/ansible-build-data>`_." msgstr "`ansible-build-data repository <https://github.com/ansible-community/ansible-build-data>`_ ã®å¯¾å¿œã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã® ``ansible.in`` ファイルã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:151 +#: ../../rst/community/steering/community_steering_committee.rst:153 msgid "Announces the inclusion through the `Bullhorn newsletter <https://github.com/ansible/community/wiki/News#the-bullhorn>`_." msgstr "`Bullhorn ニュースレター <https://github.com/ansible/community/wiki/News#the-bullhorn>`_ ã‹ã‚‰ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ã‚¸ãƒ§ãƒ³ã«ã¤ã„ã¦ç™ºè¡¨ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:152 +#: ../../rst/community/steering/community_steering_committee.rst:154 msgid "Closes the topic." msgstr "トピックを終了ã—ã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:155 +#: ../../rst/community/steering/community_steering_committee.rst:157 msgid "Community Working Group meetings" msgstr "コミュニティーワーã‚ンググループã®ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°" -#: ../../rst/community/steering/community_steering_committee.rst:157 +#: ../../rst/community/steering/community_steering_committee.rst:159 msgid "See the Community Working Group meeting `schedule <https://github.com/ansible/community/blob/main/meetings/README.md#wednesdays>`_. Meeting summaries are posted in the `Community Working Group Meeting Agenda <https://github.com/ansible/community/issues?q=is%3Aopen+label%3Ameeting_agenda+label%3Acommunity+>`_ issue." msgstr "コミュニティーワーã‚ンググループã®ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã® `スケジュール <https://github.com/ansible/community/blob/main/meetings/README.md#wednesdays>`_.を確èªã—ã¦ãã ã•ã„。ミーティングã®ã‚µãƒžãƒªãƒ¼ã¯ã€`コミュニティーã®ãƒ¯ãƒ¼ã‚ンググループã®ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚¢ã‚¸ã‚§ãƒ³ãƒ€ <https://github.com/ansible/community/issues?q=is%3Aopen+label%3Ameeting_agenda+label%3Acommunity+>`_ issue ã«æŠ•ç¨¿ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:161 +#: ../../rst/community/steering/community_steering_committee.rst:163 msgid "Participation in the Community Working Group meetings is optional for Committee members. Decisions on community topics are made asynchronously in the `community-topics <https://github.com/ansible-community/community-topics/issues>`_ repository." msgstr "Committee メンãƒãƒ¼ãŒã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãƒ¯ãƒ¼ã‚ンググループã®ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã«å‚åŠ ã™ã‚‹ã“ã¨ã¯ä»»æ„ã¨ãªã£ã¦ã„ã¾ã™ã€‚コミュニティーã®ãƒˆãƒ”ックã«é–¢ã™ã‚‹æ±ºå®šã¯ã€`community-topics <https://github.com/ansible-community/community-topics/issues>`_ リãƒã‚¸ãƒˆãƒªãƒ¼ã§éžåŒæœŸçš„ã«è¡Œã‚ã‚Œã¾ã™ã€‚" -#: ../../rst/community/steering/community_steering_committee.rst:163 +#: ../../rst/community/steering/community_steering_committee.rst:165 msgid "The meeting minutes can be found at the `fedora meetbot site <https://meetbot.fedoraproject.org/sresults/?group_id=ansible-community&type=channel>`_ and the same is posted to `Ansible Devel Mailing List <https://groups.google.com/g/ansible-devel>`_ after every meeting." msgstr "ミーティングã®è°äº‹éŒ²ã¯ã€`fedora meetbot サイト <https://meetbot.fedoraproject.org/sresults/?group_id=ansible-community&type=channel>`_ ã§ç¢ºèªã§ãã¾ã™ã€‚ã¾ãŸã€ã“ã®è°äº‹éŒ²ã¯ã€ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°çµ‚了後ã¯æ¯Žå›ž `Ansible Devel メーリングリスト <https://groups.google.com/g/ansible-devel>`_ ã«æŠ•ç¨¿ã•ã‚Œã¦ã„ã¾ã™ã€‚" @@ -6563,4 +6716,40 @@ msgstr "本セクションã§ã¯ã€Ansible コミュニティー㮠Steering Com #~ msgid "For details on how Ansibot manages the triage process, please consult the `Ansibot Issue Guide <https://github.com/ansible/ansibullbot/blob/master/ISSUE_HELP.md>`_." #~ msgstr "Ansibot ã«ã‚ˆã‚‹ãƒˆãƒªã‚¢ãƒ¼ã‚¸ãƒ—ãƒã‚»ã‚¹ã®ç®¡ç†æ–¹æ³•ã«é–¢ã™ã‚‹è©³ç´°ã¯ã€ã€Œ`Ansibot å•é¡Œã‚¬ã‚¤ãƒ‰ <https://github.com/ansible/ansibullbot/blob/master/ISSUE_HELP.md>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#~ msgid "If you are going to release the ``community.general`` and ``community.network`` collections, create new ``backport-X`` and ``needs_backport_to_stable_X`` labels in the corresponding repositories. Copy the styles and descriptions from the corresponding existing labels." +#~ msgstr "``community.general`` ãŠã‚ˆã³ ``community.network`` コレクションをリリースã™ã‚‹å ´åˆã¯ã€å¯¾å¿œã™ã‚‹ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«æ–°ã—ã„ ``backport-X`` ãŠã‚ˆã³ ``needs_backport_to_stable_X`` ラベルを作æˆã—ã¾ã™ã€‚対応ã™ã‚‹æ—¢å˜ãƒ©ãƒ™ãƒ«ã‹ã‚‰ã‚¹ã‚¿ã‚¤ãƒ«ãŠã‚ˆã³èª¬æ˜Žã‚’コピーã—ã¾ã™ã€‚" + +#~ msgid "Most changelog entries are ``bugfixes`` or ``minor_changes``. You can also use ``trivial`` for any collection that requires a changelog fragment for each pull request. ``trivial`` changelog fragments are excluded from the changelog output." +#~ msgstr "ã»ã¨ã‚“ã©ã® changelog エントリーã¯ã€``bugfixes`` ã¾ãŸã¯ ``minor_changes`` ã§ã™ã€‚プルè¦æ±‚ã”ã¨ã« changelog フラグメントを必è¦ã¨ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã« ``trivial`` を使用ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚``trivial`` changelog フラグメント㯠changelog 出力ã‹ã‚‰é™¤å¤–ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "`Ansible Lockdown List <https://groups.google.com/forum/#!forum/ansible-lockdown>`_ is for all things related to Ansible Lockdown projects, including DISA STIG automation and CIS Benchmarks." +#~ msgstr "`Ansible Lockdown リスト <https://groups.google.com/forum/#!forum/ansible-lockdown>`_ ã¯ã€DISA STIG オートメーションや CIS ベンãƒãƒžãƒ¼ã‚¯ãªã©ã€Ansible Lockdown プãƒã‚¸ã‚§ã‚¯ãƒˆã«é–¢é€£ã™ã‚‹ã‚‚ã®ã‚’対象ã¨ã—ã¦ã„ã¾ã™ã€‚" + +#~ msgid "edits (so you can fix your typos)" +#~ msgstr "編集（タイプミスを修æ£ã§ãã¾ã™ï¼‰" + +#~ msgid "`Ansible Lockdown Working Group <https://github.com/ansible/community/wiki/Lockdown>`_ (`Security playbooks/roles <https://github.com/ansible/ansible-lockdown>`_) - Matrix: `#lockdown:ansible.com <https://matrix.to:/#/#lockdown:ansible.com>`_ | IRC: ``#ansible-lockdown``" +#~ msgstr "`Ansible Lockdown Working Group <https://github.com/ansible/community/wiki/Lockdown>`_ (`Security playbooks/roles <https://github.com/ansible/ansible-lockdown>`_) - Matrix: `#lockdown:ansible.com <https://matrix.to:/#/#lockdown:ansible.com>`_ | IRC: ``#ansible-lockdown``" + +#~ msgid "You can also look for GitHub issues labeled with the ``easyfix``, ``good_first_issue``, and ``docs`` labels. Add a comment on the GitHub issue to say you are looking at it and to ask for help if you need it." +#~ msgstr "``easyfix``ã€``good_first_issue``ã€``docs`` ã§ãƒ©ãƒ™ãƒ«ä»˜ã‘ã•ã‚ŒãŸ GitHub issue を見ã¤ã‘ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚GitHub issue ã«é–²è¦§ã—ãŸã“ã¨ã‚’示ã™ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã€å¿…è¦ã«å¿œã˜ã¦åŠ©è¨€ã‚’ä¾é ¼ã—ã¦ãã ã•ã„。" + +#~ msgid "You can use the ``-vv`` or ``-vvv`` argument, if you need more detailed output." +#~ msgstr "より詳細ãªå‡ºåŠ›ãŒå¿…è¦ãªå ´åˆã¯ã€``-vv`` 引数ã¾ãŸã¯ ``-vvv`` 引数を使用ã§ãã¾ã™ã€‚" + +#~ msgid "You can also contribute by reviewing open documentation `issues <https://github.com/ansible/ansible/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Adocs>`_ and `PRs <https://github.com/ansible/ansible/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3Adocs>`_. To add a helpful review, please:" +#~ msgstr "é–‹ã„ã¦ã„るドã‚ュメント㮠`å•é¡Œ (issue) <https://github.com/ansible/ansible/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Adocs>`_ ãŠã‚ˆã³ `プルè¦æ±‚ <https://github.com/ansible/ansible/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3Adocs>`_ を確èªã™ã‚‹ã“ã¨ã§è²¢çŒ®ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚å½¹ã«ç«‹ã¤ãƒ¬ãƒ“ãƒ¥ãƒ¼ã‚’è¿½åŠ ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Include a comment - \"looks good to me\" only helps if we know why." +#~ msgstr "「looks good to me (ç§ã«ã¯è‰¯ã•ãã†ã«è¦‹ãˆã‚‹)ã€ã¨ã„ã†ã‚³ãƒ¡ãƒ³ãƒˆã¯ã€ä»–ã®äººã«ã‚‚ãã®ç†ç”±ãŒæ˜Žã‚‰ã‹ãªå ´åˆã«ã®ã¿ä½¿ç”¨ã—ã¦ãã ã•ã„。" + +#~ msgid "For issues, reproduce the problem." +#~ msgstr "å•é¡Œã«ã¤ã„ã¦ã¯ã€å•é¡Œã‚’å†ç¾ã—ã¾ã™ã€‚" + +#~ msgid "For PRs, test the change." +#~ msgstr "プルè¦æ±‚ã«ã¤ã„ã¦ã¯ã€å¤‰æ›´ã‚’テストã—ã¾ã™ã€‚" + +#~ msgid "The Community and the Steering Committee come together at weekly meetings in the ``#ansible-community`` :ref:`Matrix/Libera.Chat <communication_irc>` channel to discuss important project-scale questions. See the `schedule <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ and join." +#~ msgstr "コミュニティー㨠Steering Committee ã¯ã€``#ansible-community`` :ref:`Matrix/Libera.Chat <communication_irc>` ãƒãƒ£ãƒ³ãƒãƒ«ã§æ¯Žé€±ãƒŸãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚’è¡Œã„ã€ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆè¦æ¨¡ã®é‡è¦ãªè³ªå•ã«ã¤ã„ã¦è©±ã—åˆã„ã¾ã™ã€‚`schedule <https://github.com/ansible/community/blob/main/meetings/README.md#schedule>`_ ã‚’å‚ç…§ã—ã¦å‚åŠ ã—ã¦ãã ã•ã„。" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/dev_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/dev_guide.po index 58733fa3..b6abc3e5 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/dev_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/dev_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/dev_guide/ansible_index.rst:5 ../../rst/dev_guide/core_index.rst:5 msgid "Developer Guide" @@ -104,7 +104,7 @@ msgstr ":ref:`Python 開発環境をセットアップ <environment_setup>` ã—ã msgid "I want to :ref:`get started writing a module <developing_modules_general>`." msgstr ":ref:`モジュールã®è¨˜è¿°ã‚’開始 <developing_modules_general>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:40 +#: ../../rst/dev_guide/ansible_index.rst:39 #: ../../rst/dev_guide/core_index.rst:36 msgid "I want to write a specific kind of module:" msgstr "特定ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’作æˆã—ãŸã„ã§ã™ã€‚" @@ -124,98 +124,94 @@ msgid "an :ref:`Amazon module <ansible_collections.amazon.aws.docsite.dev_guide_ msgstr ":ref:`Amazon module <ansible_collections.amazon.aws.docsite.dev_guide_intro>`." #: ../../rst/dev_guide/ansible_index.rst:39 -msgid "an :ref:`OpenStack module <OpenStack_module_development>`." -msgstr ":ref:`OpenStack モジュール <OpenStack_module_development>`" +msgid "an :ref:`oVirt/RHV module <https://github.com/oVirt/ovirt-ansible-collection/blob/master/README-developers.md>`." +msgstr ":ref:`oVirt/RHV module <https://github.com/oVirt/ovirt-ansible-collection/blob/master/README-developers.md>`" #: ../../rst/dev_guide/ansible_index.rst:40 -msgid "an :ref:`oVirt/RHV module <oVirt_module_development>`." -msgstr ":ref:`oVirt/RHV モジュール <oVirt_module_development>`" - -#: ../../rst/dev_guide/ansible_index.rst:41 msgid "a :ref:`VMware module <ansible_collections.community.vmware.docsite.vmware_ansible_devguide>`." msgstr ":ref:`VMware module <ansible_collections.community.vmware.docsite.vmware_ansible_devguide>`" -#: ../../rst/dev_guide/ansible_index.rst:42 +#: ../../rst/dev_guide/ansible_index.rst:41 #: ../../rst/dev_guide/core_index.rst:38 msgid "I want to :ref:`write a series of related modules <developing_modules_in_groups>` that integrate Ansible with a new product (for example, a database, cloud provider, network platform, and so on)." msgstr "Ansible ã‚’æ–°è¦è£½å“ (例: データベースã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ—ラットフォーム) ã¨çµ±åˆã™ã‚‹ :ref:`一連ã®é–¢é€£ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’記述 <developing_modules_in_groups>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:44 +#: ../../rst/dev_guide/ansible_index.rst:43 #: ../../rst/dev_guide/core_index.rst:40 msgid "I want to refine my code:" msgstr "コードを改良ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:46 +#: ../../rst/dev_guide/ansible_index.rst:45 #: ../../rst/dev_guide/core_index.rst:42 msgid "I want to :ref:`debug my module code <debugging_modules>`." msgstr ":ref:`モジュールコードをデãƒãƒƒã‚° <debugging_modules>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:47 +#: ../../rst/dev_guide/ansible_index.rst:46 #: ../../rst/dev_guide/core_index.rst:43 msgid "I want to :ref:`add tests <developing_testing>`." msgstr ":ref:`ãƒ†ã‚¹ãƒˆã‚’è¿½åŠ <developing_testing>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:48 +#: ../../rst/dev_guide/ansible_index.rst:47 #: ../../rst/dev_guide/core_index.rst:44 msgid "I want to :ref:`document my module <module_documenting>`." msgstr ":ref:`モジュールをドã‚ュメント化 <module_documenting>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:49 +#: ../../rst/dev_guide/ansible_index.rst:48 #: ../../rst/dev_guide/core_index.rst:45 msgid "I want to :ref:`document my set of modules for a network platform <documenting_modules_network>`." msgstr ":ref:`ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ—ラットフォームã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚»ãƒƒãƒˆã‚’文書化 <documenting_modules_network>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:50 +#: ../../rst/dev_guide/ansible_index.rst:49 #: ../../rst/dev_guide/core_index.rst:46 msgid "I want to follow :ref:`conventions and tips for clean, usable module code <developing_modules_best_practices>`." msgstr ":ref:`クリーンã§ä½¿ã„ã‚„ã™ã„モジュールコードã®ãŸã‚ã®è¦å‰‡ã¨ãƒ’ント <developing_modules_best_practices>` ã‚’é©ç”¨ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:51 +#: ../../rst/dev_guide/ansible_index.rst:50 #: ../../rst/dev_guide/core_index.rst:47 msgid "I want to :ref:`make sure my code runs on Python 2 and Python 3 <developing_python_3>`." msgstr ":ref:`作æˆã—ãŸã‚³ãƒ¼ãƒ‰ãŒ Python 2 ãŠã‚ˆã³ Python 3 ã§å®Ÿè¡Œã™ã‚‹ <developing_python_3>` よã†ã«ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:53 +#: ../../rst/dev_guide/ansible_index.rst:52 #: ../../rst/dev_guide/core_index.rst:49 msgid "I want to work on other development projects:" msgstr "ä»–ã®é–‹ç™ºãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã§ä½œæ¥ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:55 +#: ../../rst/dev_guide/ansible_index.rst:54 #: ../../rst/dev_guide/core_index.rst:51 msgid "I want to :ref:`write a plugin <developing_plugins>`." msgstr ":ref:`プラグインを記述 <developing_plugins>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:56 +#: ../../rst/dev_guide/ansible_index.rst:55 #: ../../rst/dev_guide/core_index.rst:52 msgid "I want to :ref:`connect Ansible to a new source of inventory <developing_inventory>`." msgstr ":ref:`Ansible ã‚’æ–°ã—ã„インベントリーソースã«æŽ¥ç¶š <developing_inventory>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:57 +#: ../../rst/dev_guide/ansible_index.rst:56 #: ../../rst/dev_guide/core_index.rst:53 msgid "I want to :ref:`deprecate an outdated module <deprecating_modules>`." msgstr ":ref:`å¤ã„モジュールをéžæŽ¨å¥¨ <deprecating_modules>` ã«ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:59 +#: ../../rst/dev_guide/ansible_index.rst:58 #: ../../rst/dev_guide/core_index.rst:55 msgid "I want to contribute back to the Ansible project:" msgstr "Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã«è²¢çŒ®ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:61 +#: ../../rst/dev_guide/ansible_index.rst:60 #: ../../rst/dev_guide/core_index.rst:57 msgid "I want to :ref:`understand how to contribute to Ansible <ansible_community_guide>`." msgstr ":ref:`Ansible ã¸ã®è²¢çŒ®æ–¹æ³•ã‚’ç†è§£ <ansible_community_guide>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:62 +#: ../../rst/dev_guide/ansible_index.rst:61 #: ../../rst/dev_guide/core_index.rst:58 msgid "I want to :ref:`contribute my module or plugin <developing_modules_checklist>`." msgstr ":ref:`モジュールã¾ãŸã¯ãƒ—ラグインã«è²¢çŒ® <developing_modules_checklist>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:63 +#: ../../rst/dev_guide/ansible_index.rst:62 #: ../../rst/dev_guide/core_index.rst:59 msgid "I want to :ref:`understand the license agreement <contributor_license_agreement>` for contributions to Ansible." msgstr "Ansible ã«å‚åŠ ã™ã‚‹ãŸã‚ã® :ref:`使用許諾契約をç†è§£ <contributor_license_agreement>` ã—ãŸã„ã§ã™ã€‚" -#: ../../rst/dev_guide/ansible_index.rst:65 +#: ../../rst/dev_guide/ansible_index.rst:64 #: ../../rst/dev_guide/core_index.rst:61 msgid "If you prefer to read the entire guide, here's a list of the pages in order." msgstr "本ガイドをã™ã¹ã¦èªã‚€å ´åˆã¯ã€ä»¥ä¸‹ã«ç¤ºã™é †ç•ªã§ãƒšãƒ¼ã‚¸ã‚’表示ã—ã¦ãã ã•ã„。" @@ -482,7 +478,7 @@ msgstr "\\ :literal:`galaxy.yml`\\ã€\\ :literal:`\\*.pyc`\\ã€\\ :literal:`\\*. #: ../../rst/dev_guide/collections_galaxy_meta.rst:301 msgid "Mutually exclusive with \\ :literal:`manifest`\\" -msgstr " \\ :literal:`manifest`\\ ã¨ä½µç”¨ã§ãã¾ã›ã‚“。" +msgstr "\\ :literal:`manifest`\\ ã¨ä½µç”¨ã§ãã¾ã›ã‚“。" #: ../../rst/dev_guide/collections_galaxy_meta.rst:307 msgid "manifest |br|" @@ -526,14 +522,16 @@ msgstr "コレクションを開発ã™ã‚‹ã‹ã€ã¾ãŸã¯å¤‰æ›´ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/collections_galaxy_meta.rst:357 #: ../../rst/dev_guide/developing_api.rst:40 -#: ../../rst/dev_guide/developing_inventory.rst:475 -#: ../../rst/dev_guide/developing_plugins.rst:544 +#: ../../rst/dev_guide/developing_inventory.rst:505 +#: ../../rst/dev_guide/developing_plugins.rst:548 +#: ../../rst/dev_guide/sidecar.rst:95 #: ../../rst/dev_guide/testing_units_modules.rst:571 msgid ":ref:`developing_modules_general`" msgstr ":ref:`developing_modules_general`" #: ../../rst/dev_guide/collections_galaxy_meta.rst:358 -#: ../../rst/dev_guide/developing_plugins.rst:545 +#: ../../rst/dev_guide/developing_plugins.rst:549 +#: ../../rst/dev_guide/sidecar.rst:96 msgid "Learn about how to write Ansible modules" msgstr "Ansible モジュールã®ä½œæˆæ–¹æ³•ã«ã¤ã„ã¦" @@ -542,7 +540,7 @@ msgstr "Ansible モジュールã®ä½œæˆæ–¹æ³•ã«ã¤ã„ã¦" #: ../../rst/dev_guide/developing_collections_changelogs.rst:75 #: ../../rst/dev_guide/developing_collections_contributing.rst:58 #: ../../rst/dev_guide/developing_collections_creating.rst:54 -#: ../../rst/dev_guide/developing_collections_distributing.rst:397 +#: ../../rst/dev_guide/developing_collections_distributing.rst:399 #: ../../rst/dev_guide/developing_collections_migrating.rst:129 #: ../../rst/dev_guide/developing_collections_shared.rst:87 msgid ":ref:`collections`" @@ -552,7 +550,7 @@ msgstr ":ref:`collections`" #: ../../rst/dev_guide/developing_collections_changelogs.rst:76 #: ../../rst/dev_guide/developing_collections_contributing.rst:59 #: ../../rst/dev_guide/developing_collections_creating.rst:55 -#: ../../rst/dev_guide/developing_collections_distributing.rst:398 +#: ../../rst/dev_guide/developing_collections_distributing.rst:400 #: ../../rst/dev_guide/developing_collections_migrating.rst:130 #: ../../rst/dev_guide/developing_collections_shared.rst:88 msgid "Learn how to install and use collections." @@ -563,29 +561,31 @@ msgstr "コレクションã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ–¹æ³•ãŠã‚ˆã³ä½¿ç”¨æ–¹æ³•ã¯ã“ #: ../../rst/dev_guide/developing_collections_changelogs.rst:79 #: ../../rst/dev_guide/developing_collections_contributing.rst:62 #: ../../rst/dev_guide/developing_collections_creating.rst:58 -#: ../../rst/dev_guide/developing_collections_distributing.rst:401 +#: ../../rst/dev_guide/developing_collections_distributing.rst:403 #: ../../rst/dev_guide/developing_collections_migrating.rst:133 #: ../../rst/dev_guide/developing_collections_shared.rst:91 #: ../../rst/dev_guide/developing_collections_structure.rst:290 #: ../../rst/dev_guide/developing_collections_testing.rst:96 #: ../../rst/dev_guide/developing_core.rst:19 #: ../../rst/dev_guide/developing_modules.rst:48 -#: ../../rst/dev_guide/developing_plugins.rst:546 +#: ../../rst/dev_guide/developing_plugins.rst:550 +#: ../../rst/dev_guide/sidecar.rst:97 msgid "`Mailing List <https://groups.google.com/group/ansible-devel>`_" -msgstr "`メーリングリスト <https://groups.google.com/group/ansible-devel>`_" +msgstr "`Mailing List <https://groups.google.com/group/ansible-devel>`_" #: ../../rst/dev_guide/collections_galaxy_meta.rst:362 #: ../../rst/dev_guide/developing_collections.rst:47 #: ../../rst/dev_guide/developing_collections_changelogs.rst:80 #: ../../rst/dev_guide/developing_collections_contributing.rst:63 #: ../../rst/dev_guide/developing_collections_creating.rst:59 -#: ../../rst/dev_guide/developing_collections_distributing.rst:402 +#: ../../rst/dev_guide/developing_collections_distributing.rst:404 #: ../../rst/dev_guide/developing_collections_migrating.rst:134 #: ../../rst/dev_guide/developing_collections_shared.rst:92 #: ../../rst/dev_guide/developing_collections_structure.rst:291 #: ../../rst/dev_guide/developing_collections_testing.rst:97 #: ../../rst/dev_guide/developing_core.rst:20 -#: ../../rst/dev_guide/developing_plugins.rst:547 +#: ../../rst/dev_guide/developing_plugins.rst:551 +#: ../../rst/dev_guide/sidecar.rst:98 msgid "The development mailing list" msgstr "開発メーリングリスト" @@ -714,8 +714,8 @@ msgid "Once you edit the code or arguments in the exploded tree, use the ``execu msgstr "展開ã•ã‚ŒãŸãƒ„リーã®ã‚³ãƒ¼ãƒ‰ã¾ãŸã¯å¼•æ•°ã‚’編集ã—ãŸã‚‰ã€``execute`` サブコマンドを使用ã—ã¦ã“れを実行ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/debugging.rst:97 -msgid "This subcommand inserts the absolute path to ``debug_dir`` as the first item in ``sys.path`` and invokes the script using the arguments in the ``args`` file. You can continue to run the module like this until you understand the problem. Then you can copy the changes back into your real module file and test that the real module works via ``ansible`` or ``ansible-playbook``." -msgstr "ã“ã®ã‚µãƒ–コマンドã¯ã€``sys.path`` ã®æœ€åˆã®é …ç›®ã¨ã—㦠``debug_dir`` ã«çµ¶å¯¾ãƒ‘スを挿入ã—ã€``args`` ファイルã®å¼•æ•°ã‚’使用ã—ã¦ã‚¹ã‚¯ãƒªãƒ—トを呼ã³å‡ºã—ã¾ã™ã€‚å•é¡Œã‚’ç†è§£ã™ã‚‹ã¾ã§ã€ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Ÿè¡Œã‚’継続ã§ãã¾ã™ã€‚変更を実際ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚³ãƒ”ーã—ã€å®Ÿéš›ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒ ``ansible`` ã¾ãŸã¯ ``ansible-playbook`` ã§å‹•ä½œã™ã‚‹ã“ã¨ã‚’テストã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "This subcommand inserts the absolute path to ``debug_dir`` as the first item in ``sys.path`` and invokes the script using the arguments in the ``args`` file. You can continue to run the module like this until you understand the problem. Then you can copy the changes back into your real module file and test that the real module works by using the ``ansible`` or ``ansible-playbook``." +msgstr "ã“ã®ã‚µãƒ–コマンドã¯ã€``sys.path`` ã®æœ€åˆã®é …ç›®ã¨ã—㦠``debug_dir`` ã«çµ¶å¯¾ãƒ‘スを挿入ã—ã€``args`` ファイルã®å¼•æ•°ã‚’使用ã—ã¦ã‚¹ã‚¯ãƒªãƒ—トを呼ã³å‡ºã—ã¾ã™ã€‚å•é¡Œã‚’把æ¡ã™ã‚‹ã¾ã§ã€ã“ã®ã‚ˆã†ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Ÿè¡Œã‚’継続ã§ãã¾ã™ã€‚次ã«ã€å¤‰æ›´ã‚’実際ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚³ãƒ”ーã—ã€å®Ÿéš›ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒ ``ansible`` ã¾ãŸã¯ ``ansible-playbook`` ã§å‹•ä½œã™ã‚‹ã“ã¨ã‚’テストã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/debugging.rst:103 msgid "Simple debugging" @@ -744,15 +744,11 @@ msgstr "Python API" #: ../../rst/dev_guide/developing_api.rst:7 #: ../../rst/dev_guide/developing_inventory.rst:17 #: ../../rst/dev_guide/developing_modules_best_practices.rst:9 -#: ../../rst/dev_guide/testing_compile.rst:9 #: ../../rst/dev_guide/testing_httptester.rst:7 #: ../../rst/dev_guide/testing_integration.rst:9 -#: ../../rst/dev_guide/testing_integration_legacy.rst:9 -#: ../../rst/dev_guide/testing_pep8.rst:9 #: ../../rst/dev_guide/testing_sanity.rst:9 #: ../../rst/dev_guide/testing_units.rst:14 #: ../../rst/dev_guide/testing_units_modules.rst:11 -#: ../../rst/dev_guide/testing_validate-modules.rst:9 msgid "Topics" msgstr "トピック" @@ -781,7 +777,7 @@ msgid "This example is a simple demonstration that shows how to minimally run a msgstr "ã“ã®ä¾‹ã¯ã€ã„ãã¤ã‹ã®ã‚¿ã‚¹ã‚¯ã‚’最å°é™ã«å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã‚’示ã™ç°¡å˜ãªãƒ‡ãƒ¢ã§ã™ã€‚" #: ../../rst/dev_guide/developing_api.rst:31 -msgid "Ansible emits warnings and errors via the display object, which prints directly to stdout, stderr and the Ansible log." +msgid "Ansible emits warnings and errors through the display object, which prints directly to stdout, stderr and the Ansible log." msgstr "Ansible ã¯ã€è¡¨ç¤ºã‚ªãƒ–ジェクトを介ã—ã¦è¦å‘Šã¨ã‚¨ãƒ©ãƒ¼ã‚’出力ã—ã¾ã™ã€‚標準出力 (stdout)ã€æ¨™æº–エラー (stderr)ã€Ansible ãƒã‚°ã«ç›´æŽ¥å‡ºåŠ›ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_api.rst:33 @@ -789,7 +785,8 @@ msgid "The source code for the ``ansible`` command line tools (``lib/ansible/cli msgstr "``ansible`` コマンドラインツールã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ (``lib/ansible/cli/``) 㯠`GitHub ã§åˆ©ç”¨ <https://github.com/ansible/ansible/tree/devel/lib/ansible/cli>`_ ã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_api.rst:38 -#: ../../rst/dev_guide/developing_plugins.rst:542 +#: ../../rst/dev_guide/developing_plugins.rst:546 +#: ../../rst/dev_guide/sidecar.rst:93 msgid ":ref:`developing_inventory`" msgstr ":ref:`developing_inventory`" @@ -803,23 +800,23 @@ msgstr "モジュール開発を始ã‚ã‚‹" #: ../../rst/dev_guide/developing_api.rst:42 #: ../../rst/dev_guide/developing_core.rst:17 -#: ../../rst/dev_guide/developing_inventory.rst:477 +#: ../../rst/dev_guide/developing_inventory.rst:507 msgid ":ref:`developing_plugins`" msgstr ":ref:`developing_plugins`" #: ../../rst/dev_guide/developing_api.rst:43 -#: ../../rst/dev_guide/developing_inventory.rst:478 +#: ../../rst/dev_guide/developing_inventory.rst:508 msgid "How to develop plugins" msgstr "プラグインã®é–‹ç™ºæ–¹æ³•" #: ../../rst/dev_guide/developing_api.rst:44 -#: ../../rst/dev_guide/developing_inventory.rst:481 +#: ../../rst/dev_guide/developing_inventory.rst:511 #: ../../rst/dev_guide/testing_units_modules.rst:579 msgid "`Development Mailing List <https://groups.google.com/group/ansible-devel>`_" msgstr "`Development Mailing List <https://groups.google.com/group/ansible-devel>`_" #: ../../rst/dev_guide/developing_api.rst:45 -#: ../../rst/dev_guide/developing_inventory.rst:482 +#: ../../rst/dev_guide/developing_inventory.rst:512 #: ../../rst/dev_guide/testing_units_modules.rst:580 msgid "Mailing list for development topics" msgstr "開発トピックã®ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆ" @@ -829,14 +826,15 @@ msgstr "開発トピックã®ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆ" #: ../../rst/dev_guide/developing_collections_changelogs.rst:81 #: ../../rst/dev_guide/developing_collections_contributing.rst:64 #: ../../rst/dev_guide/developing_collections_creating.rst:60 -#: ../../rst/dev_guide/developing_collections_distributing.rst:403 +#: ../../rst/dev_guide/developing_collections_distributing.rst:405 #: ../../rst/dev_guide/developing_collections_migrating.rst:135 #: ../../rst/dev_guide/developing_collections_shared.rst:93 #: ../../rst/dev_guide/developing_collections_structure.rst:292 #: ../../rst/dev_guide/developing_collections_testing.rst:98 -#: ../../rst/dev_guide/developing_inventory.rst:483 +#: ../../rst/dev_guide/developing_inventory.rst:513 #: ../../rst/dev_guide/developing_modules.rst:50 -#: ../../rst/dev_guide/developing_plugins.rst:548 +#: ../../rst/dev_guide/developing_plugins.rst:552 +#: ../../rst/dev_guide/sidecar.rst:99 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" @@ -845,14 +843,15 @@ msgstr ":ref:`communication_irc`" #: ../../rst/dev_guide/developing_collections_changelogs.rst:82 #: ../../rst/dev_guide/developing_collections_contributing.rst:65 #: ../../rst/dev_guide/developing_collections_creating.rst:61 -#: ../../rst/dev_guide/developing_collections_distributing.rst:404 +#: ../../rst/dev_guide/developing_collections_distributing.rst:406 #: ../../rst/dev_guide/developing_collections_migrating.rst:136 #: ../../rst/dev_guide/developing_collections_shared.rst:94 #: ../../rst/dev_guide/developing_collections_structure.rst:293 #: ../../rst/dev_guide/developing_collections_testing.rst:99 -#: ../../rst/dev_guide/developing_inventory.rst:484 +#: ../../rst/dev_guide/developing_inventory.rst:514 #: ../../rst/dev_guide/developing_modules.rst:51 -#: ../../rst/dev_guide/developing_plugins.rst:549 +#: ../../rst/dev_guide/developing_plugins.rst:553 +#: ../../rst/dev_guide/sidecar.rst:100 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -1030,7 +1029,7 @@ msgstr "最åˆã® 2 ã¤ã®ã‚ªãƒ—ションã®å ´åˆã€Ansible ã¯å¤‰æ›´ãƒã‚°ã®è #: ../../rst/dev_guide/developing_collections_changelogs.rst:73 msgid ":ref:`collection_changelogs`" -msgstr ":ref:`collections`" +msgstr ":ref:`collection_changelogs`" #: ../../rst/dev_guide/developing_collections_changelogs.rst:74 msgid "Learn how to create good changelog fragments." @@ -1256,12 +1255,12 @@ msgid "Building your collection tarball" msgstr "コレクション tarball ã®ãƒ“ルド" #: ../../rst/dev_guide/developing_collections_distributing.rst:24 -#: ../../rst/dev_guide/developing_collections_distributing.rst:289 +#: ../../rst/dev_guide/developing_collections_distributing.rst:291 msgid "Preparing to publish your collection" msgstr "コレクション公開ã®æº–å‚™" #: ../../rst/dev_guide/developing_collections_distributing.rst:25 -#: ../../rst/dev_guide/developing_collections_distributing.rst:356 +#: ../../rst/dev_guide/developing_collections_distributing.rst:358 msgid "Publishing your collection" msgstr "コレクションã®å…¬é–‹" @@ -1378,7 +1377,7 @@ msgid "setting a server in configuration by creating a :ref:`GALAXY_SERVER` sett msgstr ":file:`ansible.cfg` ファイルã¸ã® :ref:`GALAXY_SERVER` è¨å®šã®ä½œæˆã«ã‚ˆã‚‹ã‚³ãƒ³ãƒ•ã‚£ã‚®ãƒ¥ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã§ã®ã‚µãƒ¼ãƒãƒ¼ã®è¨å®š" #: ../../rst/dev_guide/developing_collections_distributing.rst:111 -#: ../../rst/dev_guide/style_guide/index.rst:222 +#: ../../rst/dev_guide/style_guide/index.rst:224 #: ../../rst/shared_snippets/installing_collections_git_repo.txt:10 msgid "For example:" msgstr "例:" @@ -1400,190 +1399,190 @@ msgid "Run ``ansible-galaxy collection build`` from inside the top-level directo msgstr "コレクションã®æœ€ä¸Šä½ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã®ä¸ã‹ã‚‰``ansible-galaxy collection build`` を実行ã—ã¾ã™ã€‚例ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_distributing.rst:135 -msgid "This command builds a tarball of the collection in the current directory, which you can upload to your selected distribution server::" +msgid "This command builds a tarball of the collection in the current directory, which you can upload to your selected distribution server:" msgstr "ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã«ã‚ˆã‚Šã€ç¾åœ¨ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® tarball ãŒãƒ“ルドã•ã‚Œã¾ã™ã€‚ã“れを希望ã™ã‚‹é…信サーãƒãƒ¼ã«ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:144 +#: ../../rst/dev_guide/developing_collections_distributing.rst:146 msgid "To reduce the size of collections, certain files and folders are excluded from the collection tarball by default. See :ref:`ignoring_files_and_folders_collections` if your collection directory contains other files you want to exclude." msgstr "コレクションã®ã‚µã‚¤ã‚ºã‚’å°ã•ãã™ã‚‹ãŸã‚ã«ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®tarballã‹ã‚‰ç‰¹å®šã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚„フォルダãŒé™¤å¤–ã•ã‚Œã¦ã„ã¾ã™ã€‚コレクションディレクトリã«é™¤å¤–ã—ãŸã„ä»–ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€:ref:`ignoring_files_and_folders_collections` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:145 +#: ../../rst/dev_guide/developing_collections_distributing.rst:147 msgid "The current Galaxy maximum tarball size is 2 MB." msgstr "ç¾åœ¨ã® Galaxy ã® tarball ã®æœ€å¤§ã‚µã‚¤ã‚ºã¯ 2 MB ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:147 +#: ../../rst/dev_guide/developing_collections_distributing.rst:149 msgid "You can upload your tarball to one or more distribution servers. You can also distribute your collection locally by copying the tarball to install your collection directly on target systems." msgstr "tarballã¯ã€1ã¤ã¾ãŸã¯è¤‡æ•°ã®é…信サーãƒãƒ¼ã«ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ãƒãƒ¼ã‚«ãƒ«ã«é…布ã™ã‚‹ã«ã¯ã€tarballをコピーã—ã¦ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚·ã‚¹ãƒ†ãƒ ã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’直接インストールã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:153 +#: ../../rst/dev_guide/developing_collections_distributing.rst:155 msgid "Ignoring files and folders" msgstr "ファイルやフォルダーを無視ã™ã‚‹" -#: ../../rst/dev_guide/developing_collections_distributing.rst:155 +#: ../../rst/dev_guide/developing_collections_distributing.rst:157 msgid "You can exclude files from your collection with either :ref:`build_ignore <build_ignore>` or :ref:`manifest_directives`. For more information on the :file:`galaxy.yml` file, see :ref:`collections_galaxy_meta`." msgstr ":ref:`build_ignore <build_ignore>` ã¾ãŸã¯ :ref:`manifest_directives` ã®ã„ãšã‚Œã‹ã‚’使用ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‹ã‚‰ãƒ•ã‚¡ã‚¤ãƒ«ã‚’除外ã§ãã¾ã™ã€‚:file:`galaxy.yml` ファイルã®è©³ç´°ã¯ã€ :ref:`collections_galaxy_meta` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:161 +#: ../../rst/dev_guide/developing_collections_distributing.rst:163 msgid "Include all, with explicit ignores" msgstr "明示的ã«ç„¡è¦–ã—ã¦ã™ã¹ã¦ã‚’å«ã‚ã‚‹" -#: ../../rst/dev_guide/developing_collections_distributing.rst:163 +#: ../../rst/dev_guide/developing_collections_distributing.rst:165 msgid "By default the build step includes all the files in the collection directory in the tarball except for the following:" msgstr "デフォルトã§ã¯ã€ãƒ“ルドステップã§ã¯ã€tarball内ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ã‚ã‚‹ã€ä»¥ä¸‹ã‚’除ãã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:165 +#: ../../rst/dev_guide/developing_collections_distributing.rst:167 msgid "``galaxy.yml``" msgstr "``galaxy.yml``" -#: ../../rst/dev_guide/developing_collections_distributing.rst:166 +#: ../../rst/dev_guide/developing_collections_distributing.rst:168 msgid "``*.pyc``" msgstr "``*.pyc``" -#: ../../rst/dev_guide/developing_collections_distributing.rst:167 +#: ../../rst/dev_guide/developing_collections_distributing.rst:169 msgid "``*.retry``" msgstr "``*.retry``" -#: ../../rst/dev_guide/developing_collections_distributing.rst:168 +#: ../../rst/dev_guide/developing_collections_distributing.rst:170 msgid "``tests/output``" msgstr "``tests/output``" -#: ../../rst/dev_guide/developing_collections_distributing.rst:169 +#: ../../rst/dev_guide/developing_collections_distributing.rst:171 msgid "previously built tarballs in the root directory" msgstr "ルートディレクトリーã«ä»¥å‰ã«ãƒ“ルドã•ã‚ŒãŸtarball" -#: ../../rst/dev_guide/developing_collections_distributing.rst:170 +#: ../../rst/dev_guide/developing_collections_distributing.rst:172 msgid "various version control directories such as ``.git/``" msgstr "``.git/`` ãªã©ã®ã•ã¾ã–ã¾ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç®¡ç†ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼" -#: ../../rst/dev_guide/developing_collections_distributing.rst:172 +#: ../../rst/dev_guide/developing_collections_distributing.rst:174 msgid "To exclude other files and folders from your collection tarball, set a list of file glob-like patterns in the ``build_ignore`` key in the collection's ``galaxy.yml`` file. These patterns use the following special characters for wildcard matching:" msgstr "コレクションã®tarballã‹ã‚‰ä»–ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŠã‚ˆã³ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’除外ã™ã‚‹ã«ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® ``galaxy.yml`` ファイル㮠``build_ignore`` ã‚ーã«ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚°ãƒãƒ–ã®ã‚ˆã†ãªãƒ‘ターンã®ä¸€è¦§ã‚’è¨å®šã—ã¾ã™ã€‚ã“れらã®ãƒ‘ターンã¯ãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã®ä¸€è‡´ã«ä»¥ä¸‹ã®ç‰¹æ®Šæ–‡å—を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:174 +#: ../../rst/dev_guide/developing_collections_distributing.rst:176 msgid "``*``: Matches everything" msgstr "``*``: ã™ã¹ã¦ã«ä¸€è‡´ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:175 +#: ../../rst/dev_guide/developing_collections_distributing.rst:177 msgid "``?``: Matches any single character" msgstr "``?``: ä»»æ„ã®å˜ä¸€æ–‡å—ã«ä¸€è‡´ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:176 +#: ../../rst/dev_guide/developing_collections_distributing.rst:178 msgid "``[seq]``: Matches any character in sequence" msgstr "``[seq]``:ä»»æ„ã®é€£ç¶šã—ãŸæ–‡å—ã«ä¸€è‡´ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:177 +#: ../../rst/dev_guide/developing_collections_distributing.rst:179 msgid "``[!seq]``:Matches any character not in sequence" msgstr "``[!seq]``:連続ã—ã¦ã„ãªã„ä»»æ„ã®æ–‡å—ã«ä¸€è‡´ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:179 +#: ../../rst/dev_guide/developing_collections_distributing.rst:181 msgid "For example, to exclude the :file:`sensitive` folder within the ``playbooks`` folder as well any ``.tar.gz`` archives, set the following in your ``galaxy.yml`` file:" msgstr "ãŸã¨ãˆã°ã€``playbooks`` ディレクトリー内㮠:file:`sensitive` ディレクトリーや ``.tar.gz`` アーカイブを除外ã™ã‚‹å ´åˆã¯ã€``galaxy.yml`` ファイルã«ä»¥ä¸‹ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:188 +#: ../../rst/dev_guide/developing_collections_distributing.rst:190 msgid "The ``build_ignore`` feature is only supported with ``ansible-galaxy collection build`` in Ansible 2.10 or newer." msgstr "``build_ignore`` 機能ã¯ã€Ansible 2.10 以é™ã®``ansible-galaxy collection build`` ã§ã®ã¿ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:194 +#: ../../rst/dev_guide/developing_collections_distributing.rst:196 msgid "Manifest Directives" msgstr "マニフェストディレクティブ" -#: ../../rst/dev_guide/developing_collections_distributing.rst:198 +#: ../../rst/dev_guide/developing_collections_distributing.rst:200 msgid "The :file:`galaxy.yml` file supports manifest directives that are historically used in Python packaging, as described in `MANIFEST.in commands <https://packaging.python.org/en/latest/guides/using-manifest-in/#manifest-in-commands>`_." msgstr ":file:`galaxy.yml` ファイルã¯ã€`MANIFEST.in commands <https://packaging.python.org/en/latest/guides/using-manifest-in/#manifest-in-commands>`_ ã§èª¬æ˜Žã•ã‚Œã¦ã„るよã†ã«ã€Python パッケージã§ã“ã‚Œã¾ã§ä½¿ç”¨ã•ã‚Œã¦ã„ãŸãƒžãƒ‹ãƒ•ã‚§ã‚¹ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:201 +#: ../../rst/dev_guide/developing_collections_distributing.rst:203 msgid "The use of ``manifest`` requires installing the optional ``distlib`` Python dependency." msgstr "``manifest`` を使用ã™ã‚‹ã«ã¯ã€ã‚ªãƒ—ション㮠``distlib`` Python ä¾å˜é–¢ä¿‚をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:204 +#: ../../rst/dev_guide/developing_collections_distributing.rst:206 msgid "The ``manifest`` feature is only supported with ``ansible-galaxy collection build`` in ``ansible-core`` 2.14 or newer, and is mutually exclusive with ``build_ignore``." msgstr "``manifest`` 機能ã¯ã€``ansible-core`` 2.14 以é™ã® ``ansible-galaxy collection build`` ã§ã®ã¿ã‚µãƒãƒ¼ãƒˆã•ã‚Œã€``build_ignore`` ã¨åˆã‚ã›ã¦ä½¿ç”¨ã§ãã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:206 +#: ../../rst/dev_guide/developing_collections_distributing.rst:208 msgid "For example, to exclude the :file:`sensitive` folder within the ``playbooks`` folder as well as any ``.tar.gz`` archives, set the following in your :file:`galaxy.yml` file:" msgstr "ãŸã¨ãˆã°ã€``playbooks`` ディレクトリー内㮠:file:`sensitive` ディレクトリーや ``.tar.gz`` アーカイブを除外ã™ã‚‹å ´åˆã¯ã€:file:`galaxy.yml` ファイルã«ä»¥ä¸‹ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:215 +#: ../../rst/dev_guide/developing_collections_distributing.rst:217 msgid "By default, the ``MANIFEST.in`` style directives would exclude all files by default, but there are default directives in place. Those default directives are described below. To see the directives in use during build, pass ``-vvv`` with the ``ansible-galaxy collection build`` command." msgstr "デフォルトã§ã¯ã€``MANIFEST.in`` スタイルã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’除外ã—ã¾ã™ãŒã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ãŒé…ç½®ã•ã‚Œã¦ã„ã¾ã™ã€‚ã“れらã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ã«ã¤ã„ã¦ä»¥ä¸‹ã§èª¬æ˜Žã—ã¾ã™ã€‚ビルド時ã«ä½¿ç”¨ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を表示ã™ã‚‹ã«ã¯ã€``ansible-galaxy collection build`` コマンド㧠``-vvv`` を指定ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:249 +#: ../../rst/dev_guide/developing_collections_distributing.rst:251 msgid "``<namespace>-<name>-*.tar.gz`` is expanded with the actual ``namespace`` and ``name``." msgstr "``<namespace>-<name>-*.tar.gz`` ã¯ã€å®Ÿéš›ã® ``namespace`` ãŠã‚ˆã³ ``name`` ã§å±•é–‹ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:251 +#: ../../rst/dev_guide/developing_collections_distributing.rst:253 msgid "The ``manifest.directives`` supplied in :file:`galaxy.yml` are inserted after the default includes and before the default excludes." msgstr ":file:`galaxy.yml` ã§æŒ‡å®šã•ã‚Œã‚‹ ``manifest.directives`` ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® includes ãŠã‚ˆã³ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® excludes ã®å‰ã«æŒ¿å…¥ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:253 +#: ../../rst/dev_guide/developing_collections_distributing.rst:255 msgid "To enable the use of manifest directives without supplying your own, insert either ``manifest: {}`` or ``manifest: null`` in the :file:`galaxy.yml` file and remove any use of ``build_ignore``." msgstr "独自ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を指定ã›ãšã«ãƒžãƒ‹ãƒ•ã‚§ã‚¹ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を使用ã§ãるよã†ã«ã™ã‚‹ã«ã¯ã€ï¼šfile:`galaxy.yml` ファイル㫠``manifest: {}`` ã¾ãŸã¯ ``manifest: null`` を挿入ã—ã€ä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹ ``build_ignore`` を削除ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:255 +#: ../../rst/dev_guide/developing_collections_distributing.rst:257 msgid "If the default manifest directives do not meet your needs, you can set ``manifest.omit_default_directives`` to a value of ``true`` in :file:`galaxy.yml`. You then must specify a full compliment of manifest directives in :file:`galaxy.yml`. The defaults documented above are a good starting point." msgstr "デフォルトã®ãƒžãƒ‹ãƒ•ã‚§ã‚¹ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ãŒè¦ä»¶ã«åˆã‚ãªã„å ´åˆã«ã¯ã€:file:`galaxy.yml` 㧠``manifest.omit_default_directives`` ã®å€¤ã‚’ ``true`` ã«æŒ‡å®šã§ãã¾ã™ã€‚次㫠:file:`galaxy.yml` ã§å®Œå…¨ã«è£œå®Œã—ãŸãƒžãƒ‹ãƒ•ã‚§ã‚¹ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚出発点ã¨ã—ã¦ã€ä¸Šè¨˜ã«è¨˜è¼‰ã•ã‚Œã¦ã„るよã†ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’使用ã™ã‚‹ã“ã¨ãŒé©åˆ‡ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:257 +#: ../../rst/dev_guide/developing_collections_distributing.rst:259 msgid "Below is an example where the default directives are not included." msgstr "以下ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ãŒå«ã¾ã‚Œã¦ã„ãªã„例ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:274 +#: ../../rst/dev_guide/developing_collections_distributing.rst:276 msgid "Signing a collection" msgstr "コレクションã®ç½²å" -#: ../../rst/dev_guide/developing_collections_distributing.rst:276 +#: ../../rst/dev_guide/developing_collections_distributing.rst:278 msgid "You can include a GnuPG signature with your collection on a :term:`Pulp 3 Galaxy` server. See `Enabling collection signing <https://galaxyng.netlify.app/config/collection_signing/>`_ for details." msgstr ":term:`Pulp 3 Galaxy` ã®ã”使用ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã« GnuPGç½²åã‚’è¿½åŠ ã§ãã¾ã™ã€‚詳細ã¯ã€`Enabling collection signing <https://galaxyng.netlify.app/config/collection_signing/>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:278 +#: ../../rst/dev_guide/developing_collections_distributing.rst:280 msgid "You can manually generate detached signatures for a collection using the ``gpg`` CLI using the following step. This step assume you have generated a GPG private key, but do not cover this process." msgstr "以下ã®æ‰‹é †ã® ``gpg`` CLI を使用ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ‡ã‚¿ãƒƒãƒã•ã‚ŒãŸç½²åを手動ã§ç”Ÿæˆã§ãã¾ã™ã€‚ã“ã®æ‰‹é †ã§ã¯ GPG 秘密éµã‚’生æˆã—ã¦ã„ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ãŒã€ã“ã®ãƒ—ãƒã‚»ã‚¹ã«ã¤ã„ã¦ã¯èª¬æ˜Žã—ã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:291 +#: ../../rst/dev_guide/developing_collections_distributing.rst:293 msgid "Each time you publish your collection, you must create a :ref:`new version <collection_versions>` on the distribution server. After you publish a version of a collection, you cannot delete or modify that version. To avoid unnecessary extra versions, check your collection for bugs, typos, and other issues locally before publishing:" msgstr "コレクションを公開ã™ã‚‹ãŸã³ã«ã€é…信サーãƒãƒ¼ã«:ref:`new version <collection_versions>` を作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚コレクションã®ã‚ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’公開ã—ãŸå¾Œã¯ã€ãã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’削除ã—ãŸã‚Šå¤‰æ›´ã—ãŸã‚Šã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。ä¸è¦ãªè¿½åŠ ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’é¿ã‘ã‚‹ãŸã‚ã«ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’公開ã™ã‚‹å‰ã«ãƒãƒ¼ã‚«ãƒ«ã§ãƒã‚°ã‚„タイプミスãªã©ã®å•é¡Œã‚’ãƒã‚§ãƒƒã‚¯ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:293 +#: ../../rst/dev_guide/developing_collections_distributing.rst:295 msgid "Install the collection locally." msgstr "コレクションをãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:294 +#: ../../rst/dev_guide/developing_collections_distributing.rst:296 msgid "Review the locally installed collection before publishing a new version." msgstr "æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’公開ã™ã‚‹å‰ã«ã€ãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„るコレクションを確èªã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:297 +#: ../../rst/dev_guide/developing_collections_distributing.rst:299 msgid "Installing your collection locally" msgstr "コレクションã®ãƒãƒ¼ã‚«ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/dev_guide/developing_collections_distributing.rst:299 +#: ../../rst/dev_guide/developing_collections_distributing.rst:301 msgid "You have two options for installing your collection locally:" msgstr "コレクションをãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€2ã¤ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:301 +#: ../../rst/dev_guide/developing_collections_distributing.rst:303 msgid "Install your collection locally from the tarball." msgstr "コレクションをtarballã‹ã‚‰ãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:302 +#: ../../rst/dev_guide/developing_collections_distributing.rst:304 msgid "Install your collection locally from your git repository." msgstr "gitリãƒã‚¸ãƒˆãƒªã‹ã‚‰ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:305 +#: ../../rst/dev_guide/developing_collections_distributing.rst:307 msgid "Installing your collection locally from the tarball" msgstr "tarballã‹ã‚‰ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/dev_guide/developing_collections_distributing.rst:307 +#: ../../rst/dev_guide/developing_collections_distributing.rst:309 msgid "To install your collection locally from the tarball, run ``ansible-galaxy collection install`` and specify the collection tarball. You can optionally specify a location using the ``-p`` flag. For example:" msgstr "コレクションをtarballã‹ã‚‰ãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€``ansible-galaxy collection install`` を実行ã—ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®tarballを指定ã—ã¾ã™ã€‚オプションã§``-p`` フラグを使ã£ã¦å ´æ‰€ã‚’指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚例ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:313 +#: ../../rst/dev_guide/developing_collections_distributing.rst:315 msgid "Install the tarball into a directory configured in :ref:`COLLECTIONS_PATHS` so Ansible can easily find and load the collection. If you do not specify a path value, ``ansible-galaxy collection install`` installs the collection in the first path defined in :ref:`COLLECTIONS_PATHS`." msgstr "AnsibleãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ç°¡å˜ã«è¦‹ã¤ã‘ã¦ãƒãƒ¼ãƒ‰ã§ãるよã†ã«ã€:ref:`COLLECTIONS_PATHS` ã§è¨å®šã—ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«tarballをインストールã—ã¾ã™ã€‚パスã®å€¤ã‚’指定ã—ãªã„å ´åˆã€``ansible-galaxy collection install`` ã¯ã€:ref:`COLLECTIONS_PATHS` ã§å®šç¾©ã•ã‚ŒãŸæœ€åˆã®ãƒ‘スã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:318 +#: ../../rst/dev_guide/developing_collections_distributing.rst:320 msgid "Installing your collection locally from a git repository" msgstr "git リãƒã‚¸ãƒˆãƒªãƒ¼ã‹ã‚‰ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/dev_guide/developing_collections_distributing.rst:320 +#: ../../rst/dev_guide/developing_collections_distributing.rst:322 msgid "To install your collection locally from a git repository, specify the repository and the branch you want to install:" msgstr "コレクションをgitリãƒã‚¸ãƒˆãƒªã‹ã‚‰ãƒãƒ¼ã‚«ãƒ«ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ãŸã„リãƒã‚¸ãƒˆãƒªã¨ãƒ–ランãƒã‚’指定ã—ã¾ã™ã€‚" @@ -1659,115 +1658,115 @@ msgstr "リãƒã‚¸ãƒˆãƒªãƒ¼ã«ã‚ˆã£ã¦ã¯ã€ãƒ¡ã‚¤ãƒ³ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¯ msgid "You can install all collections in this repository, or install one collection from a specific commit:" msgstr "ã“ã®ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ã™ã¹ã¦ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã™ã‚‹ã‹ã€ç‰¹å®šã®ã‚³ãƒŸãƒƒãƒˆã‹ã‚‰ 1 ã¤ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:329 +#: ../../rst/dev_guide/developing_collections_distributing.rst:331 msgid "Reviewing your collection" msgstr "コレクションã®ç¢ºèª" -#: ../../rst/dev_guide/developing_collections_distributing.rst:331 +#: ../../rst/dev_guide/developing_collections_distributing.rst:333 msgid "Review the collection:" msgstr "コレクションを確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:333 +#: ../../rst/dev_guide/developing_collections_distributing.rst:335 msgid "Run a playbook that uses the modules and plugins in your collection. Verify that new features and functionality work as expected. For examples and more details see :ref:`Using collections <using_collections>`." msgstr "コレクションã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„プラグインを使用ã™ã‚‹Playbookを実行ã—ã¾ã™ã€‚æ–°ã—ã„機能ãŒæœŸå¾…通りã«å‹•ä½œã™ã‚‹ã‹ã©ã†ã‹ã‚’検証ã—ã¾ã™ã€‚例や詳細ã«ã¤ã„ã¦ã¯ã€:ref:`Using collections <using_collections>` ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:334 +#: ../../rst/dev_guide/developing_collections_distributing.rst:336 msgid "Check the documentation for typos." msgstr "ドã‚ュメントã«èª¤å—脱å—ãŒãªã„ã‹ç¢ºèªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:335 +#: ../../rst/dev_guide/developing_collections_distributing.rst:337 msgid "Check that the version number of your tarball is higher than the latest published version on the distribution server or servers." msgstr "tarballã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ãŒã€é…信サーãƒãƒ¼ã§å…¬é–‹ã•ã‚Œã¦ã„る最新ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚ˆã‚Šã‚‚高ã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:336 +#: ../../rst/dev_guide/developing_collections_distributing.rst:338 msgid "If you find any issues, fix them and rebuild the collection tarball." msgstr "å•é¡ŒãŒè¦‹ã¤ã‹ã£ãŸå ´åˆã¯ã€ãれを修æ£ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®tarballã‚’å†ãƒ“ルドã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:341 +#: ../../rst/dev_guide/developing_collections_distributing.rst:343 msgid "Understanding collection versioning" msgstr "コレクションã®ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã«ã¤ã„ã¦" -#: ../../rst/dev_guide/developing_collections_distributing.rst:343 +#: ../../rst/dev_guide/developing_collections_distributing.rst:345 msgid "The only way to change a collection is to release a new version. The latest version of a collection (by highest version number) is the version displayed everywhere in Galaxy and Automation Hub. Users can still download older versions." msgstr "コレクションを変更ã™ã‚‹å”¯ä¸€ã®æ–¹æ³•ã¯ã€æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’リリースã™ã‚‹ã“ã¨ã§ã™ã€‚(最大ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã«ã‚ˆã‚‹) コレクションã®æœ€æ–°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€Galaxy ãŠã‚ˆã³Automation Hubã®ã‚ã‚‰ã‚†ã‚‹å ´æ‰€ã«è¡¨ç¤ºã•ã‚Œã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ãªã‚Šã¾ã™ã€‚ユーザーã¯ã€å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’引ã続ãダウンãƒãƒ¼ãƒ‰ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:345 +#: ../../rst/dev_guide/developing_collections_distributing.rst:347 msgid "Follow semantic versioning when setting the version for your collection. In summary:" msgstr "コレクションã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’è¨å®šã™ã‚‹éš›ã¯ã€ã‚»ãƒžãƒ³ãƒ†ã‚£ãƒƒã‚¯ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã«å¾“ã£ã¦ãã ã•ã„。è¦ç´„ã™ã‚‹ã¨ã€ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:347 +#: ../../rst/dev_guide/developing_collections_distributing.rst:349 msgid "Increment the major version number, ``x`` of ``x.y.z``, for an incompatible API change." msgstr "互æ›æ€§ã®ãªã„ API 変更ã®å ´åˆ:メジャーãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå· (例: ``x.y.z`` ã® ``x``) を増やã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:348 +#: ../../rst/dev_guide/developing_collections_distributing.rst:350 msgid "Increment the minor version number, ``y`` of ``x.y.z``, for new functionality in a backwards compatible manner (for example new modules/plugins, parameters, return values)." msgstr "下ä½äº’æ›æ€§ã®ã‚る新機能（例ãˆã°ã€æ–°ã—ã„モジュール/プラグインã€ãƒ‘ラメータã€æˆ»ã‚Šå€¤ãªã©ï¼‰ã®å ´åˆ:マイナーãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ï¼ˆ``x.y.z`` ã®``y``）を増やã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:349 +#: ../../rst/dev_guide/developing_collections_distributing.rst:351 msgid "Increment the patch version number, ``z`` of ``x.y.z``, for backwards compatible bug fixes." msgstr "後方互æ›æ€§ã®ã‚ã‚‹ãƒã‚°ä¿®æ£ã®å ´åˆ:パッãƒã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ï¼ˆ``x.y.z`` ã®``z``）を増やã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:351 +#: ../../rst/dev_guide/developing_collections_distributing.rst:353 msgid "Read the official `Semantic Versioning <https://semver.org/>`_ documentation for details and examples." msgstr "詳細や例ã«ã¤ã„ã¦ã¯ã€`Semantic Versioning <https://semver.org/>`_ã®å…¬å¼ãƒ‰ã‚ュメントをãŠèªã¿ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:358 +#: ../../rst/dev_guide/developing_collections_distributing.rst:360 msgid "The last step in distributing your collection is publishing the tarball to Ansible Galaxy, Red Hat Automation Hub, or a privately hosted Automation Hub instance. You can publish your collection in two ways:" msgstr "コレクションをé…布ã™ã‚‹æœ€å¾Œã®ã‚¹ãƒ†ãƒƒãƒ—ã¯ã€Ansible Galaxyã€Red Hat Automation Hubã€ã¾ãŸã¯ãƒ—ライベートã«ãƒ›ã‚¹ãƒˆã•ã‚Œã¦ã„るオートメーションãƒãƒ–インスタンス㫠tarball を公開ã™ã‚‹ã“ã¨ã§ã™ã€‚コレクションã®å…¬é–‹ã«ã¯2ã¤ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:360 +#: ../../rst/dev_guide/developing_collections_distributing.rst:362 msgid "from the command line using the ``ansible-galaxy collection publish`` command" msgstr "コマンドラインã‹ã‚‰ï¼ˆ``ansible-galaxy collection publish`` コマンドã®ä½¿ç”¨ï¼‰" -#: ../../rst/dev_guide/developing_collections_distributing.rst:361 +#: ../../rst/dev_guide/developing_collections_distributing.rst:363 msgid "from the website of the distribution server (Galaxy, Automation Hub) itself" msgstr "é…信サーãƒãƒ¼ï¼ˆGalaxyã€Automation Hub）自体ã®Webサイトã‹ã‚‰" -#: ../../rst/dev_guide/developing_collections_distributing.rst:367 +#: ../../rst/dev_guide/developing_collections_distributing.rst:369 msgid "Publishing a collection from the command line" msgstr "コマンドラインã‹ã‚‰ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®å…¬é–‹" -#: ../../rst/dev_guide/developing_collections_distributing.rst:369 +#: ../../rst/dev_guide/developing_collections_distributing.rst:371 msgid "To upload the collection tarball from the command line using ``ansible-galaxy``:" msgstr "``ansible-galaxy`` を使ã£ã¦ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‹ã‚‰ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® tarball をアップãƒãƒ¼ãƒ‰ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:377 +#: ../../rst/dev_guide/developing_collections_distributing.rst:379 msgid "This ansible-galaxy command assumes you have retrieved and stored your API token in configuration. See :ref:`galaxy_specify_token` for details." msgstr "ã“ã®ansible-galaxyコマンドã¯ã€APIトークンをå–å¾—ã—ã¦ã‚³ãƒ³ãƒ•ã‚£ã‚°ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã«ä¿å˜ã—ã¦ã„ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚詳細ã¯:ref:`galaxy_specify_token` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_collections_distributing.rst:379 +#: ../../rst/dev_guide/developing_collections_distributing.rst:381 msgid "The ``ansible-galaxy collection publish`` command triggers an import process, just as if you uploaded the collection through the Galaxy website. The command waits until the import process completes before reporting the status back. If you want to continue without waiting for the import result, use the ``--no-wait`` argument and manually look at the import progress in your `My Imports <https://galaxy.ansible.com/my-imports/>`_ page." msgstr "``ansible-galaxy collection publish`` コマンドã¯ã€Galaxy ã® Web サイトã§ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’アップãƒãƒ¼ãƒ‰ã—ã¦ã„ã‚‹ã®ã¨åŒæ§˜ã«ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆãƒ—ãƒã‚»ã‚¹ã‚’発生ã•ã›ã¾ã™ã€‚コマンドã¯ã€ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚’å ±å‘Šã™ã‚‹å‰ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆãƒ—ãƒã‚»ã‚¹ãŒå®Œäº†ã™ã‚‹ã¾ã§å¾…ã¡ã¾ã™ã€‚インãƒãƒ¼ãƒˆçµæžœã‚’å¾…ãŸãšã«ç¶šè¡Œã™ã‚‹å ´åˆã¯ã€``--no-wait`` 引数を使用ã—ã¦ã€`My Imports <https://galaxy.ansible.com/my-imports/>`_ ページã§æ‰‹å‹•ã§ã‚¤ãƒ³ãƒãƒ¼ãƒˆã®é€²è¡ŒçŠ¶æ³ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:384 +#: ../../rst/dev_guide/developing_collections_distributing.rst:386 msgid "Publishing a collection from the website" msgstr "Web サイトã‹ã‚‰ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®å…¬é–‹" -#: ../../rst/dev_guide/developing_collections_distributing.rst:386 +#: ../../rst/dev_guide/developing_collections_distributing.rst:388 msgid "To publish your collection directly on the Galaxy website:" msgstr "コレクションを Galaxy ã® Web サイトã«ç›´æŽ¥å…¬é–‹ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:388 +#: ../../rst/dev_guide/developing_collections_distributing.rst:390 msgid "Go to the `My Content <https://galaxy.ansible.com/my-content/namespaces>`_ page, and click the **Add Content** button on one of your namespaces." msgstr "`My Content <https://galaxy.ansible.com/my-content/namespaces>`_ ページã«ç§»å‹•ã—ã€åå‰ç©ºé–“ã®ã„ãšã‚Œã‹ã® **ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’è¿½åŠ ** ボタンをクリックã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:389 +#: ../../rst/dev_guide/developing_collections_distributing.rst:391 msgid "From the **Add Content** dialogue, click **Upload New Collection**, and select the collection archive file from your local filesystem." msgstr "**コンテンツã®è¿½åŠ ** ダイアãƒã‚°ã‹ã‚‰ã€**æ–°è¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰** をクリックã—ã¦ã€ãƒãƒ¼ã‚«ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã‹ã‚‰ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚¢ãƒ¼ã‚«ã‚¤ãƒ–ファイルをé¸æŠžã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:391 +#: ../../rst/dev_guide/developing_collections_distributing.rst:393 msgid "When you upload a collection, Ansible always uploads the tarball to the namespace specified in the collection metadata in the ``galaxy.yml`` file, no matter which namespace you select on the website. If you are not an owner of the namespace specified in your collection metadata, the upload request fails." msgstr "コレクションをアップãƒãƒ¼ãƒ‰ã™ã‚‹éš›ã€Web サイトã§é¸æŠžã—ãŸåå‰ç©ºé–“ã«é–¢ä¿‚ãªãã€Ansibleã¯``galaxy.yml`` ファイルã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã§æŒ‡å®šã•ã‚ŒãŸåå‰ç©ºé–“ã«tarballをアップãƒãƒ¼ãƒ‰ã—ã¾ã™ã€‚コレクションメタデータã§æŒ‡å®šã•ã‚ŒãŸåå‰ç©ºé–“ã®æ‰€æœ‰è€…ã§ãªã„å ´åˆã€ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ãƒªã‚¯ã‚¨ã‚¹ãƒˆã¯å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:393 +#: ../../rst/dev_guide/developing_collections_distributing.rst:395 msgid "After Galaxy uploads and accepts a collection, the website shows you the **My Imports** page. This page shows import process information. You can review any errors or warnings about your upload there." msgstr "GalaxyãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’アップãƒãƒ¼ãƒ‰ã—ã¦å—ç†ã™ã‚‹ã¨ã€Web サイトã§ã¯**My Imports**ページãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“ã®ãƒšãƒ¼ã‚¸ã«ã¯ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆãƒ—ãƒã‚»ã‚¹æƒ…å ±ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“ã“ã§ã¯ã€ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ã«é–¢ã™ã‚‹ã‚¨ãƒ©ãƒ¼ã‚„è¦å‘Šã‚’確èªã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_collections_distributing.rst:399 +#: ../../rst/dev_guide/developing_collections_distributing.rst:401 msgid ":ref:`collections_galaxy_meta`" msgstr ":ref:`collections_galaxy_meta`" -#: ../../rst/dev_guide/developing_collections_distributing.rst:400 +#: ../../rst/dev_guide/developing_collections_distributing.rst:402 msgid "Table of fields used in the :file:`galaxy.yml` file" msgstr ":file:`galaxy.yml` ファイルã§ä½¿ç”¨ã•ã‚Œã‚‹ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã®è¡¨" @@ -1781,7 +1780,7 @@ msgstr "ドã‚ュメントã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŠã‚ˆã³ãƒ—ラグイン" #: ../../rst/dev_guide/developing_collections_documenting.rst:10 msgid "Documenting modules is thoroughly documented in :ref:`module_documenting`. Plugins can be documented the same way as modules, that is with ``DOCUMENTATION``, ``EXAMPLES``, and ``RETURN`` blocks." -msgstr "モジュールã®æ–‡æ›¸åŒ–ã«ã¤ã„ã¦ã¯ã€:ref: ã§è©³ã—ã説明ã—ã¦ã„ã¾ã™ã€‚プラグインã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨åŒã˜ã‚ˆã†ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ (``DOCUMENTATION``ã€``EXAMPLES`` ãŠã‚ˆã³ ``RETURN`` ã®ãƒ–ãƒãƒƒã‚¯)。" +msgstr "モジュールã®æ–‡æ›¸åŒ–ã«ã¤ã„ã¦ã¯ã€:ref:`module_documenting` ã§è©³ã—ã説明ã—ã¦ã„ã¾ã™ã€‚プラグインã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨åŒã˜ã‚ˆã†ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ (``DOCUMENTATION``ã€``EXAMPLES`` ãŠã‚ˆã³ ``RETURN`` ã®ãƒ–ãƒãƒƒã‚¯)。" #: ../../rst/dev_guide/developing_collections_documenting.rst:13 msgid "Documenting roles" @@ -2033,7 +2032,7 @@ msgstr "Ansibulbot ã¯ã€æ—¢å˜ã®å•é¡Œã¨ PR ã‚’æ–°ã—ã„リãƒã‚¸ãƒˆãƒªãƒ¼ã« #: ../../rst/dev_guide/developing_collections_migrating.rst:110 msgid "`Example PR <https://github.com/ansible/ansible/pull/66981/files>`_" -msgstr "`PR ã®ä¾‹ <https://github.com/ansible/ansible/pull/66981/files>`_" +msgstr "`Example PR <https://github.com/ansible/ansible/pull/66981/files>`_" #: ../../rst/dev_guide/developing_collections_migrating.rst:112 msgid "The ``migrated_to:`` key must be added explicitly for every *file*. You cannot add ``migrated_to`` at the directory level. This is to allow module and plugin webdocs to be redirected to the new collection docs." @@ -2150,6 +2149,10 @@ msgstr "コレクションã¯ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ç‹¬ç«‹ã—ãŸãƒ¦ãƒ‹ãƒƒãƒˆã¨ msgid "You can use git repositories for collection dependencies during local development and testing. For example:" msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®é–‹ç™ºã‚„テストã®éš›ã«ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¾å˜é–¢ä¿‚用ã«gitリãƒã‚¸ãƒˆãƒªã‚’使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_collections_shared.rst:83 +msgid "Do not use git repositories as dependencies for published collections. Dependencies for published collections must be other published collections." +msgstr "公開ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¾å˜é–¢ä¿‚ã¨ã—㦠git リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’使用ã—ãªã„ã§ãã ã•ã„。公開ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¾å˜é–¢ä¿‚ã¯ã€ä»–ã®å…¬é–‹ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" + #: ../../rst/dev_guide/developing_collections_structure.rst:5 msgid "Collection structure" msgstr "ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³æ§‹é€ " @@ -2303,32 +2306,32 @@ msgid "Also, playbooks within a collection follow the same guidelines as any pla msgstr "ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã® Playbook ã¯ã€æ¬¡ã®ã„ãã¤ã‹ã®èª¿æ•´ã‚’除ã„ã¦ã€ä»–ã® Playbook ã¨åŒã˜ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã«å¾“ã„ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_structure.rst:192 -msgid "Directory: It must be in ``/playbooks directory``." -msgstr "ディレクトリー: ``/playbooks directory`` ã«ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" +msgid "Directory: It must be in the ``playbooks/`` directory." +msgstr "ディレクトリー: ``playbooks/`` ディレクトリーã«ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" #: ../../rst/dev_guide/developing_collections_structure.rst:193 msgid "Hosts: The host should be defined as a variable so the users of a playbook do not mistakenly run the plays against their entire inventory (if the host is set to all). For example - ``hosts: '{{target|default(\"all\")}}'``." msgstr "ホスト: Playbook ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å…¨ä½“ (ホストãŒã™ã¹ã¦ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆ) ã«å¯¾ã—ã¦èª¤ã£ã¦ãƒ—レイを実行ã™ã‚‹ã“ã¨ã‚’防æ¢ã™ã‚‹ãŸã‚ã€ãƒ›ã‚¹ãƒˆã¯å¤‰æ•°ã¨ã—ã¦å®šç¾©ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚例: -``hosts: '{{target|default(\"all\")}}'``。" #: ../../rst/dev_guide/developing_collections_structure.rst:195 -msgid "To run the plays, users can now use such commands as ``ansible-playbook --e 'targets=webservers'`` or ``ansible-playbook --limit webservers``. Either way, the collection owner should document their playbooks and how to use them in the ``/docs`` folder or ``README`` file." -msgstr "ユーザーã¯ã€``ansible-playbook --e 'targets=webservers'`` ã‚„ ``ansible-playbook --limit webservers`` ãªã©ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ãƒ—レイを実行ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã„ãšã‚Œã®æ–¹æ³•ã§ã‚‚ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³æ‰€æœ‰è€…㯠Playbook ã¨ã€``/docs`` フォルダーã¾ãŸã¯ ``README`` ファイルã§ã®ä½¿ç”¨æ–¹æ³•ã‚’文書化ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "To run the plays, users can now use such commands as ``ansible-playbook --e 'targets=webservers'`` or ``ansible-playbook --limit webservers``. Either way, the collection owner should document their playbooks and how to use them in the ``docs/`` folder or ``README`` file." +msgstr "ユーザーã¯ã€``ansible-playbook --e 'targets=webservers'`` ã‚„ ``ansible-playbook --limit webservers`` ãªã©ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ãƒ—レイを実行ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã„ãšã‚Œã®æ–¹æ³•ã§ã‚‚ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³æ‰€æœ‰è€…㯠Playbook ã¨ã€``docs/`` フォルダーã¾ãŸã¯ ``README`` ファイルã§ã®ä½¿ç”¨æ–¹æ³•ã‚’文書化ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_structure.rst:200 msgid "tests directory" msgstr "tests ディレクトリー" #: ../../rst/dev_guide/developing_collections_structure.rst:202 -msgid "Ansible Collections are tested much like Ansible itself, by using the `ansible-test` utility which is released as part of Ansible, version 2.9.0 and newer. Because Ansible Collections are tested using the same tooling as Ansible itself, via `ansible-test`, all Ansible developer documentation for testing is applicable for authoring Collections Tests with one key concept to keep in mind." -msgstr "Ansible Collection ã¯ã€Ansible 自体ã¨åŒã˜ã‚ˆã†ã«ã€Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.9.0 以é™ã«åŒæ¢±ã•ã‚Œã‚‹ `ansible-test` ユーティリティーを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã™ã€‚Ansible コレクション㯠Ansible 自体ã¨åŒã˜ãƒ„ールを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã‚‹ãŸã‚ã€`ansible-test` を介ã—ã¦ã€ãƒ†ã‚¹ãƒˆç”¨ã®ã™ã¹ã¦ã® Ansible 開発者å‘ã‘ドã‚ュメントã¯ã€è¦šãˆã¦ãŠãã¹ã 1 ã¤ã®é‡è¦ãªæ¦‚念を使用ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ†ã‚¹ãƒˆã‚’作æˆã™ã‚‹ãŸã‚ã«é©ç”¨ã§ãã¾ã™ã€‚" +msgid "Ansible Collections are tested much like Ansible itself, by using the `ansible-test` utility which is released as part of Ansible, version 2.9.0 and newer. Because Ansible Collections are tested using the same tooling as Ansible itself, by using the `ansible-test`, all Ansible developer documentation for testing is applicable for authoring Collections Tests with one key concept to keep in mind." +msgstr "Ansible Collection ã¯ã€Ansible 自体ã¨åŒã˜ã‚ˆã†ã«ã€Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.9.0 以é™ã«åŒæ¢±ã•ã‚Œã‚‹ `ansible-test` ユーティリティーを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã™ã€‚Ansible Collection 㯠Ansible 自体ã¨åŒã˜ãƒ„ールを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã‚‹ãŸã‚ã€`ansible-test` を介ã—ã¦ã€ãƒ†ã‚¹ãƒˆç”¨ã®ã™ã¹ã¦ã® Ansible 開発者å‘ã‘ドã‚ュメントã¯ã€è¦šãˆã¦ãŠãã¹ã 1 ã¤ã®é‡è¦ãªæ¦‚念を使用ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ†ã‚¹ãƒˆã‚’作æˆã™ã‚‹ãŸã‚ã«é©ç”¨ã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_structure.rst:204 msgid "See :ref:`testing_collections` for specific information on how to test collections with ``ansible-test``." msgstr "``ansible-test`` ã§ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’テストã™ã‚‹æ–¹æ³•ã¯ã€ã€Œ:ref:`testing_collections`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_collections_structure.rst:206 -msgid "When reading the :ref:`developing_testing` documentation, there will be content that applies to running Ansible from source code via a git clone, which is typical of an Ansible developer. However, it's not always typical for an Ansible Collection author to be running Ansible from source but instead from a stable release, and to create Collections it is not necessary to run Ansible from source. Therefore, when references of dealing with `ansible-test` binary paths, command completion, or environment variables are presented throughout the :ref:`developing_testing` documentation; keep in mind that it is not needed for Ansible Collection Testing because the act of installing the stable release of Ansible containing `ansible-test` is expected to setup those things for you." -msgstr ":ref:`developing_testing` ã®ãƒ‰ã‚ュメントをèªã‚€éš›ã€Ansible 開発者ã®å…¸åž‹çš„㪠git clone を使用ã—ã¦ã€ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‹ã‚‰ Ansible を実行ã™ã‚‹ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ãŒã‚ã‚Šã¾ã™ã€‚ãŸã ã—ã€Ansible Collection ã®ä½œæˆè€…ãŒã‚½ãƒ¼ã‚¹ã‹ã‚‰ Ansible を実行ã™ã‚‹ã“ã¨ã¯å¸¸ã«ä¸€èˆ¬çš„ã§ã¯ãªãã€å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‹ã‚‰ã§ã¯ãªãã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’作æˆã™ã‚‹ã«ã¯ã€ã‚½ãƒ¼ã‚¹ã‹ã‚‰ Ansible を実行ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。ãã®ãŸã‚ã€`ansible-test` ãƒã‚¤ãƒŠãƒªãƒ¼ãƒ‘スã€ã‚³ãƒžãƒ³ãƒ‰è£œå®Œã€ã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã«ã¤ã„ã¦ã¯ã€:ref:`developing_testing` ドã‚ュメントã§æ示ã•ã‚Œã¾ã™ã€‚Ansible Collection Testing ã§ã¯ã“ã‚ŒãŒå¿…è¦ã‚ã‚Šã¾ã›ã‚“。`ansible-test` ã‚’å«ã‚€ Ansible ã®å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‚’インストールã™ã‚‹ã«ã¯ã€ã“れらをセットアップã™ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹ãŸã‚ã§ã™ã€‚" +msgid "When reading the :ref:`developing_testing` documentation, there will be content that applies to running Ansible from source code through a git clone, which is typical of an Ansible developer. However, it's not always typical for an Ansible Collection author to be running Ansible from source but instead from a stable release, and to create Collections it is not necessary to run Ansible from source. Therefore, when references of dealing with `ansible-test` binary paths, command completion, or environment variables are presented throughout the :ref:`developing_testing` documentation; keep in mind that it is not needed for Ansible Collection Testing because the act of installing the stable release of Ansible containing `ansible-test` is expected to setup those things for you." +msgstr ":ref:`developing_testing` ã®ãƒ‰ã‚ュメントをèªã‚€éš›ã€Ansible 開発者ã®å…¸åž‹çš„㪠git clone を使用ã—ã¦ã€ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‹ã‚‰ã® Ansible ã®å®Ÿè¡Œã«é©ç”¨ã•ã‚Œã‚‹ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ãŒã‚ã‚Šã¾ã™ã€‚ã—ã‹ã—ã€Ansible Collection ã®ä½œè€…㌠Ansible をソースã‹ã‚‰ã§ã¯ãªãã€å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‹ã‚‰å®Ÿè¡Œã™ã‚‹ã“ã¨ã¯å¿…ãšã—も一般的ã§ã¯ãªãã€Collection を作æˆã™ã‚‹ãŸã‚ã«ã¯ã€Ansible をソースã‹ã‚‰å®Ÿè¡Œã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。ãã®ãŸã‚ã€`ansible-test` ãƒã‚¤ãƒŠãƒªãƒ¼ãƒ‘スã€ã‚³ãƒžãƒ³ãƒ‰è£œå®Œã€ã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã®æ‰±ã„ã«é–¢ã™ã‚‹å‚ç…§ã«ã¤ã„ã¦ã¯ã€:ref:`developing_testing` ドã‚ュメントã§æ示ã•ã‚Œã¾ã™ã€‚Ansible Collection Testing ã§ã¯ã“ã‚ŒãŒå¿…è¦ã‚ã‚Šã¾ã›ã‚“。`ansible-test` ã‚’å«ã‚€ Ansible ã®å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‚’インストールã™ã‚‹ã«ã¯ã€ã“れらをセットアップã™ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹ãŸã‚ã§ã™ã€‚" #: ../../rst/dev_guide/developing_collections_structure.rst:211 msgid "meta directory and runtime.yml" @@ -2387,8 +2390,8 @@ msgid "Testing collections" msgstr "コレクションã®ãƒ†ã‚¹ãƒˆ" #: ../../rst/dev_guide/developing_collections_testing.rst:7 -msgid "Testing your collection ensures that your code works well and integrates well with the rest of the Ansible ecosystem. Your collection should pass the general compile and sanity tests for Ansible code. You should also add unit tests to cover the code in your collection and integration tests to cover the interactions between your collection and ansible-core." -msgstr "コレクションã®ãƒ†ã‚¹ãƒˆã«ã‚ˆã‚Šã€ã‚³ãƒ¼ãƒ‰ãŒé©åˆ‡ã«æ©Ÿèƒ½ã—ã€Ansible エコシステムã®ä»–ã®éƒ¨åˆ†ã¨ã®çµ±åˆæ€§ãŒå‘上ã—ã¾ã™ã€‚コレクションã§ã¯ã€Ansible コードã®ä¸€èˆ¬çš„ãªã‚³ãƒ³ãƒ‘イルãŠã‚ˆã³å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’渡ã—ã¾ã™ã€‚ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚³ãƒ¼ãƒ‰ã«å¯¾å¿œã™ã‚‹ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã¨ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨ ansible-core ã¨ã®é–“ã®å¯¾è©±ã«å¯¾å¿œã™ã‚‹çµ±åˆãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "Testing your collection ensures that your code works well and integrates well with the rest of the Ansible ecosystem. Your collection should pass the sanity tests for Ansible code. You should also add unit tests to cover the code in your collection and integration tests to cover the interactions between your collection and ansible-core." +msgstr "コレクションã®ãƒ†ã‚¹ãƒˆã«ã‚ˆã‚Šã€ã‚³ãƒ¼ãƒ‰ãŒé©åˆ‡ã«æ©Ÿèƒ½ã—ã€Ansible エコシステムã®ä»–ã®éƒ¨åˆ†ã¨ã®çµ±åˆæ€§ãŒå‘上ã—ã¾ã™ã€‚コレクションã§ã¯ã€Ansible コードã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’渡ã—ã¾ã™ã€‚ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚³ãƒ¼ãƒ‰ã«å¯¾å¿œã™ã‚‹ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã¨ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨ ansible-core ã¨ã®é–“ã®å¯¾è©±ã«å¯¾å¿œã™ã‚‹çµ±åˆãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_testing.rst:14 msgid "Testing tools" @@ -2399,24 +2402,24 @@ msgid "The main tool for testing collections is ``ansible-test``, Ansible's test msgstr "コレクションをテストã™ã‚‹ä¸»ãªãƒ„ールã¯ã€:ref:`developing_testing` ã§èª¬æ˜Žã•ã‚Œã¦ã„ã‚‹ Ansible ã®ãƒ†ã‚¹ãƒˆãƒ„ール ``ansible-test`` ã§ã™ã€‚ã“ã‚Œã¯ã€``ansible`` パッケージ㨠``ansible-core`` パッケージã®ä¸¡æ–¹ã§æä¾›ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_testing.rst:18 -msgid "You can run several compile and sanity checks, as well as run unit and integration tests for plugins using ``ansible-test``. When you test collections, test against the ansible-core version(s) you are targeting." -msgstr "ã¾ãŸã€è¤‡æ•°ã®ã‚³ãƒ³ãƒ‘イルãƒã‚§ãƒƒã‚¯ã¨å¥å…¨æ€§ãƒã‚§ãƒƒã‚¯ã‚’実行ã—ãŸã‚Šã€``ansible-test`` を使用ã—ã¦ãƒ—ラグイン用ã«ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚„çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã§ãã¾ã™ã€‚コレクションをテストã™ã‚‹å ´åˆã«ã€ä½¿ç”¨ã™ã‚‹ ansible-core ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "You can run several sanity tests, as well as run unit and integration tests for plugins using ``ansible-test``. When you test collections, test against the ansible-core version(s) you are targeting." +msgstr "ã¾ãŸã€è¤‡æ•°ã®å¥å…¨æ€§ãƒã‚§ãƒƒã‚¯ã‚’実行ã—ãŸã‚Šã€``ansible-test`` を使用ã—ã¦ãƒ—ラグイン用ã«ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚„çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã§ãã¾ã™ã€‚コレクションをテストã™ã‚‹å ´åˆã«ã€ä½¿ç”¨ã™ã‚‹ ansible-core ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_testing.rst:20 msgid "You must always execute ``ansible-test`` from the root directory of a collection. You can run ``ansible-test`` in Docker containers without installing any special requirements. The Ansible team uses this approach in Azure Pipelines both in the ansible/ansible GitHub repository and in the large community collections such as `community.general <https://github.com/ansible-collections/community.general/>`_ and `community.network <https://github.com/ansible-collections/community.network/>`_. The examples below demonstrate running tests in Docker containers." msgstr "常ã«ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ«ãƒ¼ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰ã€``ansible-test`` を実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚特別ãªè¦ä»¶ã‚’インストールã›ãšã« Docker コンテナー㮠``ansible-test`` を実行ã§ãã¾ã™ã€‚Ansible ãƒãƒ¼ãƒ ã¯ã€ansible/ansible GitHub リãƒã‚¸ãƒˆãƒªãƒ¼ã¨ã€`community.general <https://github.com/ansible-collections/community.general/>`_ ã‚„ `community.network <https://github.com/ansible-collections/community.network/>`_ よã†ãªå¤§è¦æ¨¡ãªã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸¡æ–¹ã® Azure Pipeline ã§ã€ã“ã®ã‚¢ãƒ—ãƒãƒ¼ãƒã‚’使用ã—ã¾ã™ã€‚以下ã®ä¾‹ã§ã¯ã€Docker コンテナーã§ãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œæ–¹æ³•ã‚’示ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_collections_testing.rst:23 -msgid "Compile and sanity tests" -msgstr "コンパイルã¨å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ" +msgid "Sanity tests" +msgstr "å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ" #: ../../rst/dev_guide/developing_collections_testing.rst:25 -msgid "To run all compile and sanity tests:" -msgstr "ã™ã¹ã¦ã®ã‚³ãƒ³ãƒ‘イルãŠã‚ˆã³å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" +msgid "To run all sanity tests:" +msgstr "ã™ã¹ã¦ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹å ´åˆ:" #: ../../rst/dev_guide/developing_collections_testing.rst:31 -msgid "See :ref:`testing_compile` and :ref:`testing_sanity` for more information. See the :ref:`full list of sanity tests <all_sanity_tests>` for details on the sanity tests and how to fix identified issues." -msgstr "詳細ã¯ã€:ref:`testing_compile` ãŠã‚ˆã³ :ref:`testing_sanity` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®è©³ç´°ã¨ã€ç‰¹å®šã•ã‚ŒãŸå•é¡Œã‚’ä¿®æ£ã™ã‚‹æ–¹æ³•ã¯ã€ã€Œ:ref:`å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®å®Œå…¨ãƒªã‚¹ãƒˆ <all_sanity_tests>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "See :ref:`testing_sanity` for more information. See the :ref:`full list of sanity tests <all_sanity_tests>` for details on the sanity tests and how to fix identified issues." +msgstr "詳細ã¯ã€:ref:`testing_sanity` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®è©³ç´°ã¨ã€ç‰¹å®šã•ã‚ŒãŸå•é¡Œã‚’ä¿®æ£ã™ã‚‹æ–¹æ³•ã¯ã€:ref:`full list of sanity tests <all_sanity_tests>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_collections_testing.rst:34 msgid "Adding unit tests" @@ -2499,17 +2502,19 @@ msgid "Developing ``ansible-core``" msgstr "``ansible-core`` ã®é–‹ç™º" #: ../../rst/dev_guide/developing_core.rst:5 -msgid "Although ``ansible-core`` (the code hosted in the `ansible/ansible repository <https://github.com/ansible/ansible>`_ on GitHub) includes a few plugins that can be swapped out via playbook directives or configuration, much of the code there is not modular. The documents here give insight into how the parts of ``ansible-core`` work together." -msgstr "``ansible-core`` (GitHub ã® `ansible/ansible リãƒã‚¸ãƒˆãƒªãƒ¼ <https://github.com/ansible/ansible>`_ ã§ãƒ›ã‚¹ãƒˆã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰) ã«ã¯ã€Playbook ディレクティブã¾ãŸã¯è¨å®šã‚’介ã—ã¦ã‚¹ãƒ¯ãƒƒãƒ—ã§ãるプラグインãŒå«ã¾ã‚Œã¦ã„ã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åŒ–ã•ã‚Œãªã„コードãŒå¤šãã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€``ansible-core`` ã®ä¸€éƒ¨ãŒé€£æºã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹ãƒ‰ã‚ュメントã§ã™ã€‚" +msgid "Although ``ansible-core`` (the code hosted in the `ansible/ansible repository <https://github.com/ansible/ansible>`_ on GitHub) includes a few plugins that can be swapped out by the playbook directives or configuration, much of the code there is not modular. The documents here give insight into how the parts of ``ansible-core`` work together." +msgstr "``ansible-core`` (GitHub ã® `ansible/ansible repository <https://github.com/ansible/ansible>`_ ã§ãƒ›ã‚¹ãƒˆã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰) ã«ã¯ã€Playbook ディレクティブã¾ãŸã¯è¨å®šã‚’介ã—ã¦ã‚¹ãƒ¯ãƒƒãƒ—ã§ãるプラグインãŒå«ã¾ã‚Œã¦ã„ã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åŒ–ã•ã‚Œãªã„コードãŒå¤šãã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€ã“ã®ãƒ‰ã‚ュメントã¯ã€``ansible-core`` ã®ä¸€éƒ¨ãŒé€£æºã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹æ´žå¯Ÿã‚’与ãˆã¦ãã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/developing_core.rst:15 -#: ../../rst/dev_guide/developing_inventory.rst:473 -#: ../../rst/dev_guide/developing_plugins.rst:540 +#: ../../rst/dev_guide/developing_inventory.rst:503 +#: ../../rst/dev_guide/developing_plugins.rst:544 +#: ../../rst/dev_guide/sidecar.rst:91 msgid ":ref:`developing_api`" msgstr ":ref:`developing_api`" #: ../../rst/dev_guide/developing_core.rst:16 -#: ../../rst/dev_guide/developing_plugins.rst:541 +#: ../../rst/dev_guide/developing_plugins.rst:545 +#: ../../rst/dev_guide/sidecar.rst:92 msgid "Learn about the Python API for task execution" msgstr "タスク実行用㮠Python API ã«ã¤ã„ã¦" @@ -2518,7 +2523,7 @@ msgid "Learn about developing plugins" msgstr "プラグインã®é–‹ç™ºã«ã¤ã„ã¦" #: ../../rst/dev_guide/developing_core.rst:21 -#: ../../rst/dev_guide/style_guide/index.rst:337 +#: ../../rst/dev_guide/style_guide/index.rst:339 msgid "`irc.libera.chat <https://libera.chat>`_" msgstr "`irc.libera.chat <https://libera.chat>`_" @@ -2535,8 +2540,8 @@ msgid "Ansible can pull inventory information from dynamic sources, including cl msgstr "Ansible ã¯ã€æŒ‡å®šã•ã‚ŒãŸ :ref:`インベントリープラグイン <inventory_plugins>` を使用ã—ã¦ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã‚½ãƒ¼ã‚¹ã‚’å«ã‚€å‹•çš„ソースã‹ã‚‰ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼æƒ…å ±ã‚’ãƒ—ãƒ«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼æƒ…å ±ã®ãƒ—ル方法ã®è©³ç´°ã¯ã€ã€Œ:ref:`dynamic_inventory`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ç¾åœ¨ã€æ—¢å˜ã®ãƒ—ラグインã§å¯¾è±¡ã¨ã—ã¦ã„ãªã„ソースã«ã¤ã„ã¦ã¯ã€ä»–ã®ãƒ—ラグインタイプã§ç‹¬è‡ªã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインを作æˆã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_inventory.rst:9 -msgid "In previous versions, you had to create a script or program that could output JSON in the correct format when invoked with the proper arguments. You can still use and write inventory scripts, as we ensured backwards compatibility via the :ref:`script inventory plugin <script_inventory>` and there is no restriction on the programming language used. If you choose to write a script, however, you will need to implement some features yourself such as caching, configuration management, dynamic variable and group composition, and so on. If you use :ref:`inventory plugins <inventory_plugins>` instead, you can use the Ansible codebase and add these common features automatically." -msgstr "以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€é©åˆ‡ãªå¼•æ•°ã§å‘¼ã³å‡ºã•ã‚ŒãŸã¨ãã«æ£ã—ã„å½¢å¼ã§ JSON を出力ã§ãるスクリプトやプãƒã‚°ãƒ©ãƒ を作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã—ãŸã€‚:ref:`script inventory plugin <script_inventory>` を通ã˜ã¦å¾Œæ–¹äº’æ›æ€§ã‚’確ä¿ã—ã¦ãŠã‚Šã€ä½¿ç”¨ã™ã‚‹ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã«ã‚‚制é™ãŒãªã„ãŸã‚ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã—ãŸã‚Šæ›¸ã„ãŸã‚Šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã ã—ã€ã‚¹ã‚¯ãƒªãƒ—トを書ãå ´åˆã¯ã€ã‚ャッシュã€è¨å®šç®¡ç†ã€å‹•çš„ãªå¤‰æ•°ã€ã‚°ãƒ«ãƒ¼ãƒ—ã®æ§‹æˆãªã©ã€ã„ãã¤ã‹ã®æ©Ÿèƒ½ã‚’自分ã§å®Ÿè£…ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« :ref:`inventory plugins <inventory_plugins>` を使用ã™ã‚Œã°ã€Ansible ã®ã‚³ãƒ¼ãƒ‰ãƒ™ãƒ¼ã‚¹ã‚’使用ã—ã€ã“れらã®å…±é€šæ©Ÿèƒ½ã‚’自動的ã«è¿½åŠ ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "In previous versions, you had to create a script or program that could output JSON in the correct format when invoked with the proper arguments. You can still use and write inventory scripts, as we ensured backwards compatibility through the :ref:`script inventory plugin <script_inventory>` and there is no restriction on the programming language used. If you choose to write a script, however, you will need to implement some features yourself such as caching, configuration management, dynamic variable and group composition, and so on. If you use :ref:`inventory plugins <inventory_plugins>` instead, you can use the Ansible codebase and add these common features automatically." +msgstr "以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€é©åˆ‡ãªå¼•æ•°ã§å‘¼ã³å‡ºã•ã‚ŒãŸã¨ãã«æ£ã—ã„å½¢å¼ã§ JSON を出力ã§ãるスクリプトやプãƒã‚°ãƒ©ãƒ を作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã—ãŸã€‚:ref:`script inventory plugin <script_inventory>` を通ã˜ã¦å¾Œæ–¹äº’æ›æ€§ã‚’確ä¿ã—ã¦ãŠã‚Šã€ä½¿ç”¨ã™ã‚‹ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã«ã‚‚制é™ãŒãªã„ãŸã‚ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを引ã続ã使用ã—ãŸã‚Šæ›¸ã„ãŸã‚Šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã ã—ã€ã‚¹ã‚¯ãƒªãƒ—トを書ãå ´åˆã¯ã€ã‚ャッシュã€è¨å®šç®¡ç†ã€å‹•çš„ãªå¤‰æ•°ã€ã‚°ãƒ«ãƒ¼ãƒ—ã®æ§‹æˆãªã©ã€ã„ãã¤ã‹ã®æ©Ÿèƒ½ã‚’自分ã§å®Ÿè£…ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« :ref:`inventory plugins <inventory_plugins>` を使用ã™ã‚Œã°ã€Ansible ã®ã‚³ãƒ¼ãƒ‰ãƒ™ãƒ¼ã‚¹ã‚’使用ã—ã€ã“れらã®å…±é€šæ©Ÿèƒ½ã‚’自動的ã«è¿½åŠ ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_inventory.rst:22 msgid "Inventory sources" @@ -2604,7 +2609,7 @@ msgid "Path to an executable that outputs JSON" msgstr "JSON を出力ã™ã‚‹å®Ÿè¡Œå¯èƒ½ãƒ•ã‚¡ã‚¤ãƒ«ã¸ã®ãƒ‘ス" #: ../../rst/dev_guide/developing_inventory.rst:49 -#: ../../rst/dev_guide/developing_plugins.rst:334 +#: ../../rst/dev_guide/developing_plugins.rst:338 msgid "Inventory plugins" msgstr "inventory プラグイン" @@ -2705,150 +2710,202 @@ msgid "For examples on how to implement an inventory plugin, see the source code msgstr "インベントリープラグインã®å®Ÿè£…方法ã®ä¾‹ã¯ã€ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ (`lib/ansible/plugins/inventory <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/inventory>`_) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_inventory.rst:195 +msgid "inventory object" +msgstr "インベントリーオブジェクト" + +#: ../../rst/dev_guide/developing_inventory.rst:197 +msgid "The ``inventory`` object passed to ``parse`` has helpful methods for populating inventory." +msgstr "``parse`` ã«æ¸¡ã•ã‚ŒãŸ ``inventory`` オブジェクトã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«å…¥åŠ›ã™ã‚‹ãŸã‚ã®ä¾¿åˆ©ãªæ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:199 +msgid "``add_group`` adds a group to inventory if it doesn't already exist. It takes the group name as the only positional argument." +msgstr "``add_group`` ã¯ã€ã¾ã å˜åœ¨ã—ãªã„å ´åˆã«ã‚°ãƒ«ãƒ¼ãƒ—をインベントリーã«è¿½åŠ ã—ã¾ã™ã€‚唯一ã®ä½ç½®å¼•æ•°ã¨ã—ã¦ã‚°ãƒ«ãƒ¼ãƒ—åã‚’å–ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:201 +msgid "``add_child`` adds a group or host that exists in inventory to a parent group in inventory. It takes two positional arguments, the name of the parent group and the name of the child group or host." +msgstr "``add_child`` ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«å˜åœ¨ã™ã‚‹ã‚°ãƒ«ãƒ¼ãƒ—ã¾ãŸã¯ãƒ›ã‚¹ãƒˆã‚’インベントリーã®è¦ªã‚°ãƒ«ãƒ¼ãƒ—ã«è¿½åŠ ã—ã¾ã™ã€‚2 ã¤ã®ä½ç½®å¼•æ•° (親グループã®åå‰ã¨åグループã¾ãŸã¯ãƒ›ã‚¹ãƒˆã®åå‰) ã‚’å–ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:203 +msgid "``add_host`` adds a host to inventory if it doesn't already exist, optionally to a specific group. It takes the host name as the first argument and accepts two optional keyword arguments, ``group`` and ``port``. ``group`` is the name of a group in inventory, and ``port`` is an integer." +msgstr "``add_host`` ã¯ã€ã¾ã å˜åœ¨ã—ãªã„å ´åˆã«ãƒ›ã‚¹ãƒˆã‚’インベントリー (オプションã§ç‰¹å®šã®ã‚°ãƒ«ãƒ¼ãƒ—) ã«è¿½åŠ ã—ã¾ã™ã€‚最åˆã®å¼•æ•°ã¨ã—ã¦ãƒ›ã‚¹ãƒˆåã‚’å–ã‚Šã€ã‚ªãƒ—ション㧠2 ã¤ã®ã‚ーワード引数 (``group``ã¨``port``) ã‚’å—ã‘入れã¾ã™ã€‚``group`` ã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã®ã‚°ãƒ«ãƒ¼ãƒ—ã®åå‰ã€``port`` ã¯æ•´æ•°ã§ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:205 +msgid "``set_variable`` adds a variable to a group or host in inventory. It takes three positional arguments: the name of the group or host, the name of the variable, and the value of the variable." +msgstr "``set_variable`` ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã®ã‚°ãƒ«ãƒ¼ãƒ—ã¾ãŸã¯ãƒ›ã‚¹ãƒˆã«å¤‰æ•°ã‚’è¿½åŠ ã—ã¾ã™ã€‚3 ã¤ã®ä½ç½®å¼•æ•° (グループã¾ãŸã¯ãƒ›ã‚¹ãƒˆã®åå‰ã€å¤‰æ•°ã®åå‰ã€å¤‰æ•°ã®å€¤) ã‚’å–ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:207 +msgid "To create groups and variables using Jinja2 expressions, see the section on implementing ``constructed`` features below." +msgstr "Jinja2 å¼ã‚’使用ã—ã¦ã‚°ãƒ«ãƒ¼ãƒ—ã¨å¤‰æ•°ã‚’作æˆã™ã‚‹å ´åˆã¯ã€å¾Œè¿°ã® ``constructed`` 機能ã®å®Ÿè£…ã«é–¢ã™ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_inventory.rst:209 +msgid "To see other inventory object methods, see the source code here: `lib/ansible/inventory/data.py <https://github.com/ansible/ansible/tree/devel/lib/ansible/inventory/data.py>`_." +msgstr "ä»–ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚ªãƒ–ジェクトメソッドを確èªã™ã‚‹ã«ã¯ã€`lib/ansible/inventory/data.py <https://github.com/ansible/ansible/tree/devel/lib/ansible/inventory/data.py>`_ ã§ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_inventory.rst:215 msgid "inventory cache" msgstr "インベントリーã‚ャッシュ" -#: ../../rst/dev_guide/developing_inventory.rst:197 +#: ../../rst/dev_guide/developing_inventory.rst:217 msgid "To cache the inventory, extend the inventory plugin documentation with the inventory_cache documentation fragment and use the Cacheable base class." msgstr "インベントリーをã‚ャッシュã™ã‚‹ã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインã®ãƒ‰ã‚ュメントを inventory_cache ドã‚ュメントフラグメントã§æ‹¡å¼µã—ã€cacheable 基本クラスを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:210 +#: ../../rst/dev_guide/developing_inventory.rst:230 msgid "Next, load the cache plugin specified by the user to read from and update the cache. If your inventory plugin uses YAML-based configuration files and the ``_read_config_data`` method, the cache plugin is loaded within that method. If your inventory plugin does not use ``_read_config_data``, you must load the cache explicitly with ``load_cache_plugin``." msgstr "次ã«ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæŒ‡å®šã—ãŸã‚ャッシュプラグインをèªã¿è¾¼ã¿ã€ã‚ャッシュã®èªã¿å–ã‚Šã¨æ›´æ–°ã‚’è¡Œã„ã¾ã™ã€‚インベントリープラグイン㌠YAML ベースã®æ§‹æˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã—ã¦ã„ã¦ã€``_read_config_data`` メソッドã®å ´åˆã€ã‚ャッシュプラグインã¯ãã®ãƒ¡ã‚½ãƒƒãƒ‰å†…ã«èªã¿è¾¼ã¾ã‚Œã¾ã™ã€‚インベントリープラグイン㌠``_read_config_data`` を使用ã—ãªã„å ´åˆã¯ã€``load_cache_plugin`` を使用ã—ã¦ã‚ャッシュを明示的ã«èªã¿è¾¼ã‚€å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:221 +#: ../../rst/dev_guide/developing_inventory.rst:241 msgid "Before using the cache plugin, you must retrieve a unique cache key by using the ``get_cache_key`` method. This task needs to be done by all inventory modules using the cache, so that you don't use/overwrite other parts of the cache." msgstr "ã‚ャッシュプラグインを使用ã™ã‚‹å‰ã«ã€``get_cache_key`` メソッドを使用ã—ã¦ä¸€æ„ã®ã‚ャッシュã‚ーをå–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚¿ã‚¹ã‚¯ã¯ã€ã‚ャッシュを使用ã™ã‚‹ã™ã¹ã¦ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§å®Ÿè¡Œã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ã‚ャッシュã®ä»–ã®éƒ¨åˆ†ã‚’使用/上書ãã—ãªã„よã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:231 -msgid "Now that you've enabled caching, loaded the correct plugin, and retrieved a unique cache key, you can set up the flow of data between the cache and your inventory using the ``cache`` parameter of the ``parse`` method. This value comes from the inventory manager and indicates whether the inventory is being refreshed (such as via ``--flush-cache`` or the meta task ``refresh_inventory``). Although the cache shouldn't be used to populate the inventory when being refreshed, the cache should be updated with the new inventory if the user has enabled caching. You can use ``self._cache`` like a dictionary. The following pattern allows refreshing the inventory to work in conjunction with caching." -msgstr "ã“ã‚Œã§ã‚ャッシュを有効ã«ã—ã€æ£ã—ã„プラグインをèªã¿è¾¼ã¿ã€ä¸€æ„ã®ã‚ャッシュã‚ーをå–å¾—ã—ã€``parse`` メソッド㮠``cache`` パラメーターを使用ã—ã¦ã€ã‚ャッシュã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®é–“ã§ãƒ‡ãƒ¼ã‚¿ã®ãƒ•ãƒãƒ¼ã‚’è¨å®šã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®å€¤ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒžãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã‹ã‚‰å–å¾—ã•ã‚Œã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’æ›´æ–°ã™ã‚‹ã‹ (例: ``--flush-cache``ã€ãƒ¡ã‚¿ã‚¿ã‚¹ã‚¯ ``refresh_inventory`` ãªã©) を示ã—ã¾ã™ã€‚ã‚ャッシュã¯ã€æ›´æ–°æ™‚ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’入力ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã—ã¾ã™ãŒã€ã‚ャッシュを有効ã«ã—ãŸå ´åˆã¯ã€ã‚ャッシュを新ã—ã„インベントリーã§æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ディクショナリーã®ã‚ˆã†ãª ``self._cache`` を使用ã§ãã¾ã™ã€‚以下ã®ãƒ‘ターンを使用ã™ã‚‹ã¨ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’ã‚ャッシュã¨ã¨ã‚‚ã«å‹•ä½œã•ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_inventory.rst:251 +msgid "Now that you've enabled caching, loaded the correct plugin, and retrieved a unique cache key, you can set up the flow of data between the cache and your inventory using the ``cache`` parameter of the ``parse`` method. This value comes from the inventory manager and indicates whether the inventory is being refreshed (such as by the ``--flush-cache`` or the meta task ``refresh_inventory``). Although the cache shouldn't be used to populate the inventory when being refreshed, the cache should be updated with the new inventory if the user has enabled caching. You can use ``self._cache`` like a dictionary. The following pattern allows refreshing the inventory to work in conjunction with caching." +msgstr "ã“ã‚Œã§ã‚ャッシュを有効ã«ã—ã€æ£ã—ã„プラグインをèªã¿è¾¼ã¿ã€ä¸€æ„ã®ã‚ャッシュã‚ーをå–å¾—ã—ãŸã“ã¨ã§ã€``parse`` メソッド㮠``cache`` パラメーターを使用ã—ã¦ã€ã‚ャッシュã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®é–“ã§ãƒ‡ãƒ¼ã‚¿ã®ãƒ•ãƒãƒ¼ã‚’è¨å®šã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®å€¤ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒžãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã‹ã‚‰å–å¾—ã•ã‚Œã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’æ›´æ–°ã™ã‚‹ã‹ (例: ``--flush-cache``ã€ãƒ¡ã‚¿ã‚¿ã‚¹ã‚¯ ``refresh_inventory`` ãªã©) を示ã—ã¾ã™ã€‚ã‚ャッシュã¯ã€æ›´æ–°æ™‚ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’入力ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã™ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ã‚ャッシュを有効ã«ã—ãŸå ´åˆã¯ã€ã‚ャッシュを新ã—ã„インベントリーã§æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ディクショナリーã®ã‚ˆã†ãª ``self._cache`` を使用ã§ãã¾ã™ã€‚以下ã®ãƒ‘ターンを使用ã™ã‚‹ã¨ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’ã‚ャッシュã¨ã¨ã‚‚ã«å‹•ä½œã•ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:266 +#: ../../rst/dev_guide/developing_inventory.rst:286 msgid "After the ``parse`` method is complete, the contents of ``self._cache`` is used to set the cache plugin if the contents of the cache have changed." msgstr "``parse`` メソッドãŒå®Œäº†ã™ã‚‹ã¨ã€``self._cache`` ã®å†…容ã¯ã€ã‚ャッシュã®å†…容ãŒå¤‰æ›´ã•ã‚ŒãŸå ´åˆã«ã‚ャッシュプラグインをè¨å®šã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:271 +#: ../../rst/dev_guide/developing_inventory.rst:291 msgid "You have three other cache methods available:" msgstr "利用å¯èƒ½ãª 3 ã¤ã®ã‚ャッシュメソッド:" -#: ../../rst/dev_guide/developing_inventory.rst:269 +#: ../../rst/dev_guide/developing_inventory.rst:289 msgid "``set_cache_plugin`` forces the cache plugin to be set with the contents of ``self._cache``, before the ``parse`` method completes" msgstr "``set_cache_plugin`` ã¯ã€``parse`` メソッドã®å®Œäº†å‰ã«ã€ã‚ャッシュプラグインを ``self._cache`` ã®å†…容ã§å¼·åˆ¶çš„ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:270 +#: ../../rst/dev_guide/developing_inventory.rst:290 msgid "``update_cache_if_changed`` sets the cache plugin only if ``self._cache`` has been modified, before the ``parse`` method completes" msgstr "``update_cache_if_changed`` ã¯ã€``parse`` メソッドãŒå®Œäº†ã™ã‚‹å‰ã« ``self._cache`` ãŒå¤‰æ›´ã•ã‚ŒãŸå ´åˆã®ã¿ã‚ャッシュプラグインをè¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:271 +#: ../../rst/dev_guide/developing_inventory.rst:291 msgid "``clear_cache`` flushes the cache, ultimately by calling the cache plugin's ``flush()`` method, whose implementation is dependent upon the particular cache plugin in use. Note that if the user is using the same cache backend for facts and inventory, both will get flushed. To avoid this, the user can specify a distinct cache backend in their inventory plugin configuration." msgstr "``clear_cache`` ã‚ャッシュをフラッシュã—ã€ã‚ャッシュプラグイン㮠``flush()`` メソッドを呼ã³å‡ºã™ã“ã¨ã§ã€ã“れらã®å®Ÿè£…ã¯ä½¿ç”¨ä¸ã®ç‰¹å®šã®ã‚ャッシュプラグインã«ä¾å˜ã—ã¾ã™ã€‚ファクトã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§åŒã˜ã‚ャッシュãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ä¸¡æ–¹ã®ã‚ャッシュãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚’フラッシュã—ã¾ã™ã€‚ã“れを回é¿ã™ã‚‹ãŸã‚ã«ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインè¨å®šã§å€‹åˆ¥ã®ã‚ャッシュãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚’指定ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:274 +#: ../../rst/dev_guide/developing_inventory.rst:294 msgid "constructed features" msgstr "constructed 機能" -#: ../../rst/dev_guide/developing_inventory.rst:276 +#: ../../rst/dev_guide/developing_inventory.rst:296 msgid "Inventory plugins can create host variables and groups from Jinja2 expressions and variables by using features from the ``constructed`` inventory plugin. To do this, use the ``Constructable`` base class and extend the inventory plugin's documentation with the ``constructed`` documentation fragment." msgstr "インベントリープラグインã¯ã€``constructed`` インベントリープラグインã®æ©Ÿèƒ½ã‚’使用ã—ã¦ã€Jinja2 å¼ãŠã‚ˆã³å¤‰æ•°ã‹ã‚‰ãƒ›ã‚¹ãƒˆå¤‰æ•°ãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—を作æˆã§ãã¾ã™ã€‚ã“れを行ã†ã«ã¯ã€``Constructable`` ベースクラスを使用ã—ã€``constructed`` ドã‚ュメントフラグメントã§ãƒ‰ã‚ュメントを拡張ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:289 -msgid "The three main options from the ``constructed`` documentation fragment are ``compose``, ``keyed_groups``, and ``groups``. See the ``constructed`` inventory plugin for examples on using these. ``compose`` is a dictionary of variable names and Jinja2 expressions. Once a host is added to inventory and any initial variables have been set, call the method ``_set_composite_vars`` to add composed host variables. If this is done before adding ``keyed_groups`` and ``groups``, the group generation will be able to use the composed variables." -msgstr "``constructed`` ドã‚ュメントフラグ㮠3 ã¤ã®ä¸»è¦ãªã‚ªãƒ—ションã¯ã€``compose``ã€``keyed_groups``ã€ãŠã‚ˆã³ ``groups`` ã§ã™ã€‚ã“れらã®ä½¿ç”¨ä¾‹ã¯ã€``constructed`` インベントリープラグインをå‚ç…§ã—ã¦ãã ã•ã„。``compose`` ã¯ã€å¤‰æ•°åãŠã‚ˆã³ Jinja2 å¼ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã™ã€‚ホストãŒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«è¿½åŠ ã•ã‚Œã€åˆæœŸå¤‰æ•°ãŒè¨å®šã•ã‚Œã‚‹ã¨ã€``_set_composite_vars`` メソッドを呼ã³å‡ºã—ã¦æ§‹æˆã•ã‚ŒãŸãƒ›ã‚¹ãƒˆå¤‰æ•°ã‚’è¿½åŠ ã—ã¾ã™ã€‚``keyed_groups`` ãŠã‚ˆã³ ``groups`` ã‚’è¿½åŠ ã™ã‚‹å‰ã«ã“れを行ã†ã¨ã€ã‚°ãƒ«ãƒ¼ãƒ—ã®ç”Ÿæˆã¯æ§‹æˆã•ã‚ŒãŸå¤‰æ•°ã‚’使用ã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_inventory.rst:309 +msgid "There are three main options in the ``constructed`` documentation fragment:" +msgstr "``constructed`` ドã‚ュメントフラグメントã«ã¯ã€ä¸»ã« 3 ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:311 +msgid "``compose`` creates variables using Jinja2 expressions. This is implemented by calling the ``_set_composite_vars`` method. ``keyed_groups`` creates groups of hosts based on variable values. This is implemented by calling the ``_add_host_to_keyed_groups`` method. ``groups`` creates groups based on Jinja2 conditionals. This is implemented by calling the ``_add_host_to_composed_groups`` method." +msgstr "``compose`` ã¯ã€Jinja2 å¼ã‚’使用ã—ã¦å¤‰æ•°ã‚’作æˆã—ã¾ã™ã€‚ã“ã‚Œã¯ã€``_set_composite_vars`` メソッドを呼ã³å‡ºã™ã“ã¨ã§å®Ÿè£…ã•ã‚Œã¾ã™ã€‚``keyed_groups`` ã¯ã€å¤‰æ•°å€¤ã«åŸºã¥ã„ã¦ãƒ›ã‚¹ãƒˆã®ã‚°ãƒ«ãƒ¼ãƒ—を作æˆã—ã¾ã™ã€‚ã“ã‚Œã¯ã€``_add_host_to_keyed_groups`` メソッドを呼ã³å‡ºã™ã“ã¨ã§å®Ÿè£…ã•ã‚Œã¾ã™ã€‚``groups`` ã¯ã€Jinja2 æ¡ä»¶ã«åŸºã¥ã„ã¦ã‚°ãƒ«ãƒ¼ãƒ—を作æˆã—ã¾ã™ã€‚ã“ã‚Œã¯ã€``_add_host_to_composed_groups`` メソッドを呼ã³å‡ºã™ã“ã¨ã§å®Ÿè£…ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:315 +msgid "Each method should be called for every host added to inventory. Three positional arguments are required: the constructed option, a dictionary of variables, and a host name. Calling the method ``_set_composite_vars`` first will allow ``keyed_groups`` and ``groups`` to use the composed variables." +msgstr "å„メソッドã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«è¿½åŠ ã•ã‚ŒãŸãƒ›ã‚¹ãƒˆã”ã¨ã«å‘¼ã³å‡ºã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ 3 ã¤ã®ä½ç½®å¼•æ•° (構築済ã¿ã‚ªãƒ—ションã€å¤‰æ•°ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã€ãƒ›ã‚¹ãƒˆå) ãŒå¿…è¦ã§ã™ã€‚最åˆã« ``_set_composite_vars`` メソッドを呼ã³å‡ºã™ã¨ã€``keyed_groups`` 㨠``groups`` ã¯æ§‹ç¯‰æ¸ˆã¿å¤‰æ•°ã‚’使用ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:310 +#: ../../rst/dev_guide/developing_inventory.rst:317 +msgid "By default, undefined variables are ignored. This is permitted by default for ``compose`` so you can make the variable definitions depend on variables that will be populated later in a play from other sources. For groups, it allows using variables that are not always present without having to use the ``default`` filter. To support configuring undefined variables to be an error, pass the constructed option ``strict`` to each of the methods as a keyword argument." +msgstr "デフォルトã§ã¯ã€æœªå®šç¾©ã®å¤‰æ•°ã¯ç„¡è¦–ã•ã‚Œã¾ã™ã€‚``compose`` ã§ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§è¨±å¯ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€å¾Œã§ä»–ã®ã‚½ãƒ¼ã‚¹ã‹ã‚‰ãƒ—レイã§å…¥åŠ›ã•ã‚Œã‚‹å¤‰æ•°ã«ä¾å˜ã™ã‚‹å¤‰æ•°å®šç¾©ã‚’作æˆã§ãã¾ã™ã€‚グループã®å ´åˆã€``default`` フィルターを使用ã—ãªãã¦ã‚‚ã€å¸¸ã«å˜åœ¨ã™ã‚‹ã¨ã¯é™ã‚‰ãªã„変数を使用ã§ãã¾ã™ã€‚未定義ã®å¤‰æ•°ã‚’エラーã«ã™ã‚‹è¨å®šã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€æ§‹ç¯‰ã•ã‚ŒãŸã‚ªãƒ—ション ``strict`` ã‚’ã‚ーワード引数ã¨ã—ã¦å„メソッドã«æ¸¡ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:319 +msgid "``keyed_groups`` and ``groups`` use any variables already associated with the host (for example, from an earlier inventory source). ``_add_host_to_keyed_groups`` and ``add_host_to_composed_groups`` can turn this off by passing the keyword argument ``fetch_hostvars``." +msgstr "``keyed_groups`` ã¨``groups`` ã¯ã€ã™ã§ã«ãƒ›ã‚¹ãƒˆã«é–¢é€£ä»˜ã‘られã¦ã„る変数を使用ã—ã¾ã™ (ãŸã¨ãˆã°ã€ä»¥å‰ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‹ã‚‰)。``_add_host_to_keyed_groups`` 㨠``add_host_to_composed_groups`` ã¯ã€ã‚ーワード引数 ``fetch_hostvars`` を渡ã™ã“ã¨ã§ã“れをオフã«ã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:321 +msgid "Here is an example using all three methods:" +msgstr "以下ã¯ã€3 ã¤ã®æ–¹æ³•ã™ã¹ã¦ã‚’使用ã—ãŸä¾‹ã§ã™ã€‚" + +#: ../../rst/dev_guide/developing_inventory.rst:340 msgid "By default, group names created with ``_add_host_to_composed_groups()`` and ``_add_host_to_keyed_groups()`` are valid Python identifiers. Invalid characters are replaced with an underscore ``_``. A plugin can change the sanitization used for the constructed features by setting ``self._sanitize_group_name`` to a new function. The core engine also does sanitization, so if the custom function is less strict it should be used in conjunction with the configuration setting ``TRANSFORM_INVALID_GROUP_CHARS``." msgstr "デフォルトã§ã¯ã€``_add_host_to_composed_groups()`` ãŠã‚ˆã³ ``_add_host_to_keyed_groups()`` ã§ä½œæˆã•ã‚ŒãŸã‚°ãƒ«ãƒ¼ãƒ—åã¯æœ‰åŠ¹ãª Python è˜åˆ¥åã§ã™ã€‚無効ãªæ–‡å—ã¯ã‚¢ãƒ³ãƒ€ãƒ¼ã‚¹ã‚³ã‚¢ ``_`` ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚プラグインã¯ã€``self._sanitize_group_name`` ã‚’æ–°ã—ã„機能ã«è¨å®šã™ã‚‹ã“ã¨ã§ã€constructed 機能ã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚µãƒ‹ã‚¿ã‚¤ã‚¼ãƒ¼ã‚·ãƒ§ãƒ³ã‚’変更ã§ãã¾ã™ã€‚コアエンジンもサニタイゼーションを実行ã™ã‚‹ãŸã‚ã€ã‚«ã‚¹ã‚¿ãƒ 機能ãŒãã‚Œã»ã©åŽ³å¯†ã§ãªã„å ´åˆã¯ã€æ§‹æˆè¨å®š ``TRANSFORM_INVALID_GROUP_CHARS`` ã¨çµ„ã¿åˆã‚ã›ã¦ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:332 +#: ../../rst/dev_guide/developing_inventory.rst:362 msgid "Common format for inventory sources" msgstr "インベントリーソースã®å…±é€šå½¢å¼" -#: ../../rst/dev_guide/developing_inventory.rst:334 +#: ../../rst/dev_guide/developing_inventory.rst:364 msgid "To simplify development, most plugins use a standard YAML-based configuration file as the inventory source. The file has only one required field ``plugin``, which should contain the name of the plugin that is expected to consume the file. Depending on other common features used, you might need other fields, and you can add custom options in each plugin as required. For example, if you use the integrated caching, ``cache_plugin``, ``cache_timeout`` and other cache-related fields could be present." msgstr "開発を簡å˜ã«ã™ã‚‹ãŸã‚ã«ã€ã»ã¨ã‚“ã©ã®ãƒ—ラグインã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã¨ã—ã¦æ¨™æº–的㪠YAML ベースã®è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã—ã¦ã„ã¾ã™ã€‚ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€å¿…é ˆãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒ 1 ã¤ã—ã‹ã‚ã‚Šã¾ã›ã‚“ (``plugin``)。ã“ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã«ã¯ã€ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã™ã‚‹ã“ã¨ãŒæœŸå¾…ã•ã‚Œã‚‹ãƒ—ラグインã®åå‰ã‚’入れる必è¦ãŒã‚ã‚Šã¾ã™ã€‚使用ã™ã‚‹ä»–ã®å…±é€šæ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ä»–ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã€å¿…è¦ã«å¿œã˜ã¦å„プラグインã«ã‚«ã‚¹ã‚¿ãƒ ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€çµ±åˆã‚ャッシングを使用ã™ã‚‹å ´åˆã¯ã€``cache_plugin``ã€``cache_timeout`` ãªã©ã®ã‚ャッシュ関連ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒå˜åœ¨ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:341 +#: ../../rst/dev_guide/developing_inventory.rst:371 msgid "The 'auto' plugin" msgstr "「autoã€ãƒ—ラグイン" -#: ../../rst/dev_guide/developing_inventory.rst:343 +#: ../../rst/dev_guide/developing_inventory.rst:373 msgid "From Ansible 2.5 onwards, we include the :ref:`auto inventory plugin <auto_inventory>` and enable it by default. If the ``plugin`` field in your standard configuration file matches the name of your inventory plugin, the ``auto`` inventory plugin will load your plugin. The 'auto' plugin makes it easier to use your plugin without having to update configurations." msgstr "Ansible 2.5 以é™ã§ã¯ã€:ref:`auto inventory plugin <auto_inventory>` ã‚’è¿½åŠ ã—ã€ã“れをデフォルトã§æœ‰åŠ¹åŒ–ã—ã¾ã™ã€‚標準è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã® ``plugin`` フィールドãŒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインã®åå‰ã¨ä¸€è‡´ã™ã‚‹å ´åˆã€``auto`` インベントリープラグインã¯ãƒ—ラグインをèªã¿è¾¼ã¿ã¾ã™ã€‚「autoã€ãƒ—ラグインã¯ã€è¨å®šã‚’æ›´æ–°ã›ãšã«ãƒ—ラグインを簡å˜ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:350 +#: ../../rst/dev_guide/developing_inventory.rst:380 msgid "Inventory scripts" msgstr "インベントリースクリプト" -#: ../../rst/dev_guide/developing_inventory.rst:352 +#: ../../rst/dev_guide/developing_inventory.rst:382 msgid "Even though we now have inventory plugins, we still support inventory scripts, not only for backwards compatibility but also to allow users to use other programming languages." msgstr "inventory プラグインã¯ãã®ã¾ã¾ã§ã™ãŒã€å¾Œæ–¹äº’æ›æ€§ã ã‘ã§ãªãã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒä»–ã®ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã‚’使用ã§ãるよã†ã«ã€å¼•ã続ãインベントリースクリプトをサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:358 +#: ../../rst/dev_guide/developing_inventory.rst:388 msgid "Inventory script conventions" msgstr "インベントリースクリプトã®è¦å‰‡" -#: ../../rst/dev_guide/developing_inventory.rst:360 +#: ../../rst/dev_guide/developing_inventory.rst:390 msgid "Inventory scripts must accept the ``--list`` and ``--host <hostname>`` arguments. Although other arguments are allowed, Ansible will not use them. Such arguments might still be useful for executing the scripts directly." msgstr "インベントリースクリプトã§ã¯ã€å¼•æ•° ``--list`` ãŠã‚ˆã³ ``--host <hostname>`` を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ä»–ã®å¼•æ•°ã¯è¨å®šã§ãã¾ã™ãŒã€Ansible ã¯ãれらを使用ã—ã¾ã›ã‚“。ã“ã®ã‚ˆã†ãªå¼•æ•°ã¯ã€ã‚¹ã‚¯ãƒªãƒ—トを直接実行ã™ã‚‹ã®ã«å½¹ç«‹ã¤å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:363 +#: ../../rst/dev_guide/developing_inventory.rst:393 msgid "When the script is called with the single argument ``--list``, the script must output to stdout a JSON object that contains all the groups to be managed. Each group's value should be either an object containing a list of each host, any child groups, and potential group variables, or simply a list of hosts:" msgstr "スクリプトãŒå˜ä¸€ã®å¼•æ•° ``--list`` ã§å‘¼ã³å‡ºã•ã‚Œã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯ã€æ¨™æº–出力ã«ã€ç®¡ç†ã™ã‚‹ã™ã¹ã¦ã®ã‚°ãƒ«ãƒ¼ãƒ—ãŒå«ã¾ã‚Œã‚‹ JSON オブジェクトを出力ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚å„グループã®å€¤ã¯ã€å„ホストã€åグループã€ãŠã‚ˆã³æ½œåœ¨çš„ãªã‚°ãƒ«ãƒ¼ãƒ—変数ã®ä¸€è¦§ã‚’å«ã‚€ã‚ªãƒ–ジェクトã€ã¾ãŸã¯ç°¡å˜ã«ãƒ›ã‚¹ãƒˆã®ä¸€è¦§ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:386 +#: ../../rst/dev_guide/developing_inventory.rst:416 msgid "If any of the elements of a group are empty, they may be omitted from the output." msgstr "グループã®ã„ãšã‚Œã‹ã®è¦ç´ ãŒç©ºã®å ´åˆã¯ã€å‡ºåŠ›ã‹ã‚‰çœç•¥ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:388 +#: ../../rst/dev_guide/developing_inventory.rst:418 msgid "When called with the argument ``--host <hostname>`` (where <hostname> is a host from above), the script must print a JSON object, either empty or containing variables to make them available to templates and playbooks. For example:" msgstr "引数 ``--host <hostname>`` ã§å‘¼ã³å‡ºã•ã‚Œã‚‹å ´åˆ (<hostname> ã¯ä¸Šè¨˜ã®ãƒ›ã‚¹ãƒˆ) ã§å‘¼ã³å‡ºã•ã‚Œã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ç©ºã‹ã€å¤‰æ•°ã‚’å«ã‚€ JSON オブジェクトを出力ã—ã¦ã€ãƒ†ãƒ³ãƒ—レート㨠Playbook ã§åˆ©ç”¨å¯èƒ½ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:397 +#: ../../rst/dev_guide/developing_inventory.rst:427 msgid "Printing variables is optional. If the script does not print variables, it should print an empty JSON object." msgstr "変数ã®å‡ºåŠ›ã¯ä»»æ„ã§ã™ã€‚スクリプトãŒå¤‰æ•°ã‚’出力ã—ãªã„å ´åˆã¯ã€ç©ºã® JSON オブジェクトを出力ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:402 +#: ../../rst/dev_guide/developing_inventory.rst:432 msgid "Tuning the external inventory script" msgstr "外部インベントリースクリプトã®ãƒãƒ¥ãƒ¼ãƒ‹ãƒ³ã‚°" -#: ../../rst/dev_guide/developing_inventory.rst:406 +#: ../../rst/dev_guide/developing_inventory.rst:436 msgid "The stock inventory script system mentioned above works for all versions of Ansible, but calling ``--host`` for every host can be rather inefficient, especially if it involves API calls to a remote subsystem." msgstr "上記ã®ã‚¹ãƒˆãƒƒã‚¯ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トシステムã¯ã€ã™ã¹ã¦ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã«å¯¾ã—ã¦å‹•ä½œã—ã¾ã™ãŒã€ç‰¹ã«ãƒªãƒ¢ãƒ¼ãƒˆã‚µãƒ–システムã¸ã® API 呼ã³å‡ºã—ãŒå¿…è¦ã«ãªã‚‹å ´åˆã¯ã€ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã«å¯¾ã—㦠``--host`` を呼ã³å‡ºã™ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:408 +#: ../../rst/dev_guide/developing_inventory.rst:438 msgid "To avoid this inefficiency, if the inventory script returns a top-level element called \"_meta\", it is possible to return all the host variables in a single script execution. When this meta element contains a value for \"hostvars\", the inventory script will not be invoked with ``--host`` for each host. This behavior results in a significant performance increase for large numbers of hosts." msgstr "ã“れを回é¿ã™ã‚‹ã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トãŒã€Œ_metaã€ã¨ã„ã†æœ€ä¸Šä½ã®è¦ç´ ã‚’è¿”ã™å ´åˆã«ã¯ã€å˜ä¸€ã‚¹ã‚¯ãƒªãƒ—トã®å®Ÿè¡Œã§ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆå¤‰æ•°ã‚’è¿”ã™ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã®ãƒ¡ã‚¿è¦ç´ ã«ã€Œhostvarsã€ã®å€¤ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã¨ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯å„ホストã«å¯¾ã—㦠``--host`` ã§å‘¼ã³å‡ºã•ã‚Œã¾ã›ã‚“。ã“ã®å‹•ä½œã¯ã€å¤šæ•°ã®ãƒ›ã‚¹ãƒˆã®ãƒ‘フォーマンスを大幅ã«å‘上ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:410 +#: ../../rst/dev_guide/developing_inventory.rst:440 msgid "The data to be added to the top-level JSON object looks like this:" msgstr "レベル㮠JSON オブジェクトã«è¿½åŠ ã™ã‚‹ãƒ‡ãƒ¼ã‚¿ã¯æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:431 +#: ../../rst/dev_guide/developing_inventory.rst:461 msgid "To satisfy the requirements of using ``_meta``, to prevent ansible from calling your inventory with ``--host`` you must at least populate ``_meta`` with an empty ``hostvars`` object. For example:" msgstr "Ansible ㌠``--host`` ã§ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’呼ã³å‡ºã™ã®ã‚’防ããŸã‚ã« ``_meta`` を使用ã™ã‚‹è¦ä»¶ã‚’満ãŸã™ã«ã¯ã€å°‘ãªãã¨ã‚‚空㮠``hostvars`` オブジェクト㧠``_meta`` を埋ã‚ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:449 +#: ../../rst/dev_guide/developing_inventory.rst:479 msgid "If you intend to replace an existing static inventory file with an inventory script, it must return a JSON object which contains an 'all' group that includes every host in the inventory as a member and every group in the inventory as a child. It should also include an 'ungrouped' group which contains all hosts which are not members of any other group. A skeleton example of this JSON object is:" msgstr "æ—¢å˜ã®é™çš„インベントリーファイルをインベントリースクリプトã«ç½®ãæ›ãˆã‚‹å ´åˆã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã®ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã‚’メンãƒãƒ¼ã¨ã—ã¦ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã®ã™ã¹ã¦ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’åã¨ã—ã¦å«ã‚€ã€Œã™ã¹ã¦ã€ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’å«ã‚€ JSON オブジェクトを返ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€ä»–ã®ã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã¯ãªã„ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã‚’å«ã‚€ã€Œã‚°ãƒ«ãƒ¼ãƒ—化ã•ã‚Œã¦ã„ãªã„ã€ã‚°ãƒ«ãƒ¼ãƒ—ã‚‚å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã® JSON オブジェクトã®ã‚¹ã‚±ãƒ«ãƒˆãƒ³ã®ä¾‹ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:469 +#: ../../rst/dev_guide/developing_inventory.rst:499 msgid "An easy way to see how this should look is using :ref:`ansible-inventory`, which also supports ``--list`` and ``--host`` parameters like an inventory script would." msgstr "ã“ã‚ŒãŒã©ã®ã‚ˆã†ã«è¦‹ãˆã‚‹ã‹ã‚’確èªã™ã‚‹ç°¡å˜ãªæ–¹æ³•ã¯ã€:ref:`ansible-inventory` を使用ã™ã‚‹ã“ã¨ã§ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã®ã‚ˆã†ã« ``--list`` パラメーターãŠã‚ˆã³ ``--host`` パラメーターãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_inventory.rst:474 +#: ../../rst/dev_guide/developing_inventory.rst:504 msgid "Python API to Playbooks and Ad Hoc Task Execution" msgstr "Playbook ãŠã‚ˆã³ã‚¢ãƒ‰ãƒ›ãƒƒã‚¯ã‚¿ã‚¹ã‚¯å®Ÿè¡Œã®ãŸã‚ã® Python API" -#: ../../rst/dev_guide/developing_inventory.rst:476 +#: ../../rst/dev_guide/developing_inventory.rst:506 msgid "Get started with developing a module" msgstr "モジュールã®é–‹ç™ºã‚’始ã‚ã‚‹" -#: ../../rst/dev_guide/developing_inventory.rst:479 +#: ../../rst/dev_guide/developing_inventory.rst:509 msgid "`AWX <https://github.com/ansible/awx>`_" msgstr "`AWX <https://github.com/ansible/awx>`_" -#: ../../rst/dev_guide/developing_inventory.rst:480 +#: ../../rst/dev_guide/developing_inventory.rst:510 msgid "REST API endpoint and GUI for Ansible, syncs with dynamic inventory" msgstr "Ansible ã® REST API エンドãƒã‚¤ãƒ³ãƒˆãŠã‚ˆã³ GUI (動的インベントリーã¨åŒæœŸ)" @@ -2901,12 +2958,12 @@ msgid "If you are looking to add functionality to Ansible, you might wonder whet msgstr "Ansible ã«æ©Ÿèƒ½ã‚’è¿½åŠ ã™ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインã®ã©ã¡ã‚‰ãŒå¿…è¦ã‹ç–‘å•ã«æ€ã†å ´åˆãŒã‚ã‚Šã¾ã™ã€‚以下ã«ã€å¿…è¦ãªã‚‚ã®ã‚’ç†è§£ã™ã‚‹ã®ã«å½¹ç«‹ã¤æ¦‚è¦ã‚’示ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_locally.rst:31 -msgid "Modules are reusable, standalone scripts that can be used by the Ansible API, the :command:`ansible` command, or the :command:`ansible-playbook` command. Modules provide a defined interface. Each module accepts arguments and returns information to Ansible by printing a JSON string to stdout before exiting. Modules execute on the target system (usually that means on a remote system) in separate processes. Modules are technically plugins, but for historical reasons we do not usually talk about \"module plugins\"." -msgstr "モジュールã¯ã€Ansible APIã€:command:`ansible` コマンドã€ã¾ãŸã¯ :command:`ansible-playbook` コマンドã§ä½¿ç”¨ã§ãã‚‹å†åˆ©ç”¨å¯èƒ½ãªã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã‚¹ã‚¯ãƒªãƒ—トã§ã™ã€‚モジュールã¯ã€å®šç¾©ã•ã‚ŒãŸã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã‚’æä¾›ã—ã¾ã™ã€‚å„モジュールã¯å¼•æ•°ã‚’å—ã‘入れã€çµ‚了ã™ã‚‹å‰ã« JSON æ–‡å—列を stdout ã«å‡ºåŠ›ã—㦠Ansible ã«æƒ…å ±ã‚’è¿”ã—ã¾ã™ã€‚モジュールã¯ã€åˆ¥ã®ãƒ—ãƒã‚»ã‚¹ã§ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚·ã‚¹ãƒ†ãƒ (通常ã¯ãƒªãƒ¢ãƒ¼ãƒˆã‚·ã‚¹ãƒ†ãƒ 上) ã§å®Ÿè¡Œã•ã‚Œã¾ã™ã€‚モジュールã¯æŠ€è¡“çš„ã«ã¯ãƒ—ラグインã§ã™ãŒã€éŽåŽ»ã®çµŒç·¯ã‹ã‚‰ã€é€šå¸¸ã€Œãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ—ラグインã€ã¨ã¯å‘¼ã³ã¾ã›ã‚“。" +msgid ":ref:`Plugins <working_with_plugins>` extend Ansible's core functionality. Most plugin types execute on the control node within the ``/usr/bin/ansible`` process. Plugins offer options and extensions for the core features of Ansible: transforming data, logging output, connecting to inventory, and more." +msgstr ":ref:`Plugins <working_with_plugins>` ã¯ã€Ansible ã®ã‚³ã‚¢æ©Ÿèƒ½ã‚’æ‹¡å¼µã—ã¾ã™ã€‚ã»ã¨ã‚“ã©ã®ãƒ—ラグインタイプã¯ã€``/usr/bin/ansible`` プãƒã‚»ã‚¹å†…ã®ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã§å®Ÿè¡Œã—ã¾ã™ã€‚プラグインã¯ã€Ansible ã®ã‚³ã‚¢æ©Ÿèƒ½ã®ã‚ªãƒ—ションãŠã‚ˆã³æ‹¡å¼µæ©Ÿèƒ½ (データã®å¤‰æ›ã€ãƒã‚°å‡ºåŠ›ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã¸ã®æŽ¥ç¶šãªã©) ã‚’æä¾›ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_locally.rst:32 -msgid ":ref:`Plugins <working_with_plugins>` extend Ansible's core functionality and execute on the control node within the ``/usr/bin/ansible`` process. Plugins offer options and extensions for the core features of Ansible - transforming data, logging output, connecting to inventory, and more." -msgstr ":ref:`Plugins <working_with_plugins>` ã¯ã€Ansible ã®ã‚³ã‚¢æ©Ÿèƒ½ã‚’æ‹¡å¼µã—ã€``/usr/bin/ansible`` プãƒã‚»ã‚¹å†…ã®ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã§å®Ÿè¡Œã—ã¾ã™ã€‚プラグインã¯ã€Ansible ã®ã‚³ã‚¢æ©Ÿèƒ½ã®ã‚ªãƒ—ションãŠã‚ˆã³æ‹¡å¼µæ©Ÿèƒ½ (データã®å¤‰æ›ã€ãƒã‚°å‡ºåŠ›ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã¸ã®æŽ¥ç¶šãªã©) ã‚’æä¾›ã—ã¾ã™ã€‚" +msgid "Modules are a type of plugin that execute automation tasks on a 'target' (usually a remote system). Modules work as standalone scripts that Ansible executes in their own process outside of the controller. Modules interface with Ansible mostly via JSON, accepting arguments and returning information by printing a JSON string to stdout before exiting. Unlike the other plugins (which must be written in Python), modules can be written in any language; although Ansible provides modules in Python and Powershell only." +msgstr "モジュールã¯ã€'target' (通常ã¯ãƒªãƒ¢ãƒ¼ãƒˆã‚·ã‚¹ãƒ†ãƒ ) ã§è‡ªå‹•åŒ–タスクを実行ã™ã‚‹ãƒ—ラグインã®ä¸€ç¨®ã§ã™ã€‚モジュールã¯ã€Ansible ãŒã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼å¤–ã®ç‹¬è‡ªã®ãƒ—ãƒã‚»ã‚¹ã§å®Ÿè¡Œã™ã‚‹ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã‚¹ã‚¯ãƒªãƒ—トã¨ã—ã¦æ©Ÿèƒ½ã—ã¾ã™ã€‚モジュールã¯ä¸»ã« JSON を介ã—㦠Ansible ã¨ã‚„ã‚Šå–ã‚Šã—ã€çµ‚了ã™ã‚‹å‰ã« JSON æ–‡å—列を stdout ã«å‡ºåŠ›ã—ã¦å¼•æ•°ã‚’å—ã‘å–ã‚Šã€æƒ…å ±ã‚’è¿”ã—ã¾ã™ã€‚ä»–ã® (Python ã§æ›¸ã‹ã‚Œã‚‹å¿…è¦ãŒã‚ã‚‹) プラグインã¨ã¯ç•°ãªã‚Šã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ä»»æ„ã®è¨€èªžã§æ›¸ãã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã ã—ã€Ansible 㯠Python 㨠Powershell ã§ã®ã¿ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’æä¾›ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_locally.rst:37 msgid "Adding modules and plugins in collections" @@ -2921,12 +2978,12 @@ msgid "The rest of this page describes other methods of using local, standalone msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã®æ®‹ã‚Šã®éƒ¨åˆ†ã§ã¯ã€ãƒãƒ¼ã‚«ãƒ«ã®ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„プラグインを使用ã™ã‚‹ä»–ã®æ–¹æ³•ã«ã¤ã„ã¦èª¬æ˜Žã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_locally.rst:46 -msgid "Adding a module outside of a collection" -msgstr "コレクション外ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®è¿½åŠ " +msgid "Adding a module or plugin outside of a collection" +msgstr "コレクション外ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„プラグインã®è¿½åŠ " #: ../../rst/dev_guide/developing_locally.rst:48 -msgid "You can configure Ansible to load standalone local modules in a specified location or locations and make them available to all playbooks and roles. Alternatively, you can make a non-collection local module available only to specific playbooks or roles." -msgstr "指定ã—ãŸå ´æ‰€ã®ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’èªã¿ã“むよã†ã«Ansibleã‚’è¨å®šã—ã€ã™ã¹ã¦ã®Playbookã‚„ãƒãƒ¼ãƒ«ã§åˆ©ç”¨ã§ãるよã†ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ãªã„ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’特定ã®Playbookã‚„ãƒãƒ¼ãƒ«ã§ã®ã¿åˆ©ç”¨ã§ãるよã†ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" +msgid "You can configure Ansible to load standalone local modules or plugins in specific locations and make them available to all playbooks and roles (using configured paths). Alternatively, you can make a non-collection local module or plugin available only to certain playbooks or roles (via adjacent paths)." +msgstr "Ansible ã‚’è¨å®šã—ã¦ã€ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインを特定ã®å ´æ‰€ã«ãƒãƒ¼ãƒ‰ã—ã€ãれらを (è¨å®šæ¸ˆã¿ã®ãƒ‘スを使用ã—ã¦) ã™ã¹ã¦ã® Playbook ãŠã‚ˆã³ãƒãƒ¼ãƒ«ã§åˆ©ç”¨å¯èƒ½ã«ã§ãã¾ã™ã€‚ã¾ãŸã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ãªã„ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインを (隣接ã™ã‚‹ãƒ‘スを介ã—ã¦) 特定㮠Playbook ã¾ãŸã¯ãƒãƒ¼ãƒ«ã®ã¿ã§åˆ©ç”¨å¯èƒ½ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/developing_locally.rst:51 msgid "Adding standalone local modules for all playbooks and roles" @@ -2972,111 +3029,116 @@ msgstr "``ansible localhost -m my_local_module`` ã¨å…¥åŠ›ã™ã‚‹ã¨ã€ãã®ãƒ¢ã msgid "type ``ansible-doc -t module my_local_module`` to see the documentation for that module" msgstr "``ansible-doc -t module my_local_module`` ã¨å…¥åŠ›ã™ã‚‹ã¨ã€ãã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:75 -msgid "Currently, the ``ansible-doc`` command can parse module documentation only from modules written in Python. If you have a module written in a programming language other than Python, please write the documentation in a Python file adjacent to the module file." -msgstr "ç¾åœ¨ã€``ansible-doc`` コマンドã¯ã€Python ã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰ã®ã¿ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントを解æžã§ãã¾ã™ã€‚Python 以外ã®ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã®æ¨ªã® Python ファイルã«ãƒ‰ã‚ュメントを作æˆã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/developing_locally.rst:73 +#: ../../rst/dev_guide/developing_locally.rst:86 +msgid "This applies to all plugin types but requires specific configuration and/or adjacent directories for each plugin type, see below." +msgstr "ã“ã‚Œã¯ã™ã¹ã¦ã®ãƒ—ラグインタイプã«é©ç”¨ã•ã‚Œã¾ã™ãŒã€ãƒ—ラグインタイプã”ã¨ã«ç‰¹å®šã®è¨ã‚„隣接ディレクトリーãŒå¿…è¦ã§ã™ã€‚以下をå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:78 +#: ../../rst/dev_guide/developing_locally.rst:76 +msgid "The ``ansible-doc`` command can parse module documentation from modules written in Python or an adjacent YAML file. If you have a module written in a programming language other than Python, you should write the documentation in a Python or YAML file adjacent to the module file. :ref:`adjacent_yaml_doc`" +msgstr "``ansible-doc`` コマンドã¯ã€Python ã¾ãŸã¯éš£æŽ¥ YAML ファイルã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントを解æžã§ãã¾ã™ã€‚Python 以外ã®ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«éš£æŽ¥ã™ã‚‹ Python ã¾ãŸã¯ YAML ファイルã«ãƒ‰ã‚ュメントを記述ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚:ref:`adjacent_yaml_doc`" + +#: ../../rst/dev_guide/developing_locally.rst:79 msgid "Adding standalone local modules for selected playbooks or a single role" msgstr "é¸æŠžã—ãŸãƒ—レイブックやå˜ä¸€ã®ãƒãƒ¼ãƒ«ã¸ã®ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®è¿½åŠ " -#: ../../rst/dev_guide/developing_locally.rst:80 +#: ../../rst/dev_guide/developing_locally.rst:81 msgid "Ansible automatically loads all executable files from certain directories adjacent to your playbook or role as modules. Standalone modules in these locations are available only to the specific playbook, playbooks, or role in the parent directory." msgstr "Ansibleã¯ã€Playbookã‚„ãƒãƒ¼ãƒ«ã«éš£æŽ¥ã™ã‚‹ç‰¹å®šã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ã‚ã‚‹ã™ã¹ã¦ã®å®Ÿè¡Œå¯èƒ½ãƒ•ã‚¡ã‚¤ãƒ«ã‚’モジュールã¨ã—ã¦è‡ªå‹•çš„ã«èªã¿è¾¼ã¿ã¾ã™ã€‚ã“れらã®å ´æ‰€ã«ã‚るスタンドアãƒãƒ³ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€è¦ªãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ã‚る特定ã®Playbookã¾ãŸã¯ãƒãƒ¼ãƒ«ã§ã®ã¿åˆ©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:82 +#: ../../rst/dev_guide/developing_locally.rst:83 msgid "To use a standalone module only in a selected playbook or playbooks, store the module in a subdirectory called ``library`` in the directory that contains the playbook or playbooks." msgstr "スタンドアãƒãƒ³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’特定ã®ãƒ—レイブックã§ã®ã¿ä½¿ç”¨ã™ã‚‹ã«ã¯ã€Playbookã‚’å«ã‚€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªå†…ã®``library`` ã¨ã„ã†ã‚µãƒ–ディレクトリã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’ä¿å˜ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:83 +#: ../../rst/dev_guide/developing_locally.rst:84 msgid "To use a standalone module only in a single role, store the module in a subdirectory called ``library`` within that role." msgstr "スタンドアãƒãƒ³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å˜ä¸€ã®ãƒãƒ¼ãƒ«ã§ã®ã¿ä½¿ç”¨ã™ã‚‹ã«ã¯ã€ãã®ãƒãƒ¼ãƒ«å†…ã®``library`` ã¨ã„ã†ã‚µãƒ–ディレクトリã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’ä¿å˜ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:87 +#: ../../rst/dev_guide/developing_locally.rst:90 msgid "Roles contained in collections cannot contain any modules or other plugins. All plugins in a collection must live in the collection ``plugins`` directory tree. All plugins in that tree are accessible to all roles in the collection. If you are developing new modules, we recommend distributing them in :ref:`collections <developing_collections>`, not in roles." msgstr "コレクションã«å«ã¾ã‚Œã‚‹ãƒãƒ¼ãƒ«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„ä»–ã®ãƒ—ラグインをå«ã‚€ã“ã¨ãŒã§ãã¾ã›ã‚“。コレクション内ã®ã™ã¹ã¦ã®ãƒ—ラグインã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®``plugins`` ディレクトリツリーã«æ ¼ç´ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãã®ãƒ„リー内ã®ã™ã¹ã¦ã®ãƒ—ラグインã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã®ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã‹ã‚‰ã‚¢ã‚¯ã‚»ã‚¹å¯èƒ½ã§ã™ã€‚æ–°ã—ã„モジュールを開発ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒãƒ¼ãƒ«ã§ã¯ãªãã€:ref:`collections <developing_collections>` ã§é…布ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:93 +#: ../../rst/dev_guide/developing_locally.rst:96 msgid "Adding a non-module plugin locally outside of a collection" msgstr "モジュール以外ã®ãƒ—ラグインã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å¤–ã§ã®ãƒãƒ¼ã‚«ãƒ«ã§ã®è¿½åŠ " -#: ../../rst/dev_guide/developing_locally.rst:95 +#: ../../rst/dev_guide/developing_locally.rst:98 msgid "You can configure Ansible to load standalone local plugins in a specified location or locations and make them available to all playbooks and roles. Alternatively, you can make a standalone local plugin available only to specific playbooks or roles." msgstr "指定ã—ãŸå ´æ‰€ã®ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインをèªã¿ã“むよã†ã«Ansibleã‚’è¨å®šã—ã€ã™ã¹ã¦ã®Playbookã‚„ãƒãƒ¼ãƒ«ã§åˆ©ç”¨ã§ãるよã†ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã¾ãŸã€ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインを特定ã®Playbookã‚„ãƒãƒ¼ãƒ«ã§ã®ã¿åˆ©ç”¨ã§ãるよã†ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:99 +#: ../../rst/dev_guide/developing_locally.rst:102 msgid "Although modules are plugins, the naming patterns for directory names and environment variables that apply to other plugin types do not apply to modules. See :ref:`local_modules`." msgstr "モジュールã¯ãƒ—ラグインã§ã™ãŒã€ä»–ã®ãƒ—ラグインタイプã«é©ç”¨ã•ã‚Œã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªåや環境変数ã®ãƒãƒ¼ãƒŸãƒ³ã‚°ãƒ‘ターンã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã¯é©ç”¨ã•ã‚Œã¾ã›ã‚“。:ref:`local_modules` ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:102 +#: ../../rst/dev_guide/developing_locally.rst:105 msgid "Adding local non-module plugins for all playbooks and roles" msgstr "ã™ã¹ã¦ã®Playbookã¨ãƒãƒ¼ãƒ«ã¸ã®ãƒãƒ¼ã‚«ãƒ«ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»¥å¤–ã®ãƒ—ラグインã®è¿½åŠ " -#: ../../rst/dev_guide/developing_locally.rst:104 +#: ../../rst/dev_guide/developing_locally.rst:107 msgid "To load standalone local plugins automatically and make them available to all playbooks and roles, use the configuration setting or environment variable for the type of plugin you are adding. These configuration settings and environment variables take a colon-separated list, similar to ``$PATH``. You have two options:" msgstr "スタンドアãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインを自動的ã«èªã¿è¾¼ã¿ã€ã™ã¹ã¦ã®Playbookã¨ãƒãƒ¼ãƒ«ã§åˆ©ç”¨ã§ãるよã†ã«ã™ã‚‹ã«ã¯ã€è¿½åŠ ã™ã‚‹ãƒ—ラグインã®ã‚¿ã‚¤ãƒ—ã®æ§‹æˆè¨å®šã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã‚’使用ã—ã¾ã™ã€‚``$PATH`` ã¨åŒæ§˜ã«ã€ã“れらã®æ§‹æˆè¨å®šã‚„環境変数ã¯ã‚³ãƒãƒ³ã§åŒºåˆ‡ã‚‰ã‚ŒãŸãƒªã‚¹ãƒˆã‚’å—ã‘å–ã‚Šã¾ã™ã€‚2ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:106 +#: ../../rst/dev_guide/developing_locally.rst:109 msgid "Add your local plugin to one of the default configured locations. See :ref:`configuration settings <ansible_configuration_settings>` for details on the correct configuration setting for the plugin type. Default locations may change without notice." msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインをã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§è¨å®šã•ã‚Œã¦ã„ã‚‹å ´æ‰€ã®1ã¤ã«è¿½åŠ ã—ã¾ã™ã€‚プラグインタイプã®æ£ã—ã„構æˆè¨å®šã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€:ref:`configuration settings <ansible_configuration_settings>` ã‚’ã”覧ãã ã•ã„。デフォルトã®ãƒã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã¯äºˆå‘Šãªã変更ã•ã‚Œã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:109 +#: ../../rst/dev_guide/developing_locally.rst:112 msgid "Add the location of your local plugin to an environment variable or configuration:" msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインã®å ´æ‰€ã‚’ã€ç’°å¢ƒå¤‰æ•°ã‚„è¨å®šã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:108 +#: ../../rst/dev_guide/developing_locally.rst:111 msgid "the relevant ``ANSIBLE_plugin_type_PLUGINS`` environment variable - for example, ``$ANSIBLE_INVENTORY_PLUGINS`` or ``$ANSIBLE_VARS_PLUGINS``" msgstr "関連ã™ã‚‹``ANSIBLE_plugin_type_PLUGINS`` 環境変数 - 例ãˆã°ã€``$ANSIBLE_INVENTORY_PLUGINS`` ã¾ãŸã¯ ``$ANSIBLE_VARS_PLUGINS``" -#: ../../rst/dev_guide/developing_locally.rst:109 +#: ../../rst/dev_guide/developing_locally.rst:112 msgid "the relevant ``plugin_type_PATH`` configuration setting, most of which begin with ``DEFAULT_`` - for example, ``DEFAULT_CALLBACK_PLUGIN_PATH`` or ``DEFAULT_FILTER_PLUGIN_PATH`` or ``BECOME_PLUGIN_PATH``" msgstr "関連ã™ã‚‹``plugin_type_PATH`` 構æˆè¨å®šï¼ˆã»ã¨ã‚“ã©ãŒ``DEFAULT_`` ã§å§‹ã¾ã‚‹ï¼‰- 例ãˆã°``DEFAULT_CALLBACK_PLUGIN_PATH`` ã‚„``DEFAULT_FILTER_PLUGIN_PATH`` ã‚„ ``BECOME_PLUGIN_PATH``" -#: ../../rst/dev_guide/developing_locally.rst:111 +#: ../../rst/dev_guide/developing_locally.rst:114 msgid "To view your current configuration settings for non-module plugins:" msgstr "モジュール以外ã®ãƒ—ラグインã®ç¾åœ¨ã®æ§‹æˆè¨å®šã‚’表示ã™ã‚‹ã«ã¯ï¼š" -#: ../../rst/dev_guide/developing_locally.rst:117 +#: ../../rst/dev_guide/developing_locally.rst:120 msgid "After your plugin file is added to one of these locations, Ansible loads it and you can use it in any local module, task, playbook, or role. For more information on environment variables and configuration settings, see :ref:`ansible_configuration_settings`." msgstr "プラグインファイルãŒã“れらã®å ´æ‰€ã®ã„ãšã‚Œã‹ã«è¿½åŠ ã•ã‚Œã‚‹ã¨ã€Ansible ã¯ãã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’ãƒãƒ¼ãƒ‰ã—ã€ä»»æ„ã®ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ã‚¿ã‚¹ã‚¯ã€Playbookã€ãƒãƒ¼ãƒ«ã§ä½¿ç”¨ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚環境変数ãŠã‚ˆã³æ§‹æˆè¨å®šã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€:ref:`ansible_configuration_settings` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:119 +#: ../../rst/dev_guide/developing_locally.rst:122 msgid "To confirm that ``plugins/plugin_type/my_local_plugin`` is available:" msgstr "``plugins/plugin_type/my_local_plugin`` ãŒåˆ©ç”¨å¯èƒ½ã§ã‚ã‚‹ã“ã¨ã‚’確èªã™ã‚‹ã«ã¯ï¼š" -#: ../../rst/dev_guide/developing_locally.rst:121 +#: ../../rst/dev_guide/developing_locally.rst:124 msgid "type ``ansible-doc -t <plugin_type> my_local_lookup_plugin`` to see the documentation for that plugin - for example, ``ansible-doc -t lookup my_local_lookup_plugin``" msgstr "``ansible-doc -t <plugin_type> my_local_lookup_plugin`` ã¨å…¥åŠ›ã™ã‚‹ã¨ã€ãã®ãƒ—ラグインã®ãƒ‰ã‚ュメントãŒè¡¨ç¤ºã•ã‚Œã¾ã™ （例：``ansible-doc -t lookup my_local_lookup_plugin``）。" -#: ../../rst/dev_guide/developing_locally.rst:123 +#: ../../rst/dev_guide/developing_locally.rst:126 msgid "The ``ansible-doc`` command works for most plugin types, but not for action, filter, or test plugins. See :ref:`ansible-doc` for more details." msgstr "``ansible-doc`` コマンドã¯ã€ã»ã¨ã‚“ã©ã®ç¨®é¡žã®ãƒ—ラグインã§å‹•ä½œã—ã¾ã™ãŒã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã€ãƒ†ã‚¹ãƒˆãƒ—ラグインã§ã¯å‹•ä½œã—ã¾ã›ã‚“。詳ã—ãã¯:ref:`ansible-doc` ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:126 +#: ../../rst/dev_guide/developing_locally.rst:129 msgid "Adding standalone local plugins for selected playbooks or a single role" msgstr "é¸æŠžã—ãŸãƒ—レイブックやå˜ä¸€ã®ãƒãƒ¼ãƒ«ã¸ã®ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインã®è¿½åŠ " -#: ../../rst/dev_guide/developing_locally.rst:128 +#: ../../rst/dev_guide/developing_locally.rst:131 msgid "Ansible automatically loads all plugins from certain directories adjacent to your playbook or role, loading each type of plugin separately from a directory named for the type of plugin. Standalone plugins in these locations are available only to the specific playbook, playbooks, or role in the parent directory." msgstr "Ansibleã¯ã€Playbookã‚„ãƒãƒ¼ãƒ«ã«éš£æŽ¥ã™ã‚‹ç‰¹å®šã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ã‚ã‚‹ã™ã¹ã¦ã®ãƒ—ラグインを自動的ã«èªã¿è¾¼ã¿ã¾ã™ã€‚å„タイプã®ãƒ—ラグインã¯ã€ãƒ—ラグインã®ã‚¿ã‚¤ãƒ—ã®åå‰ãŒä»˜ã„ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰å€‹åˆ¥ã«èªã¿è¾¼ã¾ã‚Œã¾ã™ã€‚ã“れらã®å ´æ‰€ã«ã‚るスタンドアãƒãƒ³ã®ãƒ—ラグインã¯ã€è¦ªãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ã‚る特定ã®Playbookã¾ãŸã¯ãƒãƒ¼ãƒ«ã§ã®ã¿åˆ©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:130 +#: ../../rst/dev_guide/developing_locally.rst:133 msgid "To use a standalone plugin only in a selected playbook or playbooks, store the plugin in a subdirectory for the correct ``plugin_type`` (for example, ``callback_plugins`` or ``inventory_plugins``) in the directory that contains the playbooks. These directories must use the ``_plugins`` suffix. For a full list of plugin types, see :ref:`working_with_plugins`." msgstr "é¸æŠžã—㟠Playbookã§ã®ã¿ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒ—ラグインを使用ã™ã‚‹ã«ã¯ã€ãã®Playbook ã‚’å«ã‚€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã®æ£ã—ã„ ``plugin_type``ã®ã‚µãƒ–ディレクトリー (例: ``callback_plugins`` ã¾ãŸã¯ ``inventory_plugins``) ã«ãƒ—ラグインをä¿å˜ã—ã¾ã™ã€‚ã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¯ã€``_plugins``ã®æŽ¥å°¾è¾žã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プラグインタイプã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ã€:ref:`working_with_plugins`ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:131 +#: ../../rst/dev_guide/developing_locally.rst:134 msgid "To use a standalone plugin only in a single role, store the plugin in a subdirectory for the correct ``plugin_type`` (for example, ``cache_plugins`` or ``strategy_plugins``) within that role. When shipped as part of a role, the plugin is available as soon as the role is executed. These directories must use the ``_plugins`` suffix. For a full list of plugin types, see :ref:`working_with_plugins`." msgstr "å˜ä¸€ã®ãƒãƒ¼ãƒ«ã§ã®ã¿ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒ—ラグインを使用ã™ã‚‹ã«ã¯ã€ãã®ãƒãƒ¼ãƒ«å†…ã®æ£ã—ã„ ``plugin_type`` ã®ã‚µãƒ–ディレクトリー （例：``cache_plugins`` ã¾ãŸã¯ ``strategy_plugins``) ã«ãƒ—ラグインをä¿å˜ã—ã¾ã™ã€‚ãƒãƒ¼ãƒ«ã®ä¸€éƒ¨ã¨ã—ã¦æä¾›ã•ã‚ŒãŸå ´åˆã¯ã€ãƒãƒ¼ãƒ«ãŒå®Ÿè¡Œã•ã‚Œã‚‹ã¨ã™ãã«ãƒ—ラグインãŒåˆ©ç”¨å¯èƒ½ã«ãªã‚Šã¾ã™ã€‚ã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¯ã€``_plugins``ã®æŽ¥å°¾è¾žã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プラグインタイプã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ã€:ref:`working_with_plugins`ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_locally.rst:135 +#: ../../rst/dev_guide/developing_locally.rst:138 msgid "Roles contained in collections cannot contain any plugins. All plugins in a collection must live in the collection ``plugins`` directory tree. All plugins in that tree are accessible to all roles in the collection. If you are developing new plugins, we recommend distributing them in :ref:`collections <developing_collections>`, not in roles." msgstr "コレクションã«å«ã¾ã‚Œã‚‹ãƒãƒ¼ãƒ«ã¯ã€ãƒ—ラグインをå«ã‚€ã“ã¨ãŒã§ãã¾ã›ã‚“。コレクション内ã®ã™ã¹ã¦ã®ãƒ—ラグインã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®``plugins`` ディレクトリツリーã«æ ¼ç´ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãã®ãƒ„リー内ã®ã™ã¹ã¦ã®ãƒ—ラグインã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã®ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã‹ã‚‰ã‚¢ã‚¯ã‚»ã‚¹å¯èƒ½ã§ã™ã€‚æ–°ã—ã„プラグインを開発ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒãƒ¼ãƒ«ã§ã¯ãªãã€:ref:`collections <developing_collections>` ã§é…布ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_locally.rst:140 +#: ../../rst/dev_guide/developing_locally.rst:143 msgid "Using ``ansible.legacy`` to access custom versions of an ``ansible.builtin`` module" msgstr "``ansible.legacy`` を使用ã—㟠``ansible.builtin`` モジュールã®ã‚«ã‚¹ã‚¿ãƒ ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹" -#: ../../rst/dev_guide/developing_locally.rst:142 +#: ../../rst/dev_guide/developing_locally.rst:145 msgid "If you need to override one of the ``ansible.builtin`` modules and are using FQCN, you need to use ``ansible.legacy`` as part of the fully-qualified collection name (FQCN). For example, if you had your own ``copy`` module, you would access it as ``ansible.legacy.copy``. See :ref:`using_ansible_legacy` for details on how to use custom modules with roles within a collection." msgstr "``ansible.builtin`` モジュールã®ã„ãšã‚Œã‹ã‚’オーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€FQCN を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å (FQCN) ã®ä¸€éƒ¨ã¨ã—㦠``ansible.legacy`` を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€ç‹¬è‡ªã® ``copy`` モジュールãŒã‚ã‚‹å ´åˆã¯ã€``ansible.legacy.copy`` ã¨ã—ã¦ã‚¢ã‚¯ã‚»ã‚¹ã—ã¾ã™ã€‚コレクション内ã®ãƒãƒ¼ãƒ«ã§ã‚«ã‚¹ã‚¿ãƒ モジュールを使用ã™ã‚‹æ–¹æ³•ã¯ã€:ref:`using_ansible_legacy` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -3093,42 +3155,42 @@ msgid "The ``ansible.module_utils`` namespace is not a plain Python package: it msgstr "``ansible.module_utils`` åå‰ç©ºé–“ã¯å˜ç´”㪠Python パッケージã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã“ã‚Œã¯ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’抽出ã—ã€ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ãªè¨å®šã‹ã‚‰æ´¾ç”Ÿã™ã‚‹ :ref:`検索パス <ansible_search_path>` ã«å¯¾ã—ã¦ä¸€è‡´ã™ã‚‹åå‰ç©ºé–“を解決ã™ã‚‹ã“ã¨ã§ã€å„タスク呼ã³å‡ºã—用ã«å‹•çš„ã«æ§‹ç¯‰ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/developing_module_utilities.rst:22 -msgid "To reduce the maintenance burden in a collection or in local modules, you can extract duplicated code into one or more module utilities and import them into your modules. For example, if you have your own custom modules that import a ``my_shared_code`` library, you can place that into a ``./module_utils/my_shared_code.py`` file like this::" +msgid "To reduce the maintenance burden in a collection or in local modules, you can extract duplicated code into one or more module utilities and import them into your modules. For example, if you have your own custom modules that import a ``my_shared_code`` library, you can place that into a ``./module_utils/my_shared_code.py`` file like this:" msgstr "コレクションã¾ãŸã¯ãƒãƒ¼ã‚«ãƒ«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹è² è·ã‚’軽減ã™ã‚‹ã«ã¯ã€é‡è¤‡ã‚³ãƒ¼ãƒ‰ã‚’ 1 ã¤ä»¥ä¸Šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã«æŠ½å‡ºã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€``my_shared_code`` ライブラリーをインãƒãƒ¼ãƒˆã™ã‚‹ç‹¬è‡ªã®ã‚«ã‚¹ã‚¿ãƒ モジュールãŒã‚ã‚‹å ´åˆã¯ã€ã“れをã€ä»¥ä¸‹ã®ã‚ˆã†ã« ``./module_utils/my_shared_code.py`` ファイルã«é…ç½®ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:27 +#: ../../rst/dev_guide/developing_module_utilities.rst:29 msgid "When you run ``ansible-playbook``, Ansible will merge any files in your local ``module_utils`` directories into the ``ansible.module_utils`` namespace in the order defined by the :ref:`Ansible search path <ansible_search_path>`." msgstr "``ansible-playbook`` を実行ã™ã‚‹ã¨ã€Ansible 㯠:ref:`Ansible 検索パス <ansible_search_path>` ã§å®šç¾©ã•ã‚Œã¦ã„ã‚‹é †åºã§ãƒãƒ¼ã‚«ãƒ«ã® ``module_utils`` ディレクトリーã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’ ``ansible.module_utils`` åå‰ç©ºé–“ã«ãƒžãƒ¼ã‚¸ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:30 +#: ../../rst/dev_guide/developing_module_utilities.rst:32 msgid "Naming and finding module utilities" msgstr "モジュールユーティリティーã®å‘½åãŠã‚ˆã³æ¤œç´¢" -#: ../../rst/dev_guide/developing_module_utilities.rst:32 +#: ../../rst/dev_guide/developing_module_utilities.rst:34 msgid "You can generally tell what a module utility does from its name and/or its location. Generic utilities (shared code used by many different kinds of modules) live in the main ansible/ansible codebase, in the ``common`` subdirectory or in the root directory of ``lib/ansible/module_utils``. Utilities used by a particular set of modules generally live in the same collection as those modules. For example:" msgstr "通常ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ãŒåå‰ã‚„ãã®å ´æ‰€ã‹ã‚‰å‹•ä½œã™ã‚‹ã‚ˆã†ã«ã§ãã¾ã™ã€‚汎用ユーティリティー (ã•ã¾ã–ã¾ãªç¨®é¡žã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ä½¿ç”¨ã•ã‚Œã‚‹å…±æœ‰ã‚³ãƒ¼ãƒ‰) ã¯ã€ãƒ¡ã‚¤ãƒ³ã® ansible/ansible コードベースã«ã‚ã‚Šã¾ã™ã€‚``common`` サブディレクトリーã€ã¾ãŸã¯ ``lib/ansible/module_utils`` ã®ãƒ«ãƒ¼ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚ã‚Šã¾ã™ã€‚特定ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚»ãƒƒãƒˆã§ä½¿ç”¨ã•ã‚Œã‚‹ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã¯ã€é€šå¸¸ã€ãれらã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨åŒã˜ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«å˜åœ¨ã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:34 +#: ../../rst/dev_guide/developing_module_utilities.rst:36 msgid "``lib/ansible/module_utils/urls.py`` contains shared code for parsing URLs" msgstr "``lib/ansible/module_utils/urls.py`` ã¯ã€URL を解æžã™ã‚‹ãŸã‚ã®å…±æœ‰ã‚³ãƒ¼ãƒ‰ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:35 +#: ../../rst/dev_guide/developing_module_utilities.rst:37 msgid "``openstack.cloud.plugins.module_utils.openstack.py`` contains utilities for modules that work with OpenStack instances" msgstr "``openstack.cloud.plugins.module_utils.openstack.py`` ã«ã¯ã€OpenStack インスタンスã¨é€£æºã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:36 +#: ../../rst/dev_guide/developing_module_utilities.rst:38 msgid "``ansible.netcommon.plugins.module_utils.network.common.config.py`` contains utility functions for use by networking modules" msgstr "``ansible.netcommon.plugins.module_utils.network.common.config.py`` ã¯ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã‚‹è¨å®šãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®æ©Ÿèƒ½ãŒå«ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:38 +#: ../../rst/dev_guide/developing_module_utilities.rst:40 msgid "Following this pattern with your own module utilities makes everything easy to find and use." msgstr "ã“ã®ãƒ‘ターンを独自ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã§è¡Œã†ã¨ã€ã‚らゆるもã®ã‚’見ã¤ã‘ã€ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒå®¹æ˜“ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:43 +#: ../../rst/dev_guide/developing_module_utilities.rst:45 msgid "Standard module utilities" msgstr "標準ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼" -#: ../../rst/dev_guide/developing_module_utilities.rst:45 +#: ../../rst/dev_guide/developing_module_utilities.rst:47 msgid "Ansible ships with an extensive library of ``module_utils`` files. You can find the module utility source code in the ``lib/ansible/module_utils`` directory under your main Ansible path. We describe the most widely used utilities below. For more details on any specific module utility, please see the `source code for module_utils <https://github.com/ansible/ansible/tree/devel/lib/ansible/module_utils>`_." msgstr "Ansible ã«ã¯ã€``module_utils`` ファイルã®åºƒç¯„ãªãƒ©ã‚¤ãƒ–ラリーãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚モジュールユーティリティーã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã¯ã€ãƒ¡ã‚¤ãƒ³ã® Ansible パス下㮠``lib/ansible/module_utils`` ディレクトリーã«ã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€ä»¥ä¸‹ã§æœ€ã‚‚広ã使用ã•ã‚Œã¦ã„るユーティリティーãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚特定ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®è©³ç´°ã¯ã€ã€Œ`モジュールユーティリティーã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ <https://github.com/ansible/ansible/tree/devel/lib/ansible/module_utils>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -3168,85 +3230,85 @@ msgstr "コンテンツãŒéŽåŽ»ã« ansible/ansible ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã msgid "Copyright entries by previous committers must also be kept in any moved files." msgstr "以å‰ã®ã‚³ãƒŸãƒƒãƒˆæ‹…当者ã«ã‚ˆã‚‹è‘—作権エントリーもã€ç§»å‹•ã—ãŸãƒ•ã‚¡ã‚¤ãƒ«ã«ä¿æŒã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:49 +#: ../../rst/dev_guide/developing_module_utilities.rst:51 msgid "``api.py`` - Supports generic API modules" msgstr "``api.py`` - 汎用 API モジュールã®ã‚µãƒãƒ¼ãƒˆ" -#: ../../rst/dev_guide/developing_module_utilities.rst:50 +#: ../../rst/dev_guide/developing_module_utilities.rst:52 msgid "``basic.py`` - General definitions and helper utilities for Ansible modules" msgstr "``basic.py`` - Ansible モジュールã®ä¸€èˆ¬çš„ãªå®šç¾©ãŠã‚ˆã³ãƒ˜ãƒ«ãƒ‘ーユーティリティー" -#: ../../rst/dev_guide/developing_module_utilities.rst:51 +#: ../../rst/dev_guide/developing_module_utilities.rst:53 msgid "``common/dict_transformations.py`` - Helper functions for dictionary transformations" msgstr "``common/dict_transformations.py`` - ディクショナリー変æ›ã®ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:52 +#: ../../rst/dev_guide/developing_module_utilities.rst:54 msgid "``common/file.py`` - Helper functions for working with files" msgstr "``common/file.py`` - ファイルをæ“作ã™ã‚‹ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:53 +#: ../../rst/dev_guide/developing_module_utilities.rst:55 msgid "``common/text/`` - Helper functions for converting and formatting text" msgstr "``common/text/`` - テã‚ストã®å¤‰æ›ãŠã‚ˆã³ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã‚’è¡Œã†ãŸã‚ã®ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:54 +#: ../../rst/dev_guide/developing_module_utilities.rst:56 msgid "``common/parameters.py`` - Helper functions for dealing with module parameters" msgstr "``common/parameters.py`` - モジュールパラメーターを処ç†ã™ã‚‹ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:55 +#: ../../rst/dev_guide/developing_module_utilities.rst:57 msgid "``common/sys_info.py`` - Functions for getting distribution and platform information" msgstr "``common/sys_info.py`` - ディストリビューションãŠã‚ˆã³ãƒ—ãƒ©ãƒƒãƒˆãƒ•ã‚©ãƒ¼ãƒ æƒ…å ±ã‚’å–å¾—ã™ã‚‹æ©Ÿèƒ½" -#: ../../rst/dev_guide/developing_module_utilities.rst:56 +#: ../../rst/dev_guide/developing_module_utilities.rst:58 msgid "``common/validation.py`` - Helper functions for validating module parameters against a module argument spec" msgstr "``common/validation.py`` - モジュール引数仕様ã«å¯¾ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‘ラメーターを検証ã™ã‚‹ãŸã‚ã®ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:57 +#: ../../rst/dev_guide/developing_module_utilities.rst:59 msgid "``facts/`` - Directory of utilities for modules that return facts. See `PR 23012 <https://github.com/ansible/ansible/pull/23012>`_ for more information" msgstr "``facts/`` - ファクトを返ã™ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã€‚詳細ã¯ã€`PR 23012 <https://github.com/ansible/ansible/pull/23012>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_module_utilities.rst:58 +#: ../../rst/dev_guide/developing_module_utilities.rst:60 msgid "``json_utils.py`` - Utilities for filtering unrelated output around module JSON output, like leading and trailing lines" msgstr "``json_utils.py`` - å…ˆé 行や末尾行ãªã©ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« JSON 出力ã«é–¢ã™ã‚‹é–¢é€£ã®ãªã„出力をフィルターをè¨å®šã™ã‚‹ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼" -#: ../../rst/dev_guide/developing_module_utilities.rst:59 +#: ../../rst/dev_guide/developing_module_utilities.rst:61 msgid "``powershell/`` - Directory of definitions and helper functions for Windows PowerShell modules" msgstr "``powershell/`` - Windows PowerShell モジュールã®å®šç¾©ãŠã‚ˆã³ãƒ˜ãƒ«ãƒ‘ー関数ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼" -#: ../../rst/dev_guide/developing_module_utilities.rst:60 +#: ../../rst/dev_guide/developing_module_utilities.rst:62 msgid "``pycompat24.py`` - Exception workaround for Python 2.4" msgstr "``pycompat24.py`` - Python 2.4 ã®ä¾‹å¤–回é¿ç–" -#: ../../rst/dev_guide/developing_module_utilities.rst:61 +#: ../../rst/dev_guide/developing_module_utilities.rst:63 msgid "``service.py`` - Utilities to enable modules to work with Linux services (placeholder, not in use)" msgstr "``service.py`` - モジュール㌠Linux サービスã¨é€£æºã§ãるよã†ã«ã™ã‚‹ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ (未使用ã®ãƒ—レースホルダー)" -#: ../../rst/dev_guide/developing_module_utilities.rst:62 +#: ../../rst/dev_guide/developing_module_utilities.rst:64 msgid "``six/__init__.py`` - Bundled copy of the `Six Python library <https://pypi.org/project/six/>`_ to aid in writing code compatible with both Python 2 and Python 3" msgstr "``six/__init__.py`` - Python 2 㨠Python 3 ã®ä¸¡æ–¹ã¨äº’æ›æ€§ã®ã‚るコードを書ã込む際ã«åŠ©ã‘ã¨ãªã‚‹ `Six Python ライブラリー <https://pypi.org/project/six/>`_ ã®ãƒãƒ³ãƒ‰ãƒ«ã‚³ãƒ”ー" -#: ../../rst/dev_guide/developing_module_utilities.rst:63 +#: ../../rst/dev_guide/developing_module_utilities.rst:65 msgid "``splitter.py`` - String splitting and manipulation utilities for working with Jinja2 templates" msgstr "``splitter.py`` - Jinja2 テンプレートを使用ã™ã‚‹æ–‡å—列分割ãŠã‚ˆã³æ“作ユーティリティー" -#: ../../rst/dev_guide/developing_module_utilities.rst:64 +#: ../../rst/dev_guide/developing_module_utilities.rst:66 msgid "``urls.py`` - Utilities for working with http and https requests" msgstr "``urls.py`` - http ãŠã‚ˆã³ https リクエストをæ“作ã™ã‚‹ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼" -#: ../../rst/dev_guide/developing_module_utilities.rst:66 +#: ../../rst/dev_guide/developing_module_utilities.rst:68 msgid "Several commonly-used utilities migrated to collections in Ansible 2.10, including:" msgstr "一般的ã«ä½¿ç”¨ã•ã‚Œã‚‹ã„ãã¤ã‹ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã¯ã€Ansible 2.10 ã§ã¯ä»¥ä¸‹ã®ã‚ˆã†ãªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»è¡Œã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_module_utilities.rst:68 +#: ../../rst/dev_guide/developing_module_utilities.rst:70 msgid "``ismount.py`` migrated to ``ansible.posix.plugins.module_utils.mount.py`` - Single helper function that fixes os.path.ismount" msgstr "``ansible.posix.plugins.module_utils.mount.py`` ã«ç§»è¡Œã—㟠``ismount.py`` - os.path.ismount ã‚’ä¿®æ£ã™ã‚‹å˜ä¸€ã®ãƒ˜ãƒ«ãƒ‘ー関数" -#: ../../rst/dev_guide/developing_module_utilities.rst:69 +#: ../../rst/dev_guide/developing_module_utilities.rst:71 msgid "``known_hosts.py`` migrated to ``community.general.plugins.module_utils.known_hosts.py`` - utilities for working with known_hosts file" msgstr "``community.general.plugins.module_utils.known_hosts.py`` ã«ç§»è¡Œã—㟠``known_hosts.py`` - known_hosts ファイルã§ä½œæ¥ã™ã‚‹ãŸã‚ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼" -#: ../../rst/dev_guide/developing_module_utilities.rst:71 -msgid "For a list of migrated content with destination collections, see https://github.com/ansible/ansible/blob/devel/lib/ansible/config/ansible_builtin_runtime.yml." -msgstr "宛先コレクションã§ç§»è¡Œã•ã‚ŒãŸã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ä¸€è¦§ã¯ã€https://github.com/ansible/ansible/blob/devel/lib/ansible/config/ansible_builtin_runtime.yml ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/developing_module_utilities.rst:73 +msgid "For a list of migrated content with destination collections, see the `runtime.yml file <https://github.com/ansible/ansible/blob/devel/lib/ansible/config/ansible_builtin_runtime.yml>`_." +msgstr "宛先コレクションã§ç§»è¡Œã•ã‚ŒãŸã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ä¸€è¦§ã¯ã€`runtime.yml file <https://github.com/ansible/ansible/blob/devel/lib/ansible/config/ansible_builtin_runtime.yml>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_modules.rst:6 msgid "Should you develop a module?" @@ -3341,12 +3403,14 @@ msgid "I want to :ref:`write multiple modules <developing_modules_in_groups>`." msgstr ":ref:`è¤‡æ•°ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’ä½œæˆ <developing_modules_in_groups>` ã—ãŸã„ã§ã™ã€‚" #: ../../rst/dev_guide/developing_modules.rst:46 -#: ../../rst/dev_guide/developing_plugins.rst:538 +#: ../../rst/dev_guide/developing_plugins.rst:542 +#: ../../rst/dev_guide/sidecar.rst:89 msgid ":ref:`list_of_collections`" msgstr ":ref:`list_of_collections`" #: ../../rst/dev_guide/developing_modules.rst:47 -#: ../../rst/dev_guide/developing_plugins.rst:539 +#: ../../rst/dev_guide/developing_plugins.rst:543 +#: ../../rst/dev_guide/sidecar.rst:90 msgid "Browse existing collections, modules, and plugins" msgstr "æ—¢å˜ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãŠã‚ˆã³ãƒ—ラグインã®é–²è¦§" @@ -3795,8 +3859,8 @@ msgid "Additional requirements may apply for certain collections. Review the ind msgstr "è¿½åŠ ã®è¦ä»¶ã¯ã€ç‰¹å®šã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«é©ç”¨ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€å€‹åˆ¥ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_modules_checklist.rst:34 -msgid "Please make sure your module meets these requirements before you submit your PR/proposal. If you have questions, reach out via the ``#ansible-devel`` chat channel (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat>`_) or the `Ansible development mailing list <https://groups.google.com/group/ansible-devel>`_." -msgstr "PR/æ案をé€ä¿¡ã™ã‚‹å‰ã«ã€ãŠä½¿ã„ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã“れらã®è¦ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ã”質å•ãŒã‚ã‚‹å ´åˆã¯ã€``#ansible-devel``ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ï¼ˆansible.imã§Matrixを使用ã€ã‚‚ã—ãã¯`irc.libera.chat <https://libera.chat>`ã§IRCを使用）ã¾ãŸã¯ `Ansible development mailing list <https://groups.google.com/group/ansible-devel>` ã¾ã§ãŠå•ã„åˆã‚ã›ãã ã•ã„。" +msgid "Please make sure your module meets these requirements before you submit your PR/proposal. If you have questions, reach out by using the ``#ansible-devel`` chat channel (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat>`_) or the `Ansible development mailing list <https://groups.google.com/group/ansible-devel>`_." +msgstr "PR/æ案をé€ä¿¡ã™ã‚‹å‰ã«ã€ãŠä½¿ã„ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã“れらã®è¦ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ã”ä¸æ˜Žãªç‚¹ãŒã”ã–ã„ã¾ã—ãŸã‚‰ã€``#ansible-devel``ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ« (ansible.im 㧠Matrix を使用ã€ã‚‚ã—ã㯠`irc.libera.chat <https://libera.chat>`_ 㧠IRC を使用) ã¾ãŸã¯ `Ansible development mailing list <https://groups.google.com/group/ansible-devel>`_ を使用ã—ã¦ãŠå•ã„åˆã‚ã›ãã ã•ã„。" #: ../../rst/dev_guide/developing_modules_checklist.rst:37 msgid "Contributing to Ansible: subjective requirements" @@ -3812,11 +3876,11 @@ msgstr "ãã®ä»–ã®ãƒã‚§ãƒƒã‚¯ãƒªã‚¹ãƒˆ" #: ../../rst/dev_guide/developing_modules_checklist.rst:44 msgid ":ref:`Tips for module development <developing_modules_best_practices>`." -msgstr ":ref:`モジュール開発ã®ãƒ’ント <developing_modules_best_practices>`" +msgstr ":ref:`Tips for module development <developing_modules_best_practices>`。" #: ../../rst/dev_guide/developing_modules_checklist.rst:45 msgid ":ref:`Windows development checklist <developing_modules_general_windows>`." -msgstr ":ref:`Windows 開発ãƒã‚§ãƒƒã‚¯ãƒªã‚¹ãƒˆ <developing_modules_general_windows>`" +msgstr ":ref:`Windows development checklist <developing_modules_general_windows>`。" #: ../../rst/dev_guide/developing_modules_documenting.rst:6 msgid "Module format and documentation" @@ -3846,104 +3910,120 @@ msgstr "**å¤ã„モジュールã¯æ³¨æ„ã—ã¦ã‚³ãƒ”ーã—ã¦ãã ã•ã„。**" msgid "Some older Ansible modules have ``imports`` at the bottom of the file, ``Copyright`` notices with the full GPL prefix, and/or ``DOCUMENTATION`` fields in the wrong order. These are legacy files that need updating - do not copy them into new modules. Over time we are updating and correcting older modules. Please follow the guidelines on this page!" msgstr "一部ã®å¤ã„ Ansible モジュールã§ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®ä¸‹éƒ¨ã« ``imports`` ãŒã‚ã‚‹ãŸã‚ã€``Copyright`` ã¯å®Œå…¨ãª GPL プレフィックスã€ã¾ãŸã¯ ``DOCUMENTATION`` フィールドを間é•ã£ãŸé †åºã§æŒã¤ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。ã“れらã¯æ›´æ–°ãŒå¿…è¦ãªãƒ¬ã‚¬ã‚·ãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã§ã™ã€‚æ–°ã—ã„モジュールã«ã‚³ãƒ”ーã—ãªã„ã§ãã ã•ã„。時間ã®çµŒéŽã¨ã¨ã‚‚ã«ã€å¤ã„モジュールを更新ãŠã‚ˆã³ä¿®æ£ã—ã¦ã„ã¾ã™ã€‚ã“ã®ãƒšãƒ¼ã‚¸ã«ã¯ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã«å¾“ã†ã‚ˆã†ã«ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:27 +#: ../../rst/dev_guide/developing_modules_documenting.rst:24 +msgid "For non-Python modules you still create a ``.py`` file for documentation purposes. Starting at ansible-core 2.14 you can instead choose to create a ``.yml`` file that has the same data structure, but in pure YAML. With YAML files, the examples below are easy to use by removing Python quoting and substituting ``=`` for ``:``, for example ``DOCUMENTATION = r''' ... '''` ` to ``DOCUMENTATION: ...`` and removing closing quotes. :ref:`adjacent_yaml_doc`" +msgstr "éž Python モジュールã®å ´åˆã€å¼•ã続ãドã‚ュメント用㫠``.py`` ファイルを作æˆã—ã¾ã™ã€‚ansible-core 2.14 以é™ã§ã¯ã€åŒã˜ãƒ‡ãƒ¼ã‚¿æ§‹é€ ã‚’æŒã¤ ``.yml`` ファイルを替ã‚ã‚Šã«ä½œæˆã§ãã¾ã™ãŒã€ã“ã‚Œã¯ç´”粋㪠YAML ã§ã™ã€‚YAML ファイルã®å ´åˆã€Python ã®å¼•ç”¨ç¬¦ã‚’削除ã—㦠``:`` ã‚’ ``=`` ã«ç½®ãæ›ãˆã‚‹ã“ã¨ã§ã€ä»¥ä¸‹ã®ä¾‹ãŒä½¿ã„ã‚„ã™ããªã‚Šã¾ã™ (例: ``DOCUMENTATION = r''' ... '''` ` to ``DOCUMENTATION: ...`` and removing closing quotes. :ref:`adjacent_yaml_doc`)" + +#: ../../rst/dev_guide/developing_modules_documenting.rst:31 msgid "Python shebang & UTF-8 coding" msgstr "Python ã‚·ãƒãƒ³ãŠã‚ˆã³ UTF-8 コーディング" -#: ../../rst/dev_guide/developing_modules_documenting.rst:29 +#: ../../rst/dev_guide/developing_modules_documenting.rst:33 msgid "Begin your Ansible module with ``#!/usr/bin/python`` - this \"shebang\" allows ``ansible_python_interpreter`` to work. Follow the shebang immediately with ``# -*- coding: utf-8 -*-`` to clarify that the file is UTF-8 encoded." msgstr "``#!/usr/bin/python`` 㧠Ansible モジュールを開始ã—ã¾ã™ (ã“ã®ã€Œã‚·ãƒãƒ³ã€ã§ã¯ ``ansible_python_interpreter`` ãŒæ©Ÿèƒ½ã—ã¾ã™)。ファイル㌠UTF-8 ã§ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‰ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’明確ã«ã™ã‚‹ãŸã‚ã«ã€ã‚·ãƒãƒ³ã®ç›´å¾Œã« ``# -*- coding: utf-8 -*-`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:34 +#: ../../rst/dev_guide/developing_modules_documenting.rst:35 +msgid "Using ``#!/usr/bin/env``, makes ``env`` the interpreter and bypasses ``ansible_<interpreter>_interpreter`` logic." +msgstr "``#!/usr/bin/env`` を使用ã™ã‚‹ã¨ã€``env`` ãŒã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã¨ãªã‚Š ``ansible_<interpreter>_interpreter`` è«–ç†ã‚’ãƒã‚¤ãƒ‘スã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_modules_documenting.rst:36 +msgid "If you develop the module using a different scripting language, adjust the interpreter accordingly (``#!/usr/bin/<interpreter>``) so ``ansible_<interpreter>_interpreter`` can work for that specific language." +msgstr "別ã®ã‚¹ã‚¯ãƒªãƒ—ト言語を使用ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’開発ã™ã‚‹å ´åˆã¯ã€ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターをé©å®œèª¿æ•´ã— (``#!/usr/bin/<interpreter>``)ã€ãã®è¨€èªžã§ ``ansible_<interpreter>_interpreter`` ãŒæ©Ÿèƒ½ã™ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_modules_documenting.rst:37 +msgid "Binary modules do not require a shebang or an interpreter." +msgstr "ãƒã‚¤ãƒŠãƒªãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã« shebang やインタープリターã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/developing_modules_documenting.rst:42 msgid "Copyright and license" msgstr "著作権ãŠã‚ˆã³ãƒ©ã‚¤ã‚»ãƒ³ã‚¹" -#: ../../rst/dev_guide/developing_modules_documenting.rst:36 +#: ../../rst/dev_guide/developing_modules_documenting.rst:44 msgid "After the shebang and UTF-8 coding, add a `copyright line <https://www.linuxfoundation.org/blog/copyright-notices-in-open-source-software-projects/>`_ with the original copyright holder and a license declaration. The license declaration should be ONLY one line, not the full GPL prefix.:" msgstr "ã‚·ãƒãƒ³ãŠã‚ˆã³ UTF-8 コーディングã®å¾Œã«ã€å…ƒã®è‘—作権所有者ãŠã‚ˆã³ãƒ©ã‚¤ã‚»ãƒ³ã‚¹å®£è¨€ã‚’å«ã‚€ `copyright line <https://www.linuxfoundation.org/blog/copyright-notices-in-open-source-software-projects/>`_ ã‚’è¿½åŠ ã—ã¾ã™ã€‚ライセンス宣言ã¯ã€å®Œå…¨ãª GPL プレフィックスã§ã¯ãªãã€1 è¡Œã®ã¿ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:46 +#: ../../rst/dev_guide/developing_modules_documenting.rst:54 msgid "Additions to the module (for instance, rewrites) are not permitted to add additional copyright lines other than the default copyright statement if missing:" msgstr "ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’è¿½åŠ ã™ã‚‹ã¨ãã«ã€ä»¥ä¸‹ãŒæ¬ ã‘ã¦ã„ã‚‹å ´åˆã«ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®è‘—作権ステートメント以外ã«ã€è‘—作権ã®è¡Œã‚’è¿½åŠ ã§ãã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:52 +#: ../../rst/dev_guide/developing_modules_documenting.rst:60 msgid "Any legal review will include the source control history, so an exhaustive copyright header is not necessary. Please do not include a copyright year. If the existing copyright statement includes a year, do not edit the existing copyright year. Any existing copyright header should not be modified without permission from the copyright author." msgstr "法的レビューã«ã¯ã‚½ãƒ¼ã‚¹ç®¡ç†å±¥æ´ãŒå«ã¾ã‚Œã‚‹ãŸã‚ã€å®Œå…¨ãªè‘—作権ヘッダーã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。著作権ã®å¹´ã¯å«ã‚ãªã„ã§ãã ã•ã„。既å˜ã®è‘—作権ステートメントã«å¹´ãŒå«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€æ—¢å˜ã®è‘—作権ã®å¹´ã‚’編集ã—ãªã„ã§ãã ã•ã„。既å˜ã®è‘—作権ヘッダーã¯ã€è‘—作権者ã®è¨±å¯ãªã—ã«å¤‰æ›´ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:58 +#: ../../rst/dev_guide/developing_modules_documenting.rst:66 msgid "ANSIBLE_METADATA block" msgstr "ANSIBLE_METADATA ブãƒãƒƒã‚¯" -#: ../../rst/dev_guide/developing_modules_documenting.rst:60 +#: ../../rst/dev_guide/developing_modules_documenting.rst:68 msgid "Since we moved to collections we have deprecated the METADATA functionality, it is no longer required for modules, but it will not break anything if present." msgstr "コレクションã«ç§»è¡Œã—ã¦ã‚‚ METADATA 機能ã¯éžæŽ¨å¥¨ã«ãªã‚Šã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã¯å¿…è¦ãªããªã‚Šã¾ã—ãŸãŒã€å˜åœ¨ã—ã¦ã‚‚ä½•ã‚‚ç ´æã—ã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:66 +#: ../../rst/dev_guide/developing_modules_documenting.rst:74 msgid "DOCUMENTATION block" msgstr "DOCUMENTATION ブãƒãƒƒã‚¯" -#: ../../rst/dev_guide/developing_modules_documenting.rst:68 +#: ../../rst/dev_guide/developing_modules_documenting.rst:76 msgid "After the shebang, the UTF-8 coding, the copyright line, and the license section comes the ``DOCUMENTATION`` block. Ansible's online module documentation is generated from the ``DOCUMENTATION`` blocks in each module's source code. The ``DOCUMENTATION`` block must be valid YAML. You may find it easier to start writing your ``DOCUMENTATION`` string in an :ref:`editor with YAML syntax highlighting <other_tools_and_programs>` before you include it in your Python file. You can start by copying our `example documentation string <https://github.com/ansible/ansible/blob/devel/examples/DOCUMENTATION.yml>`_ into your module file and modifying it. If you run into syntax issues in your YAML, you can validate it on the `YAML Lint <http://www.yamllint.com/>`_ website." msgstr "shebangã€UTF-8 コーディングã€è‘—作権行ã€ãƒ©ã‚¤ã‚»ãƒ³ã‚¹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®å¾Œã«ã¯ã€``DOCUMENTATION`` ブãƒãƒƒã‚¯ãŒã‚ã‚Šã¾ã™ã€‚Ansible ã®ã‚ªãƒ³ãƒ©ã‚¤ãƒ³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントã¯ã€å„モジュールã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰å†…ã® ``DOCUMENTATION`` ブãƒãƒƒã‚¯ã‹ã‚‰ç”Ÿæˆã•ã‚Œã¾ã™ã€‚``DOCUMENTATION`` ブãƒãƒƒã‚¯ã¯æœ‰åŠ¹ãª YAML ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。Python ファイルã«å«ã‚ã‚‹å‰ã«ã€``DOCUMENTATION`` ã®æ–‡å—列を :ref:`YAML 構文ã®å¼·èª¿è¡¨ç¤ºã‚’使用ã—ãŸã‚¨ãƒ‡ã‚£ã‚¿ãƒ¼ <other_tools_and_programs>` ã«æ›¸ã始ã‚ãŸæ–¹ãŒç°¡å˜ã ã¨æ€ã†ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。æä¾›ã—ã¦ã„ã‚‹ `サンプルã®ãƒ‰ã‚ュメントã®æ–‡å—列 <https://github.com/ansible/ansible/blob/devel/examples/DOCUMENTATION.yml>`_ を自身ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚³ãƒ”ーã—ã¦ã€ãれを修æ£ã™ã‚‹ã“ã¨ã‹ã‚‰å§‹ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚YAML ã®æ§‹æ–‡ã«å•é¡ŒãŒã‚ã‚‹å ´åˆã¯ã€`YAML Lint <http://www.yamllint.com/>`_ ã® Web サイトã§æ¤œè¨¼ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:76 +#: ../../rst/dev_guide/developing_modules_documenting.rst:84 msgid "Module documentation should briefly and accurately define what each module and option does, and how it works with others in the underlying system. Documentation should be written for broad audience--readable both by experts and non-experts." msgstr "モジュールã®ãƒ‰ã‚ュメントã§ã¯ã€å„モジュールã¨ã‚ªãƒ—ションã®å‹•ä½œã«ã¤ã„ã¦ç°¡å˜ã‹ã¤æ£ç¢ºã«å®šç¾©ã—ã€åŸºç¤Žã¨ãªã‚‹ã‚·ã‚¹ãƒ†ãƒ ã§ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ã©ã®ã‚ˆã†ã«é€£æºã™ã‚‹ã‹ã‚’説明ã—ã¾ã™ã€‚ドã‚ュメントã¯ã€å°‚門家ã¨éžå°‚門家ã®ä¸¡æ–¹ãŒèªã‚€ã“ã¨ãŒã§ãるよã†ã«ã€å¹…広ã„èªè€…ã«å‘ã‘ã¦ä½œæˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:71 +#: ../../rst/dev_guide/developing_modules_documenting.rst:79 msgid "Descriptions should always start with a capital letter and end with a full stop. Consistency always helps." msgstr "説明ã¯å¸¸ã«å¤§æ–‡å—ã§å§‹ã‚ã€å®Œå…¨ã«çµ‚了ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚一貫性ã¯å¸¸ã«å½¹ç«‹ã¡ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:72 +#: ../../rst/dev_guide/developing_modules_documenting.rst:80 msgid "Verify that arguments in doc and module spec dict are identical." msgstr "ドã‚ュメントã®å¼•æ•°ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»•æ§˜ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ãŒåŒã˜ã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:73 +#: ../../rst/dev_guide/developing_modules_documenting.rst:81 msgid "For password / secret arguments ``no_log=True`` should be set." msgstr "パスワード/シークレット引数 ``no_log=True`` ã‚’è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:74 +#: ../../rst/dev_guide/developing_modules_documenting.rst:82 msgid "For arguments that seem to contain sensitive information but **do not** contain secrets, such as \"password_length\", set ``no_log=False`` to disable the warning message." msgstr "æ©Ÿå¯†æƒ…å ±ãŒå«ã¾ã‚Œã¦ã„るよã†ã«è¦‹ãˆã¦ã‚‚「password_lengthã€ãªã©ã®ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆãŒ **å«ã¾ã‚Œã¦ã„ãªã„** よã†ã«è¡¨ç¤ºã•ã‚Œã‚‹å¼•æ•°ã«ã¯ã€``no_log=False`` ã‚’è¨å®šã—ã¦è¦å‘Šãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’無効ã«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:75 -#: ../../rst/dev_guide/developing_modules_documenting.rst:143 +#: ../../rst/dev_guide/developing_modules_documenting.rst:83 +#: ../../rst/dev_guide/developing_modules_documenting.rst:152 msgid "If an option is only sometimes required, describe the conditions. For example, \"Required when I(state=present).\"" msgstr "オプションã®ã¿ãŒå¿…è¦ãªå ´åˆã¯ã€æ¡ä»¶ã‚’記述ã—ã¦ãã ã•ã„。ãŸã¨ãˆã°ã€ã€ŒRequired when I(state=present)ã€ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:76 +#: ../../rst/dev_guide/developing_modules_documenting.rst:84 msgid "If your module allows ``check_mode``, reflect this fact in the documentation." msgstr "モジュール㧠``check_mode`` ãŒè¨±å¯ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れをドã‚ュメントã«åæ˜ ã•ã›ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:78 +#: ../../rst/dev_guide/developing_modules_documenting.rst:86 msgid "To create clear, concise, consistent, and useful documentation, follow the :ref:`style guide <style_guide>`." msgstr "明確ã‹ã¤ç°¡æ½”ã§ä¸€è²«æ€§ãŒã‚ã‚Šã€ä¾¿åˆ©ãªãƒ‰ã‚ュメント㯠:ref:`スタイルガイド <style_guide>` ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:80 +#: ../../rst/dev_guide/developing_modules_documenting.rst:88 msgid "Each documentation field is described below. Before committing your module documentation, please test it at the command line and as HTML:" msgstr "å„ドã‚ュメントフィールドã®èª¬æ˜Žã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚モジュールã®ãƒ‰ã‚ュメントをコミットã™ã‚‹å‰ã«ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ãŠã‚ˆã³ HTML ã§ãƒ†ã‚¹ãƒˆã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:82 +#: ../../rst/dev_guide/developing_modules_documenting.rst:90 msgid "As long as your module file is :ref:`available locally <local_modules>`, you can use ``ansible-doc -t module my_module_name`` to view your module documentation at the command line. Any parsing errors will be obvious - you can view details by adding ``-vvv`` to the command." msgstr "モジュールファイル㌠:ref:`ãƒãƒ¼ã‚«ãƒ«ã§åˆ©ç”¨å¯èƒ½ <local_modules>` ãªå ´åˆã«é™ã‚Šã€``ansible-doc -t module my_module_name`` を使用ã—ã¦ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントを表示ã—ã¾ã™ã€‚構文解æžã‚¨ãƒ©ãƒ¼ã¯æ˜Žç¢ºã«ãªã‚Šã¾ã™ã€‚コマンド㫠``-vvv`` ã‚’è¿½åŠ ã™ã‚‹ã¨ã€è©³ç´°ã‚’表示ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:83 +#: ../../rst/dev_guide/developing_modules_documenting.rst:91 msgid "You should also :ref:`test the HTML output <testing_module_documentation>` of your module documentation." msgstr "モジュールã®ãƒ‰ã‚ュメントã«ãŠã‘ã‚‹ :ref:`HTML 出力ã®ãƒ†ã‚¹ãƒˆ <testing_module_documentation>` ã‚‚å¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:86 +#: ../../rst/dev_guide/developing_modules_documenting.rst:95 msgid "Documentation fields" msgstr "ドã‚ュメントフィールド" -#: ../../rst/dev_guide/developing_modules_documenting.rst:88 +#: ../../rst/dev_guide/developing_modules_documenting.rst:97 msgid "All fields in the ``DOCUMENTATION`` block are lower-case. All fields are required unless specified otherwise:" msgstr "``DOCUMENTATION`` ブãƒãƒƒã‚¯ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã¯ã™ã¹ã¦å°æ–‡å—ã«ãªã‚Šã¾ã™ã€‚特ã«æŒ‡å®šãŒãªã„å ´åˆã¯ã€ã™ã¹ã¦ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:92 +#: ../../rst/dev_guide/developing_modules_documenting.rst:101 msgid "The name of the module." msgstr "モジュールã®åå‰ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:93 +#: ../../rst/dev_guide/developing_modules_documenting.rst:102 msgid "Must be the same as the filename, without the ``.py`` extension." msgstr "ファイルåã¨åŒã˜ (``.py`` æ‹¡å¼µåãªã—) ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -3951,15 +4031,15 @@ msgstr "ファイルåã¨åŒã˜ (``.py`` æ‹¡å¼µåãªã—) ã§ã‚ã‚‹å¿…è¦ãŒã‚ msgid "short_description" msgstr "short_description" -#: ../../rst/dev_guide/developing_modules_documenting.rst:97 +#: ../../rst/dev_guide/developing_modules_documenting.rst:106 msgid "A short description which is displayed on the :ref:`list_of_collections` page and ``ansible-doc -l``." msgstr ":ref:`list_of_collections` ページ㨠``ansible-doc -l`` ã«è¡¨ç¤ºã•ã‚Œã‚‹ç°¡å˜ãªèª¬æ˜Žã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:98 +#: ../../rst/dev_guide/developing_modules_documenting.rst:107 msgid "The ``short_description`` is displayed by ``ansible-doc -l`` without any category grouping, so it needs enough detail to explain the module's purpose without the context of the directory structure in which it lives." msgstr "``short_description`` ã¯ã€ã‚«ãƒ†ã‚´ãƒªãƒ¼ã‚’グループ化ã›ãšã«ã€``ansible-doc -l`` ã«ã‚ˆã£ã¦è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ãã®ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå˜åœ¨ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼æ§‹é€ ã®ã‚³ãƒ³ãƒ†ã‚ストãªã—ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ç›®çš„を説明ã™ã‚‹ã®ã«å分ãªè©³ç´°ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:100 +#: ../../rst/dev_guide/developing_modules_documenting.rst:109 msgid "Unlike ``description:``, ``short_description`` should not have a trailing period/full stop." msgstr "``description:`` ã¨ã¯ç•°ãªã‚Šã€``short_description`` ã®ãƒ”リオド (文末) ã¯è¨å®šã—ãªã„ã§ãã ã•ã„。" @@ -3967,23 +4047,23 @@ msgstr "``description:`` ã¨ã¯ç•°ãªã‚Šã€``short_description`` ã®ãƒ”リオド msgid "description" msgstr "description" -#: ../../rst/dev_guide/developing_modules_documenting.rst:104 +#: ../../rst/dev_guide/developing_modules_documenting.rst:113 msgid "A detailed description (generally two or more sentences)." msgstr "詳細ãªèª¬æ˜Ž (通常㯠2 文以上)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:105 +#: ../../rst/dev_guide/developing_modules_documenting.rst:114 msgid "Must be written in full sentences, in other words, with capital letters and periods/full stops." msgstr "æ–‡ç« ã®å½¢ã€ã¤ã¾ã‚Šå†’é ã®å¤§æ–‡å—やピリオド (文末) ãªã©ã‚’使用ã—ã¦è¨˜è¿°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:106 +#: ../../rst/dev_guide/developing_modules_documenting.rst:115 msgid "Shouldn't mention the module name." msgstr "モジュールåã«ã¤ã„ã¦è¨€åŠã™ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:107 +#: ../../rst/dev_guide/developing_modules_documenting.rst:116 msgid "Make use of multiple entries rather than using one long paragraph." msgstr "1 ã¤ã®é•·ã„段è½ã«ã›ãšã€è¤‡æ•°ã®æ–‡ç« ã«åˆ†ã‘ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:108 +#: ../../rst/dev_guide/developing_modules_documenting.rst:117 msgid "Don't quote complete values unless it is required by YAML." msgstr "YAML ã§å¿…è¦ãªå ´åˆã‚’除ãã€å®Œå…¨ãªå€¤ã‚’引用符ã§å›²ã¾ãªã„ã§ãã ã•ã„。" @@ -3991,15 +4071,15 @@ msgstr "YAML ã§å¿…è¦ãªå ´åˆã‚’除ãã€å®Œå…¨ãªå€¤ã‚’引用符ã§å›²ã¾ãªã msgid "version_added" msgstr "version_added" -#: ../../rst/dev_guide/developing_modules_documenting.rst:112 +#: ../../rst/dev_guide/developing_modules_documenting.rst:121 msgid "The version of Ansible when the module was added." msgstr "モジュールãŒè¿½åŠ ã•ã‚ŒãŸ Ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:113 +#: ../../rst/dev_guide/developing_modules_documenting.rst:122 msgid "This is a string, and not a float, for example, ``version_added: '2.1'``." msgstr "ã“ã‚Œã¯æµ®å‹•å°æ•°ç‚¹ã§ã¯ãªãæ–‡å—列ã§ã™ (例: ``version_added: '2.1'``)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:114 +#: ../../rst/dev_guide/developing_modules_documenting.rst:123 msgid "In collections, this must be the collection version the module was added to, not the Ansible version. For example, ``version_added: 1.0.0``." msgstr "コレクションã§ã¯ã€ã“れ㯠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ãªãã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒè¿½åŠ ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“ (例: ``version_added: 1.0.0``)。" @@ -4007,15 +4087,15 @@ msgstr "コレクションã§ã¯ã€ã“れ㯠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ãªã msgid "author" msgstr "author" -#: ../../rst/dev_guide/developing_modules_documenting.rst:118 +#: ../../rst/dev_guide/developing_modules_documenting.rst:127 msgid "Name of the module author in the form ``First Last (@GitHubID)``." msgstr "``First Last (@GitHubID)`` å½¢å¼ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä½œæˆè€…ã®åå‰ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:119 +#: ../../rst/dev_guide/developing_modules_documenting.rst:128 msgid "Use a multi-line list if there is more than one author." msgstr "作æˆè€…ãŒè¤‡æ•°ã«ãªã‚‹å ´åˆã¯ã€è¤‡æ•°è¡Œã®ãƒªã‚¹ãƒˆã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:120 +#: ../../rst/dev_guide/developing_modules_documenting.rst:129 msgid "Don't use quotes as it should not be required by YAML." msgstr "YAML ã§ã¯å¿…è¦ãªã„ãŸã‚ã€å¼•ç”¨ç¬¦ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。" @@ -4023,7 +4103,7 @@ msgstr "YAML ã§ã¯å¿…è¦ãªã„ãŸã‚ã€å¼•ç”¨ç¬¦ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã msgid "deprecated" msgstr "deprecated" -#: ../../rst/dev_guide/developing_modules_documenting.rst:124 +#: ../../rst/dev_guide/developing_modules_documenting.rst:133 msgid "Marks modules that will be removed in future releases. See also :ref:`module_lifecycle`." msgstr "å°†æ¥ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ãƒžãƒ¼ã‚¯ã‚’付ã‘ã—ã¾ã™ã€‚「:ref:`module_lifecycle`ã€ã‚‚ä½µã›ã¦å‚ç…§ã—ã¦ãã ã•ã„。" @@ -4032,15 +4112,15 @@ msgstr "å°†æ¥ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ãƒžãƒ¼ã‚¯ã‚’付 msgid "options" msgstr "options" -#: ../../rst/dev_guide/developing_modules_documenting.rst:128 +#: ../../rst/dev_guide/developing_modules_documenting.rst:137 msgid "Options are often called `parameters` or `arguments`. Because the documentation field is called `options`, we will use that term." msgstr "オプションã¯ã€å¤šãã®å ´åˆã€`パラメーター` ã¾ãŸã¯ `引数` ã¨å‘¼ã°ã‚Œã¾ã™ã€‚ドã‚ュメントフィールド㯠`オプション` を呼ã°ã‚Œã‚‹ãŸã‚ã€ã“ã“ã§ã¯ãã®ç”¨èªžã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:129 +#: ../../rst/dev_guide/developing_modules_documenting.rst:138 msgid "If the module has no options (for example, it's a ``_facts`` module), all you need is one line: ``options: {}``." msgstr "モジュールã«ã‚ªãƒ—ションãŒãªã„ (例: ``_facts`` モジュール) å ´åˆã€å¿…è¦ãªã®ã¯ 1 è¡Œ (``options: {}``) ã ã‘ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:130 +#: ../../rst/dev_guide/developing_modules_documenting.rst:139 msgid "If your module has options (in other words, accepts arguments), each option should be documented thoroughly. For each module option, include:" msgstr "モジュールã«ã‚ªãƒ—ションãŒã‚ã‚‹ (ã¤ã¾ã‚Šå¼•æ•°ã‚’å—ã‘入れる) å ´åˆã€å„オプションã¯è©³ç´°ã«æ–‡æ›¸åŒ–ã•ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚å„モジュールオプションã«ã¤ã„ã¦ã€ä»¥ä¸‹ã‚’記載ã—ã¾ã™ã€‚" @@ -4048,39 +4128,39 @@ msgstr "モジュールã«ã‚ªãƒ—ションãŒã‚ã‚‹ (ã¤ã¾ã‚Šå¼•æ•°ã‚’å—ã‘å…¥ã msgid "option-name" msgstr "option-name" -#: ../../rst/dev_guide/developing_modules_documenting.rst:134 +#: ../../rst/dev_guide/developing_modules_documenting.rst:143 msgid "Declarative operation (not CRUD), to focus on the final state, for example `online:`, rather than `is_online:`." msgstr "(CRUD ã§ã¯ãªã) 宣言æ“作ã¯ã€ã€Œ`is_online:`ã€ã§ã¯ãªãã€ã€Œ`online:`ã€ãªã©ã®æœ€çµ‚状態ã«ç„¦ç‚¹ã‚’ã‚ã¦ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:135 +#: ../../rst/dev_guide/developing_modules_documenting.rst:144 msgid "The name of the option should be consistent with the rest of the module, as well as other modules in the same category." msgstr "オプションã®åå‰ã¯ã€ãã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®æ®‹ã‚Šã®éƒ¨åˆ†ã€ãŠã‚ˆã³åŒã˜ã‚«ãƒ†ã‚´ãƒªãƒ¼ã®ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ä¸€è²«æ€§ã‚’æŒãŸã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:136 +#: ../../rst/dev_guide/developing_modules_documenting.rst:145 msgid "When in doubt, look for other modules to find option names that are used for the same purpose, we like to offer consistency to our users." msgstr "ä¸æ˜Žãªå ´åˆã¯ã€ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’探ã—ã¦ã€åŒã˜ç›®çš„ã§ä½¿ç”¨ã•ã‚Œã¦ã„るオプションåを見ã¤ã‘ã¦ãã ã•ã„。ユーザーã«ä¸€è²«æ€§ã‚’æä¾›ã§ãるよã†ã«ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:140 +#: ../../rst/dev_guide/developing_modules_documenting.rst:149 msgid "Detailed explanation of what this option does. It should be written in full sentences." msgstr "ã“ã®ã‚ªãƒ—ションã®æ©Ÿèƒ½ã®è©³ç´°ãªèª¬æ˜Žã€‚ã“ã‚Œã¯ã€å®Œå…¨ãªæ–‡ç« ã§è¨˜è¿°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:141 +#: ../../rst/dev_guide/developing_modules_documenting.rst:150 msgid "The first entry is a description of the option itself; subsequent entries detail its use, dependencies, or format of possible values." msgstr "最åˆã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã¯ã€ã‚ªãƒ—ションãã®ã‚‚ã®ã®èª¬æ˜Žã§ã™ã€‚後続ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã¯ã€ãã®ä½¿ç”¨ã€ä¾å˜é–¢ä¿‚ã€ã¾ãŸã¯ä½¿ç”¨ã§ãる値ã®å½¢å¼ã®è©³ç´°ã‚’説明ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:142 +#: ../../rst/dev_guide/developing_modules_documenting.rst:151 msgid "Should not list the possible values (that's what ``choices:`` is for, though it should explain what the values do if they aren't obvious)." msgstr "å¯èƒ½ãªå€¤ã‚’列挙ã—ãªã„ã§ãã ã•ã„ (``choices:`` ã¯ãã®ãŸã‚ã«ã‚ã‚Šã¾ã™ã€‚値ãŒæ˜Žã‚‰ã‹ã§ãªã„å ´åˆã¯ã€ãã®å€¤ãŒä½•ã‚’示ã™ã®ã‹ã‚’説明ã—ã¦ãã ã•ã„)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:144 +#: ../../rst/dev_guide/developing_modules_documenting.rst:153 msgid "Mutually exclusive options must be documented as the final sentence on each of the options." msgstr "相互ã«æŽ’ä»–çš„ãªã‚ªãƒ—ションã¯ã€å„オプションã®æœ€å¾Œã®æ–‡ã§æ–‡æ›¸åŒ–ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:148 +#: ../../rst/dev_guide/developing_modules_documenting.rst:157 msgid "Only needed if ``true``." msgstr "``true`` ã®å ´åˆã«ã®ã¿å¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:149 +#: ../../rst/dev_guide/developing_modules_documenting.rst:158 msgid "If missing, we assume the option is not required." msgstr "見ã¤ã‹ã‚‰ãªã„å ´åˆã¯ã€ã‚ªãƒ—ションãŒä¸è¦ã§ã‚ã‚‹ã¨ä»®å®šã—ã¾ã™ã€‚" @@ -4089,19 +4169,19 @@ msgstr "見ã¤ã‹ã‚‰ãªã„å ´åˆã¯ã€ã‚ªãƒ—ションãŒä¸è¦ã§ã‚ã‚‹ã¨ä»®å®š msgid "default" msgstr "default" -#: ../../rst/dev_guide/developing_modules_documenting.rst:153 +#: ../../rst/dev_guide/developing_modules_documenting.rst:162 msgid "If ``required`` is false/missing, ``default`` may be specified (assumed 'null' if missing)." msgstr "``required`` ㌠false ã‚‚ã—ãã¯æŒ‡å®šã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€``default`` を指定ã§ãã¾ã™ (見ã¤ã‹ã‚‰ãªã„å ´åˆã¯ã€Œnullã€ã¨è¦‹ãªã•ã‚Œã¾ã™)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:154 +#: ../../rst/dev_guide/developing_modules_documenting.rst:163 msgid "Ensure that the default value in the docs matches the default value in the code." msgstr "ドã‚ュメントã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€ã‚³ãƒ¼ãƒ‰ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¨ä¸€è‡´ã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:155 +#: ../../rst/dev_guide/developing_modules_documenting.rst:164 msgid "The default field must not be listed as part of the description, unless it requires additional information or conditions." msgstr "è¿½åŠ ã®æƒ…å ±ã‚„æ¡ä»¶ãŒå¿…è¦ãªå ´åˆã‚’除ãã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã¯ã€èª¬æ˜Žã®ä¸€éƒ¨ã¨ã—ã¦è¨˜è¼‰ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:156 +#: ../../rst/dev_guide/developing_modules_documenting.rst:165 msgid "If the option is a boolean value, you can use any of the boolean values recognized by Ansible: (such as true/false or yes/no). Choose the one that reads better in the context of the option." msgstr "オプションãŒãƒ–ール値ã®å ´åˆã¯ã€Ansible ãŒèªè˜ã™ã‚‹ä»»æ„ã®ãƒ–ール値 (true/falseã€yes/no ãªã©) を使用ã§ãã¾ã™ã€‚オプションã®ã‚³ãƒ³ãƒ†ã‚ストã§èªã¿å–ã‚ŠãŒé©åˆ‡ã§ã‚ã‚Œã°ã“れをé¸æŠžã—ã¾ã™ã€‚" @@ -4110,28 +4190,28 @@ msgstr "オプションãŒãƒ–ール値ã®å ´åˆã¯ã€Ansible ãŒèªè˜ã™ã‚‹ä»»æ msgid "choices" msgstr "choices" -#: ../../rst/dev_guide/developing_modules_documenting.rst:161 +#: ../../rst/dev_guide/developing_modules_documenting.rst:170 msgid "List of option values." msgstr "オプション値ã®ãƒªã‚¹ãƒˆã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:162 +#: ../../rst/dev_guide/developing_modules_documenting.rst:171 msgid "Should be absent if empty." msgstr "空欄ã®å ´åˆã¯æŒ‡å®šãªã—ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_modules_documenting.rst #: ../../rst/dev_guide/developing_program_flow_modules.rst msgid "type" -msgstr "type" +msgstr "タイプ" -#: ../../rst/dev_guide/developing_modules_documenting.rst:166 +#: ../../rst/dev_guide/developing_modules_documenting.rst:175 msgid "Specifies the data type that option accepts, must match the ``argspec``." msgstr "オプションã§ä½¿ç”¨ã§ãるデータ型を指定ã—ã¾ã™ã€‚``argspec`` ã¨ä¸€è‡´ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:167 +#: ../../rst/dev_guide/developing_modules_documenting.rst:176 msgid "If an argument is ``type='bool'``, this field should be set to ``type: bool`` and no ``choices`` should be specified." msgstr "引数㌠``type='bool'`` ã®å ´åˆã€ã“ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã¯ ``type: bool`` ã«è¨å®šã•ã‚Œã¾ã™ã€‚``choices`` ã¯æŒ‡å®šã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:168 +#: ../../rst/dev_guide/developing_modules_documenting.rst:177 msgid "If an argument is ``type='list'``, ``elements`` should be specified." msgstr "引数㌠``type='list'`` ã®å ´åˆã¯ã€``elements`` を指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -4140,7 +4220,7 @@ msgstr "引数㌠``type='list'`` ã®å ´åˆã¯ã€``elements`` を指定ã™ã‚‹å¿… msgid "elements" msgstr "elements" -#: ../../rst/dev_guide/developing_modules_documenting.rst:172 +#: ../../rst/dev_guide/developing_modules_documenting.rst:181 msgid "Specifies the data type for list elements in case ``type='list'``." msgstr "``type='list'`` ã®å ´åˆã«ã€ãƒªã‚¹ãƒˆè¦ç´ ã®ãƒ‡ãƒ¼ã‚¿åž‹ã‚’指定ã—ã¾ã™ã€‚" @@ -4149,23 +4229,23 @@ msgstr "``type='list'`` ã®å ´åˆã«ã€ãƒªã‚¹ãƒˆè¦ç´ ã®ãƒ‡ãƒ¼ã‚¿åž‹ã‚’指定ã msgid "aliases" msgstr "aliases" -#: ../../rst/dev_guide/developing_modules_documenting.rst:175 +#: ../../rst/dev_guide/developing_modules_documenting.rst:184 msgid "List of optional name aliases." msgstr "ä»»æ„ã®åå‰ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã®ãƒªã‚¹ãƒˆã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:176 +#: ../../rst/dev_guide/developing_modules_documenting.rst:185 msgid "Generally not needed." msgstr "一般的ã«ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:180 +#: ../../rst/dev_guide/developing_modules_documenting.rst:189 msgid "Only needed if this option was extended after initial Ansible release, in other words, this is greater than the top level `version_added` field." msgstr "ã“ã®ã‚ªãƒ—ション㌠Ansible ã®åˆå›žãƒªãƒªãƒ¼ã‚¹å¾Œã«æ‹¡å¼µã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã®ã¿å¿…è¦ã§ã™ã€‚ã¤ã¾ã‚Šã€ã“ã‚Œã¯æœ€ä¸Šä½ãƒ¬ãƒ™ãƒ«ã® `version_added` フィールドよりも大ãããªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:181 +#: ../../rst/dev_guide/developing_modules_documenting.rst:190 msgid "This is a string, and not a float, for example, ``version_added: '2.3'``." msgstr "ã“ã‚Œã¯æµ®å‹•å°æ•°ç‚¹ã§ã¯ãªãæ–‡å—列ã§ã™ (例: ``version_added: '2.3'``)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:182 +#: ../../rst/dev_guide/developing_modules_documenting.rst:191 msgid "In collections, this must be the collection version the option was added to, not the Ansible version. For example, ``version_added: 1.0.0``." msgstr "コレクションã§ã¯ã€ã“れ㯠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ãªãã€ã‚ªãƒ—ションãŒè¿½åŠ ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“ (例: ``version_added: 1.0.0``)。" @@ -4173,11 +4253,11 @@ msgstr "コレクションã§ã¯ã€ã“れ㯠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ãªã msgid "suboptions" msgstr "suboptions" -#: ../../rst/dev_guide/developing_modules_documenting.rst:186 +#: ../../rst/dev_guide/developing_modules_documenting.rst:195 msgid "If this option takes a dict or list of dicts, you can define the structure here." msgstr "ã“ã®ã‚ªãƒ—ションãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¾ãŸã¯ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒªã‚¹ãƒˆã‚’å–ã‚‹å ´åˆã¯ã€ã“ã“ã§æ§‹é€ を定義ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:187 +#: ../../rst/dev_guide/developing_modules_documenting.rst:196 msgid "See :ref:`ansible_collections.azure.azcollection.azure_rm_securitygroup_module`, :ref:`ansible_collections.azure.azcollection.azure_rm_azurefirewall_module`, and :ref:`ansible_collections.openstack.cloud.baremetal_node_action_module` for examples." msgstr "例ã¯ã€ã€Œ:ref:`ansible_collections.azure.azcollection.azure_rm_securitygroup_module`ã€ã€ã€Œ:ref:`ansible_collections.azure.azcollection.azure_rm_azurefirewall_module`ã€ã€ãŠã‚ˆã³ã€Œ:ref:`ansible_collections.openstack.cloud.baremetal_node_action_module`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -4185,11 +4265,11 @@ msgstr "例ã¯ã€ã€Œ:ref:`ansible_collections.azure.azcollection.azure_rm_securi msgid "requirements" msgstr "requirements" -#: ../../rst/dev_guide/developing_modules_documenting.rst:191 +#: ../../rst/dev_guide/developing_modules_documenting.rst:200 msgid "List of requirements (if applicable)." msgstr "è¦ä»¶ã®ãƒªã‚¹ãƒˆ (該当ã™ã‚‹å ´åˆ)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:192 +#: ../../rst/dev_guide/developing_modules_documenting.rst:201 msgid "Include minimum versions." msgstr "最å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’指定ã—ã¾ã™ã€‚" @@ -4197,23 +4277,23 @@ msgstr "最å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’指定ã—ã¾ã™ã€‚" msgid "seealso" msgstr "seealso" -#: ../../rst/dev_guide/developing_modules_documenting.rst:196 +#: ../../rst/dev_guide/developing_modules_documenting.rst:205 msgid "A list of references to other modules, documentation or Internet resources" msgstr "ãã®ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãƒ‰ã‚ュメントã€ã¾ãŸã¯ã‚¤ãƒ³ã‚¿ãƒ¼ãƒãƒƒãƒˆãƒªã‚½ãƒ¼ã‚¹ã¸ã®å‚ç…§ã®ä¸€è¦§ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:197 +#: ../../rst/dev_guide/developing_modules_documenting.rst:206 msgid "In Ansible 2.10 and later, references to modules must use the FQCN or ``ansible.builtin`` for modules in ``ansible-core``." msgstr "Ansible 2.10 以é™ã§ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¸ã®å‚照㌠``ansible-core`` ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã« FQCN ã¾ãŸã¯ ``ansible.builtin`` を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:198 +#: ../../rst/dev_guide/developing_modules_documenting.rst:207 msgid "A reference can be one of the following formats:" msgstr "å‚ç…§ã«ã¯ã€ä»¥ä¸‹ã®å½¢å¼ã®ã„ãšã‚Œã‹ã‚’使用ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:226 +#: ../../rst/dev_guide/developing_modules_documenting.rst:235 msgid "If you use ``ref:`` to link to an anchor that is not associated with a title, you must add a title to the ref for the link to work correctly." msgstr "``ref:`` を使用ã—ã¦ã‚¿ã‚¤ãƒˆãƒ«ã¨é–¢é€£ä»˜ã‘られã¦ã„ãªã„アンカーã«ãƒªãƒ³ã‚¯ã™ã‚‹å ´åˆã¯ã€ãƒªãƒ³ã‚¯ãŒæ£ã—ã機能ã™ã‚‹ã‚ˆã†ã« ref ã«ã‚¿ã‚¤ãƒˆãƒ«ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:227 +#: ../../rst/dev_guide/developing_modules_documenting.rst:236 msgid "You can link to non-module plugins with ``ref:`` using the rST anchor, but plugin and module anchors are never associated with a title, so you must supply a title when you link to them. For example ``ref: namespace.collection.plugin_name lookup plugin <ansible_collections.namespace.collection.plugin_name_lookup>``." msgstr "rST アンカーを使用ã—㦠``ref:`` ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»¥å¤–ã®ãƒ—ラグインã«ãƒªãƒ³ã‚¯ã§ãã¾ã™ãŒã€ãƒ—ラグインãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚¢ãƒ³ã‚«ãƒ¼ã¯ã‚¿ã‚¤ãƒˆãƒ«ã¨é–¢é€£ä»˜ã‘られãªã„ãŸã‚ã€ãƒªãƒ³ã‚¯ã™ã‚‹éš›ã«ã‚¿ã‚¤ãƒˆãƒ«ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€``ref: namespace.collection.plugin_name lookup plugin <ansible_collections.namespace.collection.plugin_name_lookup>`` ã¨ãªã‚Šã¾ã™ã€‚" @@ -4221,155 +4301,155 @@ msgstr "rST アンカーを使用ã—㦠``ref:`` ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»¥å¤–ã®ãƒ—ã msgid "notes" msgstr "notes" -#: ../../rst/dev_guide/developing_modules_documenting.rst:232 +#: ../../rst/dev_guide/developing_modules_documenting.rst:241 msgid "Details of any important information that doesn't fit in one of the above sections." msgstr "上記ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ã„ãšã‚Œã‹ã«è©²å½“ã—ãªã„é‡è¦ãªæƒ…å ±ã®è©³ç´°ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:233 +#: ../../rst/dev_guide/developing_modules_documenting.rst:242 msgid "For example, whether ``check_mode`` is or is not supported." msgstr "ãŸã¨ãˆã°ã€``check_mode`` ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã‹ã©ã†ã‹ãªã©ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:238 +#: ../../rst/dev_guide/developing_modules_documenting.rst:247 msgid "Linking and other format macros within module documentation" msgstr "モジュールドã‚ュメント内ã®ãƒªãƒ³ã‚¯ãŠã‚ˆã³ãã®ä»–ã®å½¢å¼ãƒžã‚¯ãƒ" -#: ../../rst/dev_guide/developing_modules_documenting.rst:240 +#: ../../rst/dev_guide/developing_modules_documenting.rst:249 msgid "You can link from your module documentation to other module docs, other resources on docs.ansible.com, and resources elsewhere on the internet with the help of some pre-defined macros. The correct formats for these macros are:" msgstr "モジュールドã‚ュメントã‹ã‚‰ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントã€docs.ansible.com ã®ä»–ã®ãƒªã‚½ãƒ¼ã‚¹ã€ä¸€éƒ¨ã®äº‹å‰è¨å®šãƒžã‚¯ãƒã§ã‚¤ãƒ³ã‚¿ãƒ¼ãƒãƒƒãƒˆä¸Šã®ä»–ã®ãƒªã‚½ãƒ¼ã‚¹ã«ãƒªãƒ³ã‚¯ã§ãã¾ã™ã€‚ã“れらã®ãƒžã‚¯ãƒã®æ£ã—ã„å½¢å¼ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:242 +#: ../../rst/dev_guide/developing_modules_documenting.rst:251 msgid "``L()`` for links with a heading. For example: ``See L(Ansible Automation Platform,https://www.ansible.com/products/automation-platform).`` As of Ansible 2.10, do not use ``L()`` for relative links between Ansible documentation and collection documentation." msgstr "``L()`` 見出ã—ã¸ã®ãƒªãƒ³ã‚¯ã€‚ãŸã¨ãˆã°ã€``See L(Ansible Automation Platform,https://www.ansible.com/products/automation-platform).`` ã¨ãªã‚Šã¾ã™ã€‚Ansible 2.10 以é™ã€Ansible ドã‚ュメントã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ‰ã‚ュメントã®ç›¸å¯¾ãƒªãƒ³ã‚¯ã«ã¯ ``L()`` を使用ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:243 +#: ../../rst/dev_guide/developing_modules_documenting.rst:252 msgid "``U()`` for URLs. For example: ``See U(https://www.ansible.com/products/automation-platform) for an overview.``" msgstr "URL ã®å ´åˆã¯ ``U()``。ãŸã¨ãˆã°ã€``See U(https://www.ansible.com/products/automation-platform) for an overview.`` ã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:244 +#: ../../rst/dev_guide/developing_modules_documenting.rst:253 msgid "``R()`` for cross-references with a heading (added in Ansible 2.10). For example: ``See R(Cisco IOS Platform Guide,ios_platform_options)``. Use the RST anchor for the cross-reference. See :ref:`adding_anchors_rst` for details." msgstr "(Ansible 2.10 ã«å«ã¾ã‚Œã‚‹) 見出ã—ã¨ç›¸äº’å‚照用 ``R()`` (例: ``See R(Cisco IOS Platform Guide,ios_platform_options)``)。クãƒã‚¹å‚照㫠RST アンカーを使用ã—ã¾ã™ã€‚詳細ã¯ã€:ref:`adding_anchors_rst` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:245 +#: ../../rst/dev_guide/developing_modules_documenting.rst:254 msgid "``M()`` for module names. For example: ``See also M(ansible.builtin.yum) or M(community.general.apt_rpm)``." msgstr "``M()`` モジュールå。ãŸã¨ãˆã° ``See also M(ansible.builtin.yum) or M(community.general.apt_rpm)`` ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:247 +#: ../../rst/dev_guide/developing_modules_documenting.rst:256 msgid "There are also some macros which do not create links but we use them to display certain types of content in a uniform way:" msgstr "リンクを作æˆã—ãªã„ã‚‚ã®ã®ã€ãã®ãƒžã‚¯ãƒã‚’使用ã—ã¦ã€ç‰¹å®šã®ã‚¿ã‚¤ãƒ—ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„を統一ã—ã¦è¡¨ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:250 +#: ../../rst/dev_guide/developing_modules_documenting.rst:259 msgid "``I()`` for option names. For example: ``Required if I(state=present).`` This is italicized in the documentation." msgstr "オプションåã®å ´åˆã¯ ``I()``。ãŸã¨ãˆã° ``Required if I(state=present).`` ã§ã™ã€‚ã“ã‚Œã¯ã€ãƒ‰ã‚ュメントã§ã¯ã‚¤ã‚¿ãƒªãƒƒã‚¯ä½“ã§ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:252 +#: ../../rst/dev_guide/developing_modules_documenting.rst:261 msgid "``C()`` for files, option values, and inline code. For example: ``If not set the environment variable C(ACME_PASSWORD) will be used.`` or ``Use C(var | foo.bar.my_filter) to transform C(var) into the required format.`` This displays with a mono-space font in the documentation." msgstr "ファイルã€ã‚ªãƒ—ション値ã€ãŠã‚ˆã³ã‚¤ãƒ³ãƒ©ã‚¤ãƒ³ã‚³ãƒ¼ãƒ‰ã®å ´åˆã¯ ``C()`` (例 ``If not set the environment variable C(ACME_PASSWORD) will be used.`` ã¾ãŸã¯ ``Use C(var | foo.bar.my_filter) to transform C(var) into the required format.``)。ã“ã‚Œã¯ã€ãƒ‰ã‚ュメントã§ã¯ Monospace フォントã¨è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:253 +#: ../../rst/dev_guide/developing_modules_documenting.rst:262 msgid "``B()`` currently has no standardized usage. It is displayed in boldface in the documentation." msgstr "ç¾æ™‚点ã§ã€``B()`` ã®æ¨™æº–化ã•ã‚ŒãŸä½¿ç”¨æ–¹æ³•ã¯ã‚ã‚Šã¾ã›ã‚“。ã“ã®ãƒ‰ã‚ュメントã§ã¯å¤ªå—ã§è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:254 +#: ../../rst/dev_guide/developing_modules_documenting.rst:263 msgid "``HORIZONTALLINE`` is used sparingly as a separator in long descriptions. It becomes a horizontal rule (the ``<hr>`` html tag) in the documentation." msgstr "``HORIZONTALLINE`` ã¯ã€é•·ã„説明ã§ã¯ã€åŒºåˆ‡ã‚Šæ–‡å—ã¨ã—ã¦æ…Žé‡ã«ä½¿ç”¨ã•ã‚Œã¦ãŠã‚Šã€ãƒ‰ã‚ュメント内ã®æ°´å¹³ãƒ«ãƒ¼ãƒ« (``<hr>`` html ã‚¿ã‚°) ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:258 +#: ../../rst/dev_guide/developing_modules_documenting.rst:267 msgid "For links between modules and documentation within a collection, you can use any of the options above. For links outside of your collection, use ``R()`` if available. Otherwise, use ``U()`` or ``L()`` with full URLs (not relative links). For modules, use ``M()`` with the FQCN or ``ansible.builtin`` as shown in the example. If you are creating your own documentation site, you will need to use the `intersphinx extension <https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>`_ to convert ``R()`` and ``M()`` to the correct links." msgstr "コレクション内ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ãƒ‰ã‚ュメント間ã®ãƒªãƒ³ã‚¯ã«ã¤ã„ã¦ã¯ã€ä¸Šè¨˜ã®ã‚ªãƒ—ションã®ã„ãšã‚Œã‹ã‚’使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚コレクション外ã®ãƒªãƒ³ã‚¯ã«ã¤ã„ã¦ã¯ã€åˆ©ç”¨å¯èƒ½ãªå ´åˆã¯ ``R()`` を使用ã—ã¾ã™ã€‚利用ã§ããªã„å ´åˆã¯ã€(相対リンクã§ã¯ãªã) 完全㪠URL 㧠``U()`` ã¾ãŸã¯ ``L()`` を使用ã—ã¾ã™ã€‚モジュールã®å ´åˆã¯ã€ä¾‹ã®ã‚ˆã†ã«ã€FQCN ã¾ãŸã¯ ``ansible.builtin`` 㧠``M()`` を使用ã—ã¾ã™ã€‚独自ã®ãƒ‰ã‚ュメントサイトを作æˆã™ã‚‹å ´åˆã¯ã€`intersphinx è¡¨ç¾ <https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>`_ を使用ã—㦠``R()`` ãŠã‚ˆã³ ``M()`` ã‚’æ£ã—ã„リンクã«å¤‰æ›ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:261 +#: ../../rst/dev_guide/developing_modules_documenting.rst:270 msgid "To refer to a group of modules in a collection, use ``R()``. When a collection is not the right granularity, use ``C(..)``:" msgstr "コレクション内ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’å‚ç…§ã™ã‚‹ã«ã¯ã€``R()`` を使用ã—ã¾ã™ã€‚コレクションãŒé©åˆ‡ãªç²’度ã§ã¯ãªã„å ´åˆã¯ã€``C(..)`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:263 +#: ../../rst/dev_guide/developing_modules_documenting.rst:272 msgid "``Refer to the R(kubernetes.core collection, plugins_in_kubernetes.core) for information on managing kubernetes clusters.``" msgstr "``Refer to the R(kubernetes.core collection, plugins_in_kubernetes.core) for information on managing kubernetes clusters.``" -#: ../../rst/dev_guide/developing_modules_documenting.rst:264 +#: ../../rst/dev_guide/developing_modules_documenting.rst:273 msgid "``The C(win_*) modules (spread across several collections) allow you to manage various aspects of windows hosts.``" msgstr "``The C(win_*) modules (spread across several collections) allow you to manage various aspects of windows hosts.``" -#: ../../rst/dev_guide/developing_modules_documenting.rst:268 +#: ../../rst/dev_guide/developing_modules_documenting.rst:277 msgid "Because it stands out better, use ``seealso`` for general references over the use of notes or adding links to the description." msgstr "``seealso`` ã®æ–¹ãŒç›®ç«‹ã¤ãŸã‚ã€ä¸€èˆ¬çš„ãªå‚ç…§ã«ã¯ãƒŽãƒ¼ãƒˆã®ä½¿ç”¨ã‚„説明ã¸ã®ãƒªãƒ³ã‚¯ã‚ˆã‚Šã‚‚ã€``seealso`` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:273 +#: ../../rst/dev_guide/developing_modules_documenting.rst:282 msgid "Documentation fragments" msgstr "ドã‚ュメントフラグメント" -#: ../../rst/dev_guide/developing_modules_documenting.rst:275 +#: ../../rst/dev_guide/developing_modules_documenting.rst:284 msgid "If you are writing multiple related modules, they may share common documentation, such as authentication details, file mode settings, ``notes:`` or ``seealso:`` entries. Rather than duplicate that information in each module's ``DOCUMENTATION`` block, you can save it once as a doc_fragment plugin and use it in each module's documentation. In Ansible, shared documentation fragments are contained in a ``ModuleDocFragment`` class in `lib/ansible/plugins/doc_fragments/ <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/doc_fragments>`_ or the equivalent directory in a collection. To include a documentation fragment, add ``extends_documentation_fragment: FRAGMENT_NAME`` in your module documentation. Use the fully qualified collection name for the FRAGMENT_NAME (for example, ``kubernetes.core.k8s_auth_options``)." msgstr "複数ã®é–¢é€£ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’記述ã—ã¦ã„ã‚‹å ´åˆã¯ã€èªè¨¼ã®è©³ç´°ã‚„ファイルモードã®è¨å®šã€``notes:`` ã‚„ ``seealso:`` ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ãªã©ã€å…±é€šã®ãƒ‰ã‚ュメントを共有ã—ã¦ã„ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ãã®ã‚ˆã†ãªæƒ…å ±ã‚’å„モジュール㮠``DOCUMENTATION`` ブãƒãƒƒã‚¯ã«è¤‡è£½ã™ã‚‹ã®ã§ã¯ãªãã€doc_fragment プラグインã¨ã—ã¦ä¸€åº¦ä¿å˜ã—ã€å„モジュールã®ãƒ‰ã‚ュメントã§ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚Ansible ã§ã¯ã€å…±æœ‰ãƒ‰ã‚ュメントフラグメントã¯ã€`lib/ansible/plugins/doc_fragments/ <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/doc_fragments>`_ ã® ``ModuleDocFragment`` クラスã€ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®åŒç‰ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ドã‚ュメントフラグメントをå«ã‚ã‚‹ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメント㫠``extends_documentation_fragment: FRAGMENT_NAME`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚FRAGMENT_NAME ã«ã¯ã€å®Œå…¨ä¿®é£¾ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã—ã¾ã™ (例: ``kubernetes.core.k8s_auth_options``)。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:277 +#: ../../rst/dev_guide/developing_modules_documenting.rst:286 msgid "Modules should only use items from a doc fragment if the module will implement all of the interface documented there in a manner that behaves the same as the existing modules which import that fragment. The goal is that items imported from the doc fragment will behave identically when used in another module that imports the doc fragment." msgstr "モジュールãŒãƒ‰ã‚ュメントフラグメントã®ã‚¢ã‚¤ãƒ†ãƒ を使用ã™ã‚‹ã®ã¯ã€ãã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’インãƒãƒ¼ãƒˆã™ã‚‹æ—¢å˜ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨åŒã˜ã‚ˆã†ã«å‹•ä½œã—ã¦ã€ãƒ‰ã‚ュメント化ã•ã‚ŒãŸã™ã¹ã¦ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã‚’モジュールãŒå®Ÿè£…ã™ã‚‹å ´åˆã®ã¿ã§ã™ã€‚目標ã¯ã€ãƒ‰ã‚ュメントフラグメントã‹ã‚‰ã‚¤ãƒ³ãƒãƒ¼ãƒˆã•ã‚ŒãŸã‚¢ã‚¤ãƒ†ãƒ ãŒã€ãƒ‰ã‚ュメントフラグメントをインãƒãƒ¼ãƒˆã™ã‚‹åˆ¥ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ä½¿ç”¨ã•ã‚ŒãŸå ´åˆã¨åŒã˜ã‚ˆã†ã«å‹•ä½œã™ã‚‹ã“ã¨ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:279 +#: ../../rst/dev_guide/developing_modules_documenting.rst:288 msgid "By default, only the ``DOCUMENTATION`` property from a doc fragment is inserted into the module documentation. It is possible to define additional properties in the doc fragment in order to import only certain parts of a doc fragment or mix and match as appropriate. If a property is defined in both the doc fragment and the module, the module value overrides the doc fragment." msgstr "デフォルトã§ã¯ã€ãƒ‰ã‚ュメントフラグメント㮠``DOCUMENTATION`` プãƒãƒ‘ティーãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントã«æŒ¿å…¥ã•ã‚Œã¾ã™ã€‚ドã‚ュメントフラグメントã®ç‰¹å®šã®éƒ¨åˆ†ã®ã¿ã‚’インãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã€ã¾ãŸã¯å¿…è¦ã«å¿œã˜ã¦çµ„ã¿åˆã‚ã›ã¦ä¸€è‡´ã•ã›ã‚‹ãŸã‚ã«ã€ãƒ‰ã‚ュメントフラグメントã«è¿½åŠ ã®ãƒ—ãƒãƒ‘ティーを定義ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚プãƒãƒ‘ティーãŒãƒ‰ã‚ュメントフラグメントã¨ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ä¸¡æ–¹ã§å®šç¾©ã•ã‚Œã¦ã„ã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å€¤ã¯ãƒ‰ã‚ュメントフラグメントを上書ãã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:281 +#: ../../rst/dev_guide/developing_modules_documenting.rst:290 msgid "Here is an example doc fragment named ``example_fragment.py``:" msgstr "以下ã¯ã€``example_fragment.py`` ã¨ã„ã†åå‰ã®ãƒ‰ã‚ュメントフラグメントã®ä¾‹ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:299 +#: ../../rst/dev_guide/developing_modules_documenting.rst:308 msgid "To insert the contents of ``OTHER`` in a module:" msgstr "``OTHER`` ã®å†…容をモジュールã«æŒ¿å…¥ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:305 +#: ../../rst/dev_guide/developing_modules_documenting.rst:314 msgid "Or use both :" msgstr "ã¾ãŸã¯ã€ä»¥ä¸‹ã®ä¸¡æ–¹ã‚’使用ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:318 +#: ../../rst/dev_guide/developing_modules_documenting.rst:327 msgid "Since Ansible 2.8, you can have user-supplied doc_fragments by using a ``doc_fragments`` directory adjacent to play or role, just like any other plugin." msgstr "Ansible 2.8 以é™ã€ãã®ä»–ã®ãƒ—ラグインã¨åŒæ§˜ã«ã€ãƒ—レイやãƒãƒ¼ãƒ«ã«éš£æŽ¥ã™ã‚‹ ``doc_fragments`` ディレクトリーを使用ã™ã‚‹ã“ã¨ã§ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæä¾›ã™ã‚‹ãƒ‰ã‚ュメントフラグメントをè¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:320 +#: ../../rst/dev_guide/developing_modules_documenting.rst:329 msgid "For example, all AWS modules should include:" msgstr "ãŸã¨ãˆã°ã€ã™ã¹ã¦ã® AWS モジュールã«ã¯ä»¥ä¸‹ã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:328 +#: ../../rst/dev_guide/developing_modules_documenting.rst:337 msgid ":ref:`docfragments_collections` describes how to incorporate documentation fragments in a collection." msgstr "「:ref:`docfragments_collections`ã€ã§ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ãƒ‰ã‚ュメントã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’組ã¿è¾¼ã‚€æ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:333 +#: ../../rst/dev_guide/developing_modules_documenting.rst:342 msgid "EXAMPLES block" msgstr "EXAMPLES ブãƒãƒƒã‚¯" -#: ../../rst/dev_guide/developing_modules_documenting.rst:335 +#: ../../rst/dev_guide/developing_modules_documenting.rst:344 msgid "After the shebang, the UTF-8 coding, the copyright line, the license section, and the ``DOCUMENTATION`` block comes the ``EXAMPLES`` block. Here you show users how your module works with real-world examples in multi-line plain-text YAML format. The best examples are ready for the user to copy and paste into a playbook. Review and update your examples with every change to your module." msgstr "ã‚·ãƒãƒ³ã®å¾Œã€UTF-8 コーディングã€è‘—作権表示ã€ãƒ©ã‚¤ã‚»ãƒ³ã‚¹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã€ãŠã‚ˆã³ ``DOCUMENTATION`` ブãƒãƒƒã‚¯ã®å¾Œã« ``EXAMPLES`` ブãƒãƒƒã‚¯ãŒç¶šãã¾ã™ã€‚ã“ã“ã§ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå®Ÿéš›ã®ä¾‹ã§è¤‡æ•°è¡Œã®ãƒ—レーンテã‚スト YAML å½¢å¼ã§ã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã™ã‚‹ã‹ã‚’ユーザーã«ç¤ºã—ã¾ã™ã€‚最良ã®ä¾‹ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒã‚³ãƒ”ーã—㦠Playbook ã«è²¼ã‚Šä»˜ã‘る準備ãŒã§ãã¦ã„ã¾ã™ã€‚モジュールã«å¤‰æ›´ã‚’åŠ ãˆã‚‹ãŸã³ã«ã€ä¾‹ã‚’確èªã—ã¦æ›´æ–°ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:337 +#: ../../rst/dev_guide/developing_modules_documenting.rst:346 msgid "Per playbook best practices, each example should include a ``name:`` line:" msgstr "Playbook ã®ãƒ™ã‚¹ãƒˆãƒ—ラクティスã«åŸºã¥ãã€å„例ã«ã¯ ``name:`` è¡ŒãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:348 +#: ../../rst/dev_guide/developing_modules_documenting.rst:357 msgid "The ``name:`` line should be capitalized and not include a trailing dot." msgstr "``name:`` è¡Œã¯å¤§æ–‡å—ã«ã—ã€æœ«å°¾ã®ãƒ‰ãƒƒãƒˆã¯å«ã‚ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:350 +#: ../../rst/dev_guide/developing_modules_documenting.rst:359 msgid "Use a fully qualified collection name (FQCN) as a part of the module's name like in the example above. For modules in ``ansible-core``, use the ``ansible.builtin.`` identifier, for example ``ansible.builtin.debug``." msgstr "上記ã®ä¾‹ã®ã‚ˆã†ã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åã®ä¸€éƒ¨ã¨ã—ã¦å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å (FQCN) を使用ã—ã¾ã™ã€‚``ansible-core`` ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å ´åˆã¯ã€``ansible.builtin.`` è˜åˆ¥å (ãŸã¨ãˆã° ``ansible.builtin.debug``) を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:352 +#: ../../rst/dev_guide/developing_modules_documenting.rst:361 msgid "If your examples use boolean options, use yes/no values. Since the documentation generates boolean values as yes/no, having the examples use these values as well makes the module documentation more consistent." msgstr "サンプルã§ãƒ–ール値オプションを使用ã™ã‚‹å ´åˆã¯ã€yes/no ã®å€¤ã‚’使用ã—ã¾ã™ã€‚ドã‚ュメントã«ã‚ˆã‚Šãƒ–ール値㌠yes/no ã¨ã—ã¦ç”Ÿæˆã•ã‚Œã‚‹ãŸã‚ã€ã“ã®ã‚µãƒ³ãƒ—ルã§ã¯ã“れらã®å€¤ãŒä½¿ç”¨ã•ã‚Œã¦ãŠã‚Šã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントã®ä¸€è²«æ€§ãŒä¿ãŸã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:354 +#: ../../rst/dev_guide/developing_modules_documenting.rst:363 msgid "If your module returns facts that are often needed, an example of how to use them can be helpful." msgstr "モジュールãŒå¿…è¦ãªãƒ•ã‚¡ã‚¯ãƒˆã‚’è¿”ã™ã¨ã€ãã®ä½¿ç”¨æ–¹æ³•ã®ä¾‹ãŒä¾¿åˆ©ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:359 +#: ../../rst/dev_guide/developing_modules_documenting.rst:368 msgid "RETURN block" msgstr "RETURN ブãƒãƒƒã‚¯" -#: ../../rst/dev_guide/developing_modules_documenting.rst:361 +#: ../../rst/dev_guide/developing_modules_documenting.rst:370 msgid "After the shebang, the UTF-8 coding, the copyright line, the license section, ``DOCUMENTATION`` and ``EXAMPLES`` blocks comes the ``RETURN`` block. This section documents the information the module returns for use by other modules." msgstr "ã‚·ãƒãƒ³ã€UTF-8コーディングã€è‘—作権表示ã€ãƒ©ã‚¤ã‚»ãƒ³ã‚¹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã€``DOCUMENTATION`` ブãƒãƒƒã‚¯ãŠã‚ˆã³ ``EXAMPLES`` ブãƒãƒƒã‚¯ã®å¾Œã«ã€``RETURN`` ブãƒãƒƒã‚¯ãŒç¶šãã¾ã™ã€‚ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«è¿”ã™æƒ…å ±ã‚’èª¬æ˜Žã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:363 +#: ../../rst/dev_guide/developing_modules_documenting.rst:372 msgid "If your module doesn't return anything (apart from the standard returns), this section of your module should read: ``RETURN = r''' # '''`` Otherwise, for each value returned, provide the following fields. All fields are required unless specified otherwise." msgstr "モジュールãŒä½•ã‚‚è¿”ã•ãªã„å ´åˆã¯ (標準ã®æˆ»ã‚Šå€¤ã¨ã¯ç•°ãªã‚Š)ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã¯ ``RETURN = r''' # '''`` ã‚’èªã¿å–ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãれ以外ã®å ´åˆã¯ã€è¿”ã•ã‚ŒãŸå„値ã«ä»¥ä¸‹ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã‚’指定ã—ã¾ã™ã€‚特ã«æŒ‡å®šãŒãªã„å ´åˆã¯ã™ã¹ã¦ã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" @@ -4377,11 +4457,11 @@ msgstr "モジュールãŒä½•ã‚‚è¿”ã•ãªã„å ´åˆã¯ (標準ã®æˆ»ã‚Šå€¤ã¨ã¯ç msgid "return name" msgstr "return name" -#: ../../rst/dev_guide/developing_modules_documenting.rst:367 +#: ../../rst/dev_guide/developing_modules_documenting.rst:376 msgid "Name of the returned field." msgstr "è¿”ã•ã‚Œã‚‹ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã®åå‰ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:370 +#: ../../rst/dev_guide/developing_modules_documenting.rst:379 msgid "Detailed description of what this value represents. Capitalized and with trailing dot." msgstr "ã“ã®å€¤ãŒè¡¨ã™å†…容ã®è©³ç´°ãªèª¬æ˜Žã€‚大文å—ã§ã€æœ«å°¾ã®ãƒ‰ãƒƒãƒˆã‚’使用ã—ã¾ã™ã€‚" @@ -4389,15 +4469,15 @@ msgstr "ã“ã®å€¤ãŒè¡¨ã™å†…容ã®è©³ç´°ãªèª¬æ˜Žã€‚大文å—ã§ã€æœ«å°¾ã®ãƒ‰ msgid "returned" msgstr "returned" -#: ../../rst/dev_guide/developing_modules_documenting.rst:372 +#: ../../rst/dev_guide/developing_modules_documenting.rst:381 msgid "When this value is returned, such as ``always``, ``changed`` or ``success``. This is a string and can contain any human-readable content." msgstr "``always``ã€``changed``ã€``success`` ãªã©ã®ã“ã®å€¤ãŒè¿”ã•ã‚Œã‚‹ã¨ã€ã“ã‚Œã¯æ–‡å—列ã¨ãªã‚Šã€äººé–“ãŒåˆ¤èªã§ãるコンテンツをå«ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:374 +#: ../../rst/dev_guide/developing_modules_documenting.rst:383 msgid "Data type." msgstr "データ型。" -#: ../../rst/dev_guide/developing_modules_documenting.rst:376 +#: ../../rst/dev_guide/developing_modules_documenting.rst:385 msgid "If ``type='list'``, specifies the data type of the list's elements." msgstr "``type='list'`` ã®å ´åˆã¯ã€ãƒªã‚¹ãƒˆã®è¦ç´ ã®ãƒ‡ãƒ¼ã‚¿ã‚¿ã‚¤ãƒ—を指定ã—ã¾ã™ã€‚" @@ -4405,11 +4485,11 @@ msgstr "``type='list'`` ã®å ´åˆã¯ã€ãƒªã‚¹ãƒˆã®è¦ç´ ã®ãƒ‡ãƒ¼ã‚¿ã‚¿ã‚¤ãƒ—ã‚ msgid "sample" msgstr "sample" -#: ../../rst/dev_guide/developing_modules_documenting.rst:378 +#: ../../rst/dev_guide/developing_modules_documenting.rst:387 msgid "One or more examples." msgstr "1 ã¤ä»¥ä¸Šã®ä¾‹ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:380 +#: ../../rst/dev_guide/developing_modules_documenting.rst:389 msgid "Only needed if this return was extended after initial Ansible release, in other words, this is greater than the top level `version_added` field. This is a string, and not a float, for example, ``version_added: '2.3'``." msgstr "ã“ã‚Œã¯ã€æœ€åˆã® Ansible リリースã®å¾Œã«ã“ã®è¿”ã•ã‚ŒãŸå ´åˆã«ã®ã¿å¿…è¦ã§ã™ã€‚ã¤ã¾ã‚Šã€ã“ã‚Œã¯æœ€ä¸Šä½ãƒ¬ãƒ™ãƒ«ã® `version_added` フィールドよりも大ãããªã‚Šã¾ã™ã€‚ã“ã‚Œã¯æµ®å‹•å°æ•°ç‚¹ã§ã¯ãªãã€æ–‡å—列ã§ã™ (例: ``version_added: '2.3'``)。" @@ -4417,32 +4497,31 @@ msgstr "ã“ã‚Œã¯ã€æœ€åˆã® Ansible リリースã®å¾Œã«ã“ã®è¿”ã•ã‚ŒãŸå ´ msgid "contains" msgstr "contains" -#: ../../rst/dev_guide/developing_modules_documenting.rst:383 +#: ../../rst/dev_guide/developing_modules_documenting.rst:392 msgid "Optional. To describe nested return values, set ``type: dict``, or ``type: list``/``elements: dict``, or if you really have to, ``type: complex``, and repeat the elements above for each sub-field." msgstr "ä»»æ„ã§ã™ã€‚ãƒã‚¹ãƒˆã•ã‚ŒãŸæˆ»ã‚Šå€¤ã‚’記述ã™ã‚‹ã«ã¯ã€``type: dict`` ã¾ãŸã¯ ``type: list``/``elements: dict`` ã‚’è¨å®šã™ã‚‹ã‹ã€æœ¬å½“ã«å¿…è¦ã§ã‚れ㰠``type: complex`` ã‚’è¨å®šã—ã€å„サブフィールドã«å¯¾ã—ã¦ä¸Šè¨˜ã®è¦ç´ ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:385 +#: ../../rst/dev_guide/developing_modules_documenting.rst:394 msgid "Here are two example ``RETURN`` sections, one with three simple fields and one with a complex nested field:" msgstr "以下ã®ä¾‹ã¯ã€``RETURN`` セクションを 3 ã¤ã®å˜ç´”ãªãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã¨ã€è¤‡é›‘ãªãƒã‚¹ãƒˆã•ã‚ŒãŸãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã‚’æŒã¤ 2 ã¤ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:435 +#: ../../rst/dev_guide/developing_modules_documenting.rst:444 msgid "Python imports" msgstr "Python ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" -#: ../../rst/dev_guide/developing_modules_documenting.rst:437 +#: ../../rst/dev_guide/developing_modules_documenting.rst:446 msgid "After the shebang, the UTF-8 coding, the copyright line, the license, and the sections for ``DOCUMENTATION``, ``EXAMPLES``, and ``RETURN``, you can finally add the python imports. All modules must use Python imports in the form:" msgstr "ã‚·ãƒãƒ³ã®å¾Œã«ã¯ã€UTF-8 コード行ã€è‘—作権行ã€ãƒ©ã‚¤ã‚»ãƒ³ã‚¹ã€ãŠã‚ˆã³ ``DOCUMENTATION``ã€``EXAMPLES``ã€ãŠã‚ˆã³ ``RETURN`` ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ãŒæœ€å¾Œã« python インãƒãƒ¼ãƒˆã‚’è¿½åŠ ã§ãã¾ã™ã€‚ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã“ã®å½¢å¼ã® Python インãƒãƒ¼ãƒˆã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:443 +#: ../../rst/dev_guide/developing_modules_documenting.rst:452 msgid "The use of \"wildcard\" imports such as ``from module_utils.basic import *`` is no longer allowed." msgstr "``from module_utils.basic import *`` ãªã©ã®ã€Œãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆã®ä½¿ç”¨ã¯è¨±å¯ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_modules_documenting.rst:448 -#: ../../rst/dev_guide/testing_documentation.rst:7 +#: ../../rst/dev_guide/developing_modules_documenting.rst:457 msgid "Testing module documentation" msgstr "モジュールドã‚ュメンテーションã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/developing_modules_documenting.rst:450 +#: ../../rst/dev_guide/developing_modules_documenting.rst:459 msgid "To test Ansible documentation locally please :ref:`follow instruction<testing_module_documentation>`. To test documentation in collections, please see :ref:`build_collection_docsite`." msgstr "Ansible ドã‚ュメントをãƒãƒ¼ã‚«ãƒ«ã§ãƒ†ã‚¹ãƒˆã™ã‚‹æ–¹æ³•ã¯ã€:ref:`<testing_module_documentation>ã®æŒ‡ç¤ºã«å¾“ã„ã¾ã™ã€‚`ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ‰ã‚ュメントをテストã™ã‚‹å ´åˆã¯ã€:ref:`build_collection_docsite` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -4599,6 +4678,7 @@ msgid "Create a playbook in any directory: ``$ touch testmod.yml``" msgstr "ä»»æ„ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã« Playbook を作æˆã—ã¾ã™ (``$ touch testmod.yml``)。" #: ../../rst/dev_guide/developing_modules_general.rst:124 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:566 msgid "Add the following to the new playbook file:" msgstr "以下を新ã—ã„ Playbook ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" @@ -4674,488 +4754,6 @@ msgstr "è¬è¾ž" msgid "Thank you to Thomas Stringer (`@trstringer <https://github.com/trstringer>`_) for contributing source material for this topic." msgstr "ã“ã®ãƒˆãƒ”ックã®å…ƒã¨ãªã‚‹è³‡æ–™ã‚’æä¾›ã—ã¦ã„ãŸã ã„㟠Thomas Stringer (`@trstringer <https://github.com/trstringer>`_) æ°ã«æ„Ÿè¬ã®æ„を示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_aci.rst:5 -msgid "Developing Cisco ACI modules" -msgstr "Cisco ACI モジュールã®é–‹ç™º" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:6 -msgid "This is a brief walk-through of how to create new Cisco ACI modules for Ansible." -msgstr "Ansible å‘ã‘ã«æ–°ã—ã„ Cisco ACI モジュールを作æˆã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹ç°¡å˜ãªã‚¦ã‚©ãƒ¼ã‚¯ã‚¹ãƒ«ãƒ¼ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:8 -msgid "For more information about Cisco ACI, look at the :ref:`Cisco ACI user guide <aci_guide>`." -msgstr "Cisco ACI ã®è©³ç´°ã¯ã€ã€Œ:ref:`Cisco ACI ユーザーガイド <aci_guide>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:10 -#: ../../rst/dev_guide/developing_modules_general_windows.rst:13 -msgid "What's covered in this section:" -msgstr "æœ¬é …ã§å–り上ã’られã¦ã„る内容:" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:20 -#: ../../rst/dev_guide/testing_units_modules.rst:14 -msgid "Introduction" -msgstr "ã¯ã˜ã‚ã«" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:21 -msgid "The `cisco.aci collection <https://galaxy.ansible.com/cisco/aci>`_ already includes a large number of Cisco ACI modules, however the ACI object model is huge and covering all possible functionality would easily cover more than 1500 individual modules." -msgstr "`cisco.aci collection <https://galaxy.ansible.com/cisco/aci>`_ ã«ã¯ã™ã§ã«å¤šæ•°ã® Cisco ACI モジュールãŒå«ã¾ã‚Œã¦ã„ã¾ã™ãŒã€ACI オブジェクトモデルã¯å¤§ããã€ã™ã¹ã¦ã®æ©Ÿèƒ½ã«å¯¾å¿œã™ã‚‹ãŸã‚ã€1500 以上ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’ç°¡å˜ã«å¯¾å¿œã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:23 -msgid "If you need specific functionality, you have 2 options:" -msgstr "特定ã®æ©Ÿèƒ½ãŒå¿…è¦ãªå ´åˆã¯ã€2 ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:25 -msgid "Learn the ACI object model and use the low-level APIC REST API using the :ref:`aci_rest <aci_rest_module>` module" -msgstr "ACI オブジェクトモデルをå¦ç¿’ã—ã€ã€Œ:ref:`aci_rest <aci_rest_module>`ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦ä½Žãƒ¬ãƒ™ãƒ«ã® APIC REST API を使用ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:26 -msgid "Write your own dedicated modules, which is actually quite easy" -msgstr "独自ã®å°‚用モジュールを作æˆã™ã‚‹ã“ã¨ã¯ã€å®Ÿéš›ã«ã¯éžå¸¸ã«ç°¡å˜ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:30 -#: ../../rst/dev_guide/developing_modules_general_aci.rst:413 -msgid "`Ansible ACI collection <https://github.com/CiscoDevNet/ansible-aci>`_" -msgstr "`Ansible ACI collection <https://github.com/CiscoDevNet/ansible-aci>`_" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:31 -#: ../../rst/dev_guide/developing_modules_general_aci.rst:414 -msgid "Github repository of the ansible ACI collection" -msgstr "Ansible ACI コレクション㮠GitHub リãƒã‚¸ãƒˆãƒªãƒ¼" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:32 -#: ../../rst/dev_guide/developing_modules_general_aci.rst:409 -msgid ":ref:`hacking_collections`" -msgstr ":ref:`collections`" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:33 -msgid "Information on how to contribute to collections." -msgstr "コレクションã¸ã®è²¢çŒ®æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:34 -msgid "`ACI Fundamentals: ACI Policy Model <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/aci-fundamentals/b_ACI-Fundamentals/b_ACI-Fundamentals_chapter_010001.html>`_" -msgstr "`ACI Fundamentals: ACI Policy Model <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/aci-fundamentals/b_ACI-Fundamentals/b_ACI-Fundamentals_chapter_010001.html>`_" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:35 -msgid "A good introduction to the ACI object model." -msgstr "ACI オブジェクトモデルã®å„ªã‚ŒãŸæ¦‚è¦" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:36 -msgid "`APIC Management Information Model reference <https://developer.cisco.com/docs/apic-mim-ref/>`_" -msgstr "`APIC Management Information Model reference <https://developer.cisco.com/docs/apic-mim-ref/>`_" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:37 -msgid "Complete reference of the APIC object model." -msgstr "APIC オブジェクトモデルã®å®Œå…¨ãªãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:38 -msgid "`APIC REST API Configuration Guide <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/2-x/rest_cfg/2_1_x/b_Cisco_APIC_REST_API_Configuration_Guide.html>`_" -msgstr "`APIC REST API Configuration Guide <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/2-x/rest_cfg/2_1_x/b_Cisco_APIC_REST_API_Configuration_Guide.html>`_" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:39 -msgid "Detailed guide on how the APIC REST API is designed and used, incl. many examples." -msgstr "APIC REST API ã‚’è¨è¨ˆãŠã‚ˆã³ä½¿ç”¨ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦ã®è©³ç´°ã‚¬ã‚¤ãƒ‰ã€‚多数ã®ä¾‹ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:42 -msgid "So let's look at how a typical ACI module is built up." -msgstr "ãã‚Œã§ã¯ã€å…¸åž‹çš„㪠ACI モジュールãŒã©ã®ã‚ˆã†ã«æ§‹ç¯‰ã•ã‚Œã‚‹ã‹ã‚’見ã¦ã¿ã¾ã—ょã†ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:48 -msgid "ACI module structure" -msgstr "ACI ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«æ§‹é€ " - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:51 -msgid "Importing objects from Python libraries" -msgstr "Python ライブラリーã‹ã‚‰ã®ã‚ªãƒ–ジェクトã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:52 -msgid "The following imports are standard across ACI modules:" -msgstr "以下ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ã€ACI モジュール全体ã§æ¨™æº–ã®ã‚‚ã®ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:61 -msgid "Defining the argument spec" -msgstr "引数仕様ã®å®šç¾©" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:62 -msgid "The first line adds the standard connection parameters to the module. After that, the next section will update the ``argument_spec`` dictionary with module-specific parameters. The module-specific parameters should include:" -msgstr "最åˆã®è¡Œã¯ã€æ¨™æº–ã®æŽ¥ç¶šãƒ‘ラメーターをモジュールã«è¿½åŠ ã—ã¾ã™ã€‚ãã®å¾Œã€ä»¥ä¸‹ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å›ºæœ‰ã®ãƒ‘ラメーター㧠``argument_spec`` ディクショナリーを更新ã—ã¾ã™ã€‚モジュール固有ã®ãƒ‘ラメーターã«ã¯ä»¥ä¸‹ãŒå«ã¾ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:64 -msgid "the object_id (usually the name)" -msgstr "object_id (通常ã¯åå‰)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:65 -msgid "the configurable properties of the object" -msgstr "オブジェクトã®è¨å®šå¯èƒ½ãªãƒ—ãƒãƒ‘ティー" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:66 -msgid "the parent object IDs (all parents up to the root)" -msgstr "親オブジェクト ID (ルートã¾ã§ã®ã™ã¹ã¦ã®è¦ª)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:67 -msgid "only child classes that are a 1-to-1 relationship (1-to-many/many-to-many require their own module to properly manage)" -msgstr "1 対 1 ã®é–¢ä¿‚ã§ã‚ã‚‹åクラスã®ã¿ (1 対多/多対多ã§ã¯ã€ç‹¬è‡ªã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’é©åˆ‡ã«ç®¡ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:68 -msgid "the state" -msgstr "状態" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:70 -msgid "``state: absent`` to ensure object does not exist" -msgstr "``state: absent``: オブジェクトãŒå˜åœ¨ã—ãªã„ã“ã¨ã‚’確èªã™ã‚‹" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:71 -msgid "``state: present`` to ensure the object and configs exist; this is also the default" -msgstr "``state: present``: オブジェクトã¨è¨å®šãŒå˜åœ¨ã™ã‚‹ã“ã¨ã‚’確èªã™ã‚‹ (デフォルト)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:72 -msgid "``state: query`` to retrieve information about objects in the class" -msgstr "``state: query``: クラスã®ã‚ªãƒ–ジェクトã«é–¢ã™ã‚‹æƒ…å ±ã‚’å–å¾—ã™ã‚‹" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:90 -msgid "Do not provide default values for configuration arguments. Default values could cause unintended changes to the object." -msgstr "è¨å®šå¼•æ•°ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’指定ã—ãªã„ã§ãã ã•ã„。デフォルト値ã«ã‚ˆã‚Šã€ã‚ªãƒ–ジェクトã¸ã®æ„図ã—ãªã„変更ãŒç”Ÿã˜ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:93 -msgid "Using the AnsibleModule object" -msgstr "AnsibleModule オブジェクトã®ä½¿ç”¨" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:94 -msgid "The following section creates an AnsibleModule instance. The module should support check-mode, so we pass the ``argument_spec`` and ``supports_check_mode`` arguments. Since these modules support querying the APIC for all objects of the module's class, the object/parent IDs should only be required if ``state: absent`` or ``state: present``." -msgstr "次ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€AnsibleModule インスタンスを作æˆã—ã¾ã™ã€‚モジュールã¯ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’サãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚‹ãŸã‚ã€``argument_spec`` 引数ãŠã‚ˆã³ ``supports_check_mode`` 引数を渡ã—ã¾ã™ã€‚ã“れらã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚¯ãƒ©ã‚¹ã®ã™ã¹ã¦ã®ã‚ªãƒ–ジェクトã«å¯¾ã™ã‚‹ APIC ã®ã‚¯ã‚¨ãƒªãƒ¼ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã€ã‚ªãƒ–ジェクト/親 ID ã¯ã€``state: absent`` ã¾ãŸã¯ ``state: present`` ã®å ´åˆã«é™ã‚Šå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:109 -msgid "Mapping variable definition" -msgstr "マッピング変数定義" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:110 -msgid "Once the AnsibleModule object has been initiated, the necessary parameter values should be extracted from ``params`` and any data validation should be done. Usually the only params that need to be extracted are those related to the ACI object configuration and its child configuration. If you have integer objects that you would like to validate, then the validation should be done here, and the ``ACIModule.payload()`` method will handle the string conversion." -msgstr "AnsibleModule オブジェクトãŒé–‹å§‹ã•ã‚ŒãŸã‚‰ã€å¿…è¦ãªãƒ‘ラメーターã®å€¤ã‚’ ``params`` ã‹ã‚‰æŠ½å‡ºã—ã€ãƒ‡ãƒ¼ã‚¿ã®æ¤œè¨¼ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚通常ã€æŠ½å‡ºã™ã‚‹å¿…è¦ãŒã‚る唯一ã®ãƒ‘ラメーター㌠ACI オブジェクトã®è¨å®šãŠã‚ˆã³ãã®åè¨å®šã«é–¢é€£ã™ã‚‹ãƒ‘ラメーターã®ã¿ã¨ãªã‚Šã¾ã™ã€‚検証ã™ã‚‹æ•´æ•°ã‚ªãƒ–ジェクトãŒã‚ã‚‹å ´åˆã¯ã€æ¤œè¨¼ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚データ検証ã¯ã“ã“ã§è¡Œã†å¿…è¦ãŒã‚ã‚Šã€``ACIModule.payload()`` メソッドã¯å¤‰æ›æ–‡å—列を処ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:126 -msgid "Using the ACIModule object" -msgstr "ACIModule オブジェクトã®ä½¿ç”¨" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:127 -msgid "The ACIModule class handles most of the logic for the ACI modules. The ACIModule extends functionality to the AnsibleModule object, so the module instance must be passed into the class instantiation." -msgstr "ACIModule クラスã¯ã€ACI モジュールã®ãƒã‚¸ãƒƒã‚¯ã®å¤§éƒ¨åˆ†ã‚’処ç†ã—ã¾ã™ã€‚ACIModule ã¯æ©Ÿèƒ½ã‚’ AnsibleModule オブジェクトã«æ‹¡å¼µã™ã‚‹ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã‚’クラスã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹åŒ–ã«æ¸¡ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:133 -msgid "The ACIModule has six main methods that are used by the modules:" -msgstr "ACIModule ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã‚‹ 6 ã¤ã®ä¸»ãªãƒ¡ã‚½ãƒƒãƒ‰ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:135 -msgid "construct_url" -msgstr "construct_url" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:136 -msgid "get_existing" -msgstr "get_existing" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:137 -msgid "payload" -msgstr "payload" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:138 -msgid "get_diff" -msgstr "get_diff" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:139 -msgid "post_config" -msgstr "post_config" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:140 -msgid "delete_config" -msgstr "delete_config" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:142 -msgid "The first two methods are used regardless of what value is passed to the ``state`` parameter." -msgstr "最åˆã® 2 ã¤ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€``state`` パラメーターã«æ¸¡ã•ã‚Œã‚‹å€¤ã«é–¢ä¿‚ãªã使用ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:145 -msgid "Constructing URLs" -msgstr "URL ã®æ§‹ç¯‰" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:146 -msgid "The ``construct_url()`` method is used to dynamically build the appropriate URL to interact with the object, and the appropriate filter string that should be appended to the URL to filter the results." -msgstr "``construct_url()`` メソッドã¯ã€ã‚ªãƒ–ジェクトã¨å¯¾è©±ã™ã‚‹ãŸã‚ã«é©åˆ‡ãª URL ã¨ã€URL ã«è¿½åŠ ã—ã¦çµæžœã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’è¨å®šã™ã‚‹é©åˆ‡ãªãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列を動的ã«æ§‹ç¯‰ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:148 -msgid "When the ``state`` is not ``query``, the URL is the base URL to access the APIC plus the distinguished name to access the object. The filter string will restrict the returned data to just the configuration data." -msgstr "``state`` ㌠``query`` ã§ãªã„å ´åˆã€URL 㯠APIC ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãƒ™ãƒ¼ã‚¹ URL ã¨ã€ã‚ªãƒ–ジェクトã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãŸã‚ã®è˜åˆ¥åã§ã™ã€‚フィルター文å—列ã¯è¿”ã•ã‚ŒãŸãƒ‡ãƒ¼ã‚¿ã‚’è¨å®šãƒ‡ãƒ¼ã‚¿ã«ã®ã¿åˆ¶é™ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:149 -msgid "When ``state`` is ``query``, the URL and filter string used depends on what parameters are passed to the object. This method handles the complexity so that it is easier to add new modules and so that all modules are consistent in what type of data is returned." -msgstr "``state`` ㌠``query`` ã•ã‚Œã‚‹å ´åˆã€ä½¿ç”¨ã•ã‚Œã‚‹ URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列ã¯ã€ã‚ªãƒ–ジェクトã«æ¸¡ã•ã‚Œã‚‹ãƒ‘ラメーターã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚ã“ã®æ–¹æ³•ã¯è¤‡é›‘性を処ç†ã™ã‚‹ãŸã‚ã€æ–°ã—ã„モジュールã®è¿½åŠ ãŒå®¹æ˜“ã«ãªã‚Šã¾ã™ã€‚ã¾ãŸã€ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã©ã®ã‚¿ã‚¤ãƒ—ã®ãƒ‡ãƒ¼ã‚¿ã‚’è¿”ã™ã‹ã«ä¸€è²«æ€§ã‚’æŒãŸã›ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:151 -msgid "Our design goal is to take all ID parameters that have values, and return the most specific data possible. If you do not supply any ID parameters to the task, then all objects of the class will be returned. If your task does consist of ID parameters sed, then the data for the specific object is returned. If a partial set of ID parameters are passed, then the module will use the IDs that are passed to build the URL and filter strings appropriately." -msgstr "ã“ã®è¨è¨ˆã®ç›®çš„ã¯ã€å€¤ãŒã‚ã‚‹ã™ã¹ã¦ã® ID パラメーターをå–ã‚Šã€æœ€ã‚‚具体的ãªãƒ‡ãƒ¼ã‚¿ã‚’è¿”ã™ã“ã¨ã§ã™ã€‚ID パラメーターをタスクã«æŒ‡å®šã—ãªã„ã¨ã€ã‚¯ãƒ©ã‚¹ã®ã™ã¹ã¦ã®ã‚ªãƒ–ジェクトãŒè¿”ã•ã‚Œã¾ã™ã€‚タスク㌠ID パラメーター sed ã§æ§‹æˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ç‰¹å®šã®ã‚ªãƒ–ジェクトã®ãƒ‡ãƒ¼ã‚¿ãŒè¿”ã•ã‚Œã¾ã™ã€‚ID パラメーターã®ä¸€éƒ¨ãŒæ¸¡ã•ã‚Œã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列をé©åˆ‡ã«ãƒ“ルドã™ã‚‹ãŸã‚ã«æ¸¡ã•ã‚ŒãŸ ID を使用ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:153 -msgid "The ``construct_url()`` method takes 2 required arguments:" -msgstr "``construct_url()`` メソッドã¯ã€å¿…è¦ãªå¼•æ•°ã‚’ 2 ã¤å–ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:155 -msgid "**self** - passed automatically with the class instance" -msgstr "**self** - クラスインスタンスã§è‡ªå‹•çš„ã«æ¸¡ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:156 -msgid "**root_class** - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" -msgstr "**root_class**: ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:158 -msgid "**aci_class**: The name of the class used by the APIC, for example ``fvTenant``" -msgstr "**aci_class**: APIC ãŒä½¿ç”¨ã™ã‚‹ã‚¯ãƒ©ã‚¹å (例: ``fvTenant``)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:160 -msgid "**aci_rn**: The relative name of the object, for example ``tn-ACME``" -msgstr "**aci_rn**: オブジェクトã®ç›¸å¯¾å (例: ``tn-ACME``)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:162 -msgid "**target_filter**: A dictionary with key-value pairs that make up the query string for selecting a subset of entries, for example ``{'name': 'ACME'}``" -msgstr "**target_filter**: エントリーã®ã‚µãƒ–セットをé¸æŠžã™ã‚‹ã‚¯ã‚¨ãƒªãƒ¼æ–‡å—列を構æˆã™ã‚‹ã‚ーã¨å€¤ã®ãƒšã‚¢ã‚’æŒã¤ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ (例: ``{'name': 'ACME'}``)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:164 -msgid "**module_object**: The particular object for this class, for example ``ACME``" -msgstr "**module_object**: ã“ã®ã‚¯ãƒ©ã‚¹ã®ç‰¹å®šã®ã‚ªãƒ–ジェクト (例: ``ACME``)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:166 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:599 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:638 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:652 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:752 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:769 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:783 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:810 -#: ../../rst/dev_guide/developing_program_flow_modules.rst:827 -#: ../../rst/dev_guide/testing_units_modules.rst:90 -#: ../../rst/dev_guide/testing_units_modules.rst:109 -msgid "Example:" -msgstr "例: " - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:179 -msgid "Some modules, like ``aci_tenant``, are the root class and so they would not need to pass any additional arguments to the method." -msgstr "``aci_tenant`` ãªã©ã®ä¸€éƒ¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ root クラスã§ã‚ã‚‹ãŸã‚ã€ãƒ¡ã‚½ãƒƒãƒ‰ã«è¿½åŠ ã®å¼•æ•°ã‚’渡ã™å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:181 -msgid "The ``construct_url()`` method takes 4 optional arguments, the first three imitate the root class as described above, but are for child objects:" -msgstr "``construct_url()`` メソッドã¯ã€4 ã¤ã®ä»»æ„ã®å¼•æ•°ã‚’å–ã‚Šã¾ã™ã€‚最åˆã® 3 ã¤ã®å¼•æ•°ãŒä¸Šè¨˜ã®ã‚ˆã†ã« root クラスを模倣ã—ã¾ã™ãŒã€ã“ã‚Œã¯åオブジェクト用ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:183 -msgid "subclass_1 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" -msgstr "subclass_1 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:185 -msgid "Example: Application Profile Class (AP)" -msgstr "例: Application Profile Class (AP)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:187 -msgid "subclass_2 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" -msgstr "subclass_2 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:189 -msgid "Example: End Point Group (EPG)" -msgstr "例: エンドãƒã‚¤ãƒ³ãƒˆã‚°ãƒ«ãƒ¼ãƒ— (EPG)" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:191 -msgid "subclass_3 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" -msgstr "subclass_3 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:193 -msgid "Example: Binding a Contract to an EPG" -msgstr "例: EPG ã¸ã®å¥‘ç´„ã®ãƒã‚¤ãƒ³ãƒ‰" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:195 -msgid "child_classes - The list of APIC names for the child classes supported by the modules." -msgstr "child_classes - モジュールãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹åクラス㮠APIC åã®ãƒªã‚¹ãƒˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:197 -msgid "This is a list, even if it is a list of one" -msgstr "1 ã¤ã®ãƒªã‚¹ãƒˆã§ã‚ã£ã¦ã‚‚ã€ã“ã‚Œã¯ãƒªã‚¹ãƒˆã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:198 -msgid "These are the unfriendly names used by the APIC" -msgstr "ã“れらã¯ã€APIC ãŒä½¿ç”¨ã™ã‚‹åˆ†ã‹ã‚Šã«ãã„åå‰ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:199 -msgid "These are used to limit the returned child_classes when possible" -msgstr "å¯èƒ½ãªå ´åˆã¯ã€è¿”ã•ã‚ŒãŸ child_classes を制é™ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:200 -msgid "Example: ``child_classes=['fvRsBDSubnetToProfile', 'fvRsNdPfxPol']``" -msgstr "例: ``child_classes=['fvRsBDSubnetToProfile', 'fvRsNdPfxPol']``" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:202 -msgid "Sometimes the APIC will require special characters ([, ], and -) or will use object metadata in the name (\"vlanns\" for VLAN pools); the module should handle adding special characters or joining of multiple parameters in order to keep expected inputs simple." -msgstr "APIC ã¯ã€ç‰¹æ®Šæ–‡å— ([, ]ã€ãŠã‚ˆã³ -) ã‚’è¦æ±‚ã—ãŸã‚Šã€åå‰ã«ã‚ªãƒ–ジェクトã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ (「VLANã€ãƒ—ールã®å ´åˆã¯ã€Œvlannsã€) を使用ã—ãŸã‚Šã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚モジュールã¯ã€äºˆæƒ³ã•ã‚Œã‚‹å…¥åŠ›ã®å˜ç´”ã•ã«ä¿ã¤ãŸã‚ã«ã€ç‰¹æ®Šæ–‡å—ã®è¿½åŠ ã¾ãŸã¯è¤‡æ•°ã®ãƒ‘ラメーターã®çµåˆã‚’処ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:205 -msgid "Getting the existing configuration" -msgstr "æ—¢å˜è¨å®šã®å–å¾—" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:206 -msgid "Once the URL and filter string have been built, the module is ready to retrieve the existing configuration for the object:" -msgstr "URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列ãŒæ§‹ç¯‰ã•ã‚Œã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã‚ªãƒ–ジェクトã®æ—¢å˜ã®è¨å®šã‚’å–å¾—ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:208 -msgid "``state: present`` retrieves the configuration to use as a comparison against what was entered in the task. All values that are different than the existing values will be updated." -msgstr "``state: present`` ã¯ã€ã‚¿ã‚¹ã‚¯ã«å…¥åŠ›ã—ãŸå€¤ã¨æ¯”較ã¨ã—ã¦ä½¿ç”¨ã™ã‚‹è¨å®šã‚’å–å¾—ã—ã¾ã™ã€‚æ—¢å˜ã®å€¤ã¨ã¯ç•°ãªã‚‹å€¤ã¯ã™ã¹ã¦æ›´æ–°ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:209 -msgid "``state: absent`` uses the existing configuration to see if the item exists and needs to be deleted." -msgstr "``state: absent`` ã¯ã€æ—¢å˜ã®è¨å®šã‚’使用ã—ã¦é …ç›®ãŒå˜åœ¨ã—ã€å‰Šé™¤ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:210 -msgid "``state: query`` uses this to perform the query for the task and report back the existing data." -msgstr "``state: query`` ã¯ã€ã“れを使用ã—ã¦ã‚¿ã‚¹ã‚¯ã®ã‚¯ã‚¨ãƒªãƒ¼ã‚’実行ã—ã€æ—¢å˜ã®ãƒ‡ãƒ¼ã‚¿ã‚’å ±å‘Šã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:218 -msgid "When state is present" -msgstr "state ㌠present ã®å ´åˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:219 -msgid "When ``state: present``, the module needs to perform a diff against the existing configuration and the task entries. If any value needs to be updated, then the module will make a POST request with only the items that need to be updated. Some modules have children that are in a 1-to-1 relationship with another object; for these cases, the module can be used to manage the child objects." -msgstr "``state: present`` ã®å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯æ—¢å˜ã®è¨å®šã¨ã‚¿ã‚¹ã‚¯ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã«å¯¾ã—㦠diff を実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚値を更新ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯æ›´æ–°ãŒå¿…è¦ãªã‚¢ã‚¤ãƒ†ãƒ ã®ã¿ãŒå«ã¾ã‚Œã‚‹ POST è¦æ±‚ã‚’è¡Œã„ã¾ã™ã€‚モジュールã«ã‚ˆã£ã¦ã¯ã€åˆ¥ã®ã‚ªãƒ–ジェクト㨠1 対 1 ã®é–¢ä¿‚ã«ã‚ã‚‹åãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯åオブジェクトを管ç†ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:222 -msgid "Building the ACI payload" -msgstr "ACI ペイãƒãƒ¼ãƒ‰ã®æ§‹ç¯‰" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:223 -msgid "The ``aci.payload()`` method is used to build a dictionary of the proposed object configuration. All parameters that were not provided a value in the task will be removed from the dictionary (both for the object and its children). Any parameter that does have a value will be converted to a string and added to the final dictionary object that will be used for comparison against the existing configuration." -msgstr "``aci.payload()`` メソッドã¯ã€æ案ã•ã‚ŒãŸã‚ªãƒ–ジェクトè¨å®šã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼æ§‹ç¯‰ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚タスクã§å€¤ãŒæä¾›ã•ã‚Œã¦ã„ãªã„パラメーターã¯ã™ã¹ã¦ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ (オブジェクトã¨ãã®åã®ä¸¡æ–¹) ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚値ã®ã‚るパラメーターã¯æ–‡å—列ã«å¤‰æ›ã•ã‚Œã€æ—¢å˜ã®è¨å®šã¨ã®æ¯”較ã«ä½¿ç”¨ã•ã‚Œã‚‹æœ€çµ‚ディクショナリーオブジェクトã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:225 -msgid "The ``aci.payload()`` method takes two required arguments and 1 optional argument, depending on if the module manages child objects." -msgstr "``aci.payload()`` メソッドã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒåオブジェクトを管ç†ã™ã‚‹ã‹ã©ã†ã‹ã«å¿œã˜ã¦ã€2 ã¤ã®å¿…é ˆå¼•æ•°ã¨ã€1 ã¤ã®ä»»æ„ã®å¼•æ•°ã‚’å–ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:227 -msgid "``aci_class`` is the APIC name for the object's class, for example ``aci_class='fvBD'``" -msgstr "``aci_class`` ã¯ã€ã‚ªãƒ–ジェクトã®ã‚¯ãƒ©ã‚¹ã® APIC åã§ã™ã€‚ãŸã¨ãˆã°ã€``aci_class='fvBD'`` ã«ãªã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:228 -msgid "``class_config`` is the appropriate dictionary to be used as the payload for the POST request" -msgstr "``class_config`` 㯠POST è¦æ±‚ã®ãƒšã‚¤ãƒãƒ¼ãƒ‰ã¨ã—ã¦ä½¿ç”¨ã™ã‚‹é©åˆ‡ãªãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:230 -msgid "The keys should match the names used by the APIC." -msgstr "ã‚ー㯠APIC ã§ä½¿ç”¨ã•ã‚Œã‚‹åå‰ã¨ä¸€è‡´ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:231 -msgid "The values should be the corresponding value in ``module.params``; these are the variables defined above" -msgstr "``module.params`` ã®å¯¾å¿œã™ã‚‹å€¤ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。ã“れらã¯ä¸Šã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã§ã™" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:233 -msgid "``child_configs`` is optional, and is a list of child config dictionaries." -msgstr "``child_configs`` ã¯ä»»æ„ã§ã‚ã‚Šã€åè¨å®šã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ä¸€è¦§ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:235 -msgid "The child configs include the full child object dictionary, not just the attributes configuration portion." -msgstr "åè¨å®šã«ã¯ã€å±žæ€§è¨å®šéƒ¨åˆ†ã ã‘ã§ãªãã€å®Œå…¨ãªåオブジェクトディクショナリーãŒå«ã¾ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:236 -msgid "The configuration portion is built the same way as the object." -msgstr "è¨å®šéƒ¨åˆ†ã¯ã€ã‚ªãƒ–ジェクトã¨åŒã˜æ–¹æ³•ã§æ§‹ç¯‰ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:260 -msgid "Performing the request" -msgstr "è¦æ±‚ã®å®Ÿè¡Œ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:261 -msgid "The ``get_diff()`` method is used to perform the diff, and takes only one required argument, ``aci_class``. Example: ``aci.get_diff(aci_class='fvBD')``" -msgstr "``get_diff()`` メソッド㯠diff を実行ã—ã€å¿…è¦ãªå¼•æ•° ``aci_class`` ã‚’ 1 ã¤ã ã‘å–ã‚Šã¾ã™ã€‚ãŸã¨ãˆã° ``aci.get_diff(aci_class='fvBD')`` ã§ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:264 -msgid "The ``post_config()`` method is used to make the POST request to the APIC if needed. This method doesn't take any arguments and handles check mode. Example: ``aci.post_config()``" -msgstr "``post_config()`` メソッドã¯ã€å¿…è¦ã«å¿œã˜ã¦ APIC ã¸ã® POST è¦æ±‚ã‚’è¡Œã†ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯å¼•æ•°ã‚’å—ã‘付ã‘ãšã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’処ç†ã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``aci.post_config()`` ã«ãªã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:269 -msgid "Example code" -msgstr "サンプルコード" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:299 -msgid "When state is absent" -msgstr "state ㌠absent ã®å ´åˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:300 -msgid "If the task sets the state to absent, then the ``delete_config()`` method is all that is needed. This method does not take any arguments, and handles check mode." -msgstr "タスク㌠state ã‚’ absent ã«è¨å®šã™ã‚‹ã¨ã€``delete_config()`` メソッドã®ã¿ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯å¼•æ•°ã‚’å–らãšã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’処ç†ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:309 -msgid "Exiting the module" -msgstr "モジュールã®çµ‚了" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:310 -msgid "To have the module exit, call the ACIModule method ``exit_json()``. This method automatically takes care of returning the common return values for you." -msgstr "モジュールを終了ã™ã‚‹ã«ã¯ã€ACIModule メソッド ``exit_json()`` を呼ã³å‡ºã—ã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ä¸€èˆ¬çš„ãªæˆ»ã‚Šå€¤ã‚’è¿”ã™ã“ã¨ã‚’自動的ã«è¡Œã„ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:323 -msgid "Testing ACI library functions" -msgstr "ACI ライブラリー関数ã®ãƒ†ã‚¹ãƒˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:324 -msgid "You can test your ``construct_url()`` and ``payload()`` arguments without accessing APIC hardware by using the following python script:" -msgstr "以下㮠python スクリプトを使用ã—ã¦ã€APIC ãƒãƒ¼ãƒ‰ã‚¦ã‚§ã‚¢ã«ã‚¢ã‚¯ã‚»ã‚¹ã›ãšã« ``construct_url()`` 引数ãŠã‚ˆã³ ``payload()`` 引数をテストã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:383 -msgid "This will result in:" -msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ä»¥ä¸‹ãŒç”Ÿæˆã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:397 -msgid "Testing for sanity checks" -msgstr "å¥å…¨æ€§ãƒã‚§ãƒƒã‚¯ã®ãƒ†ã‚¹ãƒˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:398 -msgid "For legacy versions of ansible, you can run from your fork something like:" -msgstr "Ansible ã®ãƒ¬ã‚¬ã‚·ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€æ¬¡ã®ã‚ˆã†ãªãƒ•ã‚©ãƒ¼ã‚¯ã‹ã‚‰å®Ÿè¡Œã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:404 -msgid "Meanwhile, the ACI modules have moved into a collection. Please refer to the links below, which provide detailed guidance how to setup your environment and test the collection." -msgstr "ACI モジュールã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»å‹•ã—ã¾ã—ãŸã€‚以下ã®ãƒªãƒ³ã‚¯ã‚’å‚ç…§ã—ã¦ãã ã•ã„。環境をè¨å®šã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’テストã™ã‚‹æ–¹æ³•ã®è©³ç´°ãªã‚¬ã‚¤ãƒ€ãƒ³ã‚¹ãŒè¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:410 -msgid "Information how to setup your environment to contribute to collections" -msgstr "環境をè¨å®šã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«è²¢çŒ®ã™ã‚‹æ–¹æ³•" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:411 -#: ../../rst/dev_guide/testing.rst:33 -msgid ":ref:`testing_sanity`" -msgstr ":ref:`testing_sanity`" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:412 -msgid "Information on how to build sanity tests." -msgstr "å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’構築ã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:418 -msgid "Testing ACI integration tests" -msgstr "ACI çµ±åˆãƒ†ã‚¹ãƒˆã®ãƒ†ã‚¹ãƒˆ" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:419 -#: ../../rst/dev_guide/developing_modules_general_aci.rst:449 -msgid "You can run this:" -msgstr "以下を実行ã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:425 -msgid "You may need to add ``--python 2.7`` or ``--python 3.6`` in order to use the correct python version for performing tests." -msgstr "テストã®å®Ÿè¡Œã«é©åˆ‡ãª python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã™ã‚‹ã«ã¯ã€``--python 2.7`` ã¾ãŸã¯ ``--python 3.6`` ã‚’è¿½åŠ ã—ãªã„ã¨ã„ã‘ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:427 -msgid "You may want to edit the used inventory at *test/integration/inventory.networking* and add something like:" -msgstr "*test/integration/inventory.networking* ã§ä½¿ç”¨ã•ã‚ŒãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’編集ã—ã€ä»¥ä¸‹ã®ã‚ˆã†ã«è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:443 -#: ../../rst/dev_guide/testing.rst:37 -msgid ":ref:`testing_integration`" -msgstr ":ref:`testing_integration`" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:444 -msgid "Information on how to build integration tests." -msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã®æ§‹ç¯‰æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_aci.rst:448 -msgid "Testing for test coverage" -msgstr "テストカãƒãƒ¬ãƒ¼ã‚¸ã®ãƒ†ã‚¹ãƒˆ" - #: ../../rst/dev_guide/developing_modules_general_windows.rst:5 msgid "Windows module development walkthrough" msgstr "Windows モジュール開発ウォークスルー" @@ -5168,6 +4766,10 @@ msgstr "本セクションã§ã¯ã€Ansible Windows モジュールã®é–‹ç™ºã€ãƒ msgid "Because Windows modules are written in Powershell and need to be run on a Windows host, this guide differs from the usual development walkthrough guide." msgstr "Windows モジュール㯠Powershell ã§æ›¸ã‹ã‚Œã¦ãŠã‚Šã€Windows ホスト上ã§å®Ÿè¡Œã™ã‚‹å¿…è¦ãŒã‚ã‚‹ãŸã‚ã€ã“ã®ã‚¬ã‚¤ãƒ‰ã¯é€šå¸¸ã®é–‹ç™ºã‚¦ã‚©ãƒ¼ã‚¯ã‚¹ãƒ«ãƒ¼ã‚¬ã‚¤ãƒ‰ã¨ã¯ç•°ãªã‚Šã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_modules_general_windows.rst:13 +msgid "What's covered in this section:" +msgstr "æœ¬é …ã§å–り上ã’られã¦ã„る内容:" + #: ../../rst/dev_guide/developing_modules_general_windows.rst:20 msgid "Windows environment setup" msgstr "Windows 環境ã®è¨å®š" @@ -5235,11 +4837,11 @@ msgstr "`jborean93/WindowsServer2016 <https://app.vagrantup.com/jborean93/boxes/ #: ../../rst/dev_guide/developing_modules_general_windows.rst:90 msgid "`jborean93/WindowsServer2019 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2019>`_" -msgstr "`jborean93/WindowsServer2016 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2016>`_" +msgstr "`jborean93/WindowsServer2019 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2019>`_" #: ../../rst/dev_guide/developing_modules_general_windows.rst:91 msgid "`jborean93/WindowsServer2022 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2022>`_" -msgstr "`jborean93/WindowsServer2012R2 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2012R2>`_" +msgstr "`jborean93/WindowsServer2022 <https://app.vagrantup.com/jborean93/boxes/WindowsServer2022>`_" #: ../../rst/dev_guide/developing_modules_general_windows.rst:93 msgid "When the host is online, it can accessible by RDP on ``127.0.0.1:3389`` but the port may differ depending if there was a conflict. To get rid of the host, run ``vagrant destroy --force`` and Vagrant will automatically remove the VM and any other files associated with that VM." @@ -5370,8 +4972,8 @@ msgid "Avoid using PSCustomObjects unless necessary" msgstr "å¿…è¦ãªå ´åˆã‚’除ã PSCustomObject ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。" #: ../../rst/dev_guide/developing_modules_general_windows.rst:171 -msgid "Look for common functions in ``./lib/ansible/module_utils/powershell/`` and use the code there instead of duplicating work. These can be imported by adding the line ``#Requires -Module *`` where * is the filename to import, and will be automatically included with the module code sent to the Windows target when run via Ansible" -msgstr "é‡è¤‡ã™ã‚‹ä½œæ¥ã‚’è¡Œã‚ãªã„よã†ã«ã€``./lib/ansible/module_utils/powershell/`` ã«ã‚る共通ã®é–¢æ•°ã‚’探ã—ã¦ã€ãã“ã«ã‚るコードを使用ã—ã¦ãã ã•ã„。ã“れらã®é–¢æ•°ã¯ ``#Requires -Module *`` ã¨ã„ã†è¡Œã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚* ã¯ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«åã§ã€Ansible を介ã—ã¦å®Ÿè¡Œã™ã‚‹å ´åˆã«ã€è‡ªå‹•çš„ã« Windows ターゲットã«é€ä¿¡ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚³ãƒ¼ãƒ‰ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" +msgid "Look for common functions in ``./lib/ansible/module_utils/powershell/`` and use the code there instead of duplicating work. These can be imported by adding the line ``#Requires -Module *`` where * is the filename to import, and will be automatically included with the module code sent to the Windows target when run through Ansible" +msgstr "é‡è¤‡ã™ã‚‹ä½œæ¥ã‚’è¡Œã‚ãªã„よã†ã«ã€``./lib/ansible/module_utils/powershell/`` ã«ã‚る共通ã®é–¢æ•°ã‚’探ã—ã¦ã€ãã“ã«ã‚るコードを使用ã—ã¦ãã ã•ã„。ã“れらã®é–¢æ•°ã¯ ``#Requires -Module *`` ã¨ã„ã†è¡Œã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚* ã¯ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«åã§ã€Ansible を介ã—ã¦å®Ÿè¡Œã™ã‚‹å ´åˆã«ã€Windows ターゲットã«é€ä¿¡ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚³ãƒ¼ãƒ‰ãŒè‡ªå‹•çš„ã«å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_modules_general_windows.rst:172 msgid "As well as PowerShell module utils, C# module utils are stored in ``./lib/ansible/module_utils/csharp/`` and are automatically imported in a module execution if the line ``#AnsibleRequires -CSharpUtil *`` is present" @@ -5403,7 +5005,7 @@ msgstr "コマンドレットã§åå‰ä»˜ãパラメーターを使用ã—ã¾ã™ #: ../../rst/dev_guide/developing_modules_general_windows.rst:180 msgid "A very basic Powershell module `win_environment <https://github.com/ansible-collections/ansible.windows/blob/main/plugins/modules/win_environment.ps1>`_ incorporates best practices for Powershell modules. It demonstrates how to implement check-mode and diff-support, and also shows a warning to the user when a specific condition is met." -msgstr "éžå¸¸ã«åŸºæœ¬çš„㪠Powershell モジュール `win_environment <https://github.com/ansible-collections/ansible.windows/blob/main/plugins/modules/win_environment.ps1>`_ ãŒã€Powershell モジュールã®ãƒ™ã‚¹ãƒˆãƒ—ラクティスã«çµ„ã¿è¾¼ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã“ã‚Œã¯ã€check-mode ãŠã‚ˆã³ diff-support を実装ã™ã‚‹æ–¹æ³•ã‚’示ã—ã€ç‰¹å®šã®æ¡ä»¶ãŒæº€ãŸã•ã‚Œã‚‹ã¨ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«è¦å‘Šã‚’表示ã—ã¾ã™ã€‚" +msgstr "éžå¸¸ã«åŸºæœ¬çš„㪠Powershell モジュール `win_environment <https://github.com/ansible-collections/ansible.windows/blob/main/plugins/modules/win_environment.ps1>`_ ãŒã€Powershell モジュールã®ãƒ™ã‚¹ãƒˆãƒ—ラクティスを組ã¿è¾¼ã‚“ã§ã„ã¾ã™ã€‚ã“ã‚Œã¯ã€check-mode ãŠã‚ˆã³ diff-support を実装ã™ã‚‹æ–¹æ³•ã‚’示ã—ã€ç‰¹å®šã®æ¡ä»¶ãŒæº€ãŸã•ã‚Œã‚‹ã¨ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«è¦å‘Šã‚’表示ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_modules_general_windows.rst:182 msgid "A slightly more advanced module is `win_uri <https://github.com/ansible-collections/ansible.windows/blob/main/plugins/modules/win_uri.ps1>`_ which additionally shows how to use different parameter types (bool, str, int, list, dict, path) and a selection of choices for parameters, how to fail a module and how to handle exceptions." @@ -5770,222 +5372,218 @@ msgid "C# module utilities can also be stored outside of the standard Ansible di msgstr "C# モジュールユーティリティーã¯ã€ã‚«ã‚¹ã‚¿ãƒ モジュールã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã®æ¨™æº–ã® Ansible ディストリビューション外ã«ã‚‚ä¿å˜ã§ãã¾ã™ã€‚PowerShellutils ã¨åŒæ§˜ã€``module_utils`` ディレクトリーã«æ ¼ç´ã•ã‚Œã€ãƒ•ã‚¡ã‚¤ãƒ«åã¯æ‹¡å¼µå ``.cs`` ã§çµ‚ã‚ã‚Šã€``Ansible.`` ã§å§‹ã¾ã‚‹ã€ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã§å®šç¾©ã•ã‚ŒãŸåå‰ç©ºé–“ã®å¾Œã«åå‰ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_modules_general_windows.rst:413 -msgid "The below example is a role structure that contains two PowerShell custom module_utils called ``Ansible.ModuleUtils.ModuleUtil1``, ``Ansible.ModuleUtils.ModuleUtil2``, and a C# util containing the namespace ``Ansible.CustomUtil``::" -msgstr "次ã®ä¾‹ã¯ã€å‘¼ã³å‡ºã•ã‚ŒãŸ 2 ã¤ã® PowerShell ã®ã‚«ã‚¹ã‚¿ãƒ モジュールユーティリティー (``Ansible.ModuleUtils.ModuleUtil1``ã€``Ansible.ModuleUtils.ModuleUtil2``ã€ãŠã‚ˆã³åå‰ç©ºé–“ ``Ansible.CustomUtil`` ã‚’å«ã‚€ C# ユーティリティー) ã‚’å«ã‚€ãƒãƒ¼ãƒ«æ§‹é€ ã§ã™ã€‚" +msgid "The below example is a role structure that contains two PowerShell custom module_utils called ``Ansible.ModuleUtils.ModuleUtil1``, ``Ansible.ModuleUtils.ModuleUtil2``, and a C# util containing the namespace ``Ansible.CustomUtil``:" +msgstr "次ã®ä¾‹ã¯ã€å‘¼ã³å‡ºã•ã‚ŒãŸ 2 ã¤ã® PowerShell ã®ã‚«ã‚¹ã‚¿ãƒ module_utils (``Ansible.ModuleUtils.ModuleUtil1``ã€``Ansible.ModuleUtils.ModuleUtil2``ã€ãŠã‚ˆã³åå‰ç©ºé–“ ``Ansible.CustomUtil`` ã‚’å«ã‚€ C# ユーティリティー) ã‚’å«ã‚€ãƒãƒ¼ãƒ«æ§‹é€ ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:428 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:430 msgid "Each PowerShell module_util must contain at least one function that has been exported with ``Export-ModuleMember`` at the end of the file. For example" msgstr "PowerShell ã®å„モジュールユーティリティーã«ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®çµ‚ã‚ã‚Šã« ``Export-ModuleMember`` ã§ã‚¨ã‚¯ã‚¹ãƒãƒ¼ãƒˆã•ã‚ŒãŸé–¢æ•°ãŒå°‘ãªãã¨ã‚‚ 1 ã¤å«ã¾ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:437 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:439 msgid "Exposing shared module options" msgstr "共有モジュールオプションã®å…¬é–‹" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:439 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:441 msgid "PowerShell module utils can easily expose common module options that a module can use when building its argument spec. This allows common features to be stored and maintained in one location and have those features used by multiple modules with minimal effort. Any new features or bugfixes added to one of these utils are then automatically used by the various modules that call that util." msgstr "PowerShell モジュールユーティリティーã¯ã€å¼•æ•°ä»•æ§˜ã‚’構築ã™ã‚‹éš›ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒä½¿ç”¨ã§ãる共通ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚ªãƒ—ションを簡å˜ã«å…¬é–‹ã§ãã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€å…±é€šã®æ©Ÿèƒ½ã¯ 1 ã¤ã®å ´æ‰€ã«ä¿å˜ãŠã‚ˆã³ç¶æŒã§ãã€æœ€å°é™ã®ä½œæ¥ã§è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã‚‹æ©Ÿèƒ½ã‚’利用ã§ãã¾ã™ã€‚ã“れらã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®ã„ãšã‚Œã‹ã«è¿½åŠ ã•ã‚ŒãŸæ–°æ©Ÿèƒ½ã¾ãŸã¯ãƒã‚°ä¿®æ£ã¯ã€ãã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®ã„ãšã‚Œã‹ã‚’呼ã³å‡ºã™ã•ã¾ã–ã¾ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦è‡ªå‹•çš„ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:444 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:446 msgid "An example of this would be to have a module util that handles authentication and communication against an API This util can be used by multiple modules to expose a common set of module options like the API endpoint, username, password, timeout, cert validation, and so on without having to add those options to each module spec." msgstr "ã“ã®ä¾‹ã¨ã—ã¦ã¯ã€API ã«å¯¾ã™ã‚‹èªè¨¼ã¨é€šä¿¡ã‚’処ç†ã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã¯ã€API エンドãƒã‚¤ãƒ³ãƒˆã€ãƒ¦ãƒ¼ã‚¶ãƒ¼åã€ãƒ‘スワードã€ã‚¿ã‚¤ãƒ アウトã€èªå®šæ¤œè¨¼ãªã©ã®å…±é€šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚ªãƒ—ションセットを公開ã™ã‚‹ãŸã‚ã€å„モジュール仕様ã«ãれらã®ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã—ãªãã¦ã‚‚ã€è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:448 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:450 msgid "The standard convention for a module util that has a shared argument spec would have" msgstr "共有引数仕様をæŒã¤ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã®æ¨™æº–è¦å‰‡ã¯æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:451 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:453 msgid "A ``Get-<namespace.name.util name>Spec`` function that outputs the common spec for a module" msgstr "モジュールã®å…±é€šã®ä»•æ§˜ã‚’出力ã™ã‚‹ ``Get-<namespace.name.util name>Spec`` 関数" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:451 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:453 msgid "It is highly recommended to make this function name be unique to the module to avoid any conflicts with other utils that can be loaded" msgstr "èªã¿è¾¼ã¿ã§ãã‚‹ä»–ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã¨ã®ç«¶åˆã‚’é¿ã‘ã‚‹ãŸã‚ã«ã€ã“ã®é–¢æ•°åをモジュールã«å›ºæœ‰ã®ã‚‚ã®ã«å¼·ã推奨ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:452 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:454 msgid "The format of the output spec is a Hashtable in the same format as the ``$spec`` used for normal modules" msgstr "出力仕様ã®å½¢å¼ã¯ã€é€šå¸¸ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ä½¿ç”¨ã•ã‚Œã‚‹ ``$spec`` ã¨åŒã˜å½¢å¼ã®ãƒãƒƒã‚·ãƒ¥ãƒ†ãƒ¼ãƒ–ルã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:453 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:455 msgid "A function that takes in an ``AnsibleModule`` object called under the ``-Module`` parameter which it can use to get the shared options" msgstr "``-Module`` パラメーター下ã§å‘¼ã³å‡ºã•ã‚ŒãŸ ``AnsibleModule`` オブジェクトをå–り入れãŸé–¢æ•°ã€‚ã“れを使用ã—ã¦å…±æœ‰ã‚ªãƒ—ションをå–å¾—ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:455 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:457 msgid "Because these options can be shared across various module it is highly recommended to keep the module option names and aliases in the shared spec as specific as they can be. For example do not have a util option called ``password``, rather you should prefix it with a unique name like ``acme_password``." msgstr "ã“れらã®ã‚ªãƒ—ションã¯å„種モジュール間ã§å…±æœ‰ã§ãã‚‹ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚ªãƒ—ションåã¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’ã€å¯èƒ½ãªé™ã‚Šå…·ä½“çš„ãªä»•æ§˜ã«ç¶æŒã™ã‚‹ã“ã¨ãŒé«˜ã推奨ã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€``password`` ユーティリティーオプションãŒã‚ã‚Šã¾ã›ã‚“。ãŸã¨ãˆã°ã€``acme_password`` ãªã©ã®ä¸€æ„ã®åå‰ã§ãƒ—レフィックスを付ã‘ã‚‹ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:460 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:462 msgid "Failure to have a unique option name or alias can prevent the util being used by module that also use those names or aliases for its own options." msgstr "一æ„ã®ã‚ªãƒ—ションåã¾ãŸã¯ã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒãªã„ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã‚’使用ã§ããªããªã‚Šã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãれらã®åå‰ã¾ãŸã¯ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’独自ã®ã‚ªãƒ—ションã«ä½¿ç”¨ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:463 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:465 msgid "The following is an example module util called ``ServiceAuth.psm1`` in a collection that implements a common way for modules to authentication with a service." msgstr "以下ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ ``ServiceAuth.psm1`` モジュールユーティリティーã®ä¾‹ã«ãªã‚Šã¾ã™ã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã‚µãƒ¼ãƒ“スを使用ã—ãŸèªè¨¼ã«å…±é€šã®æ–¹æ³•ã‚’実装ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:519 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:521 msgid "For a module to take advantage of this common argument spec it can be set out like" msgstr "モジュールãŒã“ã®å…±é€šã®å¼•æ•°ä»•æ§˜ã‚’利用ã§ãるよã†ã«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:546 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:548 msgid "Options defined in the module spec will always have precedence over a util spec. Any list values under the same key in a util spec will be appended to the module spec for that same key. Dictionary values will add any keys that are missing from the module spec and merge any values that are lists or dictionaries. This is similar to how the doc fragment plugins work when extending module documentation." msgstr "モジュール仕様ã«å®šç¾©ã•ã‚Œã¦ã„るオプションã¯å¸¸ã«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ä»•æ§˜ã‚ˆã‚Šã‚‚優先ã•ã‚Œã¾ã™ã€‚ユーティリティー仕様ã®åŒã˜ã‚ー下ã®ãƒªã‚¹ãƒˆå€¤ã¯ã€åŒã˜ã‚ーã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»•æ§˜ã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚ディクショナリーã®å€¤ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»•æ§˜ã«ä¸è¶³ã—ã¦ã„ã‚‹éµã‚’è¿½åŠ ã—ã€ãƒªã‚¹ãƒˆã¾ãŸã¯ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã‚る値をマージã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントを拡張ã™ã‚‹ã¨ãã«ãƒ‰ã‚ュメントフラグメントプラグインãŒã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã™ã‚‹ã‹ã¨ä¼¼ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:551 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:553 msgid "To document these shared util options for a module, create a doc fragment plugin that documents the options implemented by the module util and extend the module docs for every module that implements the util to include that fragment in its docs." msgstr "モジュールã®ã“れらã®å…±æœ‰ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã‚ªãƒ—ションを文書化ã™ã‚‹ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã«ã‚ˆã‚Šå®Ÿè£…ã•ã‚ŒãŸã‚ªãƒ—ションを文書化ã™ã‚‹ãƒ‰ã‚ュメントフラグメントプラグインを作æˆã—ã€ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã‚’実装ã™ã‚‹ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントを拡張ã—ã¦ã€ãã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’ドã‚ュメントã«å«ã‚ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:557 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:559 msgid "Windows playbook module testing" msgstr "Windows Playbook モジュールã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:559 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:561 msgid "You can test a module with an Ansible playbook. For example:" msgstr "以下ã®ã‚ˆã†ã«ã€Ansible Playbook ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’テストã§ãã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:561 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:563 msgid "Create a playbook in any directory ``touch testmodule.yml``." msgstr "ä»»æ„ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã« Playbook を作æˆã—ã¾ã™ (``touch testmodule.yml``)。" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:562 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:564 msgid "Create an inventory file in the same directory ``touch hosts``." msgstr "åŒã˜ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ ``touch hosts`` ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:563 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:565 msgid "Populate the inventory file with the variables required to connect to a Windows host(s)." msgstr "Windows ホストã¸ã®æŽ¥ç¶šã«å¿…è¦ãªå¤‰æ•°ã‚’指定ã—ã¦ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:564 -msgid "Add the following to the new playbook file::" -msgstr "以下を新ã—ã„ Playbook ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_modules_general_windows.rst:574 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:578 msgid "Run the playbook ``ansible-playbook -i hosts testmodule.yml``" msgstr "Playbook ``ansible-playbook -i hosts testmodule.yml`` を実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:576 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:580 msgid "This can be useful for seeing how Ansible runs with the new module end to end. Other possible ways to test the module are shown below." msgstr "ã“ã‚Œã¯ã€Ansible ãŒæ–°ã—ã„モジュールã§ã‚¨ãƒ³ãƒ‰ãƒ„ーエンドã§ã©ã®ã‚ˆã†ã«å®Ÿè¡Œã•ã‚Œã‚‹ã‹ã‚’確èªã™ã‚‹ã®ã«å½¹ç«‹ã¡ã¾ã™ã€‚モジュールをテストã™ã‚‹ä»–ã®å¯èƒ½ãªæ–¹æ³•ã‚’以下ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:582 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:586 msgid "Windows debugging" msgstr "Windows ã®ãƒ‡ãƒãƒƒã‚°" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:584 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:588 msgid "Debugging a module currently can only be done on a Windows host. This can be useful when developing a new module or implementing bug fixes. These are some steps that need to be followed to set this up:" msgstr "ç¾åœ¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‡ãƒãƒƒã‚°ã¯ Windows ホストã§ã®ã¿å®Ÿè¡Œã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€æ–°ã—ã„モジュールを開発ã—ãŸã‚Šã€ãƒã‚°ä¿®æ£ã‚’実装ã—ãŸã‚Šã™ã‚‹ã¨ãã«å½¹ç«‹ã¡ã¾ã™ã€‚ã“れをè¨å®šã™ã‚‹ã«ã¯ã€æ¬¡ã®æ‰‹é †ã«å¾“ã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:588 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:592 msgid "Copy the module script to the Windows server" msgstr "モジュールスクリプトを Windows サーãƒãƒ¼ã«ã‚³ãƒ”ーã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:589 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:593 msgid "Copy the folders ``./lib/ansible/module_utils/powershell`` and ``./lib/ansible/module_utils/csharp`` to the same directory as the script above" msgstr "``./lib/ansible/module_utils/powershell`` ディレクトリー㨠``./lib/ansible/module_utils/csharp`` ディレクトリーを上記ã®ã‚¹ã‚¯ãƒªãƒ—トã¨åŒã˜ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚³ãƒ”ーã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:590 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:594 msgid "Add an extra ``#`` to the start of any ``#Requires -Module`` lines in the module code, this is only required for any lines starting with ``#Requires -Module``" msgstr "モジュールコードã«ã‚ã‚‹ã™ã¹ã¦ã® ``#Requires -Module`` è¡Œã®å…ˆé ã« ``#`` ã‚’è¿½åŠ ã—ã¦ãã ã•ã„。ã“ã‚Œã¯ã€``#Requires -Module`` ã§å§‹ã¾ã‚‹è¡Œã«ã®ã¿å¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:591 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:595 msgid "Add the following to the start of the module script that was copied to the server:" msgstr "以下をã€ã‚µãƒ¼ãƒãƒ¼ã«ã‚³ãƒ”ーã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚¹ã‚¯ãƒªãƒ—トã®å…ˆé ã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:623 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:627 msgid "You can add more args to ``$complex_args`` as required by the module or define the module options through a JSON file with the structure:" msgstr "モジュールã«å¿…è¦ãªå ´åˆã¯ ``$complex_args`` ã«ã•ã‚‰ã«å¼•æ•°ã‚’è¿½åŠ ã—ãŸã‚Šã€ãã®æ§‹é€ ã‚’æŒã¤ JSON ファイルã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚ªãƒ—ションを定義ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:637 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:641 msgid "There are multiple IDEs that can be used to debug a Powershell script, two of the most popular ones are" msgstr "Powershell スクリプトã®ãƒ‡ãƒãƒƒã‚°ã«ä½¿ç”¨ã§ãã‚‹ IDE ãŒè¤‡æ•°ã‚ã‚Šã€ä»¥ä¸‹ã® 2 ã¤ãŒæœ€ã‚‚一般的ãªã‚‚ã®ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:640 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:644 msgid "`Powershell ISE`_" msgstr "`Powershell ISE`_" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:641 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:645 msgid "`Visual Studio Code`_" msgstr "`Visual Studio Code`_" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:646 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:650 msgid "To be able to view the arguments as passed by Ansible to the module follow these steps." msgstr "Ansible ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æ¸¡ã—ãŸå¼•æ•°ã‚’表示ã™ã‚‹ã«ã¯ã€æ¬¡ã®æ‰‹é †ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:649 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:653 msgid "Prefix the Ansible command with :envvar:`ANSIBLE_KEEP_REMOTE_FILES=1<ANSIBLE_KEEP_REMOTE_FILES>` to specify that Ansible should keep the exec files on the server." msgstr "Ansible コマンドã®å‰ã« :envvar:`ANSIBLE_KEEP_REMOTE_FILES=1<ANSIBLE_KEEP_REMOTE_FILES>` を付ã‘ã¦ã€Ansible ㌠exec ファイルをサーãƒä¸Šã«ä¿æŒã™ã‚‹ã‚ˆã†ã«æŒ‡å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:650 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:654 msgid "Log onto the Windows server using the same user account that Ansible used to execute the module." msgstr "Ansible ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Ÿè¡Œã«ä½¿ç”¨ã—ãŸã®ã¨åŒã˜ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‚’使用ã—㦠Windows サーãƒãƒ¼ã«ãƒã‚°ã‚¤ãƒ³ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:651 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:655 msgid "Navigate to ``%TEMP%\\..``. It should contain a folder starting with ``ansible-tmp-``." msgstr "``%TEMP%\\..`` ã«ç§»å‹•ã—ã¾ã™ã€‚ã“ã‚Œã«ã¯ã€``ansible-tmp-`` ã§å§‹ã¾ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ãŒå«ã¾ã‚Œã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:652 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:656 msgid "Inside this folder, open the PowerShell script for the module." msgstr "ã“ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼å†…ã§ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã® PowerShell スクリプトを開ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:653 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:657 msgid "In this script is a raw JSON script under ``$json_raw`` which contains the module arguments under ``module_args``. These args can be assigned manually to the ``$complex_args`` variable that is defined on your debug script or put in the ``args.json`` file." msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€``$json_raw`` ã«ã‚る生㮠JSON スクリプトã§ã€``module_args`` ã®ä¸‹ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å¼•æ•°ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã“れらã®å¼•æ•°ã¯ã€ãƒ‡ãƒãƒƒã‚°ã‚¹ã‚¯ãƒªãƒ—トã§å®šç¾©ã•ã‚Œã‚‹ ``$complex_args`` 変数ã«æ‰‹å‹•ã§å‰²ã‚Šå½“ã¦ãŸã‚Šã€``args.json`` ファイルã«ç½®ã„ãŸã‚Šã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:657 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:661 msgid "Windows unit testing" msgstr "Windows ユニットテスト" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:659 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:663 msgid "Currently there is no mechanism to run unit tests for Powershell modules under Ansible CI." msgstr "ç¾åœ¨ã€Ansible CI 㧠Powershell モジュールã®ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:663 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:667 msgid "Windows integration testing" msgstr "Windows çµ±åˆãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:665 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:669 msgid "Integration tests for Ansible modules are typically written as Ansible roles. These test roles are located in ``./test/integration/targets``. You must first set up your testing environment, and configure a test inventory for Ansible to connect to." msgstr "Ansible モジュールã®çµ±åˆãƒ†ã‚¹ãƒˆã¯é€šå¸¸ Ansible ãƒãƒ¼ãƒ«ã¨ã—ã¦è¨˜è¿°ã•ã‚Œã¾ã™ã€‚ã“れらã®ãƒ†ã‚¹ãƒˆãƒãƒ¼ãƒ«ã¯ ``./test/integration/targets`` ã«ã‚ã‚Šã¾ã™ã€‚ã¾ãšã€ãƒ†ã‚¹ãƒˆç’°å¢ƒã‚’è¨å®šã—ã¦ã€Ansible ãŒæŽ¥ç¶šã§ãるよã†ã«ãƒ†ã‚¹ãƒˆã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:669 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:673 msgid "In this example we will set up a test inventory to connect to two hosts and run the integration tests for win_stat:" msgstr "ã“ã®ä¾‹ã§ã¯ã€2 ã¤ã®ãƒ›ã‚¹ãƒˆã«æŽ¥ç¶šã—ã€win_stat ã®çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ãŸã‚ã®ãƒ†ã‚¹ãƒˆã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:672 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:676 msgid "Run the command ``source ./hacking/env-setup`` to prepare environment." msgstr "環境を準備ã™ã‚‹ã«ã¯ã€``source ./hacking/env-setup`` コマンドを実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:673 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:677 msgid "Create a copy of ``./test/integration/inventory.winrm.template`` and name it ``inventory.winrm``." msgstr "``./test/integration/inventory.winrm.template`` ã®ã‚³ãƒ”ーを作æˆã—ã€``inventory.winrm`` ã¨ã„ã†åå‰ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:674 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:678 msgid "Fill in entries under ``[windows]`` and set the required variables that are needed to connect to the host." msgstr "``[windows]`` ã®ä¸‹ã«ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’入力ã—ã€ãƒ›ã‚¹ãƒˆã¸ã®æŽ¥ç¶šã«å¿…è¦ãªå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:675 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:679 msgid ":ref:`Install the required Python modules <windows_winrm>` to support WinRM and a configured authentication method." msgstr "WinRM ã¨ã€è¨å®šã•ã‚ŒãŸèªè¨¼æ–¹æ³•ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã®ã« :ref:`å¿…è¦ãª Python モジュールをインストール <windows_winrm>` ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:676 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:680 msgid "To execute the integration tests, run ``ansible-test windows-integration win_stat``; you can replace ``win_stat`` with the role you want to test." msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€``ansible-test windows-integration win_stat`` を実行ã—ã¾ã™ã€‚``win_stat`` ã¯ã€ãƒ†ã‚¹ãƒˆã™ã‚‹ãƒãƒ¼ãƒ«ã«ç½®ãæ›ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:678 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:682 msgid "This will execute all the tests currently defined for that role. You can set the verbosity level using the ``-v`` argument just as you would with ansible-playbook." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ãã®ãƒãƒ¼ãƒ«ã«å¯¾ã—ã¦ç¾åœ¨å®šç¾©ã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã®ãƒ†ã‚¹ãƒˆãŒå®Ÿè¡Œã•ã‚Œã¾ã™ã€‚ansible-playbook ã®å ´åˆã¨åŒã˜ã‚ˆã†ã«ã€``-v`` 引数を使用ã—ã¦è©³ç´°ãƒ¬ãƒ™ãƒ«ã‚’è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:682 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:686 msgid "When developing tests for a new module, it is recommended to test a scenario once in check mode and twice not in check mode. This ensures that check mode does not make any changes but reports a change, as well as that the second run is idempotent and does not report changes. For example:" msgstr "æ–°ã—ã„モジュールã®ãƒ†ã‚¹ãƒˆã‚’開発ã™ã‚‹ã¨ãã¯ã€ã‚·ãƒŠãƒªã‚ªã‚’ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã§ 1 回ã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ä»¥å¤–㧠2 回テストã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã§ã¯å¤‰æ›´ã¯è¡Œã‚ã‚Œãšã€å¤‰æ›´ãŒå ±å‘Šã•ã‚Œã¾ã™ã€‚ã¾ãŸã€2 回目ã®å®Ÿè¡Œã¯å†ªç‰ã§ã‚ã‚Šã€å¤‰æ›´ã¯å ±å‘Šã•ã‚Œã¾ã›ã‚“。以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:735 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:739 msgid "Windows communication and development support" msgstr "Windows ã®é€šä¿¡ãŠã‚ˆã³é–‹ç™ºã‚µãƒãƒ¼ãƒˆ" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:737 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:741 msgid "Join the ``#ansible-devel`` or ``#ansible-windows`` chat channels (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat/>`_) for discussions about Ansible development for Windows." msgstr "``#ansible-devel`` ã¾ãŸã¯``#ansible-windows``ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ï¼ˆansible.imã§Matrixを使用ã€ã¾ãŸã¯`irc.libera.chat <https://libera.chat/>`ã§IRCを使用）ã«å‚åŠ ã—ã¦ã€Windowså‘ã‘ã®Ansible 開発ã«é–¢ã™ã‚‹è°è«–ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_modules_general_windows.rst:739 +#: ../../rst/dev_guide/developing_modules_general_windows.rst:743 msgid "For questions and discussions pertaining to using the Ansible product, use the ``#ansible`` channel." msgstr "Ansible 製å“ã®ä½¿ç”¨ã«é–¢ã™ã‚‹è³ªå•ãŠã‚ˆã³è²¢çŒ®ã«ã¤ã„ã¦ã¯ã€``#ansible`` ãƒãƒ£ãƒ³ãƒãƒ«ã‚’使用ã—ã¾ã™ã€‚" @@ -6230,286 +5828,307 @@ msgid "Configuration sources follow the precedence rules for values in Ansible. msgstr "è¨å®šã‚½ãƒ¼ã‚¹ã¯ã€Ansibleã®å€¤ã®å„ªå…ˆé †ä½ãƒ«ãƒ¼ãƒ«ã«å¾“ã„ã¾ã™ã€‚åŒã˜ã‚«ãƒ†ã‚´ãƒªã‹ã‚‰ã®å€¤ãŒè¤‡æ•°ã‚ã‚‹å ´åˆã€æœ€å¾Œã«å®šç¾©ã•ã‚ŒãŸå€¤ãŒå„ªå…ˆã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€ä¸Šè¨˜ã®è¨å®šãƒ–ãƒãƒƒã‚¯ã§ã¯ã€``name_of_ansible_var`` ã¨``name_of_second_var`` ã®ä¸¡æ–¹ãŒå®šç¾©ã•ã‚Œã¦ã„ã‚‹å ´åˆã€``option_name`` オプションã®å€¤ã¯``name_of_second_var`` ã®å€¤ã«ãªã‚Šã¾ã™ã€‚詳細ã¯:ref:`general_precedence_rules` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/developing_plugins.rst:82 -msgid "Plugins that support embedded documentation (see :ref:`ansible-doc` for the list) should include well-formed doc strings. If you inherit from a plugin, you must document the options it takes, either via a documentation fragment or as a copy. See :ref:`module_documenting` for more information on correct documentation. Thorough documentation is a good idea even if you're developing a plugin for local use." -msgstr "埋ã‚è¾¼ã¿ãƒ‰ã‚ュメントをサãƒãƒ¼ãƒˆã™ã‚‹ãƒ—ラグイン (:ref:`ansible-doc` リストã®å ´åˆã‚’å‚ç…§) ã¯ã€é©åˆ‡ã«æ§‹ç¯‰ã•ã‚ŒãŸãƒ‰ã‚ュメント文å—列をå«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プラグインã‹ã‚‰ç¶™æ‰¿ã™ã‚‹å ´åˆã¯ã€ãƒ‰ã‚ュメントフラグメントを介ã—ã¦ã€ã¾ãŸã¯ã‚³ãƒ”ーã¨ã—ã¦ã€å¿…è¦ãªã‚ªãƒ—ションを記述ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚æ£ã—ã„ドã‚ュメントã«é–¢ã™ã‚‹è©³ç´°ã¯ã€ã€Œ:ref:`module_documenting`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ãƒãƒ¼ã‚«ãƒ«ã§ä½¿ç”¨ã™ã‚‹ãƒ—ラグインを開発ã—ã¦ã„ã‚‹å ´åˆã§ã‚‚ã€å®Œå…¨ãªãƒ‰ã‚ュメントを作æˆã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" +msgid "Plugins that support embedded documentation (see :ref:`ansible-doc` for the list) should include well-formed doc strings. If you inherit from a plugin, you must document the options it takes, either through a documentation fragment or as a copy. See :ref:`module_documenting` for more information on correct documentation. Thorough documentation is a good idea even if you're developing a plugin for local use." +msgstr "埋ã‚è¾¼ã¿ãƒ‰ã‚ュメントをサãƒãƒ¼ãƒˆã™ã‚‹ãƒ—ラグイン (リスト㯠:ref:`ansible-doc` ã‚’å‚ç…§) ã¯ã€é©åˆ‡ã«æ§‹ç¯‰ã•ã‚ŒãŸãƒ‰ã‚ュメント文å—列をå«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プラグインã‹ã‚‰ç¶™æ‰¿ã™ã‚‹å ´åˆã¯ã€ãƒ‰ã‚ュメントフラグメントを介ã—ã¦ã€ã¾ãŸã¯ã‚³ãƒ”ーã¨ã—ã¦ã€å¿…è¦ãªã‚ªãƒ—ションを記述ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚æ£ã—ã„ドã‚ュメントã«é–¢ã™ã‚‹è©³ç´°ã¯ã€ã€Œ:ref:`module_documenting`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ãƒãƒ¼ã‚«ãƒ«ã§ä½¿ç”¨ã™ã‚‹ãƒ—ラグインを開発ã—ã¦ã„ã‚‹å ´åˆã§ã‚‚ã€å®Œå…¨ãªãƒ‰ã‚ュメントを作æˆã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_plugins.rst:86 +msgid "In ansible-core 2.14 we added support for documenting filter and test plugins. You have two options for providing documentation:" +msgstr "ansible-core 2.14 ã§ã¯ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ãŠã‚ˆã³ãƒ†ã‚¹ãƒˆãƒ—ラグインã®ãƒ‰ã‚ュメント化をサãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ドã‚ュメントã®æä¾›ã«ã¯ã€æ¬¡ã® 2 ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_plugins.rst:85 +msgid "Define a Python file that includes inline documentation for each plugin." +msgstr "å„プラグインã®ã‚¤ãƒ³ãƒ©ã‚¤ãƒ³ãƒ‰ã‚ュメントをå«ã‚€ Python ファイルを定義ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_plugins.rst:86 +msgid "Define a Python file for multiple plugins and create adjacent documentation files in YAML format." +msgstr "複数ã®ãƒ—ラグイン用㮠Python ファイルを定義ã—ã€éš£æŽ¥ã™ã‚‹ãƒ‰ã‚ュメントファイルを YAML å½¢å¼ã§ä½œæˆã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_plugins.rst:89 msgid "Developing particular plugin types" msgstr "特定ã®ãƒ—ラグインタイプã®é–‹ç™º" -#: ../../rst/dev_guide/developing_plugins.rst:90 +#: ../../rst/dev_guide/developing_plugins.rst:94 #: ../../rst/dev_guide/developing_program_flow_modules.rst:24 msgid "Action plugins" msgstr "action プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:92 +#: ../../rst/dev_guide/developing_plugins.rst:96 msgid "Action plugins let you integrate local processing and local data with module functionality." msgstr "action プラグインを使用ã™ã‚‹ã¨ã€ãƒãƒ¼ã‚«ãƒ«å‡¦ç†ã¨ãƒãƒ¼ã‚«ãƒ«ãƒ‡ãƒ¼ã‚¿ã‚’モジュール機能ã«çµ±åˆã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:94 +#: ../../rst/dev_guide/developing_plugins.rst:98 msgid "To create an action plugin, create a new class with the Base(ActionBase) class as the parent:" msgstr "action プラグインを作æˆã™ã‚‹ã«ã¯ã€Base(ActionBase) クラスを親ã¨ã—ã¦æ–°ã—ã„クラスを作æˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:103 +#: ../../rst/dev_guide/developing_plugins.rst:107 msgid "From there, execute the module using the ``_execute_module`` method to call the original module. After successful execution of the module, you can modify the module return data." msgstr "ãã“ã‹ã‚‰ã€``_execute_module`` メソッドを使用ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã—ã¦ã€å…ƒã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’呼ã³å‡ºã—ã¾ã™ã€‚モジュールã®å®Ÿè¡Œã«æˆåŠŸã™ã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®æˆ»ã‚Šå€¤ãƒ‡ãƒ¼ã‚¿ã‚’変更ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:113 +#: ../../rst/dev_guide/developing_plugins.rst:117 msgid "For example, if you wanted to check the time difference between your Ansible controller and your target machine(s), you could write an action plugin to check the local time and compare it to the return data from Ansible's ``setup`` module:" msgstr "ãŸã¨ãˆã°ã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã¨ã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒžã‚·ãƒ³é–“ã®æ™‚間差を確èªã™ã‚‹å ´åˆã¯ã€action プラグインを作æˆã—ã¦ãƒãƒ¼ã‚«ãƒ«ã‚¿ã‚¤ãƒ を確èªã—ã€ãれを Ansible ã® ``setup`` モジュールã‹ã‚‰è¿”ã•ã‚Œã‚‹ãƒ‡ãƒ¼ã‚¿ã¨æ¯”較ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:150 +#: ../../rst/dev_guide/developing_plugins.rst:154 msgid "This code checks the time on the controller, captures the date and time for the remote machine using the ``setup`` module, and calculates the difference between the captured time and the local time, returning the time delta in days, seconds and microseconds." msgstr "ã“ã®ã‚³ãƒ¼ãƒ‰ã¯ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã®æ™‚間を確èªã—ã€``setup`` モジュールを使用ã—ã¦ãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ã®æ—¥æ™‚ã‚’å–å¾—ã—ã€å–å¾—ã—ãŸæ™‚é–“ã¨ãƒãƒ¼ã‚«ãƒ«æ™‚é–“ã®å·®ç•°ã‚’算出ã—ã€ãã®æ™‚間差を日数ã€ç§’ã€ãŠã‚ˆã³ãƒžã‚¤ã‚¯ãƒç§’ã§è¿”ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:153 +#: ../../rst/dev_guide/developing_plugins.rst:157 msgid "For practical examples of action plugins, see the source code for the `action plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/action>`_" msgstr "action プラグインã®å®Ÿéš›ã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ action プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/action>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:159 +#: ../../rst/dev_guide/developing_plugins.rst:163 msgid "Cache plugins" msgstr "Cache プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:161 +#: ../../rst/dev_guide/developing_plugins.rst:165 msgid "Cache plugins store gathered facts and data retrieved by inventory plugins." msgstr "dache プラグインã¯ã€inventory プラグインã«ã‚ˆã£ã¦å–å¾—ã•ã‚Œã‚‹ãƒ•ã‚¡ã‚¯ãƒˆãŠã‚ˆã³ãƒ‡ãƒ¼ã‚¿ã‚’æ ¼ç´ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:163 -msgid "Import cache plugins using the cache_loader so you can use ``self.set_options()`` and ``self.get_option(<option_name>)``. If you import a cache plugin directly in the code base, you can only access options via ``ansible.constants``, and you break the cache plugin's ability to be used by an inventory plugin." +#: ../../rst/dev_guide/developing_plugins.rst:167 +msgid "Import cache plugins using the cache_loader so you can use ``self.set_options()`` and ``self.get_option(<option_name>)``. If you import a cache plugin directly in the code base, you can only access options by the ``ansible.constants``, and you break the cache plugin's ability to be used by an inventory plugin." msgstr "``self.set_options()`` ãŠã‚ˆã³ ``self.get_option(<option_name>)`` を使用ã§ãã‚‹ cache_loader を使用ã™ã‚‹ cache プラグインをインãƒãƒ¼ãƒˆã—ã¾ã™ã€‚コードベース㧠cache プラグインを直接インãƒãƒ¼ãƒˆã™ã‚‹å ´åˆã¯ã€``ansible.constants`` ã‹ã‚‰ã®ã¿ã‚ªãƒ—ションã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã€inventory プラグインã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã‚‹ cache プラグインã®æ©Ÿèƒ½ãŒå£Šã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:171 +#: ../../rst/dev_guide/developing_plugins.rst:175 msgid "There are two base classes for cache plugins, ``BaseCacheModule`` for database-backed caches, and ``BaseCacheFileModule`` for file-backed caches." msgstr "cache プラグインã«ã¯ã€2 ã¤ã®ãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ (データベースベースã®ãƒãƒƒã‚¯ã‚¢ãƒƒãƒ—用ã®ã‚ャッシュã®å ´åˆã¯ ``BaseCacheModule``ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒãƒƒã‚¯ã‚¢ãƒƒãƒ—用ã®ã‚ャッシュã®å ´åˆã¯ ``BaseCacheFileModule``) ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:173 +#: ../../rst/dev_guide/developing_plugins.rst:177 msgid "To create a cache plugin, start by creating a new ``CacheModule`` class with the appropriate base class. If you're creating a plugin using an ``__init__`` method you should initialize the base class with any provided args and kwargs to be compatible with inventory plugin cache options. The base class calls ``self.set_options(direct=kwargs)``. After the base class ``__init__`` method is called ``self.get_option(<option_name>)`` should be used to access cache options." msgstr "ã‚ャッシュプラグインを作æˆã™ã‚‹ã«ã¯ã€é©åˆ‡ãªãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ã§æ–°ã—ã„ ``CacheModule`` クラスを作æˆã—ã¦é–‹å§‹ã—ã¾ã™ã€‚``__init__`` メソッドを使用ã—ã¦ãƒ—ラグインを作æˆã™ã‚‹å ´åˆã¯ã€æŒ‡å®šã•ã‚ŒãŸ arg ãŠã‚ˆã³ kwarg ã§ãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ã‚’åˆæœŸåŒ–ã—ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインã‚ャッシュオプションã¨äº’æ›æ€§ãŒã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ベースクラス㯠``self.set_options(direct=kwargs)`` を呼ã³å‡ºã—ã¾ã™ã€‚ベースクラス ``__init__`` メソッドãŒå‘¼ã³å‡ºã•ã‚Œã‚‹ã¨ã€``self.get_option(<option_name>)`` を使用ã—ã¦ã€ã‚ャッシュオプションã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:175 +#: ../../rst/dev_guide/developing_plugins.rst:179 msgid "New cache plugins should take the options ``_uri``, ``_prefix``, and ``_timeout`` to be consistent with existing cache plugins." msgstr "æ–°ã—ã„ cache プラグインã¯ã€æ—¢å˜ã® cache プラグインã¨ã®æ•´åˆæ€§ã‚’ä¿ã¤ãŸã‚ã«ã€``_uri`` オプションã€``_prefix`` オプションã€ãŠã‚ˆã³ ``_timeout`` オプションを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:188 +#: ../../rst/dev_guide/developing_plugins.rst:192 msgid "If you use the ``BaseCacheModule``, you must implement the methods ``get``, ``contains``, ``keys``, ``set``, ``delete``, ``flush``, and ``copy``. The ``contains`` method should return a boolean that indicates if the key exists and has not expired. Unlike file-based caches, the ``get`` method does not raise a KeyError if the cache has expired." msgstr "``BaseCacheModule`` を使用ã™ã‚‹å ´åˆã¯ã€ãƒ¡ã‚½ãƒƒãƒ‰ ``get``ã€``contains``ã€``keys``ã€``set``ã€``delete``ã€``flush``ã€ãŠã‚ˆã³ ``copy`` を実装ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚``contains`` メソッドã¯ã€ã‚ーãŒå˜åœ¨ã—ã€æœ‰åŠ¹æœŸé™ãŒåˆ‡ã‚Œã¦ã„ãªã„ã“ã¨ã‚’示ã™ãƒ–ール値を返ã™ã¯ãšã§ã™ã€‚ファイルベースã®ã‚ャッシュã¨ã¯ç•°ãªã‚Šã€ã‚ャッシュã®æœ‰åŠ¹æœŸé™ãŒåˆ‡ã‚Œã‚‹ã¨ã€``get`` メソッドã«ã‚ˆã£ã¦ KeyError ã¯ç™ºç”Ÿã—ã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_plugins.rst:190 +#: ../../rst/dev_guide/developing_plugins.rst:194 msgid "If you use the ``BaseFileCacheModule``, you must implement ``_load`` and ``_dump`` methods that will be called from the base class methods ``get`` and ``set``." msgstr "``BaseFileCacheModule`` を使用ã™ã‚‹å ´åˆã¯ã€ãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ãƒ¡ã‚½ãƒƒãƒ‰ ``get`` ãŠã‚ˆã³ ``set`` ã‹ã‚‰å‘¼ã³å‡ºã•ã‚Œã‚‹ ``_load`` メソッドãŠã‚ˆã³ ``_dump`` メソッドを実装ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:192 +#: ../../rst/dev_guide/developing_plugins.rst:196 msgid "If your cache plugin stores JSON, use ``AnsibleJSONEncoder`` in the ``_dump`` or ``set`` method and ``AnsibleJSONDecoder`` in the ``_load`` or ``get`` method." msgstr "ã‚ャッシュプラグイン㫠JSON ãŒä¿å˜ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``_dump`` メソッドã¾ãŸã¯ ``set`` メソッド㮠``AnsibleJSONEncoder`` ã¨ã€``_load`` メソッドã¾ãŸã¯``get`` メソッド㮠``AnsibleJSONDecoder`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:194 +#: ../../rst/dev_guide/developing_plugins.rst:198 msgid "For example cache plugins, see the source code for the `cache plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/cache>`_." msgstr "cache プラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ cache プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/cache>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:199 +#: ../../rst/dev_guide/developing_plugins.rst:203 msgid "Callback plugins" msgstr "callback プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:201 +#: ../../rst/dev_guide/developing_plugins.rst:205 msgid "Callback plugins add new behaviors to Ansible when responding to events. By default, callback plugins control most of the output you see when running the command line programs." msgstr "callback プラグインã¯ã€ã‚¤ãƒ™ãƒ³ãƒˆã«å¿œç”ã™ã‚‹éš›ã«æ–°ã—ã„動作を Ansible ã«è¿½åŠ ã—ã¾ã™ã€‚デフォルトã§ã¯ã€callback プラグインã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ãƒ—ãƒã‚°ãƒ©ãƒ ã®å®Ÿè¡Œæ™‚ã«è¡¨ç¤ºã•ã‚Œã‚‹ã»ã¨ã‚“ã©ã®å‡ºåŠ›ã‚’制御ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:203 +#: ../../rst/dev_guide/developing_plugins.rst:207 msgid "To create a callback plugin, create a new class with the Base(Callbacks) class as the parent:" msgstr "callback プラグインを作æˆã™ã‚‹ã«ã¯ã€Base(Callbacks) クラスを親ã¨ã—ã¦ä½¿ç”¨ã—ã¦æ–°è¦ã‚¯ãƒ©ã‚¹ã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:212 +#: ../../rst/dev_guide/developing_plugins.rst:216 msgid "From there, override the specific methods from the CallbackBase that you want to provide a callback for. For plugins intended for use with Ansible version 2.0 and later, you should only override methods that start with ``v2``. For a complete list of methods that you can override, please see ``__init__.py`` in the `lib/ansible/plugins/callback <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/callback>`_ directory." msgstr "ãã“ã‹ã‚‰ã€ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã‚’æä¾›ã™ã‚‹ CallbackBase ã‹ã‚‰ç‰¹å®šã®ãƒ¡ã‚½ãƒƒãƒ‰ã‚’上書ãã—ã¾ã™ã€‚Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.0 以é™ã§ä½¿ç”¨ã™ã‚‹ãƒ—ラグインã§ã¯ã€``v2`` ã§å§‹ã¾ã‚‹æ–¹æ³•ã®ã¿ã‚’上書ãã—ã¦ãã ã•ã„。上書ãã§ãるメソッドã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ã€`lib/ansible/plugins/callback <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/callback>`_ ディレクトリー㮠``__init__.py`` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:217 +#: ../../rst/dev_guide/developing_plugins.rst:221 msgid "The following is a modified example of how Ansible's timer plugin is implemented, but with an extra option so you can see how configuration works in Ansible version 2.4 and later:" msgstr "以下ã¯ã€Ansible ã® timer プラグインã®å®Ÿè£…方法ã®å¤‰æ›´ä¾‹ã§ã™ã€‚ãŸã ã—ã€è¿½åŠ ã®ã‚ªãƒ—ションを使用ã™ã‚‹ã¨ã€Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.4 以é™ã§æ§‹æˆãŒã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã™ã‚‹ã‹ã‚’確èªã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:286 +#: ../../rst/dev_guide/developing_plugins.rst:290 msgid "Note that the ``CALLBACK_VERSION`` and ``CALLBACK_NAME`` definitions are required for properly functioning plugins for Ansible version 2.0 and later. ``CALLBACK_TYPE`` is mostly needed to distinguish 'stdout' plugins from the rest, since you can only load one plugin that writes to stdout." msgstr "``CALLBACK_VERSION`` ãŠã‚ˆã³ ``CALLBACK_NAME`` ã®å®šç¾©ã¯ã€Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.0 以é™ã®ãƒ—ラグインãŒæ£ã—ã機能ã™ã‚‹ãŸã‚ã«å¿…è¦ã§ã‚ã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。``CALLBACK_TYPE`` ã¯ã€æ¨™æº–出力 (stdout) ã«æ›¸ã込むプラグインを 1 ã¤ã ã‘èªã¿è¾¼ã‚€ã“ã¨ãŒã§ãã‚‹ãŸã‚ã€ã»ã¨ã‚“ã©ã®ã€Œstdoutã€ãƒ—ラグインをãã®ä»–ã®ã‚‚ã®ã¨åŒºåˆ¥ã™ã‚‹ãŸã‚ã«å¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:288 +#: ../../rst/dev_guide/developing_plugins.rst:292 msgid "For example callback plugins, see the source code for the `callback plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/callback>`_" msgstr "callback プラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ callback プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/callback>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:290 -msgid "New in ansible-core 2.11, callback plugins are notified (via ``v2_playbook_on_task_start``) of :ref:`meta<meta_module>` tasks. By default, only explicit ``meta`` tasks that users list in their plays are sent to callbacks." +#: ../../rst/dev_guide/developing_plugins.rst:294 +msgid "New in ansible-core 2.11, callback plugins are notified (by the ``v2_playbook_on_task_start``) of :ref:`meta<meta_module>` tasks. By default, only explicit ``meta`` tasks that users list in their plays are sent to callbacks." msgstr "ansible-core 2.11 ã®æ–°æ©Ÿèƒ½ã¨ã—ã¦ã€:ref:`meta<meta_module>` タスクã®ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ãƒ—ラグイン㌠(``v2_playbook_on_task_start`` を介ã—ã¦) 通知ã•ã‚Œã¾ã™ã€‚デフォルトã§ã¯ã€ãƒ—レイã«è¿½åŠ ã™ã‚‹æ˜Žç¤ºçš„㪠``meta`` タスクã®ã¿ãŒã€ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã«é€ä¿¡ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:292 +#: ../../rst/dev_guide/developing_plugins.rst:296 msgid "There are also some tasks which are generated internally and implicitly at various points in execution. Callback plugins can opt-in to receiving these implicit tasks as well, by setting ``self.wants_implicit_tasks = True``. Any ``Task`` object received by a callback hook will have an ``.implicit`` attribute, which can be consulted to determine whether the ``Task`` originated from within Ansible, or explicitly by the user." msgstr "実行ã®ã•ã¾ã–ã¾ãªæ™‚点ã§ã€å†…部的ãŠã‚ˆã³æš—黙的ã«ç”Ÿæˆã•ã‚Œã‚‹ã‚¿ã‚¹ã‚¯ã‚‚ã„ãã¤ã‹ã‚ã‚Šã¾ã™ã€‚callback プラグインã¯ã€``self.wants_implicit_tasks = True`` ã‚’è¨å®šã™ã‚‹ã“ã¨ã«ã‚ˆã‚Šã€ã“れらã®æš—黙的ãªã‚¿ã‚¹ã‚¯ã‚’å—ã‘å–ã‚‹ã“ã¨ã‚’オプトインã§ãã¾ã™ã€‚コールãƒãƒƒã‚¯ãƒ•ãƒƒã‚¯ã«ã‚ˆã£ã¦å—ä¿¡ã—㟠``Task`` オブジェクトã«ã¯ã€``.implicit`` 属性ãŒã‚ã‚Šã¾ã™ã€‚ã“れをå‚ç…§ã—ã¦ã€``Task`` ㌠Ansible 内ã‹ã‚‰ã€ã¾ãŸã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ã‚ˆã£ã¦æ˜Žç¤ºçš„ã«ç™ºä¿¡ã•ã‚ŒãŸã‹ã©ã†ã‹ã‚’決ã‚ã‚‹ãŸã‚ã«å‚ç…§ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:297 +#: ../../rst/dev_guide/developing_plugins.rst:301 msgid "Connection plugins" msgstr "connection プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:299 +#: ../../rst/dev_guide/developing_plugins.rst:303 msgid "Connection plugins allow Ansible to connect to the target hosts so it can execute tasks on them. Ansible ships with many connection plugins, but only one can be used per host at a time. The most commonly used connection plugins are the ``paramiko`` SSH, native ssh (just called ``ssh``), and ``local`` connection types. All of these can be used in playbooks and with ``/usr/bin/ansible`` to connect to remote machines." msgstr "connection プラグインã«ã‚ˆã‚Šã€Ansible ã¯ã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒ›ã‚¹ãƒˆã«æŽ¥ç¶šã—ã¦ãã®ãƒ›ã‚¹ãƒˆã«ã‚るタスクを実行ã§ãるよã†ã«ã—ã¾ã™ã€‚Ansible ã«ã¯å¤šãã® connection プラグインãŒåŒæ¢±ã•ã‚Œã¦ã„ã¾ã™ãŒã€ä¸€åº¦ã«ä½¿ç”¨ã§ãã‚‹ã®ã¯ 1 ã¤ã®ã¿ã¨ãªã‚Šã¾ã™ã€‚最も一般的ã«ä½¿ç”¨ã•ã‚Œã‚‹ connection プラグインã¯ã€``paramiko`` SSHã€ãƒã‚¤ãƒ†ã‚£ãƒ– ssh (å˜ã« ``ssh`` ã¨å‘¼ã°ã‚Œã‚‹)ã€ãŠã‚ˆã³ ``local`` 接続タイプã§ã™ã€‚ã“れらã¯ã™ã¹ã¦ Playbook ã§ä½¿ç”¨ã•ã‚Œã€``/usr/bin/ansible`` を使用ã—ã¦ãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ã«æŽ¥ç¶šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:301 +#: ../../rst/dev_guide/developing_plugins.rst:305 msgid "Ansible version 2.1 introduced the ``smart`` connection plugin. The ``smart`` connection type allows Ansible to automatically select either the ``paramiko`` or ``openssh`` connection plugin based on system capabilities, or the ``ssh`` connection plugin if OpenSSH supports ControlPersist." msgstr "Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.1 ã§ã¯ã€``smart`` connection プラグインãŒå°Žå…¥ã•ã‚Œã¾ã™ã€‚``smart`` 接続タイプã«ã‚ˆã‚Šã€Ansible ã¯ã€ã‚·ã‚¹ãƒ†ãƒ 機能ã«åŸºã¥ã„ã¦ã€``paramiko`` ã¾ãŸã¯ ``openssh`` connection プラグインã®ã„ãšã‚Œã‹ã‚’自動的ã«é¸æŠžã§ãã¾ã™ãŒã€OpenSSH ㌠ControlPersist ã«å¯¾å¿œã—ã¦ã„ã‚‹å ´åˆã¯ connetion プラグイン ``ssh`` ã‚’é¸æŠžã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:303 +#: ../../rst/dev_guide/developing_plugins.rst:307 msgid "To create a new connection plugin (for example, to support SNMP, Message bus, or other transports), copy the format of one of the existing connection plugins and drop it into ``connection`` directory on your :ref:`local plugin path <local_plugins>`." msgstr "æ–°ã—ã„ connetion プラグイン (SNMPã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒã‚¹ã€ã¾ãŸã¯ãã®ä»–ã®ãƒˆãƒ©ãƒ³ã‚¹ãƒãƒ¼ãƒˆã‚’サãƒãƒ¼ãƒˆã™ã‚‹å ´åˆãªã©) を作æˆã™ã‚‹ã«ã¯ã€æ—¢å˜ã® connetion プラグインã®ã„ãšã‚Œã‹ã®å½¢å¼ã‚’コピーã—ã¦ã€:ref:`ãƒãƒ¼ã‚«ãƒ«ãƒ—ラグインパス <local_plugins>` ã«ã‚ã‚‹ ``connection`` ディレクトリーã«ç½®ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:305 +#: ../../rst/dev_guide/developing_plugins.rst:309 msgid "Connection plugins can support common options (such as the ``--timeout`` flag) by defining an entry in the documentation for the attribute name (in this case ``timeout``). If the common option has a non-null default, the plugin should define the same default since a different default would be ignored." msgstr "connection プラグインã¯ã€å±žæ€§å (ã“ã“ã§ã¯ ``timeout``) ã®ãƒ‰ã‚ュメントã§ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’定義ã™ã‚‹ã“ã¨ã§ã€ä¸€èˆ¬çš„ãªã‚ªãƒ—ション (``--timeout`` フラグãªã©) をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚一般的ãªã‚ªãƒ—ションã«ã¯ null 以外ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒã‚ã‚‹å ´åˆã€åˆ¥ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ç„¡è¦–ã•ã‚Œã‚‹ãŸã‚ã€ãƒ—ラグインã¯åŒã˜ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’定義ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:307 +#: ../../rst/dev_guide/developing_plugins.rst:311 msgid "For example connection plugins, see the source code for the `connection plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/connection>`_." msgstr "é¸æŠžãƒ—ラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹æŽ¥ç¶šãƒ—ラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/connection>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:312 +#: ../../rst/dev_guide/developing_plugins.rst:316 msgid "Filter plugins" msgstr "filter プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:314 +#: ../../rst/dev_guide/developing_plugins.rst:318 msgid "Filter plugins manipulate data. They are a feature of Jinja2 and are also available in Jinja2 templates used by the ``template`` module. As with all plugins, they can be easily extended, but instead of having a file for each one you can have several per file. Most of the filter plugins shipped with Ansible reside in a ``core.py``." msgstr "filter プラグインã¯ãƒ‡ãƒ¼ã‚¿ã‚’æ“作ã—ã¾ã™ã€‚ã“れら㯠Jinja2 ã®æ©Ÿèƒ½ã§ã‚ã‚Šã€``template`` モジュールãŒä½¿ç”¨ã™ã‚‹ Jinja2 テンプレートã§åˆ©ç”¨ã§ãã¾ã™ã€‚ã™ã¹ã¦ã®ãƒ—ラグインã¨åŒæ§˜ã«ã€ãƒ—ラグインã¯ç°¡å˜ã«æ‹¡å¼µã§ãã¾ã™ãŒã€ãƒ—ラグインã”ã¨ã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã™ã‚‹ä»£ã‚ã‚Šã«ã€ãƒ•ã‚¡ã‚¤ãƒ«ã”ã¨ã«è¤‡æ•°ã®ãƒ—ラグインを作æˆã§ãã¾ã™ã€‚Ansible ã«åŒæ¢±ã•ã‚Œã¦ã„るフィルタープラグインã®ã»ã¨ã‚“ã©ã¯ã€``core.py`` ã«ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:316 -msgid "Filter plugins do not use the standard configuration and documentation system described above." -msgstr "filter プラグインã¯ã€ä¸Šè¨˜ã®æ¨™æº–è¨å®šãŠã‚ˆã³ãƒ‰ã‚ュメントシステムを使用ã—ã¾ã›ã‚“。" +#: ../../rst/dev_guide/developing_plugins.rst:320 +msgid "Filter plugins do not use the standard configuration system described above, but since ansible-core 2.14 can use it as plain documentation." +msgstr "フィルタープラグインã¯ã€ä¸Šè¨˜ã®æ¨™æº–è¨å®šã‚·ã‚¹ãƒ†ãƒ を使用ã—ã¾ã›ã‚“ãŒã€ansible-core 2.14 以é™ã§ã¯å˜ç´”ãªãƒ‰ã‚ュメントã¨ã—ã¦ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:318 +#: ../../rst/dev_guide/developing_plugins.rst:322 msgid "Since Ansible evaluates variables only when they are needed, filter plugins should propagate the exceptions ``jinja2.exceptions.UndefinedError`` and ``AnsibleUndefinedVariable`` to ensure undefined variables are only fatal when necessary." msgstr "Ansibleã¯å¿…è¦ãªã¨ãã«ã®ã¿å¤‰æ•°ã‚’評価ã™ã‚‹ã®ã§ã€æœªå®šç¾©ã®å¤‰æ•°ãŒå¿…è¦ãªã¨ãã«ã®ã¿è‡´å‘½çš„ãªå•é¡Œã‚’èµ·ã“ã™ã‚ˆã†ã«ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ãƒ—ラグインã¯ã€ä¾‹å¤–``jinja2.exceptions.UndefinedError`` ã¨``AnsibleUndefinedVariable`` ã‚’ä¼æ’ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:329 +#: ../../rst/dev_guide/developing_plugins.rst:333 msgid "For example filter plugins, see the source code for the `filter plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/filter>`_." msgstr "filter プラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ filter プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/filter>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:336 +#: ../../rst/dev_guide/developing_plugins.rst:340 msgid "Inventory plugins parse inventory sources and form an in-memory representation of the inventory. Inventory plugins were added in Ansible version 2.4." msgstr "inventory プラグインã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’解æžã—ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®ã‚¤ãƒ³ãƒ¡ãƒ¢ãƒªãƒ¼è¡¨ç¤ºã‚’å½¢æˆã—ã¾ã™ã€‚inventory プラグイン㯠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.4 ã§è¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:338 +#: ../../rst/dev_guide/developing_plugins.rst:342 msgid "You can see the details for inventory plugins in the :ref:`developing_inventory` page." msgstr "inventory プラグインã®è©³ç´°ã¯ã€:ref:`developing_inventory` ページをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:343 +#: ../../rst/dev_guide/developing_plugins.rst:347 msgid "Lookup plugins" msgstr "lookup プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:345 -msgid "Lookup plugins pull in data from external data stores. Lookup plugins can be used within playbooks both for looping --- playbook language constructs like ``with_fileglob`` and ``with_items`` are implemented via lookup plugins --- and to return values into a variable or parameter." +#: ../../rst/dev_guide/developing_plugins.rst:349 +msgid "Lookup plugins pull in data from external data stores. Lookup plugins can be used within playbooks both for looping --- playbook language constructs like ``with_fileglob`` and ``with_items`` are implemented through lookup plugins --- and to return values into a variable or parameter." msgstr "lookup プラグインã¯ã€å¤–部データストアã‹ã‚‰ãƒ‡ãƒ¼ã‚¿ã‚’プルã—ã¾ã™ã€‚lookup プラグイン㯠Playbook 内ã§ãƒ«ãƒ¼ãƒ—ã™ã‚‹ãŸã‚ (``with_fileglob`` ã‚„ ``with_items`` ãªã©ã® Playbook 言語ã®æ§‹é€ 㯠lookup プラグインを介ã—ã¦å®Ÿè£…ã•ã‚Œã¦ã„ã¾ã™)ã€ã¾ãŸå¤‰æ•°ã‚„パラメーターã«å€¤ã‚’è¿”ã™ãŸã‚ã«ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:347 +#: ../../rst/dev_guide/developing_plugins.rst:351 msgid "Lookup plugins are expected to return lists, even if just a single element." msgstr "lookup プラグインã¯ã€å˜ä¸€ã®è¦ç´ ã®ã¿ã§ã‚ã£ã¦ã‚‚リストを返ã™ã“ã¨ãŒæƒ³å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:349 +#: ../../rst/dev_guide/developing_plugins.rst:353 msgid "Ansible includes many :ref:`filters <playbooks_filters>` which can be used to manipulate the data returned by a lookup plugin. Sometimes it makes sense to do the filtering inside the lookup plugin, other times it is better to return results that can be filtered in the playbook. Keep in mind how the data will be referenced when determining the appropriate level of filtering to be done inside the lookup plugin." msgstr "Ansible ã«ã¯ã€lookup プラグインãŒè¿”ã™ãƒ‡ãƒ¼ã‚¿ã‚’æ“作ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã‚‹ :ref:`filters <playbooks_filters>` ãŒå¤šæ•°å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚lookup プラグイン内ã§ãƒ•ã‚£ãƒ«ã‚¿ãƒªãƒ³ã‚°ã‚’è¡Œã†ã“ã¨ãŒç†ã«ã‹ãªã£ã¦ã„ã‚‹å ´åˆã‚‚ã‚ã‚Œã°ã€Playbook ã§ãƒ•ã‚£ãƒ«ã‚¿ãƒªãƒ³ã‚°ã§ãã‚‹çµæžœã‚’è¿”ã™æ–¹ãŒã‚ˆã„å ´åˆã‚‚ã‚ã‚Šã¾ã™ã€‚lookup プラグイン内ã§å®Ÿè¡Œã™ã‚‹é©åˆ‡ãªãƒ•ã‚£ãƒ«ã‚¿ãƒªãƒ³ã‚°ãƒ¬ãƒ™ãƒ«ã‚’決定ã™ã‚‹ã¨ãã¯ã€ãƒ‡ãƒ¼ã‚¿ãŒã©ã®ã‚ˆã†ã«å‚ç…§ã•ã‚Œã‚‹ã‹ã«ç•™æ„ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:351 +#: ../../rst/dev_guide/developing_plugins.rst:355 msgid "Here's a simple lookup plugin implementation --- this lookup returns the contents of a text file as a variable:" msgstr "以下ã¯ç°¡å˜ãª lookup プラグインã®å®Ÿè£…ã§ã™ã€‚ã“ã® lookup ã¯ã€ãƒ†ã‚ストファイルã®å†…容を変数ã¨ã—ã¦è¿”ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:428 +#: ../../rst/dev_guide/developing_plugins.rst:432 msgid "The following is an example of how this lookup is called:" msgstr "以下ã¯ã€ã“ã®ãƒ«ãƒƒã‚¯ã‚¢ãƒƒãƒ—ãŒã©ã®ã‚ˆã†ã«å‘¼ã³å‡ºã•ã‚Œã‚‹ã‹ã®ä¾‹ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:443 +#: ../../rst/dev_guide/developing_plugins.rst:447 msgid "For example lookup plugins, see the source code for the `lookup plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/lookup>`_." msgstr "lookup プラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ lookup プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/lookup>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:445 +#: ../../rst/dev_guide/developing_plugins.rst:449 msgid "For more usage examples of lookup plugins, see :ref:`Using Lookups<playbooks_lookups>`." msgstr "lookup プラグインã®ãã®ä»–ã®ä½¿ç”¨ä¾‹ã«ã¤ã„ã¦ã¯ã€ã€Œ:ref:`検索ã®ä½¿ç”¨<playbooks_lookups>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:450 +#: ../../rst/dev_guide/developing_plugins.rst:454 msgid "Test plugins" msgstr "test プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:452 +#: ../../rst/dev_guide/developing_plugins.rst:456 msgid "Test plugins verify data. They are a feature of Jinja2 and are also available in Jinja2 templates used by the ``template`` module. As with all plugins, they can be easily extended, but instead of having a file for each one you can have several per file. Most of the test plugins shipped with Ansible reside in a ``core.py``. These are specially useful in conjunction with some filter plugins like ``map`` and ``select``; they are also available for conditional directives like ``when:``." msgstr "テストプラグインã¯ãƒ‡ãƒ¼ã‚¿ã‚’検証ã—ã¾ã™ã€‚ã“れ㯠Jinja2 ã®æ©Ÿèƒ½ã§ã€``template`` モジュールãŒä½¿ç”¨ã™ã‚‹ Jinja2 テンプレートã§ã‚‚利用ã§ãã¾ã™ã€‚ä»–ã®ã™ã¹ã¦ã®ãƒ—ラグインã¨åŒæ§˜ã€ã“ã®ãƒ—ラグインã¯ç°¡å˜ã«æ‹¡å¼µã§ãã¾ã™ãŒã€ãƒ—ラグインã”ã¨ã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã™ã‚‹ä»£ã‚ã‚Šã«ã€ãƒ•ã‚¡ã‚¤ãƒ«ã”ã¨ã«è¤‡æ•°ã®ãƒ—ラグインを作æˆã§ãã¾ã™ã€‚Ansible ã«åŒæ¢±ã•ã‚Œã¦ã„るテストプラグインã®ã»ã¨ã‚“ã©ã¯ã€``core.py`` ã«æ ¼ç´ã•ã‚Œã¦ã„ã¾ã™ã€‚ã“れらã®ãƒ—ラグインã¯ã€``map`` ã‚„ ``select`` ãªã©ã® filter プラグインã¨çµ„ã¿åˆã‚ã›ã¦ä½¿ã†ã¨ç‰¹ã«ä¾¿åˆ©ã§ã™ã€‚ã¾ãŸã€``when:`` ãªã©ã®æ¡ä»¶ä»˜ãディレクティブã«ã‚‚利用ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:454 -msgid "Test plugins do not use the standard configuration and documentation system described above." -msgstr "test プラグインã¯ã€ä¸Šè¨˜ã®æ¨™æº–è¨å®šãŠã‚ˆã³ãƒ‰ã‚ュメントシステムを使用ã—ã¾ã›ã‚“。" +#: ../../rst/dev_guide/developing_plugins.rst:458 +msgid "Test plugins do not use the standard configuration system described above. Since ansible-core 2.14 test plugins can use plain documentation." +msgstr "テストプラグインã¯ã€ä¸Šè¨˜ã®æ¨™æº–è¨å®šã‚·ã‚¹ãƒ†ãƒ を使用ã—ã¾ã›ã‚“。ansible-core 2.14 以é™ã«ãŠã„ã¦ã€ãƒ†ã‚¹ãƒˆãƒ—ラグインã¯å˜ç´”ãªãƒ‰ã‚ュメントを使用ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:456 +#: ../../rst/dev_guide/developing_plugins.rst:460 msgid "Since Ansible evaluates variables only when they are needed, test plugins should propagate the exceptions ``jinja2.exceptions.UndefinedError`` and ``AnsibleUndefinedVariable`` to ensure undefined variables are only fatal when necessary." msgstr "Ansibleã¯å¿…è¦ãªã¨ãã«ã®ã¿å¤‰æ•°ã‚’評価ã™ã‚‹ã®ã§ã€æœªå®šç¾©ã®å¤‰æ•°ãŒå¿…è¦ãªã¨ãã«ã®ã¿è‡´å‘½çš„ãªå•é¡Œã‚’èµ·ã“ã™ã‚ˆã†ã«ã€ãƒ†ã‚¹ãƒˆãƒ—ラグインã¯ã€ä¾‹å¤–``jinja2.exceptions.UndefinedError`` ã¨``AnsibleUndefinedVariable`` ã‚’ä¼æ’ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:467 +#: ../../rst/dev_guide/developing_plugins.rst:471 msgid "For example test plugins, see the source code for the `test plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/test>`_." msgstr "test プラグインã®ä¾‹ã¯ã€`Ansible Core ã«åŒæ¢±ã•ã‚Œã‚‹ test プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/test>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:472 +#: ../../rst/dev_guide/developing_plugins.rst:476 msgid "Vars plugins" msgstr "vars プラグイン" -#: ../../rst/dev_guide/developing_plugins.rst:474 +#: ../../rst/dev_guide/developing_plugins.rst:478 msgid "Vars plugins inject additional variable data into Ansible runs that did not come from an inventory source, playbook, or command line. Playbook constructs like 'host_vars' and 'group_vars' work using vars plugins." msgstr "vars プラグインã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã€Playbookã€ã¾ãŸã¯ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã«çµ„ã¿è¾¼ã¾ã‚Œã¦ã„ãªã„ Ansible ã®å®Ÿè¡Œã«ã€å¤‰æ•°ãƒ‡ãƒ¼ã‚¿ã‚’è¿½åŠ ã—ã¾ã™ã€‚「host_varsã€ã‚„「group_varsã€ã®ã‚ˆã†ãª Playbook ã®æ§‹æˆè¦ç´ ã¯ã€vars プラグインを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:476 +#: ../../rst/dev_guide/developing_plugins.rst:480 msgid "Vars plugins were partially implemented in Ansible 2.0 and rewritten to be fully implemented starting with Ansible 2.4. Vars plugins are supported by collections starting with Ansible 2.10." msgstr "vars プラグイン㯠Ansible 2.0 ã«éƒ¨åˆ†çš„ã«å®Ÿè£…ã•ã‚Œã€Ansible 2.4 以é™ã§ã¯ã€å®Œå…¨å®Ÿè£…ã«ãªã‚‹ã‚ˆã†ã«æ›¸ãç›´ã•ã‚Œã¾ã—ãŸã€‚vars プラグインã¯Ansible 2.10以é™ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚µãƒãƒ¼ãƒˆå¯¾è±¡ã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:478 +#: ../../rst/dev_guide/developing_plugins.rst:482 msgid "Older plugins used a ``run`` method as their main body/work:" msgstr "å¤ã„プラグインã§ã¯ã€``run`` メソッドを主è¦ãªæœ¬æ–‡/作æ¥ã¨ã—ã¦ä½¿ç”¨ã—ã¦ã„ã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:486 +#: ../../rst/dev_guide/developing_plugins.rst:490 msgid "Ansible 2.0 did not pass passwords to older plugins, so vaults were unavailable. Most of the work now happens in the ``get_vars`` method which is called from the VariableManager when needed." msgstr "Ansible 2.0 ã¯å¤ã„プラグインã«ãƒ‘スワードを渡ã•ãªã‹ã£ãŸãŸã‚ã€vault ã¯åˆ©ç”¨ã§ãã¾ã›ã‚“ã§ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ä½œæ¥ã¯ã€å¿…è¦ã«å¿œã˜ã¦ VariableManager ã‹ã‚‰å‘¼ã³å‡ºã•ã‚Œã‚‹ ``get_vars`` メソッドã§å®Ÿè¡Œã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:494 +#: ../../rst/dev_guide/developing_plugins.rst:498 msgid "The parameters are:" msgstr "パラメーターã¯ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:496 +#: ../../rst/dev_guide/developing_plugins.rst:500 msgid "loader: Ansible's DataLoader. The DataLoader can read files, auto-load JSON/YAML and decrypt vaulted data, and cache read files." msgstr "loader: Ansible ã® DataLoader。DataLoader ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®èªã¿å–ã‚Šã€JSON/YAML ã®è‡ªå‹•èªã¿è¾¼ã¿ã€vault を使用ã—ãŸãƒ‡ãƒ¼ã‚¿ã®å¾©å·ã€ãŠã‚ˆã³èªã¿å–りファイルã®ã‚ャッシュを行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:497 +#: ../../rst/dev_guide/developing_plugins.rst:501 msgid "path: this is 'directory data' for every inventory source and the current play's playbook directory, so they can search for data in reference to them. ``get_vars`` will be called at least once per available path." msgstr "path: ã“ã‚Œã¯ã™ã¹ã¦ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã¨ç¾åœ¨ã®ãƒ—レイ㮠Playbook ディレクトリーã®ã€Œãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ãƒ‡ãƒ¼ã‚¿ã€ã§ã‚ã‚‹ãŸã‚ã€ãれをå‚ç…§ã™ã‚‹ãƒ‡ãƒ¼ã‚¿ã‚’検索ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚``get_vars`` ã¯ã€åˆ©ç”¨å¯èƒ½ãªãƒ‘スã”ã¨ã«æœ€ä½Ž 1 回呼ã³å‡ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:498 +#: ../../rst/dev_guide/developing_plugins.rst:502 msgid "entities: these are host or group names that are pertinent to the variables needed. The plugin will get called once for hosts and again for groups." msgstr "entities: å¿…è¦ãªå¤‰æ•°ã«é–¢é€£ä»˜ã‘られるホストåã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—åã§ã™ã€‚プラグインã¯ãƒ›ã‚¹ãƒˆã«å¯¾ã—㦠1 回呼ã³å‡ºã•ã‚Œã€ã‚°ãƒ«ãƒ¼ãƒ—ã«å¯¾ã—ã¦å†åº¦å‘¼ã³å‡ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:500 +#: ../../rst/dev_guide/developing_plugins.rst:504 msgid "This ``get_vars`` method just needs to return a dictionary structure with the variables." msgstr "ã“ã® ``get_vars`` メソッドã¯å¤‰æ•°ã‚’å«ã‚€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼æ§‹é€ ã‚’è¿”ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:502 +#: ../../rst/dev_guide/developing_plugins.rst:506 msgid "Since Ansible version 2.4, vars plugins only execute as needed when preparing to execute a task. This avoids the costly 'always execute' behavior that occurred during inventory construction in older versions of Ansible. Since Ansible version 2.10, vars plugin execution can be toggled by the user to run when preparing to execute a task or after importing an inventory source." msgstr "Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.4 以é™ã€ã‚¿ã‚¹ã‚¯å®Ÿè¡Œã®æº–備時ã«å¿…è¦ã«å¿œã˜ã¦ vars プラグインã®ã¿ã‚’実行ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼æ§‹ç¯‰ä¸ã«ç™ºç”Ÿã—ãŸã€è²»ç”¨ã®ã‹ã‹ã‚‹ã€Œå¸¸ã«å®Ÿè¡Œã€å‹•ä½œãŒå›žé¿ã•ã‚Œã¾ã™ã€‚Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.10 以é™ã€vars プラグインã®å®Ÿè¡Œã¯ã€ã‚¿ã‚¹ã‚¯ã®å®Ÿè¡Œæº–備時ã¾ãŸã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆå¾Œã«å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒåˆ‡ã‚Šæ›¿ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:504 +#: ../../rst/dev_guide/developing_plugins.rst:508 msgid "The user must explicitly enable vars plugins that reside in a collection. See :ref:`enable_vars` for details." msgstr "ユーザーã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ã‚ã‚‹ vars プラグインを明示的ã«æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€:ref:`enable_vars` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:506 +#: ../../rst/dev_guide/developing_plugins.rst:510 msgid "Legacy vars plugins are always loaded and run by default. You can prevent them from automatically running by setting ``REQUIRES_ENABLED`` to True." msgstr "レガシー vars プラグインã¯å¸¸ã«èªã¿è¾¼ã¾ã‚Œã€å®Ÿè¡Œã•ã‚Œã¾ã™ã€‚``REQUIRES_ENABLED`` ã‚’ True ã«è¨å®šã™ã‚‹ã¨ã€è‡ªå‹•çš„ã«å®Ÿè¡Œã—ãªã„よã†ã«ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:513 +#: ../../rst/dev_guide/developing_plugins.rst:517 msgid "Include the ``vars_plugin_staging`` documentation fragment to allow users to determine when vars plugins run." msgstr "``vars_plugin_staging`` ドã‚ãƒ¥ãƒ¡ãƒ³ãƒˆãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒ when vars プラグインã®å®Ÿè¡Œã‚’判別ã§ãるよã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_plugins.rst:533 +#: ../../rst/dev_guide/developing_plugins.rst:537 msgid "For example vars plugins, see the source code for the `vars plugins included with Ansible Core <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/vars>`_." msgstr "vars プラグインã®ä¾‹ã¯ã€`Ansible Core ã«å«ã¾ã‚Œã‚‹ vars プラグイン <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/vars>`_ ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_plugins.rst:543 +#: ../../rst/dev_guide/developing_plugins.rst:547 +#: ../../rst/dev_guide/sidecar.rst:94 msgid "Learn about how to develop dynamic inventory sources" msgstr "動的インベントリーソースã®é–‹ç™ºæ–¹æ³•ã«ã¤ã„ã¦" +#: ../../rst/dev_guide/developing_plugins.rst:554 +msgid ":ref:`adjacent_yaml_doc`" +msgstr ":ref:`adjacent_yaml_doc`" + +#: ../../rst/dev_guide/developing_plugins.rst:555 +msgid "Alternate YAML files as documentation" +msgstr "ドã‚ュメントã¨ã—ã¦ã®ä»£æ›¿ YAML ファイル" + #: ../../rst/dev_guide/developing_program_flow_modules.rst:6 msgid "Ansible module architecture" msgstr "Ansible モジュールã®ã‚¢ãƒ¼ã‚テクãƒãƒ£ãƒ¼" @@ -6595,7 +6214,7 @@ msgid "Non-native want JSON modules" msgstr "ãƒã‚¤ãƒ†ã‚£ãƒ–以外㮠JSON モジュール" #: ../../rst/dev_guide/developing_program_flow_modules.rst:116 -msgid "If a module has the string ``WANT_JSON`` in it anywhere, Ansible treats it as a non-native module that accepts a filename as its only command line parameter. The filename is for a temporary file containing a :term:`JSON` string containing the module's parameters. The module needs to open the file, read and parse the parameters, operate on the data, and print its return data as a JSON encoded dictionary to stdout before exiting." +msgid "If a module has the string ``WANT_JSON`` in it anywhere, Ansible treats it as a non-native module that accepts a filename as its only command-line parameter. The filename is for a temporary file containing a :term:`JSON` string containing the module's parameters. The module needs to open the file, read and parse the parameters, operate on the data, and print its return data as a JSON encoded dictionary to stdout before exiting." msgstr "モジュールã«æ–‡å—列 ``WANT_JSON`` ãŒã‚ã‚‹ã¨ã€Ansible ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«åをコマンドラインパラメーターã¨ã—ã¦ã®ã¿è¨±å¯ã™ã‚‹éžãƒã‚¤ãƒ†ã‚£ãƒ–モジュールã¨ã—ã¦æ‰±ã„ã¾ã™ã€‚ファイルåã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‘ラメーターをå«ã‚€ :term:`JSON` æ–‡å—列をå«ã‚€ä¸€æ™‚çš„ãªãƒ•ã‚¡ã‚¤ãƒ«å‘ã‘ã§ã™ã€‚モジュールã¯ãƒ•ã‚¡ã‚¤ãƒ«ã‚’é–‹ãã€ãƒ‘ラメーターをèªã¿å–ã‚ŠãŠã‚ˆã³è§£æžã—ã€ãƒ‡ãƒ¼ã‚¿ã§æ“作ã—ã€çµ‚了ã™ã‚‹å‰ã«ãã®æˆ»ã‚Šå€¤ã‚’ JSON エンコードディレクトリーã¨ã—㦠stdout ã«å‡ºåŠ›ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:123 @@ -6643,8 +6262,8 @@ msgid "Executor/task_executor" msgstr "Executor/task_executor" #: ../../rst/dev_guide/developing_program_flow_modules.rst:175 -msgid "The TaskExecutor receives the module name and parameters that were parsed from the :term:`playbook <playbooks>` (or from the command line in the case of :command:`/usr/bin/ansible`). It uses the name to decide whether it's looking at a module or an :ref:`Action Plugin <flow_action_plugins>`. If it's a module, it loads the :ref:`Normal Action Plugin <flow_normal_action_plugin>` and passes the name, variables, and other information about the task and play to that Action Plugin for further processing." -msgstr "TaskExecutor ã¯ã€:term:`Playbook <playbooks>` (:command:`/usr/bin/ansible` ã®å ´åˆã¯ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³) ã‹ã‚‰è§£æžã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åã¨ãƒ‘ラメーターをå—ã‘å–ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’見ã¦ã€ã¾ãŸã¯ :ref:`action プラグイン <flow_action_plugins>` を見ã¦ã„ã‚‹ã‹ã‚’判æ–ã™ã‚‹ãŸã‚ã«åå‰ã‚’使用ã—ã¾ã™ã€‚モジュールã®å ´åˆã¯ã€:ref:`Normal action プラグイン <flow_normal_action_plugin>` ã‚’èªã¿è¾¼ã¿ã€ã‚¿ã‚¹ã‚¯ã¨ãƒ—レイã«é–¢ã™ã‚‹åå‰ã€å¤‰æ•°ã€ãŠã‚ˆã³ãã®ä»–ã®æƒ…å ±ã‚’ãã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãƒ—ラグインã«æ¸¡ã—ã¦ã€ã•ã‚‰ã«å‡¦ç†ã—ã¾ã™ã€‚" +msgid "The TaskExecutor receives the module name and parameters that were parsed from the :term:`playbook <playbooks>` (or from the command-line in the case of :command:`/usr/bin/ansible`). It uses the name to decide whether it's looking at a module or an :ref:`Action Plugin <flow_action_plugins>`. If it's a module, it loads the :ref:`Normal Action Plugin <flow_normal_action_plugin>` and passes the name, variables, and other information about the task and play to that Action Plugin for further processing." +msgstr "TaskExecutor ã¯ã€:term:`playbook <playbooks>` (:command:`/usr/bin/ansible` ã®å ´åˆã¯ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³) ã‹ã‚‰è§£æžã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åã¨ãƒ‘ラメーターをå—ã‘å–ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’見ã¦ã€ã¾ãŸã¯ :ref:`Action Plugin <flow_action_plugins>` を見ã¦ã„ã‚‹ã‹ã‚’判æ–ã™ã‚‹ãŸã‚ã«åå‰ã‚’使用ã—ã¾ã™ã€‚モジュールã®å ´åˆã¯ã€:ref:`Normal Action Plugin <flow_normal_action_plugin>` ã‚’èªã¿è¾¼ã¿ã€ã‚¿ã‚¹ã‚¯ã¨ãƒ—レイã«é–¢ã™ã‚‹åå‰ã€å¤‰æ•°ã€ãŠã‚ˆã³ãã®ä»–ã®æƒ…å ±ã‚’ãã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãƒ—ラグインã«æ¸¡ã—ã¦ã€ã•ã‚‰ã«å‡¦ç†ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:186 msgid "The ``normal`` action plugin" @@ -6751,7 +6370,7 @@ msgid ":code:`\"<<INCLUDE_ANSIBLE_MODULE_COMPLEX_ARGS>>\"` is substituted with a msgstr ":code:`\"<<INCLUDE_ANSIBLE_MODULE_COMPLEX_ARGS>>\"` ã¯ã€:term:`JSON` ã§ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‰ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‘ラメーター㮠Python ``repr`` ã®æ–‡å—列ã«ç½®ãæ›ãˆã¾ã™ã€‚JSON æ–‡å—列㧠``repr`` を使用ã™ã‚‹ã¨ã€Python ファイルã«å®‰å…¨ã«åŸ‹ã‚込むã“ã¨ãŒã§ãã¾ã™ã€‚Ansiballz フレームワークã®æ–°ã—ã„スタイル Python モジュールã§ã¯ã€`AnsibleModule` をインスタンス化ã—ã¦ã‹ã‚‰ :attr:`AnsibleModule.params` を使用ã™ã‚‹ã“ã¨ã§ã€ã“ã‚Œã¯ã‚ˆã‚Šé©åˆ‡ã«ã‚¢ã‚¯ã‚»ã‚¹ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:281 -msgid ":code:`<<SELINUX_SPECIAL_FILESYSTEMS>>` substitutes a string which is a comma separated list of file systems which have a file system dependent security context in SELinux. In new-style Python modules, if you really need this you should instantiate an `AnsibleModule` and then use :attr:`AnsibleModule._selinux_special_fs`. The variable has also changed from a comma separated string of file system names to an actual python list of filesystem names." +msgid ":code:`<<SELINUX_SPECIAL_FILESYSTEMS>>` substitutes a string which is a comma-separated list of file systems which have a file system dependent security context in SELinux. In new-style Python modules, if you really need this you should instantiate an `AnsibleModule` and then use :attr:`AnsibleModule._selinux_special_fs`. The variable has also changed from a comma-separated string of file system names to an actual python list of file system names." msgstr ":code:`<<SELINUX_SPECIAL_FILESYSTEMS>>` ã¯ã€SELinux ã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã«ä¾å˜ã™ã‚‹ã‚»ã‚ュリティーコンテã‚ストãŒã‚るファイルシステムã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®ä¸€è¦§ã§ã‚ã‚‹æ–‡å—列を置ãæ›ãˆã¾ã™ã€‚æ–°ã—ã„スタイル㮠Python モジュール㧠`AnsibleModule` をインスタンス化ã—ã¦ã‹ã‚‰ã€:attr:`AnsibleModule._selinux_special_fs` を使用ã—ã¦ãã ã•ã„。ã¾ãŸã€ã“ã®å¤‰æ•°ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®æ–‡å—列ã‹ã‚‰ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ åã®å®Ÿéš›ã® python ã®ãƒªã‚¹ãƒˆã«å¤‰æ›´ã•ã‚Œã¦ã„ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:288 @@ -6775,7 +6394,7 @@ msgid "Ansible wraps the zipfile in the Python script for two reasons:" msgstr "Ansible ㌠Python スクリプト㧠zip ファイルをラップã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã® 2 ã¤ã®ç†ç”±ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:324 -msgid "for compatibility with Python 2.6 which has a less functional version of Python's ``-m`` command line switch." +msgid "for compatibility with Python 2.6 which has a less functional version of Python's ``-m`` command-line switch." msgstr "Python ã® ``-m`` コマンドラインスイッãƒã®æ©Ÿèƒ½ãŒå°‘ãªã„ Python 2.6 ã¨ã®äº’æ›æ€§ã®ãŸã‚。" #: ../../rst/dev_guide/developing_program_flow_modules.rst:327 @@ -6783,271 +6402,372 @@ msgid "so that pipelining will function properly. Pipelining needs to pipe the P msgstr "パイプ処ç†ãŒé©åˆ‡ã«æ©Ÿèƒ½ã—ã¾ã™ã€‚Pipelining 㯠Python モジュールをリモートノード上㮠Python インタープリターã«ãƒ‘イプã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Python 㯠stdin ã®ã‚¹ã‚¯ãƒªãƒ—トをç†è§£ã—ã¾ã™ãŒã€zip ファイルをç†è§£ã—ã¾ã›ã‚“。" #: ../../rst/dev_guide/developing_program_flow_modules.rst:331 -msgid "Prior to Ansible 2.7, the module was executed via a second Python interpreter instead of being executed inside of the same process. This change was made once Python-2.4 support was dropped to speed up module execution." -msgstr "Ansible 2.7 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€åŒã˜ãƒ—ãƒã‚»ã‚¹å†…ã§å®Ÿè¡Œã•ã‚Œã‚‹ã®ã§ã¯ãªã 2 ã¤ç›®ã® Python インタープリター経由ã§å®Ÿè¡Œã•ã‚Œã¾ã™ã€‚ã“ã®å¤‰æ›´ã¯ã€Python-2.4 サãƒãƒ¼ãƒˆãŒç ´æ£„ã•ã‚Œã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å®Ÿè¡Œã®ã‚¹ãƒ”ードを高ã‚ã¾ã—ãŸã€‚" +msgid "Prior to Ansible 2.7, the module was executed by a second Python interpreter instead of being executed inside of the same process. This change was made once Python-2.4 support was dropped to speed up module execution." +msgstr "Ansible 2.7 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€åŒã˜ãƒ—ãƒã‚»ã‚¹å†…ã§å®Ÿè¡Œã•ã‚Œã‚‹ã®ã§ã¯ãªã 2 ã¤ç›®ã® Python インタープリター経由ã§å®Ÿè¡Œã•ã‚Œã¦ã„ã¾ã—ãŸã€‚ã“ã®å¤‰æ›´ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Ÿè¡Œã‚’高速化ã™ã‚‹ãŸã‚ã«ã€Python-2.4 ã®ã‚µãƒãƒ¼ãƒˆãŒæ‰“ã¡åˆ‡ã‚‰ã‚ŒãŸæ™‚点ã§è¡Œã‚ã‚Œã¾ã—ãŸã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst:335 msgid "In Ansiballz, any imports of Python modules from the :py:mod:`ansible.module_utils` package trigger inclusion of that Python file into the zipfile. Instances of :code:`#<<INCLUDE_ANSIBLE_MODULE_COMMON>>` in the module are turned into :code:`from ansible.module_utils.basic import *` and :file:`ansible/module-utils/basic.py` is then included in the zipfile. Files that are included from :file:`module_utils` are themselves scanned for imports of other Python modules from :file:`module_utils` to be included in the zipfile as well." msgstr "Ansiballzã§ã¯ã€:py:mod:`ansible.module_utils` パッケージã‹ã‚‰ã® Python モジュールã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã«ã‚ˆã‚Šã€ãã® Python ファイル㌠zip ファイルã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚モジュール内㮠:code:`#<<INCLUDE_ANSIBLE_MODULE_COMMON>>` ã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã¯ :code:`from ansible.module_utils.basic import *` ã«å¤‰æ›ã•ã‚Œã€ãã®å¾Œ :file:`ansible/module-utils/basic.py` ㌠zip ファイルã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚:file:`module_utils` ã‹ã‚‰è¿½åŠ ã•ã‚Œã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€ãれ自体㌠:file:`module_utils` ã‹ã‚‰ã®ä»–ã® Python モジュールã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’スã‚ャンã—ã€åŒã˜ã‚ˆã†ã« zip ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:345 -msgid "At present, the Ansiballz Framework cannot determine whether an import should be included if it is a relative import. Always use an absolute import that has :py:mod:`ansible.module_utils` in it to allow Ansiballz to determine that the file should be included." -msgstr "ç¾çŠ¶ã€Aweraiballz Framework ã¯ã€ç›¸å¯¾ã‚¤ãƒ³ãƒãƒ¼ãƒˆã®å ´åˆã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚‹ã‹ã©ã†ã‹ã‚’判別ã§ãã¾ã›ã‚“。常ã«ã€ãã®ä¸ã« :py:mod:`ansible.module_utils` ãŒã‚る絶対インãƒãƒ¼ãƒˆã‚’使用ã—ã¦ã€ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åŒæ¢±ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã¨åˆ¤æ–ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" - -#: ../../rst/dev_guide/developing_program_flow_modules.rst:354 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:348 msgid "Passing args" msgstr "引数を渡ã™" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:356 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:350 msgid "Arguments are passed differently by the two frameworks:" msgstr "以下㮠2 ã¤ã®ãƒ•ãƒ¬ãƒ¼ãƒ ワークã§ã¯ã€å¼•æ•°ã®æ¸¡ã—æ–¹ãŒç•°ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:358 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:352 msgid "In :ref:`module_replacer`, module arguments are turned into a JSON-ified string and substituted into the combined module file." msgstr ":ref:`module_replacer` ã§ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å¼•æ•°ã¯ JSON 化ã•ã‚ŒãŸæ–‡å—列ã«å¤‰æ›ã•ã‚Œã€çµåˆã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:359 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:353 msgid "In :ref:`Ansiballz`, the JSON-ified string is part of the script which wraps the zipfile. Just before the wrapper script imports the Ansible module as ``__main__``, it monkey-patches the private, ``_ANSIBLE_ARGS`` variable in ``basic.py`` with the variable values. When a :class:`ansible.module_utils.basic.AnsibleModule` is instantiated, it parses this string and places the args into :attr:`AnsibleModule.params` where it can be accessed by the module's other code." msgstr ":ref:`Ansiballz` ã§ã¯ã€JSON 化ã•ã‚ŒãŸæ–‡å—列ã¯ã€zip ファイルをラップã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トã®ä¸€éƒ¨ã§ã™ã€‚ラッパースクリプト㌠Ansible モジュールを ``__main__`` ã¨ã—ã¦ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ç›´å‰ã«ã€``basic.py`` ã®ãƒ—ライベート変数 ``_ANSIBLE_ARGS`` を変数値ã§ãƒ¢ãƒ³ã‚ーパッãƒã—ã¦ã„ã¾ã™ã€‚:class:`ansible.module_utils.basic.AnsibleModule` ãŒã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹åŒ–ã•ã‚Œã‚‹ã¨ã€ã“ã®æ–‡å—列を解æžã—ã€å¼•æ•°ã‚’ :attr:`AnsibleModule.params` ã«é…ç½®ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ä»–ã®ã‚³ãƒ¼ãƒ‰ãŒã‚¢ã‚¯ã‚»ã‚¹ã§ãã‚‹å ´æ‰€ã«ç½®ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:362 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:356 msgid "If you are writing modules, remember that the way we pass arguments is an internal implementation detail: it has changed in the past and will change again as soon as changes to the common module_utils code allow Ansible modules to forgo using :class:`ansible.module_utils.basic.AnsibleModule`. Do not rely on the internal global ``_ANSIBLE_ARGS`` variable." msgstr "モジュールを作æˆã—ã¦ã„ã‚‹å ´åˆã¯ã€å¼•æ•°ã‚’渡ã™æ–¹æ³•ã¯å†…部実装ã®è©³ç´°ã§ã‚ã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。ã“ã‚Œã¯éŽåŽ»ã«å¤‰æ›´ã•ã‚Œã¦ãŠã‚Šã€å…±é€šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã‚³ãƒ¼ãƒ‰ã‚’変更ã™ã‚‹ã¨ã€Ansible モジュール㌠:class:`ansible.module_utils.basic.AnsibleModule` ã®ä½¿ç”¨ã‚’ã‚„ã‚ã‚‹ã¨ã™ãã«å†ã³å¤‰æ›´ã•ã‚Œã¾ã™ã€‚内部グãƒãƒ¼ãƒãƒ«å¤‰æ•° ``_ANSIBLE_ARGS`` ã«ä¾å˜ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:365 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:359 msgid "Very dynamic custom modules which need to parse arguments before they instantiate an ``AnsibleModule`` may use ``_load_params`` to retrieve those parameters. Although ``_load_params`` may change in breaking ways if necessary to support changes in the code, it is likely to be more stable than either the way we pass parameters or the internal global variable." msgstr "``AnsibleModule`` をインスタンス化ã™ã‚‹å‰ã«å¼•æ•°ã‚’解æžã™ã‚‹å¿…è¦ã®ã‚ã‚‹éžå¸¸ã«å‹•çš„ãªã‚«ã‚¹ã‚¿ãƒ モジュールã¯ã€``_load_params`` を使用ã—ã¦ã“れらã®ãƒ‘ラメーターをå–å¾—ã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚コードã®å¤‰æ›´ã‚’サãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€``_load_params`` ãŒç ´å£Šçš„ãªæ–¹æ³•ã§å¤‰æ›´ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€ãƒ‘ラメーターã¾ãŸã¯å†…部グãƒãƒ¼ãƒãƒ«å¤‰æ•°ã‚’渡ã™æ–¹æ³•ã‚ˆã‚Šã‚‚安定ã—ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:371 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:365 msgid "Prior to Ansible 2.7, the Ansible module was invoked in a second Python interpreter and the arguments were then passed to the script over the script's stdin." msgstr "Ansible 2.7 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€Ansible モジュール㯠2 番目㮠Python インタープリターã§å‘¼ã³å‡ºã•ã‚Œã€å¼•æ•°ã¯ã‚¹ã‚¯ãƒªãƒ—トã®æ¨™æº–入力 (stdin) を介ã—ã¦ã‚¹ã‚¯ãƒªãƒ—トã«æ¸¡ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:378 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:372 msgid "Internal arguments" msgstr "内部引数" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:380 -msgid "Both :ref:`module_replacer` and :ref:`Ansiballz` send additional arguments to the module beyond those which the user specified in the playbook. These additional arguments are internal parameters that help implement global Ansible features. Modules often do not need to know about these explicitly as the features are implemented in :py:mod:`ansible.module_utils.basic` but certain features need support from the module so it's good to know about them." -msgstr ":ref:`module_replacer` ãŠã‚ˆã³ :ref:`Ansiballz` ã®ä¸¡æ–¹ã¯ã€Playbook ã§æŒ‡å®šã—ãŸãƒ¦ãƒ¼ã‚¶ãƒ¼ä»¥å¤–ã«è¿½åŠ ã®å¼•æ•°ã‚’モジュールã«é€ä¿¡ã—ã¾ã™ã€‚ã“れらã®è¿½åŠ ã®å¼•æ•°ã¯ã€Ansible ã®ã‚°ãƒãƒ¼ãƒãƒ«æ©Ÿèƒ½ã®å®Ÿè£…ã«å½¹ç«‹ã¤å†…部パラメーターã§ã™ã€‚ã“れらã®æ©Ÿèƒ½ã¯ã€:py:mod:`ansible.module_utils.basic` ã«å®Ÿè£…ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒæ˜Žç¤ºçš„ã«ç†è§£ã™ã‚‹å¿…è¦ãŒãªã„ã“ã¨ãŒã—ã°ã—ã°ã‚ã‚Šã¾ã™ãŒã€æ©Ÿèƒ½ã«ã¤ã„ã¦ã‚る程度ç†è§£ã§ãるよã†ã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰ç‰¹å®šã®æ©Ÿèƒ½ã®ã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:374 +msgid "Both :ref:`module_replacer` and :ref:`Ansiballz` send additional arguments to the Ansible module beyond those which the user specified in the playbook. These additional arguments are internal parameters that help implement global Ansible features. Modules often do not need to know about these explicitly because the features are implemented in :py:mod:`ansible.module_utils.basic`. However, certain features need support from modules and some knowledge of the internal arguments is useful." +msgstr ":ref:`module_replacer` ãŠã‚ˆã³ :ref:`Ansiballz` ã®ä¸¡æ–¹ã¯ã€Playbook ã§æŒ‡å®šã—ãŸãƒ¦ãƒ¼ã‚¶ãƒ¼ä»¥å¤–ã«è¿½åŠ ã®å¼•æ•°ã‚’ Ansible モジュールã«é€ä¿¡ã—ã¾ã™ã€‚ã“れらã®è¿½åŠ ã®å¼•æ•°ã¯ã€Ansible ã®ã‚°ãƒãƒ¼ãƒãƒ«æ©Ÿèƒ½ã®å®Ÿè£…ã«å½¹ç«‹ã¤å†…部パラメーターã§ã™ã€‚ã“れらã®æ©Ÿèƒ½ã¯ã€:py:mod:`ansible.module_utils.basic` ã«å®Ÿè£…ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒæ˜Žç¤ºçš„ã«ç†è§£ã™ã‚‹å¿…è¦ãŒãªã„ã“ã¨ãŒã—ã°ã—ã°ã‚ã‚Šã¾ã™ã€‚ãŸã ã—ã€ç‰¹å®šã®æ©Ÿèƒ½ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰ã®ã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã‚ã‚Šã€å†…部引数ã«é–¢ã™ã‚‹çŸ¥è˜ã¯æœ‰ç”¨ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:387 -msgid "The internal arguments listed here are global. If you need to add a local internal argument to a custom module, create an action plugin for that specific module - see ``_original_basename`` in the `copy action plugin <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/action/copy.py#L329>`_ for an example." -msgstr "ã“ã“ã«è¨˜è¼‰ã•ã‚Œã¦ã„る内部引数ã¯ã‚°ãƒãƒ¼ãƒãƒ«ã§ã™ã€‚カスタムモジュールã«ãƒãƒ¼ã‚«ãƒ«ã®å†…éƒ¨å¼•æ•°ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€ãã®ç‰¹å®šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã« action プラグインを作æˆã—ã¦ãã ã•ã„。例ã¯ã€ã€Œ`copy action plugin <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/action/copy.py#L329>`_ã€ã®ã€Œ``_original_basename``ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:381 +msgid "The internal arguments in this section are global. If you need to add a local internal argument to a custom module, create an action plugin for that specific module. See ``_original_basename`` in the `copy action plugin <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/action/copy.py#L329>`_ for an example." +msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã«è¨˜è¼‰ã•ã‚Œã¦ã„る内部引数ã¯ã‚°ãƒãƒ¼ãƒãƒ«ã§ã™ã€‚カスタムモジュールã«ãƒãƒ¼ã‚«ãƒ«ã®å†…éƒ¨å¼•æ•°ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€ãã®ç‰¹å®šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã« action プラグインを作æˆã—ã¦ãã ã•ã„。ãã®ä¾‹ã¨ã—ã¦ã€`copy action plugin <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/action/copy.py#L329>`_ ã® ``_original_basename`` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:390 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:385 msgid "_ansible_no_log" msgstr "_ansible_no_log" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:392 -msgid "Boolean. Set to True whenever a parameter in a task or play specifies ``no_log``. Any module that calls :py:meth:`AnsibleModule.log` handles this automatically. If a module implements its own logging then it needs to check this value. To access in a module, instantiate an ``AnsibleModule`` and then check the value of :attr:`AnsibleModule.no_log`." -msgstr "ブール値。タスクã¾ãŸã¯ãƒ—レイã®ãƒ‘ラメーターを ``no_log`` ã«æŒ‡å®šã—ãŸå ´åˆã¯å¸¸ã« True ã«è¨å®šã—ã¾ã™ã€‚:py:meth:`AnsibleModule.log` を呼ã³å‡ºã™ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒè‡ªå‹•çš„ã«ã“れを処ç†ã—ã¾ã™ã€‚モジュールãŒãã®ç‹¬è‡ªã®ãƒã‚®ãƒ³ã‚°ã‚’実装ã—ãŸå ´åˆã¯ã€ã“ã®å€¤ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule.no_log` ã®å€¤ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:387 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:398 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:406 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:480 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:493 +msgid "Type: ``bool``" +msgstr "タイプ: ``bool``" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:397 -msgid "``no_log`` specified in a module's argument_spec is handled by a different mechanism." -msgstr "モジュール㮠argument_spec ã§æŒ‡å®šã•ã‚ŒãŸ ``no_log`` ã¯åˆ¥ã®ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã§å‡¦ç†ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:389 +msgid "Set to ``True`` whenever an argument in a task or play specifies ``no_log``. Any module that calls the :py:meth:`AnsibleModule.log` function handles this action automatically. If you have a module that implements its own logging then you need to check the value of ``_ansible_no_log``. To access ``_ansible_no_log`` in a module, instantiate the ``AnsibleModule`` utility and then check the value of :attr:`AnsibleModule.no_log`." +msgstr "タスクã¾ãŸã¯ãƒ—レイã®å¼•æ•°ãŒ ``no_log`` を指定ã—ãŸå ´åˆã¯ ``True`` ã«è¨å®šã—ã¾ã™ã€‚:py:meth:`AnsibleModule.log` 関数を呼ã³å‡ºã™ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã“ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã‚’自動的ã«å‡¦ç†ã—ã¾ã™ã€‚独自ã®ãƒã‚®ãƒ³ã‚°ã‚’実装ã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€``_ansible_no_log`` ã®å€¤ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュール内㮠``_ansible_no_log`` ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` ユーティリティーをインスタンス化ã—ã¦ã‹ã‚‰ :attr:`AnsibleModule.no_log` ã®å€¤ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:400 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:392 +msgid "``no_log`` specified in a module's ``argument_spec`` is handled by a different mechanism." +msgstr "モジュール㮠``argument_spec`` ã§æŒ‡å®šã•ã‚ŒãŸ ``no_log`` ã¯ã€åˆ¥ã®ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã§å‡¦ç†ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:396 msgid "_ansible_debug" msgstr "_ansible_debug" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:402 -msgid "Boolean. Turns more verbose logging on or off and turns on logging of external commands that the module executes. If a module uses :py:meth:`AnsibleModule.debug` rather than :py:meth:`AnsibleModule.log` then the messages are only logged if ``_ansible_debug`` is set to ``True``. To set, add ``debug: True`` to :file:`ansible.cfg` or set the environment variable :envvar:`ANSIBLE_DEBUG`. To access in a module, instantiate an ``AnsibleModule`` and access :attr:`AnsibleModule._debug`." -msgstr "ブール値。詳細ãªãƒã‚®ãƒ³ã‚°ã‚’オンã¾ãŸã¯ã‚ªãƒ•ã«ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå®Ÿè¡Œã™ã‚‹å¤–部コマンドã®ãƒã‚®ãƒ³ã‚°ã‚’有効ã«ã—ã¾ã™ã€‚モジュール㌠:py:meth:`AnsibleModule.log` ã§ã¯ãªã :py:meth:`AnsibleModule.debug` を使用ã™ã‚‹å ´åˆã¯ã€``_ansible_debug`` ㌠``True`` ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã®ã¿ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒãƒã‚°ã«è¨˜éŒ²ã•ã‚Œã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€``debug: True`` ã‚’ :file:`ansible.cfg` ã«è¿½åŠ ã™ã‚‹ã‹ã€ç’°å¢ƒå¤‰æ•° :envvar:`ANSIBLE_DEBUG` ã‚’è¨å®šã—ã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã€:attr:`AnsibleModule._debug` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:400 +msgid "Operates verbose logging and logging of external commands that a module executes. If the module uses the :py:meth:`AnsibleModule.debug` function rather than the :py:meth:`AnsibleModule.log` function then the messages are only logged if you set the ``_ansible_debug`` argument to ``True``. To access ``_ansible_debug`` in a module, instantiate the ``AnsibleModule`` utility and access :attr:`AnsibleModule._debug`. For more details, see :ref:`DEFAULT_DEBUG`." +msgstr "詳細ãƒã‚®ãƒ³ã‚°ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå®Ÿè¡Œã™ã‚‹å¤–部コマンドã®ãƒã‚®ãƒ³ã‚°ã‚’æ“作ã—ã¾ã™ã€‚モジュールãŒã€:py:meth:`AnsibleModule.log` 関数ã§ã¯ãªã :py:meth:`AnsibleModule.debug` 関数を使用ã™ã‚‹å ´åˆã€``_ansible_debug`` 引数を ``True`` ã«è¨å®šã—ãªã‘ã‚Œã°ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯ãƒã‚°ã«è¨˜éŒ²ã•ã‚Œã¾ã›ã‚“。モジュール㮠``_ansible_debug`` ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` ユーティリティーをインスタンス化ã—ã€:attr:`AnsibleModule._debug` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¾ã™ã€‚詳細㯠:ref:`DEFAULT_DEBUG` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:411 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:404 msgid "_ansible_diff" msgstr "_ansible_diff" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:413 -msgid "Boolean. If a module supports it, tells the module to show a unified diff of changes to be made to templated files. To set, pass the ``--diff`` command line option. To access in a module, instantiate an `AnsibleModule` and access :attr:`AnsibleModule._diff`." -msgstr "ブール値。モジュールãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å¯¾ã—ã€ãƒ†ãƒ³ãƒ—レート化ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã«åŠ ãˆã‚‰ã‚ŒãŸå¤‰æ›´ã®å·®ç•°ã‚’çµ±åˆã™ã‚‹ã‚ˆã†ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æŒ‡ç¤ºã—ã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€``--diff`` コマンドラインオプションを渡ã—ã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€`AnsibleModule` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule._diff` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:408 +msgid "With this parameter you can configure your module to show a unified diff of changes that will be applied to the templated files. To access ``_ansible_diff`` in a module, instantiate the ``AnsibleModule`` utility and access :attr:`AnsibleModule._diff`. You can also access this parameter using the ``diff`` keyword in your playbook, or the relevant environment variable. For more details, see :ref:`playbook_keywords` and the :ref:`DIFF_ALWAYS` configuration option." +msgstr "ã“ã®ãƒ‘ラメーターを使用ã™ã‚‹ã¨ã€ãƒ†ãƒ³ãƒ—レート化ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã«é©ç”¨ã•ã‚Œã‚‹å¤‰æ›´ã®çµ±åˆå·®åˆ†ã‚’表示ã™ã‚‹ã‚ˆã†ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’è¨å®šã§ãã¾ã™ã€‚モジュール㮠``_ansible_diff`` ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` ユーティリティーをインスタンス化ã—ã€:attr:`AnsibleModule._diff` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¾ã™ã€‚ã“ã®ãƒ‘ラメーターã«ã¯ã€Playbook ã® ``diff`` ã‚ーワードを使用ã™ã‚‹ã‹ã€é–¢é€£ã™ã‚‹ç’°å¢ƒå¤‰æ•°ã‚’使用ã—ã¦ã‚‚アクセスã§ãã¾ã™ã€‚詳細ã¯ã€:ref:`playbook_keywords` ãŠã‚ˆã³ :ref:`DIFF_ALWAYS` è¨å®šã‚ªãƒ—ションをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:419 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:412 msgid "_ansible_verbosity" msgstr "_ansible_verbosity" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:421 -msgid "Unused. This value could be used for finer grained control over logging." -msgstr "未使用。ã“ã®å€¤ã¯ã€ãƒã‚°ã‚’より細ã‹ã制御ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:414 +msgid "Type: ``int``" +msgstr "タイプ: ``int``" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:424 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:416 +msgid "You can use this argument to control the level (0 for none) of verbosity in logging." +msgstr "ã“ã®å¼•æ•°ã‚’使用ã—ã¦ã€ãƒã‚®ãƒ³ã‚°ã®è©³ç´°ãƒ¬ãƒ™ãƒ« (ãªã—ã®å ´åˆã¯ 0) を制御ã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:420 msgid "_ansible_selinux_special_fs" msgstr "_ansible_selinux_special_fs" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:426 -msgid "List. Names of filesystems which should have a special SELinux context. They are used by the `AnsibleModule` methods which operate on files (changing attributes, moving, and copying). To set, add a comma separated string of filesystem names in :file:`ansible.cfg`:" -msgstr "一覧。特別㪠SELinux コンテã‚ストをæŒã¤å¿…è¦ãŒã‚るファイルシステムã®åå‰ã€‚åå‰ã¯ãƒ•ã‚¡ã‚¤ãƒ« (属性ã®å¤‰æ›´ã€ç§»å‹•ã€ã‚³ãƒ”ー) ã§æ“作ã™ã‚‹ `AnsibleModule` メソッドã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€:file:`ansible.cfg` ã«ã€ãƒ•ã‚¡ã‚¤ãƒ«åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®æ–‡å—åˆ—ã‚’è¿½åŠ ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:422 +msgid "Type: ``list`` Elements: ``strings``" +msgstr "タイプ: ``list`` è¦ç´ : ``strings``" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:425 +msgid "This argument provides modules with the names of file systems which should have a special SELinux context. They are used by the ``AnsibleModule`` methods which operate on files (changing attributes, moving, and copying)." +msgstr "ã“ã®å¼•æ•°ã¯ã€ç‰¹åˆ¥ãª SELinux コンテã‚ストをæŒã¤å¿…è¦ãŒã‚るファイルシステムã®åå‰ã‚’モジュールã«æä¾›ã—ã¾ã™ã€‚ãれらã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã§æ“作ã™ã‚‹ ``AnsibleModule`` メソッド (属性ã®å¤‰æ›´ã€ç§»å‹•ã€ãŠã‚ˆã³ã‚³ãƒ”ー) ã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:436 -msgid "Most modules can use the built-in ``AnsibleModule`` methods to manipulate files. To access in a module that needs to know about these special context filesystems, instantiate an ``AnsibleModule`` and examine the list in :attr:`AnsibleModule._selinux_special_fs`." -msgstr "ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚’æ“作ã™ã‚‹çµ„ã¿è¾¼ã¿ ``AnsibleModule`` メソッドを使用ã§ãã¾ã™ã€‚ã“れらã®ç‰¹åˆ¥ãªã‚³ãƒ³ãƒ†ã‚ストファイルシステムã«ã¤ã„ã¦çŸ¥ã‚‹å¿…è¦ãŒã‚るモジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã€:attr:`AnsibleModule._selinux_special_fs` ã§ãƒªã‚¹ãƒˆã‚’調ã¹ã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:427 +msgid "Most modules can use the built-in ``AnsibleModule`` methods to manipulate files. To access in a module that needs to know about these special context file systems, instantiate ``AnsibleModule`` and examine the list in :attr:`AnsibleModule._selinux_special_fs`." +msgstr "ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ“ルトイン ``AnsibleModule`` メソッドを使用ã—ã¦ãƒ•ã‚¡ã‚¤ãƒ«ã‚’æ“作ã§ãã¾ã™ã€‚ã“れらã®ç‰¹åˆ¥ãªã‚³ãƒ³ãƒ†ã‚ストファイルシステムã«ã¤ã„ã¦çŸ¥ã‚‹å¿…è¦ãŒã‚るモジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã€:attr:`AnsibleModule._selinux_special_fs` ã§ãƒªã‚¹ãƒˆã‚’調ã¹ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:440 -msgid "This replaces :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` from :ref:`module_replacer`. In module replacer it was a comma separated string of filesystem names. Under Ansiballz it's an actual list." -msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€:ref:`module_replacer` ã® :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚モジュール置æ›ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®æ–‡å—列ã§ã—ãŸã€‚Ansiballz ã¯ã€å®Ÿéš›ã®ãƒªã‚¹ãƒˆã«ãªã‚Šã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:429 +msgid "This argument replaces :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` from :ref:`module_replacer`. In the module replacer framework the argument was formatted as a comma-separated string of file system names. Under the Ansiballz framework it is a list. You can access ``_ansible_selinux_special_fs`` using the corresponding environment variable. For more details, see the :ref:`DEFAULT_SELINUX_SPECIAL_FS` configuration option." +msgstr "ã“ã®å¼•æ•°ã¯ã€:ref:`module_replacer` ã‹ã‚‰ :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚モジュール置æ›ãƒ•ãƒ¬ãƒ¼ãƒ ワークã§ã¯ã€å¼•æ•°ã¯ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šæ–‡å—列ã¨ã—ã¦ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã•ã‚Œã¦ã„ã¾ã—ãŸã€‚リスト㯠Ansiballz フレームワークã®ä¸‹ã«ã‚ã‚Šã¾ã™ã€‚対応ã™ã‚‹ç’°å¢ƒå¤‰æ•°ã‚’使用ã™ã‚‹ã¨ã€``_ansible_selinux_special_fs`` ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚詳細ã¯ã€:ref:`DEFAULT_SELINUX_SPECIAL_FS` è¨å®šã‚ªãƒ—ションをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:447 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:435 msgid "_ansible_syslog_facility" msgstr "_ansible_syslog_facility" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:449 -msgid "This parameter controls which syslog facility Ansible module logs to. To set, change the ``syslog_facility`` value in :file:`ansible.cfg`. Most modules should just use :meth:`AnsibleModule.log` which will then make use of this. If a module has to use this on its own, it should instantiate an `AnsibleModule` and then retrieve the name of the syslog facility from :attr:`AnsibleModule._syslog_facility`. The Ansiballz code is less hacky than the old :ref:`module_replacer` code:" -msgstr "ã“ã®ãƒ‘ラメーターã¯ã€Ansible モジュールãŒã©ã® syslog 機能ã«ãƒã‚°ã‚’記録ã™ã‚‹ã‹ã‚’制御ã—ã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€:file:`ansible.cfg` ã® ``syslog_facility`` ã®å€¤ã‚’変更ã—ã¾ã™ã€‚多ãã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã“れを利用ã™ã‚‹ :meth:`AnsibleModule.log` ã®ã¿ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュールãŒç‹¬è‡ªã«ã“れを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€`AnsibleModule` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule._syslog_facility` ã‹ã‚‰ syslog 機能ã®åå‰ã‚’å–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Ansiballz コードã¯å¤ã„ :ref:`module_replacer` コードよりもãƒãƒƒã‚ングã•ã‚Œã¾ã›ã‚“。" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:437 +msgid "This argument controls which syslog facility the module logs to. Most modules should just use the :meth:`AnsibleModule.log` function which will then make use of this. If a module has to use this on its own, it should instantiate the ``AnsibleModule`` method and then retrieve the name of the syslog facility from :attr:`AnsibleModule._syslog_facility`. The Ansiballz code is less elegant than the :ref:`module_replacer` code:" +msgstr "ã“ã®å¼•æ•°ã¯ã€ã©ã® syslog 機能ã«ãƒã‚°ã‚’記録ã™ã‚‹ã‹ã‚’制御ã—ã¾ã™ã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã“れを使用ã™ã‚‹ :meth:`AnsibleModule.log` 関数を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュールãŒã“れを独自ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€``AnsibleModule`` メソッドをインスタンス化ã—ã¦ã‹ã‚‰ã€:attr:`AnsibleModule._syslog_facility` ã‹ã‚‰ syslog ファシリティーã®åå‰ã‚’å–å¾—ã—ã¾ã™ã€‚Ansiballz コードã¯ã€:ref:`module_replacer`コードã»ã©çš„確ã§ã¯ã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:451 +msgid "For more details, see the :ref:`DEFAULT_SYSLOG_FACILITY` configuration option." +msgstr "詳細ã¯ã€:ref:`DEFAULT_SYSLOG_FACILITY` è¨å®šã‚ªãƒ—ションをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:470 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:457 msgid "_ansible_version" msgstr "_ansible_version" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:472 -msgid "This parameter passes the version of Ansible that runs the module. To access it, a module should instantiate an `AnsibleModule` and then retrieve it from :attr:`AnsibleModule.ansible_version`. This replaces :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` from :ref:`module_replacer`." -msgstr "ã“ã®ãƒ‘ラメーターã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã™ã‚‹ Ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’渡ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãŸã‚ã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ `AnsibleModule` をインスタンス化ã—ã€:attr:`AnsibleModule.ansible_version` ã‹ã‚‰å–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€:ref:`module_replacer` ã® :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:459 +msgid "This argument passes the version of Ansible to the module. To access it, a module should instantiate the ``AnsibleModule`` method and then retrieve the version from :attr:`AnsibleModule.ansible_version`. This replaces :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` from :ref:`module_replacer`." +msgstr "ã“ã®å› æ•°ã¯ã€Ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’モジュールã«æ¸¡ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``AnsibleModule`` メソッドをインスタンス化ã—ã¦ã‹ã‚‰ã€:attr:`AnsibleModule.ansible_version` ã§ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯:ref:`module_replacer` ã® :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:465 +msgid "_ansible_module_name" +msgstr "_ansible_module_name" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:467 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:501 +msgid "Type: ``str``" +msgstr "タイプ: ``str``" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:469 +msgid "This argument passes the information to modules about their name. For more details see, the configuration option :ref:`DEFAULT_MODULE_NAME`." +msgstr "ã“ã®å¼•æ•°ã¯ã€åå‰ã«é–¢ã™ã‚‹æƒ…å ±ã‚’ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æ¸¡ã—ã¾ã™ã€‚詳細ã¯ã€è¨å®šã‚ªãƒ—ション :ref:`DEFAULT_MODULE_NAME` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:473 +msgid "_ansible_string_conversion_action" +msgstr "_ansible_string_conversion_action" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:474 +msgid "This argument provides instructions about what modules should do after the values of the user-specified module parameters are converted to strings. For more details, see the :ref:`STRING_CONVERSION_ACTION` configuration option." +msgstr "ã“ã®å¼•æ•°ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæŒ‡å®šã—ãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‘ラメーターã®å€¤ãŒæ–‡å—列ã«å¤‰æ›ã•ã‚ŒãŸå¾Œã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒä½•ã‚’ã™ã¹ãã‹ã«ã¤ã„ã¦ã®æŒ‡ç¤ºã‚’æä¾›ã—ã¾ã™ã€‚詳細ã¯ã€:ref:`STRING_CONVERSION_ACTION` è¨å®šã‚ªãƒ—ションをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:478 +msgid "_ansible_keep_remote_files" +msgstr "_ansible_keep_remote_files" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:482 +msgid "This argument provides instructions that modules must be ready if they need to keep the remote files. For more details, see the :ref:`DEFAULT_KEEP_REMOTE_FILES` configuration option." +msgstr "ã“ã®å¼•æ•°ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãƒªãƒ¢ãƒ¼ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’ä¿æŒã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’準備ã™ã‚‹ãŸã‚ã®æŒ‡ç¤ºã‚’æä¾›ã—ã¾ã™ã€‚詳細㯠:ref:`DEFAULT_KEEP_REMOTE_FILES` è¨å®šã‚ªãƒ—ションをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:486 +msgid "_ansible_socket" +msgstr "_ansible_socket" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:487 +msgid "This argument provides modules with a socket for persistent connections. The argument is created using the :ref:`PERSISTENT_CONTROL_PATH_DIR` configuration option." +msgstr "ã“ã®å› æ•°ã¯ã€æ°¸ç¶šçš„ãªæŽ¥ç¶šã®ãŸã‚ã®ã‚½ã‚±ãƒƒãƒˆã‚’モジュールã«æä¾›ã—ã¾ã™ã€‚ã“ã®å¼•æ•°ã¯ã€:ref:`PERSISTENT_CONTROL_PATH_DIR` è¨å®šã‚ªãƒ—ションを使用ã—ã¦ä½œæˆã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:491 +msgid "_ansible_shell_executable" +msgstr "_ansible_shell_executable" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:484 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:495 +msgid "This argument ensures that modules use the designated shell executable. For more details, see the :ref:`ansible_shell_executable` remote host environment parameter." +msgstr "ã“ã®å¼•æ•°ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒæŒ‡å®šã•ã‚ŒãŸã‚·ã‚§ãƒ«å®Ÿè¡Œå¯èƒ½ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã™ã‚‹ã“ã¨ã‚’ä¿è¨¼ã—ã¾ã™ã€‚詳細ã¯ã€:ref:`ansible_shell_executable` リモートホスト環境パラメーターをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:499 +msgid "_ansible_tmpdir" +msgstr "_ansible_tmpdir" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:503 +msgid "This argument provides instructions to modules that all commands must use the designated temporary directory, if created. The action plugin designs this temporary directory." +msgstr "ã“ã®å¼•æ•°ã¯ã€ä½œæˆã•ã‚ŒãŸå ´åˆã«ã™ã¹ã¦ã®ã‚³ãƒžãƒ³ãƒ‰ãŒæŒ‡å®šã•ã‚ŒãŸä¸€æ™‚ディレクトリーを使用ã™ã‚‹å¿…è¦ãŒã‚るモジュールã¸ã®æŒ‡ç¤ºã‚’æä¾›ã—ã¾ã™ã€‚アクションプラグインã¯ã€ã“ã®ä¸€æ™‚ディレクトリーをè¨è¨ˆã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:505 +msgid "Modules can access this parameter by using the public ``tmpdir`` property. The ``tmpdir`` property will create a temporary directory if the action plugin did not set the parameter." +msgstr "モジュールã¯ã€ãƒ‘ブリック ``tmpdir`` プãƒãƒ‘ティーを使用ã—ã¦ã“ã®ãƒ‘ラメーターã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚アクションプラグインãŒã“ã®ãƒ‘ラメーターをè¨å®šã—ãªã‹ã£ãŸå ´åˆã€``tmpdir`` プãƒãƒ‘ティーã¯ä¸€æ™‚ディレクトリーを作æˆã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:507 +msgid "The directory name is generated randomly, and the the root of the directory is determined by one of these:" +msgstr "ディレクトリーåã¯ãƒ©ãƒ³ãƒ€ãƒ ã«ç”Ÿæˆã•ã‚Œã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã®ãƒ«ãƒ¼ãƒˆã¯æ¬¡ã®ã„ãšã‚Œã‹ã«ã‚ˆã£ã¦æ±ºå®šã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:509 +msgid ":ref:`DEFAULT_LOCAL_TMP`" +msgstr ":ref:`DEFAULT_LOCAL_TMP`" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:510 +msgid "`remote_tmp <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-remote_tmp>`_" +msgstr "`remote_tmp <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-remote_tmp>`_" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:511 +msgid "`system_tmpdirs <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-system_tmpdirs>`_" +msgstr "`system_tmpdirs <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-system_tmpdirs>`_" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:513 +msgid "As a result, using the ``ansible.cfg`` configuration file to activate or customize this setting will not guarantee that you control the full value." +msgstr "ãã®ãŸã‚ã€``ansible.cfg`` è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã—ã¦ã“ã®è¨å®šã‚’アクティブ化ã¾ãŸã¯ã‚«ã‚¹ã‚¿ãƒžã‚¤ã‚ºã—ã¦ã‚‚ã€å®Œå…¨ãªå€¤ã‚’制御ã§ãã‚‹ã¨ã¯é™ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:517 +msgid "_ansible_remote_tmp" +msgstr "_ansible_remote_tmp" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:519 +msgid "The module's ``tmpdir`` property creates a randomized directory name in this directory if the action plugin did not set ``_ansible_tmpdir``. For more details, see the `remote_tmp <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-remote_tmp>`_ parameter of the shell plugin." +msgstr "アクションプラグイン㌠``_ansible_tmpdir`` ã‚’è¨å®šã—ãªã‹ã£ãŸå ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã® ``tmpdir`` プãƒãƒ‘ティーã¯ã€ã“ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼å†…ã§ãƒ©ãƒ³ãƒ€ãƒ 化ã•ã‚ŒãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼åを作æˆã—ã¾ã™ã€‚詳細㯠`remote_tmp <https://docs.ansible.com/ansible/latest/collections/ansible/builtin/sh_shell.html#parameter-remote_tmp>`_ シェルプラグインã®ãƒ‘ラメーターをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:525 msgid "Module return values & Unsafe strings" msgstr "モジュール戻り値ã¨å®‰å…¨ã§ãªã„æ–‡å—列" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:486 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:527 msgid "At the end of a module's execution, it formats the data that it wants to return as a JSON string and prints the string to its stdout. The normal action plugin receives the JSON string, parses it into a Python dictionary, and returns it to the executor." msgstr "モジュールã®å®Ÿè¡Œã®æœ€å¾Œã«ã€è¿”ã—ãŸã„データを JSON æ–‡å—列ã¨ã—ã¦å½¢å¼åŒ–ã—ã€ãã®æ–‡å—列を標準出力 (stdout) ã«å‡ºåŠ›ã—ã¾ã™ã€‚通常㮠action プラグイン㯠JSON æ–‡å—列をå—ã‘å–ã‚Šã€Python ディクショナリーã«è§£æžã—ã¦ã‚¨ã‚¯ã‚¼ã‚ューターã«è¿”ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:488 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:529 msgid "If Ansible templated every string return value, it would be vulnerable to an attack from users with access to managed nodes. If an unscrupulous user disguised malicious code as Ansible return value strings, and if those strings were then templated on the controller, Ansible could execute arbitrary code. To prevent this scenario, Ansible marks all strings inside returned data as ``Unsafe``, emitting any Jinja2 templates in the strings verbatim, not expanded by Jinja2." msgstr "Ansible ãŒã™ã¹ã¦ã®æ–‡å—列ã®æˆ»ã‚Šå€¤ã‚’テンプレート化ã™ã‚‹ã¨ã€ç®¡ç†ãƒŽãƒ¼ãƒ‰ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãるユーザーã‹ã‚‰ã®æ”»æ’ƒã«å¯¾ã—ã¦è„†å¼±ã«ãªã‚Šã¾ã™ã€‚悪æ„ã®ã‚るユーザーãŒæ‚ªæ„ã®ã‚るコードを Ansible ã®æˆ»ã‚Šå€¤ã®æ–‡å—列ã¨ã—ã¦å½è£…ã—ã€ãã®ã‚ˆã†ãªæ–‡å—列ãŒã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ä¸Šã§ãƒ†ãƒ³ãƒ—レート化ã•ã‚Œã‚‹ã¨ã€Ansible ãŒä»»æ„ã®ã‚³ãƒ¼ãƒ‰ã‚’実行ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚·ãƒŠãƒªã‚ªã‚’防ããŸã‚ã«ã€Ansible ã¯æˆ»ã‚Šå€¤ã®ãƒ‡ãƒ¼ã‚¿å†…ã®ã™ã¹ã¦ã®æ–‡å—列を ``Unsafe`` ã¨è¡¨ç¤ºã—ã€æ–‡å—列内㮠Jinja2 テンプレートを Jinja2 ã§å±•é–‹ã›ãšã«ãã®ã¾ã¾ã‚¨ãƒŸãƒƒãƒˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:490 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:531 msgid "Strings returned by invoking a module through ``ActionPlugin._execute_module()`` are automatically marked as ``Unsafe`` by the normal action plugin. If another action plugin retrieves information from a module through some other means, it must mark its return data as ``Unsafe`` on its own." msgstr "``ActionPlugin._execute_module()`` を介ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’呼ã³å‡ºã—ã¦è¿”ã•ã‚ŒãŸæ–‡å—列ã«ã¯ã€é€šå¸¸ã® action プラグインã«ã‚ˆã£ã¦è‡ªå‹•çš„ã« ``Unsafe`` ã¨ã„ã†ãƒžãƒ¼ã‚¯ãŒä»˜ãã¾ã™ã€‚別㮠action プラグインãŒä»–ã®æ–¹æ³•ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰æƒ…å ±ã‚’å–å¾—ã—ãŸå ´åˆã¯ã€ãã® action プラグイン自身ãŒãã®æˆ»ã‚Šå€¤ã« ``Unsafe`` ã¨è¡¨ç¤ºã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:492 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:533 msgid "In case a poorly-coded action plugin fails to mark its results as \"Unsafe,\" Ansible audits the results again when they are returned to the executor, marking all strings as ``Unsafe``. The normal action plugin protects itself and any other code that it calls with the result data as a parameter. The check inside the executor protects the output of all other action plugins, ensuring that subsequent tasks run by Ansible will not template anything from those results either." msgstr "ä¸é©åˆ‡ã«ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã•ã‚ŒãŸ action プラグインãŒçµæžœã‚’「Unsafeã€ã¨è¡¨ç¤ºã—ãªã‹ã£ãŸå ´åˆã€Ansible ã¯ã‚¨ã‚°ã‚¼ã‚ューターã«è¿”ã•ã‚Œã‚‹éš›ã«çµæžœã‚’å†åº¦ç›£æŸ»ã—ã€ã™ã¹ã¦ã®æ–‡å—列を ``Unsafe`` ã¨è¡¨ç¤ºã—ã¾ã™ã€‚通常㮠action プラグインã¯ã€è‡ªèº«ã¨ã€çµæžœãƒ‡ãƒ¼ã‚¿ã‚’パラメーターã¨ã—ã¦å‘¼ã³å‡ºã™ãã®ä»–ã®ã‚³ãƒ¼ãƒ‰ã‚’ä¿è·ã—ã¾ã™ã€‚エクゼã‚ュータ内ã®ãƒã‚§ãƒƒã‚¯ã¯ã€ä»–ã®ã™ã¹ã¦ã® action プラグインã®å‡ºåŠ›ã‚’ä¿è·ã—ã€Ansible ãŒå®Ÿè¡Œã™ã‚‹å¾Œç¶šã®ã‚¿ã‚¹ã‚¯ãŒã“れらã®çµæžœã‹ã‚‰ä½•ã‹ã‚’テンプレート化ã™ã‚‹ã“ã¨ãŒãªã„よã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:498 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:539 msgid "Special considerations" msgstr "特別ãªè€ƒæ…®äº‹é …" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:503 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:544 msgid "Pipelining" msgstr "パイプライン" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:505 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:546 msgid "Ansible can transfer a module to a remote machine in one of two ways:" msgstr "Ansible ã¯ã€ä»¥ä¸‹ã®ã„ãšã‚Œã‹ã®æ–¹æ³•ã§ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’リモートマシンã«è»¢é€ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:507 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:548 msgid "it can write out the module to a temporary file on the remote host and then use a second connection to the remote host to execute it with the interpreter that the module needs" msgstr "ã“ã‚Œã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã®ä¸€æ™‚ファイルã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’書ã込むã“ã¨ãŒã§ãã€æ¬¡ã«ãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã¸ã® 2 番目ã®æŽ¥ç¶šã‚’使用ã—ã¦ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå¿…è¦ã¨ã™ã‚‹ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã§ã“れを実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:510 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:551 msgid "or it can use what's known as pipelining to execute the module by piping it into the remote interpreter's stdin." msgstr "ã¾ãŸã¯ã€ãƒ‘イプラインã¨å‘¼ã°ã‚Œã‚‹ã‚‚ã®ã‚’使用ã—ã¦ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’リモートインタープリター㮠stdin ã«ãƒ‘イプã™ã‚‹ã“ã¨ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:513 -msgid "Pipelining only works with modules written in Python at this time because Ansible only knows that Python supports this mode of operation. Supporting pipelining means that whatever format the module payload takes before being sent over the wire must be executable by Python via stdin." +#: ../../rst/dev_guide/developing_program_flow_modules.rst:554 +msgid "Pipelining only works with modules written in Python at this time because Ansible only knows that Python supports this mode of operation. Supporting pipelining means that whatever format the module payload takes before being sent over the wire must be executable by Python through stdin." msgstr "パイプライン処ç†ã¯ã€ç¾æ™‚点ã§ã¯ Python ã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã®ã¿æ©Ÿèƒ½ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€Python ãŒã“ã®æ“作モードをサãƒãƒ¼ãƒˆã—ã¦ã„ã‚‹ã“ã¨ã®ã¿ã‚’ Ansible ãŒèªè˜ã—ã¦ã„ã‚‹ãŸã‚ã§ã™ã€‚パイプライン化をサãƒãƒ¼ãƒˆã™ã‚‹ã¨ã„ã†ã“ã¨ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒšã‚¤ãƒãƒ¼ãƒ‰ãŒãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯çµŒç”±ã§é€ä¿¡ã•ã‚Œã‚‹å‰ã«å–ã‚‹å½¢å¼ãŒä½•ã§ã‚ã‚Œã€Python ㌠stdin を介ã—ã¦å®Ÿè¡Œå¯èƒ½ã§ãªã‘ã‚Œã°ãªã‚‰ãªã„ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:521 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:562 msgid "Why pass args over stdin?" msgstr "標準入力 (stdin) ã§å¼•æ•°ã‚’渡ã™ç†ç”±" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:523 -msgid "Passing arguments via stdin was chosen for the following reasons:" +#: ../../rst/dev_guide/developing_program_flow_modules.rst:564 +msgid "Passing arguments through stdin was chosen for the following reasons:" msgstr "以下ã®ç†ç”±ã«ã‚ˆã‚Šã€æ¨™æº–入力ã§å¼•æ•°ã‚’渡ã™ã“ã¨ãŒé¸æŠžã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:525 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:566 msgid "When combined with :ref:`ANSIBLE_PIPELINING`, this keeps the module's arguments from temporarily being saved onto disk on the remote machine. This makes it harder (but not impossible) for a malicious user on the remote machine to steal any sensitive information that may be present in the arguments." msgstr ":ref:`ANSIBLE_PIPELINING` ã¨çµ„ã¿åˆã‚ã›ã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å¼•æ•°ã‚’リモートマシン上ã®ãƒ‡ã‚£ã‚¹ã‚¯ã«ä¸€æ™‚çš„ã«ä¿å˜ã—ãŸã¾ã¾ã«ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ä¸Šã®æ‚ªæ„ã®ã‚るユーザーãŒå¼•æ•°ã«å˜åœ¨ã™ã‚‹å¯èƒ½æ€§ã®ã‚ã‚‹æ©Ÿå¯†æƒ…å ±ã‚’ç›—ã‚€ã®ãŒå›°é›£ã«ãªã‚Šã¾ã™ (ä¸å¯èƒ½ã§ã¯ã‚ã‚Šã¾ã›ã‚“)。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:529 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:570 msgid "Command line arguments would be insecure as most systems allow unprivileged users to read the full commandline of a process." msgstr "ã»ã¨ã‚“ã©ã®ã‚·ã‚¹ãƒ†ãƒ ã§ã¯ã€æ¨©é™ã®ãªã„ユーザーãŒãƒ—ãƒã‚»ã‚¹ã®ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³å…¨ä½“ã‚’èªã‚€ã“ã¨ã‚’許å¯ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³å¼•æ•°ã¯å®‰å…¨ã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:531 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:572 msgid "Environment variables are usually more secure than the commandline but some systems limit the total size of the environment. This could lead to truncation of the parameters if we hit that limit." msgstr "環境変数ã¯é€šå¸¸ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ˆã‚Šå®‰å…¨ã§ã™ãŒã€ç’°å¢ƒã®åˆè¨ˆã‚µã‚¤ã‚ºã‚’制é™ã™ã‚‹ã‚·ã‚¹ãƒ†ãƒ ã‚‚ã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ‘ラメーターãŒä¸Šé™ã«é”ã™ã‚‹ã¨ã€ãƒ‘ラメーターãŒåˆ‡ã‚Šæ¨ã¦ã‚‰ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:539 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:580 msgid "AnsibleModule" msgstr "AnsibleModule" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:544 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:585 msgid "Argument spec" msgstr "引数ã®ä»•æ§˜" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:546 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:587 msgid "The ``argument_spec`` provided to ``AnsibleModule`` defines the supported arguments for a module, as well as their type, defaults and more." msgstr "``AnsibleModule`` ã«æä¾›ã•ã‚Œã‚‹ ``argument_spec`` ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹å¼•æ•°ã€ãã®åž‹ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãªã©ã‚’定義ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:548 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:589 msgid "Example ``argument_spec``:" msgstr "``argument_spec`` ã®ä¾‹:" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:564 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:605 msgid "This section will discuss the behavioral attributes for arguments:" msgstr "本セクションã§ã¯ã€å¼•æ•°ã®å‹•ä½œå±žæ€§ã‚’説明ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:568 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:609 msgid "``type`` allows you to define the type of the value accepted for the argument. The default value for ``type`` is ``str``. Possible values are:" msgstr "``type`` ã§ã¯ã€å¼•æ•°ã«å—ã‘入れられる値ã®åž‹ã‚’定義ã§ãã¾ã™ã€‚``type`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ ``str`` ã§ã™ã€‚å¯èƒ½ãªå€¤ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:570 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:611 msgid "str" msgstr "str" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:571 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:612 msgid "list" msgstr "list" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:572 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:613 msgid "dict" msgstr "dict" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:573 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:614 msgid "bool" msgstr "bool" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:574 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:615 msgid "int" msgstr "int" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:575 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:616 msgid "float" msgstr "float" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:576 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:617 msgid "path" msgstr "path" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:577 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:618 msgid "raw" msgstr "raw" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:578 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:619 msgid "jsonarg" msgstr "jsonarg" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:579 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:620 #: ../../rst/dev_guide/style_guide/index.rst:152 msgid "json" msgstr "json" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:580 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:621 msgid "bytes" msgstr "bytes" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:581 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:622 msgid "bits" msgstr "bits" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:583 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:624 msgid "The ``raw`` type, performs no type validation or type casting, and maintains the type of the passed value." msgstr "``raw`` åž‹ã§ã€åž‹ã®æ¤œè¨¼ã‚„åž‹ã‚ャストを行ã‚ãšã€æ¸¡ã•ã‚ŒãŸå€¤ã®åž‹ã‚’ä¿æŒã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:587 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:628 msgid "``elements`` works in combination with ``type`` when ``type='list'``. ``elements`` can then be defined as ``elements='int'`` or any other type, indicating that each element of the specified list should be of that type." msgstr "``elements`` ã¯ã€``type='list'`` ã®æ™‚ã« ``type`` ã¨çµ„ã¿åˆã‚ã›ã¦å‹•ä½œã—ã¾ã™ã€‚``elements`` 㯠``elements='int'`` ãªã©ã®åž‹ã§å®šç¾©ã™ã‚‹ã“ã¨ãŒã§ãã€æŒ‡å®šã•ã‚ŒãŸãƒªã‚¹ãƒˆã®å„è¦ç´ ãŒãã®åž‹ã§ã‚ã‚‹ã“ã¨ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:591 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:632 msgid "The ``default`` option allows sets a default value for the argument for the scenario when the argument is not provided to the module. When not specified, the default value is ``None``." msgstr "``default`` オプションã¯ã€å¼•æ•°ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æä¾›ã•ã‚Œã¦ã„ãªã„å ´åˆã®ã‚·ãƒŠãƒªã‚ªã®å¼•æ•°ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’è¨å®šã—ã¾ã™ã€‚指定ã—ãªã„å ´åˆã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ ``None`` ã§ã™ã€‚" @@ -7055,19 +6775,33 @@ msgstr "``default`` オプションã¯ã€å¼•æ•°ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æä¾›ã•ã‚Œ msgid "fallback" msgstr "fallback" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:595 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:636 msgid "``fallback`` accepts a ``tuple`` where the first argument is a callable (function) that will be used to perform the lookup, based on the second argument. The second argument is a list of values to be accepted by the callable." msgstr "``fallback`` ã¯ã€ç¬¬ 1 引数ã«ã€ç¬¬ 2 引数ã«åŸºã¥ã„ã¦æ¤œç´¢ã‚’実行ã™ã‚‹ã®ã«ä½¿ç”¨ã™ã‚‹ callable (関数) ã® ``tuple`` ã‚’å—ã‘入れã¾ã™ã€‚2 ã¤ç›®ã®å¼•æ•°ã¯ã€callable オブジェクトã«ã‚ˆã£ã¦å—ã‘入れられる値ã®ãƒªã‚¹ãƒˆã§ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:597 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:638 msgid "The most common callable used is ``env_fallback`` which will allow an argument to optionally use an environment variable when the argument is not supplied." msgstr "最も一般的ã«ä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹ callable 㯠``env_fallback`` ã§ã€ã“ã‚Œã¯å¼•æ•°ãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã«ä»»æ„ã§ç’°å¢ƒå¤‰æ•°ã‚’使用ã§ãるよã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:607 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:640 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:679 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:693 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:793 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:810 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:824 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:851 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:868 +#: ../../rst/dev_guide/testing.rst:206 +#: ../../rst/dev_guide/testing_units_modules.rst:90 +#: ../../rst/dev_guide/testing_units_modules.rst:109 +msgid "Example:" +msgstr "例:" + +#: ../../rst/dev_guide/developing_program_flow_modules.rst:648 msgid "``choices`` accepts a list of choices that the argument will accept. The types of ``choices`` should match the ``type``." msgstr "``choices`` ã¯ã€å¼•æ•°ãŒå—ã‘入れるé¸æŠžè‚¢ã®ãƒªã‚¹ãƒˆã‚’å—ã‘入れã¾ã™ã€‚``choices`` ã®åž‹ã¯ã€``type`` ã¨ä¸€è‡´ã—ã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:611 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:652 msgid "``required`` accepts a boolean, either ``True`` or ``False`` that indicates that the argument is required. When not specified, ``required`` defaults to ``False``. This should not be used in combination with ``default``." msgstr "``required`` ブール値 (``True`` ã¾ãŸã¯ ``False`` ã®ã„ãšã‚Œã‹) ã‚‚å—ã‘入れã¾ã™ã€‚ã“ã‚Œã¯ã€å¼•æ•°ãŒå¿…è¦ã§ã‚ã‚‹ã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚指定ã—ãªã„å ´åˆã€``required`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``False`` ã«ãªã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€``default`` ã¨çµ„ã¿åˆã‚ã›ã¦ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。" @@ -7075,19 +6809,19 @@ msgstr "``required`` ブール値 (``True`` ã¾ãŸã¯ ``False`` ã®ã„ãšã‚Œã‹) msgid "no_log" msgstr "no_log" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:615 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:656 msgid "``no_log`` accepts a boolean, either ``True`` or ``False``, that indicates explicitly whether or not the argument value should be masked in logs and output." msgstr "``no_log`` ã«ã¯ã€å¼•æ•°ã®å€¤ãŒãƒã‚°ã‚„出力ã§ãƒžã‚¹ã‚¯ã•ã‚Œã‚‹ã¹ãã‹ã©ã†ã‹ã‚’明示的ã«ç¤ºã™ãƒ–ール値 (``True`` ã¾ãŸã¯ ``False``) を使用ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:618 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:659 msgid "In the absence of ``no_log``, if the parameter name appears to indicate that the argument value is a password or passphrase (such as \"admin_password\"), a warning will be shown and the value will be masked in logs but **not** output. To disable the warning and masking for parameters that do not contain sensitive information, set ``no_log`` to ``False``." msgstr "``no_log`` ãŒãªã„å ´åˆã¯ã€ãƒ‘ラメーターåãŒã€å¼•æ•°ã®å€¤ãŒãƒ‘スワードやパスフレーズã§ã‚ã‚‹ã“ã¨ã‚’示ã—ã¦ã„るよã†ã«è¦‹ãˆã‚‹å ´åˆ (「admin_passwordã€ãªã©)ã€è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã€å€¤ã¯ãƒã‚°ã§ãƒžã‚¹ã‚¯ã•ã‚Œã¾ã™ãŒã€**出力ã•ã‚Œã¾ã›ã‚“**ã€‚æ©Ÿå¯†æƒ…å ±ã‚’å«ã¾ãªã„パラメーターã®è¦å‘Šã¨ãƒžã‚¹ã‚ングを無効ã«ã™ã‚‹ã«ã¯ã€``no_log`` ã‚’ ``False`` ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:622 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:663 msgid "``aliases`` accepts a list of alternative argument names for the argument, such as the case where the argument is ``name`` but the module accepts ``aliases=['pkg']`` to allow ``pkg`` to be interchangeably with ``name``" msgstr "``aliases`` ã§ã¯ã€å¼•æ•°ã®ä»£æ›¿å¼•æ•°åã®ãƒªã‚¹ãƒˆãŒä½¿ç”¨ã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€å¼•æ•°ã¯ ``name`` ã§ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒ ``aliases=['pkg']`` ã‚’å—ã‘付ã‘ã¦ã€``pkg`` ã‚’ ``name`` ã¨äº’æ›æ€§ã‚’æŒãŸã›ã‚‹ã‚ˆã†ã«ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:626 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:667 msgid "``options`` implements the ability to create a sub-argument_spec, where the sub options of the top level argument are also validated using the attributes discussed in this section. The example at the top of this section demonstrates use of ``options``. ``type`` or ``elements`` should be ``dict`` is this case." msgstr "``options`` ã¯ã€ä¸Šä½ãƒ¬ãƒ™ãƒ«ã®å¼•æ•°ã®ã‚µãƒ–オプションもã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã—ãŸå±žæ€§ã‚’使用ã—ã¦æ¤œè¨¼ã•ã‚Œã‚‹ sub-argument_spec を作æˆã™ã‚‹æ©Ÿèƒ½ã‚’実装ã—ã¦ã„ã¾ã™ã€‚ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®å†’é ã«ã‚る例ã¯ã€``options`` ã®ä½¿ç”¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚ã“ã“ã§ã¯ã€``type`` ã¾ãŸã¯ ``elements`` 㯠``dict`` ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7095,11 +6829,11 @@ msgstr "``options`` ã¯ã€ä¸Šä½ãƒ¬ãƒ™ãƒ«ã®å¼•æ•°ã®ã‚µãƒ–オプションも㓠msgid "apply_defaults" msgstr "apply_defaults" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:630 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:671 msgid "``apply_defaults`` works alongside ``options`` and allows the ``default`` of the sub-options to be applied even when the top-level argument is not supplied." msgstr "``apply_defaults`` ã¯ã€``options`` ã¨ä¸¦ã‚“ã§å‹•ä½œã—ã€ä¸Šä½ãƒ¬ãƒ™ãƒ«ã®å¼•æ•°ãŒæŒ‡å®šã•ã‚Œã¦ã„ãªã„å ´åˆã§ã‚‚サブオプション㮠``デフォルト`` ã‚’é©ç”¨ã§ãるよã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:632 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:673 msgid "In the example of the ``argument_spec`` at the top of this section, it would allow ``module.params['top_level']['second_level']`` to be defined, even if the user does not provide ``top_level`` when calling the module." msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®å†’é ã«ã‚ã‚‹ ``argument_spec`` ã®ä¾‹ã§ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’呼ã³å‡ºã™ã¨ãã« ``top_level`` を指定ã—ãªã‹ã£ãŸå ´åˆã§ã‚‚ã€``module.params['top_level']['second_level']`` を定義ã§ãるよã†ã«ã—ã¾ã™ã€‚" @@ -7107,7 +6841,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®å†’é ã«ã‚ã‚‹ ``argument_spec`` ã®ä¾‹ã§ã¯ã€ msgid "removed_in_version" msgstr "removed_in_version" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:636 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:677 msgid "``removed_in_version`` indicates which version of ansible-core or a collection a deprecated argument will be removed in. Mutually exclusive with ``removed_at_date``, and must be used with ``removed_from_collection``." msgstr "``removed_in_version`` ã¯ã€éžæŽ¨å¥¨ã®å¼•æ•°ãŒå‰Šé™¤ã•ã‚Œã‚‹ ansible-core ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’示ã—ã¾ã™ã€‚``removed_at_date`` ã§ç›¸äº’ã«æŽ’ä»–ã¨ãªã‚Šã€``removed_from_collection`` ã§ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7115,7 +6849,7 @@ msgstr "``removed_in_version`` ã¯ã€éžæŽ¨å¥¨ã®å¼•æ•°ãŒå‰Šé™¤ã•ã‚Œã‚‹ ansibl msgid "removed_at_date" msgstr "removed_at_date" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:650 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:691 msgid "``removed_at_date`` indicates that a deprecated argument will be removed in a minor ansible-core release or major collection release after this date. Mutually exclusive with ``removed_in_version``, and must be used with ``removed_from_collection``." msgstr "``removed_at_date`` ã¯ã€éžæŽ¨å¥¨ã®å¼•æ•°ãŒã€ã“ã®æ—¥ä»˜ä»¥é™ã®ãƒžã‚¤ãƒŠãƒ¼ãª ansible-core リリースã¾ãŸã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹ã“ã¨ã‚’示ã—ã¾ã™ã€‚``removed_in_version`` ã¨ç›¸äº’ã«æŽ’ä»–çš„ã§ã‚ã‚Šã€``removed_from_collection`` ã¨ä¸€ç·’ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7123,7 +6857,7 @@ msgstr "``removed_at_date`` ã¯ã€éžæŽ¨å¥¨ã®å¼•æ•°ãŒã€ã“ã®æ—¥ä»˜ä»¥é™ã®ã msgid "removed_from_collection" msgstr "removed_from_collection" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:664 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:705 msgid "Specifies which collection (or ansible-core) deprecates this deprecated argument. Specify ``ansible.builtin`` for ansible-core, or the collection's name (format ``foo.bar``). Must be used with ``removed_in_version`` or ``removed_at_date``." msgstr "ã“ã®éžæŽ¨å¥¨ã®å¼•æ•°ã‚’éžæŽ¨å¥¨ã«ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ (ã¾ãŸã¯ ansible-core) を指定ã—ã¾ã™ã€‚ansible-core ã«ã¯ ``ansible.builtin``ã€ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®åå‰ (``foo.bar`` ã®å½¢å¼) を指定ã—ã¾ã™ã€‚``removed_in_version`` ã¾ãŸã¯ ``removed_at_date`` ã¨å…±ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7131,15 +6865,15 @@ msgstr "ã“ã®éžæŽ¨å¥¨ã®å¼•æ•°ã‚’éžæŽ¨å¥¨ã«ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ (ã¾ãŸã msgid "deprecated_aliases" msgstr "deprecated_aliases" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:668 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:709 msgid "Deprecates aliases of this argument. Must contain a list or tuple of dictionaries having some the following keys:" msgstr "ã“ã®å¼•æ•°ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’éžæŽ¨å¥¨ã«ã—ã¾ã™ã€‚以下ã®ã‚ーをæŒã¤ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒªã‚¹ãƒˆã¾ãŸã¯ã‚¿ãƒ—ルãŒå«ã¾ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/developing_program_flow_modules.rst msgid "name" -msgstr "name" +msgstr "åå‰" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:672 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:713 msgid "The name of the alias to deprecate. (Required.)" msgstr "éžæŽ¨å¥¨ã«ã™ã‚‹ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã®åå‰ (å¿…é ˆ)" @@ -7148,7 +6882,7 @@ msgstr "éžæŽ¨å¥¨ã«ã™ã‚‹ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã®åå‰ (å¿…é ˆ)" msgid "version" msgstr "version" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:676 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:717 msgid "The version of ansible-core or the collection this alias will be removed in. Either ``version`` or ``date`` must be specified." msgstr "ansible-coreã€ã¾ãŸã¯ã“ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¯å‰Šé™¤ã•ã‚Œã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã€‚``version`` ã¾ãŸã¯ ``date`` ã®ã„ãšã‚Œã‹ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7156,7 +6890,7 @@ msgstr "ansible-coreã€ã¾ãŸã¯ã“ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¯å‰Šé™¤ã•ã‚Œã‚‹ã‚³ãƒ¬ã‚¯ msgid "date" msgstr "date" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:680 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:721 msgid "The a date after which a minor release of ansible-core or a major collection release will no longer contain this alias.. Either ``version`` or ``date`` must be specified." msgstr "ansible-core ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ãŸã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªãƒªãƒ¼ã‚¹ã«ã“ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒå«ã¾ã‚Œãªããªã£ãŸæ—¥ä»˜ã€‚``version`` ã¾ãŸã¯ ``date`` ã®ã„ãšã‚Œã‹ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7164,11 +6898,11 @@ msgstr "ansible-core ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ãŸã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ã‚³ãƒ¬ã‚¯ã‚ msgid "collection_name" msgstr "collection_name" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:684 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:725 msgid "Specifies which collection (or ansible-core) deprecates this deprecated alias. Specify ``ansible.builtin`` for ansible-core, or the collection's name (format ``foo.bar``). Must be used with ``version`` or ``date``." msgstr "ã“ã®éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’éžæŽ¨å¥¨ã«ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ (ã¾ãŸã¯ ansible-core) を指定ã—ã¾ã™ã€‚ansible-core ã«ã¯ ``ansible.builtin``ã€ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®åå‰ (``foo.bar`` ã®å½¢å¼) を指定ã—ã¾ã™ã€‚``version`` ã¾ãŸã¯ ``date`` ã¨å…±ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:686 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:727 msgid "Examples:" msgstr "例:" @@ -7176,7 +6910,7 @@ msgstr "例:" msgid "mutually_exclusive" msgstr "mutually_exclusive" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:710 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:751 msgid "If ``options`` is specified, ``mutually_exclusive`` refers to the sub-options described in ``options`` and behaves as in :ref:`argument_spec_dependencies`." msgstr "``options`` を指定ã™ã‚‹ã¨ã€``mutually_exclusive`` 㯠``options`` ã§èª¬æ˜Žã•ã‚Œã¦ã„るサブオプションをå‚ç…§ã—ã€:ref:`argument_spec_dependencies` ã®ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚" @@ -7184,7 +6918,7 @@ msgstr "``options`` を指定ã™ã‚‹ã¨ã€``mutually_exclusive`` 㯠``options`` msgid "required_together" msgstr "required_together" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:714 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:755 msgid "If ``options`` is specified, ``required_together`` refers to the sub-options described in ``options`` and behaves as in :ref:`argument_spec_dependencies`." msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_together`` 㯠``options`` ã§èª¬æ˜Žã•ã‚Œã¦ã„るサブオプションをå‚ç…§ã—ã€:ref:`argument_spec_dependencies` ã®ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚" @@ -7192,7 +6926,7 @@ msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_together`` 㯠``options`` ã msgid "required_one_of" msgstr "required_one_of" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:718 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:759 msgid "If ``options`` is specified, ``required_one_of`` refers to the sub-options described in ``options`` and behaves as in :ref:`argument_spec_dependencies`." msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_one_of`` 㯠``options`` ã§èª¬æ˜Žã•ã‚Œã¦ã„るサブオプションをå‚ç…§ã—ã€:ref:`argument_spec_dependencies` ã®ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚" @@ -7200,7 +6934,7 @@ msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_one_of`` 㯠``options`` 㧠msgid "required_if" msgstr "required_if" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:722 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:763 msgid "If ``options`` is specified, ``required_if`` refers to the sub-options described in ``options`` and behaves as in :ref:`argument_spec_dependencies`." msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_if`` 㯠``options`` ã§èª¬æ˜Žã•ã‚Œã¦ã„るサブオプションをå‚ç…§ã—ã€:ref:`argument_spec_dependencies` ã®ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚" @@ -7208,103 +6942,103 @@ msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_if`` 㯠``options`` ã§èª¬æ msgid "required_by" msgstr "required_by" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:726 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:767 msgid "If ``options`` is specified, ``required_by`` refers to the sub-options described in ``options`` and behaves as in :ref:`argument_spec_dependencies`." msgstr "``options`` を指定ã™ã‚‹ã¨ã€``required_by`` 㯠``options`` ã§èª¬æ˜Žã•ã‚Œã¦ã„るサブオプションをå‚ç…§ã—ã€:ref:`argument_spec_dependencies` ã®ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:732 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:773 msgid "Dependencies between module options" msgstr "モジュールオプションã®ä¾å˜é–¢ä¿‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:734 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:775 msgid "The following are optional arguments for ``AnsibleModule()``:" msgstr "以下ã¯ã€``AnsibleModule()`` ã®ä»»æ„ã®å¼•æ•°ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:750 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:791 msgid "Must be a sequence (list or tuple) of sequences of strings. Every sequence of strings is a list of option names which are mutually exclusive. If more than one options of a list are specified together, Ansible will fail the module with an error." msgstr "æ–‡å—列シーケンスã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ (リストã¾ãŸã¯ã‚¿ãƒ—ル) ã§ã™ã€‚æ–‡å—列ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã¯ç›¸äº’排他的ãªã‚ªãƒ—ションåã®ãƒªã‚¹ãƒˆã§ã™ã€‚リストã®è¤‡æ•°ã®ã‚ªãƒ—ションを指定ã™ã‚‹ã¨ã€Ansible ã¯ã‚¨ãƒ©ãƒ¼ã‚’出ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:761 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:802 msgid "In this example, the options ``path`` and ``content`` must not specified at the same time. Also the options ``repository_url`` and ``repository_filename`` must not be specified at the same time. But specifying ``path`` and ``repository_url`` is accepted." msgstr "ã“ã®ä¾‹ã§ã¯ã€``path`` オプション㨠``content`` オプションã¯åŒæ™‚ã«æŒ‡å®šã—ãªã„ã§ãã ã•ã„。``repository_url`` オプション㨠``repository_filename`` オプションをåŒæ™‚ã«æŒ‡å®šã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。ãŸã ã—ã€``path`` ãŠã‚ˆã³ ``repository_url`` を指定ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:763 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:804 msgid "To ensure that precisely one of two (or more) options is specified, combine ``mutually_exclusive`` with ``required_one_of``." msgstr "æ£ç¢ºã« 2 ã¤ã®ã‚ªãƒ—ション (ã¾ãŸã¯è¤‡æ•°ã®) オプションã®ã„ãšã‚Œã‹ã‚’指定ã™ã‚‹ã‚ˆã†ã«ã™ã‚‹ã«ã¯ã€``mutually_exclusive`` 㨠``required_one_of`` を組ã¿åˆã‚ã›ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:767 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:808 msgid "Must be a sequence (list or tuple) of sequences of strings. Every sequence of strings is a list of option names which are must be specified together. If at least one of these options are specified, the other ones from the same sequence must all be present." msgstr "æ–‡å—列ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ (リストã¾ãŸã¯ã‚¿ãƒ—ル) ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚æ–‡å—列ã®ã™ã¹ã¦ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã¯ã€ä¸€ç·’ã«æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚るオプションåã®ãƒªã‚¹ãƒˆã§ã™ã€‚ã“れらã®ã‚ªãƒ—ションãŒå°‘ãªãã¨ã‚‚ 1 ã¤æŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€åŒã˜ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã®ä»–ã®ã‚ªãƒ—ションãŒã™ã¹ã¦å˜åœ¨ã—ã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:777 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:818 msgid "In this example, if one of the options ``file_path`` or ``file_hash`` is specified, Ansible will fail the module with an error if the other one is not specified." msgstr "ã“ã®ä¾‹ã§ã¯ã€``file_path`` ã¾ãŸã¯ ``file_hash`` ã®ã„ãšã‚Œã‹ã®ã‚ªãƒ—ションを指定ã—ã€ä»–ã®ã‚ªãƒ—ションãŒæŒ‡å®šã—ã¦ã„ãªã„ã¨ã€Ansible ã¯ã‚¨ãƒ©ãƒ¼ã‚’出ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:781 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:822 msgid "Must be a sequence (list or tuple) of sequences of strings. Every sequence of strings is a list of option names from which at least one must be specified. If none one of these options are specified, Ansible will fail module execution." msgstr "æ–‡å—列ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ (リストã¾ãŸã¯ã‚¿ãƒ—ル) ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚æ–‡å—列ã®ã™ã¹ã¦ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã¯ã€å°‘ãªãã¨ã‚‚ 1 ã¤ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚るオプションåã®ãƒªã‚¹ãƒˆã§ã™ã€‚ã“れらã®ã‚ªãƒ—ションãŒã„ãšã‚Œã‚‚指定ã•ã‚Œã¦ã„ãªã„å ´åˆã€Ansible ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Ÿè¡Œã«å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:791 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:832 msgid "In this example, at least one of ``path`` and ``content`` must be specified. If none are specified, execution will fail. Specifying both is explicitly allowed; to prevent this, combine ``required_one_of`` with ``mutually_exclusive``." msgstr "ã“ã®ä¾‹ã§ã¯ã€``path`` ãŠã‚ˆã³ ``content`` ã®ã„ãšã‚Œã‹ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚指定ã—ãªã„ã¨ã€å®Ÿè¡ŒãŒå¤±æ•—ã—ã¾ã™ã€‚両方ã®å€¤ã‚’指定ã™ã‚‹ã¨ã€æ˜Žç¤ºçš„ã«è¨±å¯ã•ã‚Œã¾ã™ã€‚ã“れを回é¿ã™ã‚‹ã«ã¯ã€``required_one_of`` 㨠``mutually_exclusive`` を組ã¿åˆã‚ã›ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:795 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:836 msgid "Must be a sequence of sequences. Every inner sequence describes one conditional dependency. Every sequence must have three or four values. The first two values are the option's name and the option's value which describes the condition. The further elements of the sequence are only needed if the option of that name has precisely this value." msgstr "一連ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã™ã¹ã¦ã®å†…部シーケンスã§ã¯ã€æ¡ä»¶ã®ä¾å˜é–¢ä¿‚ã‚’ 1 ã¤èª¬æ˜Žã—ã¾ã™ã€‚ã™ã¹ã¦ã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã«ã¯ã€å€¤ãŒ 3 ã¤ã¾ãŸã¯ 4 ã¤å¿…è¦ã§ã™ã€‚最åˆã® 2 ã¤ã®å€¤ã¯ã€ã‚ªãƒ—ションåã¨ã€ãã®æ¡ä»¶ã‚’説明ã™ã‚‹ã‚ªãƒ—ションã®å€¤ã§ã™ã€‚シーケンスã®è¿½åŠ è¦ç´ ã¯ã€ãã®åå‰ã®ã‚ªãƒ—ションãŒæ£ç¢ºã«ã“ã®å€¤ã‚’æŒã£ã¦ã„ã‚‹å ´åˆã«ã®ã¿å¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:797 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:838 msgid "If you want that all options in a list of option names are specified if the condition is met, use one of the following forms:" msgstr "æ¡ä»¶ãŒæº€ãŸã•ã‚ŒãŸå ´åˆã«ã‚ªãƒ—ションåã®ãƒªã‚¹ãƒˆå†…ã®ã‚ªãƒ—ションをã™ã¹ã¦æŒ‡å®šã™ã‚‹å ´åˆã¯ã€æ¬¡ã®ã„ãšã‚Œã‹ã®å½¢å¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:804 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:845 msgid "If you want that at least one option of a list of option names is specified if the condition is met, use the following form:" msgstr "æ¡ä»¶ãŒæº€ãŸã•ã‚ŒãŸå ´åˆã«ã‚ªãƒ—ションåã®ä¸€è¦§ã®ã‚ªãƒ—ションを 1 ã¤ä»¥ä¸ŠæŒ‡å®šã™ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®å½¢å¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:819 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:860 msgid "In this example, if the user specifies ``state=present``, at least one of the options ``path`` and ``content`` must be supplied (or both). To make sure that precisely one can be specified, combine ``required_if`` with ``mutually_exclusive``." msgstr "ã“ã®ä¾‹ã§ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒ ``state=present`` を指定ã—ã¦ã„ã‚‹å ´åˆã¯ã€``path`` 㨠``content`` ã®ã„ãšã‚Œã‹ (ã¾ãŸã¯ä¸¡æ–¹) ã®ã‚ªãƒ—ションを指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚å¿…ãšæŒ‡å®šã™ã‚‹ã‚ˆã†ã«ã™ã‚‹ã«ã¯ã€``required_if`` 㨠``mutually_exclusive`` を組ã¿åˆã‚ã›ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:821 -msgid "On the other hand, if ``force`` (a boolean parameter) is set to ``true``, ``yes`` etc., both ``force_reason`` and ``force_code`` must be specified." +#: ../../rst/dev_guide/developing_program_flow_modules.rst:862 +msgid "On the other hand, if ``force`` (a boolean parameter) is set to ``true``, ``yes`` and so on, both ``force_reason`` and ``force_code`` must be specified." msgstr "一方ã€``force`` (ブール値パラメーター) ㌠``true``ã€``yes`` ãªã©ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``force_reason`` 㨠``force_code`` ã®ä¸¡æ–¹ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:825 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:866 msgid "Must be a dictionary mapping option names to sequences of option names. If the option name in a dictionary key is specified, the option names it maps to must all also be specified. Note that instead of a sequence of option names, you can also specify one single option name." msgstr "オプションåã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã¸ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ãƒžãƒƒãƒ”ングオプションåã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ディクショナリーã‚ーã§ã‚ªãƒ—ションåを指定ã™ã‚‹ã¨ã€ãã®ã‚ªãƒ—ションåã‚’ã™ã¹ã¦æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚オプションåã®ã‚·ãƒ¼ã‚±ãƒ³ã‚¹ã®ä»£ã‚ã‚Šã«ã€ã‚ªãƒ—ションã®åå‰ã‚’ 1 ã¤æŒ‡å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:836 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:877 msgid "In the example, if ``force`` is specified, ``force_reason`` must also be specified. Also, if ``path`` is specified, then three three options ``mode``, ``owner`` and ``group`` also must be specified." msgstr "ã“ã®ä¾‹ã§ã¯ã€``force`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``force_reason`` も指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€``path`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€3 ã¤ã®ã‚ªãƒ—ション ``mode``ã€``owner``ã€ãŠã‚ˆã³ ``group`` も指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:839 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:880 msgid "Declaring check mode support" msgstr "ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã®ã‚µãƒãƒ¼ãƒˆã®å®£è¨€" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:841 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:882 msgid "To declare that a module supports check mode, supply ``supports_check_mode=True`` to the ``AnsibleModule()`` call:" msgstr "モジュールãŒç¢ºèªãƒ¢ãƒ¼ãƒ‰ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ã‚’宣言ã™ã‚‹ã«ã¯ã€``AnsibleModule()`` 呼ã³å‡ºã—ã« ``supports_check_mode=True`` を指定ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:847 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:888 msgid "The module can determine whether it is called in check mode by checking the boolean value ``module.check_mode``. If it evaluates to ``True``, the module must take care not to do any modification." msgstr "モジュールã¯ã€ãƒ–ール値 ``module.check_mode`` を確èªã™ã‚‹ã“ã¨ã§ã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã§å‘¼ã³å‡ºã•ã‚Œã‚‹ã‹ã©ã†ã‹ã‚’判æ–ã§ãã¾ã™ã€‚``True`` ã«è©•ä¾¡ã™ã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å¤‰æ›´ã‚’è¡Œã‚ãªã„よã†ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:849 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:890 msgid "If ``supports_check_mode=False`` is specified, which is the default value, the module will exit in check mode with ``skipped=True`` and message ``remote module (<insert module name here>) does not support check mode``." msgstr "``supports_check_mode=False`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆ (デフォルト値)ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã§ ``skipped=True`` ãŠã‚ˆã³ ``remote module (<insert module name here>) does not support check mode`` メッセージã§çµ‚了ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:852 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:893 msgid "Adding file options" msgstr "ファイルオプションã®è¿½åŠ " -#: ../../rst/dev_guide/developing_program_flow_modules.rst:854 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:895 msgid "To declare that a module should add support for all common file options, supply ``add_file_common_args=True`` to the ``AnsibleModule()`` call:" msgstr "モジュールãŒã™ã¹ã¦ã®å…±é€šãƒ•ã‚¡ã‚¤ãƒ«ã‚ªãƒ—ションã®ã‚µãƒãƒ¼ãƒˆã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã‚’宣言ã™ã‚‹ã«ã¯ã€``add_file_common_args=True`` ã‚’ ``AnsibleModule()`` 呼ã³å‡ºã—ã«æŒ‡å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:860 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:901 msgid "You can find `a list of all file options here <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/doc_fragments/files.py>`_. It is recommended that you make your ``DOCUMENTATION`` extend the doc fragment ``ansible.builtin.files`` (see :ref:`module_docs_fragments`) in this case, to make sure that all these fields are correctly documented." msgstr "`ã“ã“ã§ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚ªãƒ—ションã®ä¸€è¦§ <https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/doc_fragments/files.py>`_ を確èªã§ãã¾ã™ã€‚今回ã¯ã€``DOCUMENTATION`` ãŒãƒ‰ã‚ュメントフラグメント ``ansible.builtin.files`` (:ref:`module_docs_fragments` ã‚’å‚ç…§) ã‚’æ‹¡å¼µã—ã€ã“れらã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãŒã™ã¹ã¦æ£ã—ã文書化ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/developing_program_flow_modules.rst:862 +#: ../../rst/dev_guide/developing_program_flow_modules.rst:903 msgid "The helper functions ``module.load_file_common_arguments()`` and ``module.set_fs_attributes_if_different()`` can be used to handle these arguments for you:" msgstr "ヘルパー関数 ``module.load_file_common_arguments()`` ãŠã‚ˆã³ ``module.set_fs_attributes_if_different()`` を使用ã—ã¦ã€ä»¥ä¸‹ã®å¼•æ•°ã‚’扱ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" @@ -7393,7 +7127,7 @@ msgid "For compatibility reasons you will see a bunch of custom functions we dev msgstr "互æ›æ€§ã®ç†ç”±ã‹ã‚‰ã€å¤šãã®ã‚«ã‚¹ã‚¿ãƒ 関数(``to_text``/``to_bytes``/``to_native``) ãŒé–‹ç™ºã•ã‚Œã¾ã—ãŸã€‚Python 2 ã«é–¢ã™ã‚‹æ‡¸å¿µã¯ãªããªã£ãŸãŸã‚ã€Unicode ã®å‡¦ç†ãŒå•é¡Œã«ãªã‚‹ã‚ˆã†ãªåˆ¥ã®ã‚±ãƒ¼ã‚¹ã«é©ç”¨ã•ã‚Œã‚‹ãŸã‚ã€ä»Šå¾Œã‚‚引ã続ãã“れを使用ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_python_3.rst:91 -msgid "While we will not be using it most of it anymore, the documentation below is still useful for those developing modules that still need to support both Python 2 and 3 simultaneouslly." +msgid "While we will not be using it most of it anymore, the documentation below is still useful for those developing modules that still need to support both Python 2 and 3 simultaneously." msgstr "ã»ã¨ã‚“ã©ä½¿ç”¨ã—ãªããªã‚Šã¾ã™ãŒã€ä»¥ä¸‹ã®ãƒ‰ã‚ュメント㯠Python 2 㨠3 ã®ä¸¡æ–¹ã‚’åŒæ™‚ã«ã‚µãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚るモジュールを開発ã—ã¦ã„ã‚‹å ´åˆã«å½¹ç«‹ã¡ã¾ã™ã€‚" #: ../../rst/dev_guide/developing_python_3.rst:95 @@ -8125,7 +7859,7 @@ msgid "Changing a module or plugin name in the Ansible main repository" msgstr "Ansible メインリãƒã‚¸ãƒˆãƒªãƒ¼ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインåã®å¤‰æ›´" #: ../../rst/dev_guide/module_lifecycle.rst:71 -msgid "You can also rename a module and keep a deprecated alias to the old name by using a symlink that starts with _. This example allows the ``stat`` module to be called with ``fileinfo``, making the following examples equivalent::" +msgid "You can also rename a module and keep a deprecated alias to the old name by using a symlink that starts with _. This example allows the ``stat`` module to be called with ``fileinfo``, making the following examples equivalent:" msgstr "_ ã§å§‹ã¾ã‚‹ã‚·ãƒ³ãƒœãƒªãƒƒã‚¯ãƒªãƒ³ã‚¯ã‚’使用ã—ã¦ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®åå‰ã‚’変更ã—ã€éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’å¤ã„åå‰ã«ä¿ã¤ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã®ä¾‹ã§ã¯ã€``stat`` モジュールを ``fileinfo`` ã§å‘¼ã³å‡ºã™ã“ã¨ãŒã§ãã‚‹ãŸã‚ã€æ¬¡ã®ä¾‹ã¯åŒç‰ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/module_lifecycle.rst:81 @@ -8237,7 +7971,7 @@ msgid "Here's what a plain text inventory file looks like:" msgstr "プレーンテã‚ストã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã¯æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/overview_architecture.rst:56 -msgid "Once inventory hosts are listed, variables can be assigned to them in simple text files (in a subdirectory called 'group_vars/' or 'host_vars/' or directly in the inventory file." +msgid "Once inventory hosts are listed, variables can be assigned to them in simple text files (in a subdirectory called 'group_vars/' or 'host_vars/') or directly in the inventory file." msgstr "インベントリーホストã®ä¸€è¦§ãŒä½œæˆã•ã‚Œã‚‹ã¨ã€å˜ç´”ãªãƒ†ã‚ストファイル形å¼ã§ (「group_vars/ã€ã¾ãŸã¯ã€Œhost_vars/ã€ã¨ã„ã†åå‰ã®ã‚µãƒ–ディレクトリー内ã€ã¾ãŸã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã«ç›´æŽ¥) 割り当ã¦ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/overview_architecture.rst:58 @@ -8304,45 +8038,61 @@ msgstr "ユーザーãŒæŒ‡å®šã—ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚るモジュール msgid "If you have more than one module, module utility, or plugin with the same name in different user-specified directories, the order of commands at the command line and the order of includes and roles in each play will affect which one is found and used on that particular play." msgstr "åŒã˜åå‰ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ã€ã¾ãŸã¯ãƒ—ラグインãŒè¤‡æ•°ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼æŒ‡å®šãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚ã‚‹å ´åˆã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ã®ã‚³ãƒžãƒ³ãƒ‰ã®é †åºã‚„ã€å„プレイã§ã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ãƒ‰ã¨ãƒãƒ¼ãƒ«ã®é †åºã¯ã€ãã®ç‰¹å®šã®ãƒ—レイã§ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒè¦‹ã¤ã‹ã‚Šã€ä½¿ç”¨ã•ã‚Œã‚‹ã‹ã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/platforms/aws_guidelines.rst:5 -msgid "Guidelines for Ansible Amazon AWS module development" -msgstr "Ansible Amazon AWS モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" +#: ../../rst/dev_guide/sidecar.rst:5 +msgid "Adjacent YAML documentation files" +msgstr "隣接 YAML ドã‚ュメントファイル" + +#: ../../rst/dev_guide/sidecar.rst:11 +msgid "YAML documentation for plugins" +msgstr "プラグイン㮠YAML ドã‚ュメント" + +#: ../../rst/dev_guide/sidecar.rst:12 +msgid "For most Ansible plugins, the documentation is in the same file as the code. This approach does not work for cases when:" +msgstr "ã»ã¨ã‚“ã©ã® Ansible プラグインã§ã¯ã€ãƒ‰ã‚ュメントã¯ã‚³ãƒ¼ãƒ‰ã¨åŒã˜ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚¢ãƒ—ãƒãƒ¼ãƒã¯ã€æ¬¡ã®å ´åˆã«ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" + +#: ../../rst/dev_guide/sidecar.rst:14 +msgid "Multiple plugins are defined in the same file, such as tests and filters." +msgstr "テストやフィルターãªã©ã€è¤‡æ•°ã®ãƒ—ラグインãŒåŒã˜ãƒ•ã‚¡ã‚¤ãƒ«ã§å®šç¾©ã•ã‚Œã¦ã„ã‚‹å ´åˆã€‚" -#: ../../rst/dev_guide/platforms/aws_guidelines.rst:7 -msgid "This guide has moved to :ref:`ansible_collections.amazon.aws.docsite.dev_guide_intro`." -msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.amazon.aws.docsite.dev_guide_intro` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" +#: ../../rst/dev_guide/sidecar.rst:15 +msgid "Plugins are written in a language other than Python (modules)." +msgstr "プラグイン㌠Python 以外ã®è¨€èªž (モジュール) ã§è¨˜è¿°ã•ã‚Œã¦ã„ã‚‹å ´åˆã€‚" -#: ../../rst/dev_guide/platforms/openstack_guidelines.rst:4 -msgid "OpenStack Ansible Modules" -msgstr "OpenStack Ansible モジュール" +#: ../../rst/dev_guide/sidecar.rst:17 +msgid "These cases require plugins to provide documentation in an adjacent ``.py`` file. As of ansible-core 2.14, you can provide documentation as adjacent YAML files instead. The format of a YAML documentation file is nearly identical to its Python equivalent, except it is pure YAML." +msgstr "ã“ã®ã‚ˆã†ãªå ´åˆã€éš£æŽ¥ã™ã‚‹ ``.py`` ファイルã§ãƒ‰ã‚ュメントをæä¾›ã™ã‚‹ãƒ—ラグインãŒå¿…è¦ã§ã™ã€‚ansible-core 2.14 以é™ã§ã¯ã€ä»£ã‚ã‚Šã«éš£æŽ¥ YAML ファイルã¨ã—ã¦ãƒ‰ã‚ュメントをæä¾›ã§ãã¾ã™ã€‚YAML ドã‚ュメントファイルã®å½¢å¼ã¯ã€ç´”粋㪠YAML ã§ã‚ã‚‹ã“ã¨ã‚’除ã„㦠Python ã®è©²å½“ファイルã¨ã»ã¼åŒã˜ã§ã™ã€‚" -#: ../../rst/dev_guide/platforms/openstack_guidelines.rst:6 -msgid "Please see the `OpenStack guidelines <https://opendev.org/openstack/ansible-collections-openstack/src/branch/master/docs/openstack_guidelines.rst>`_, for further information." -msgstr "詳細ã¯ã€`OpenStack ガイドライン <https://opendev.org/openstack/ansible-collections-openstack/src/branch/master/docs/openstack_guidelines.rst>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/sidecar.rst:22 +msgid "YAML format" +msgstr "YAML å½¢å¼" -#: ../../rst/dev_guide/platforms/ovirt_dev_guide.rst:4 -msgid "oVirt Ansible Modules" -msgstr "oVirt Ansible モジュール" +#: ../../rst/dev_guide/sidecar.rst:23 +msgid "In Python each section is a variable ``DOCUMENTATION = r\"\"\" ... \"\"\"`` while in YAML it is a mapping key ``DOCUMENTATION: ...``." +msgstr "Python ã§ã¯ã€å„セクションã¯å¤‰æ•° ``DOCUMENTATION = r\"\"\" ... \"\"\"`` ã§ã™ãŒã€YAML ã§ã¯ãƒžãƒƒãƒ”ングã‚ー ``DOCUMENTATION: ...`` ã§ã™ã€‚" -#: ../../rst/dev_guide/platforms/ovirt_dev_guide.rst:7 -msgid "See the `ovirt.ovirt collection documentation <https://github.com/oVirt/ovirt-ansible-collection/blob/master/README-developers.md>`_ for details on how to contribute to this collection." -msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¸ã®è²¢çŒ®æ–¹æ³•ã¯ã€`ovirt.ovirt collection documentation <https://github.com/oVirt/ovirt-ansible-collection/blob/master/README-developers.md>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/sidecar.rst:25 +msgid "Here is a longer example that shows documentation as embedded in a Python file:" +msgstr "ã“ã‚Œã¯ã€ãƒ‰ã‚ュメント㌠Python ファイルã«åŸ‹ã‚è¾¼ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’示ã™é•·ã„例ã§ã™ã€‚" -#: ../../rst/dev_guide/platforms/vmware_guidelines.rst:5 -msgid "Guidelines for VMware module development" -msgstr "VMware モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" +#: ../../rst/dev_guide/sidecar.rst:53 +msgid "This example shows the same documentation in YAML format:" +msgstr "次ã®ä¾‹ã¯ã€åŒã˜ãƒ‰ã‚ュメントを YAML å½¢å¼ã§ç¤ºã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/platforms/vmware_guidelines.rst:7 -msgid "This guide has moved to :ref:`ansible_collections.community.vmware.docsite.vmware_ansible_devguide`." -msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.community.vmware.docsite.vmware_ansible_devguide` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" +#: ../../rst/dev_guide/sidecar.rst:78 +msgid "As the examples above show, Python variables already contain YAML. The main change to use YAML documentation is to simply move the YAML out of such variables." +msgstr "上記ã®ä¾‹ãŒç¤ºã™ã‚ˆã†ã«ã€Python 変数ã«ã¯ã™ã§ã« YAML ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚YAML ドã‚ュメントを使用ã™ã‚‹ãŸã‚ã®ä¸»ãªå¤‰æ›´ç‚¹ã¨ã—ã¦ã€ãã®ã‚ˆã†ãªå¤‰æ•°ã‹ã‚‰ YAML を移動ã•ã›ã¾ã™ã€‚" -#: ../../rst/dev_guide/platforms/vmware_rest_guidelines.rst:5 -msgid "Guidelines for VMware REST module development" -msgstr "VMware REST モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" +#: ../../rst/dev_guide/sidecar.rst:80 +msgid "Any adjacent YAML documentation files must be in the same directory as the plugin or module that they document. This means the documentation is available in any directory that contains the plugins or modules." +msgstr "隣接 YAML ドã‚ュメントファイルã¯ã€ãƒ‰ã‚ュメント化ã™ã‚‹ãƒ—ラグインã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨åŒã˜ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ—ラグインã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å«ã‚€ä»»æ„ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ãƒ‰ã‚ュメントを利用ã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/platforms/vmware_rest_guidelines.rst:7 -msgid "This guide has moved to :ref:`ansible_collections.vmware.vmware_rest.docsite.vmware_rest_devguide`." -msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.vmware.vmware_rest.docsite.vmware_rest_devguide` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" +#: ../../rst/dev_guide/sidecar.rst:84 +msgid "Supported plugin types" +msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡ã®ãƒ—ラグインタイプ" + +#: ../../rst/dev_guide/sidecar.rst:85 +msgid "YAML documentation is mainly intended for filters, tests and modules. While it is possible to use with other plugin types, Ansible always recommends having documentation in the same file as the code for most cases." +msgstr "YAML ドã‚ュメントã¯ã€ä¸»ã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã€ãƒ†ã‚¹ãƒˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’対象ã¨ã—ã¦ã„ã¾ã™ã€‚ä»–ã®ãƒ—ラグインタイプã§ä½¿ç”¨ã§ãã¾ã™ãŒã€Ansible ã§ã¯å¯èƒ½ãªé™ã‚Šã‚³ãƒ¼ãƒ‰ã¨åŒã˜ãƒ•ã‚¡ã‚¤ãƒ«ã«ãƒ‰ã‚ュメントをå«ã‚ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/style_guide/basic_rules.rst:4 msgid "Basic rules" @@ -8399,7 +8149,7 @@ msgstr "ãŸã¨ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«æ”¹å–„ã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/style_guide/basic_rules.rst:33 #: ../../rst/dev_guide/style_guide/basic_rules.rst:39 msgid "Bad:" -msgstr "å•é¡ŒãŒã‚ã‚‹æ–‡ç« : " +msgstr "å•é¡ŒãŒã‚ã‚‹æ–‡ç« :" #: ../../rst/dev_guide/style_guide/basic_rules.rst:33 msgid "The unwise walking about upon the area near the cliff edge may result in a dangerous fall and therefore it is recommended that one remains a safe distance to maintain personal safety." @@ -8408,7 +8158,7 @@ msgstr "The unwise walking about upon the area near the cliff edge may result in #: ../../rst/dev_guide/style_guide/basic_rules.rst:36 #: ../../rst/dev_guide/style_guide/basic_rules.rst:42 msgid "Better:" -msgstr "改善例: " +msgstr "改善例:" #: ../../rst/dev_guide/style_guide/basic_rules.rst:36 msgid "Danger! Stay away from the cliff." @@ -8475,8 +8225,8 @@ msgid "On the toolbar, click the **Open File** icon." msgstr "ツールãƒãƒ¼ã§ã€**ファイルを開ã** アイコンをクリックã—ã¾ã™ã€‚" #: ../../rst/dev_guide/style_guide/basic_rules.rst:64 -msgid "For code or command snippets, use the RST `code-block directive <https://www.sphinx-doc.org/en/1.5/markup/code.html#directive-code-block>`_::" -msgstr "code ã¾ãŸã¯ command スニペットã®å ´åˆã¯ã€RST ã® `code-block ディレクティブ <https://www.sphinx-doc.org/en/1.5/markup/code.html#directive-code-block>`_ を使用ã—ã¾ã™ã€‚" +msgid "For code or command snippets, use the RST `code-block directive <https://www.sphinx-doc.org/en/1.5/markup/code.html#directive-code-block>`_:" +msgstr "code ã¾ãŸã¯ command スニペットã®å ´åˆã¯ã€RST ã® `code-block directive <https://www.sphinx-doc.org/en/1.5/markup/code.html#directive-code-block>`_ を使用ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/style_guide/grammar_punctuation.rst:3 msgid "Grammar and Punctuation" @@ -9109,178 +8859,178 @@ msgid "Place the main anchor above the main header" msgstr "メインヘッダーã®ä¸Šã«ãƒ¡ã‚¤ãƒ³ã‚¢ãƒ³ã‚«ãƒ¼ã‚’é…ç½®ã™ã‚‹ã€‚" #: ../../rst/dev_guide/style_guide/index.rst:195 -msgid "If the file has a unique title, use that for the main page anchor::" +msgid "If the file has a unique title, use that for the main page anchor:" msgstr "ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ä¸€æ„ã®ã‚¿ã‚¤ãƒˆãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€ãƒ¡ã‚¤ãƒ³ãƒšãƒ¼ã‚¸ã®ã‚¢ãƒ³ã‚«ãƒ¼ã«ä½¿ç”¨ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:199 +#: ../../rst/dev_guide/style_guide/index.rst:201 msgid "You may also add anchors elsewhere on the page" msgstr "ページã«ã‚¢ãƒ³ã‚«ãƒ¼ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:202 +#: ../../rst/dev_guide/style_guide/index.rst:204 msgid "Adding internal links" msgstr "内部リンクã®è¿½åŠ " -#: ../../rst/dev_guide/style_guide/index.rst:204 +#: ../../rst/dev_guide/style_guide/index.rst:206 msgid "All internal links must use ``:ref:`` syntax. These links both point to the anchor defined above:" msgstr "ã™ã¹ã¦ã®å†…部リンクã«ã¯ ``:ref:`` 構文を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®ãƒªãƒ³ã‚¯ã¯å…±ã«ã€ä¸Šã§å®šç¾©ã—ãŸã‚¢ãƒ³ã‚«ãƒ¼ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:211 +#: ../../rst/dev_guide/style_guide/index.rst:213 msgid "The second example adds custom text for the link." msgstr "2 ã¤ç›®ã®ä¾‹ã¯ã€ãƒªãƒ³ã‚¯ã®ã‚«ã‚¹ã‚¿ãƒ テã‚ã‚¹ãƒˆã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:214 +#: ../../rst/dev_guide/style_guide/index.rst:216 msgid "Adding links to modules and plugins" msgstr "モジュールãŠã‚ˆã³ãƒ—ラグインã¸ã®ãƒªãƒ³ã‚¯ã®è¿½åŠ " -#: ../../rst/dev_guide/style_guide/index.rst:216 +#: ../../rst/dev_guide/style_guide/index.rst:218 msgid "Ansible 2.10 and later require the extended Fully Qualified Collection Name (FQCN) as part of the links:" msgstr "Ansible 2.10 以é™ã¯ã€ãƒªãƒ³ã‚¯ã®ä¸€éƒ¨ã¨ã—ã¦ã€æ‹¡å¼µã•ã‚ŒãŸå®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å (FQCN) ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:228 +#: ../../rst/dev_guide/style_guide/index.rst:230 msgid "displays as :ref:`ansible.builtin.first_found lookup plugin <ansible_collections.ansible.builtin.first_found_lookup>`." msgstr ":ref:`ansible.builtin.first_found lookup plugin <ansible_collections.ansible.builtin.first_found_lookup>` ã¨ã—ã¦è¡¨ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:230 +#: ../../rst/dev_guide/style_guide/index.rst:232 msgid "Modules require different suffixes from other plugins:" msgstr "モジュールã«ã¯ã€ä»–ã®ãƒ—ラグインã¨ã¯ç•°ãªã‚‹ã‚µãƒ•ã‚£ãƒƒã‚¯ã‚¹ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:232 +#: ../../rst/dev_guide/style_guide/index.rst:234 msgid "Module links use this extended FQCN module name with ``_module`` for the anchor." msgstr "モジュールリンクã§ã¯ã€ã“ã®åºƒç¯„㪠FQCN モジュールåã«ã€ã‚¢ãƒ³ã‚«ãƒ¼ã« ``_module`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:233 +#: ../../rst/dev_guide/style_guide/index.rst:235 msgid "Plugin links use this extended FQCN plugin name with the plugin type (``_connection`` for example)." msgstr "プラグインã®ãƒªãƒ³ã‚¯ã¯ã€ã“ã®åºƒç¯„㪠FQCN プラグインåをプラグインタイプ (``_connection`` ãªã©) ã§ä½¿ç”¨ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:242 +#: ../../rst/dev_guide/style_guide/index.rst:244 msgid "``ansible.builtin`` is the FQCN for modules included in ``ansible.base``. Documentation links are the only place you prepend ``ansible_collections`` to the FQCN. This is used by the documentation build scripts to correctly fetch documentation from collections on Ansible Galaxy." msgstr "``ansible.builtin`` ã¯ã€``ansible.base`` ã«å«ã¾ã‚Œã¦ã„るモジュール㮠FQCN ã§ã™ã€‚ドã‚ュメントã®ãƒªãƒ³ã‚¯ã¯ã€``ansible_collections`` ã‚’ FQCN ã®å‰ã«ä»˜ã‘る唯一ã®å ´æ‰€ã§ã™ã€‚ã“ã‚Œã¯ã€Ansible Galaxy ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‹ã‚‰ãƒ‰ã‚ュメントをé©åˆ‡ã«å–å¾—ã™ã‚‹ãŸã‚ã«ã€ãƒ‰ã‚ュメントビルドスクリプトã«ã‚ˆã‚Šä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:247 +#: ../../rst/dev_guide/style_guide/index.rst:249 msgid "Adding local TOCs" msgstr "ページ内 (ãƒãƒ¼ã‚«ãƒ«) 目次ã®è¿½åŠ " -#: ../../rst/dev_guide/style_guide/index.rst:249 +#: ../../rst/dev_guide/style_guide/index.rst:251 msgid "The page you're reading includes a `local TOC <https://docutils.sourceforge.io/docs/ref/rst/directives.html#table-of-contents>`_. If you include a local TOC:" msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã«ã¯ `ãƒãƒ¼ã‚«ãƒ« TOC <https://docutils.sourceforge.io/docs/ref/rst/directives.html#table-of-contents>`_ ãŒå«ã¾ã‚Œã¾ã™ã€‚ãƒãƒ¼ã‚«ãƒ«ã® TOC ã‚’è¿½åŠ ã™ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:252 +#: ../../rst/dev_guide/style_guide/index.rst:254 msgid "place it below, not above, the main heading and (optionally) introductory text" msgstr "目次ã®ä¸‹ã«ã€ä¸»è¦ãªè¦‹å‡ºã—㨠(ä»»æ„ã§) ç´¹ä»‹æ–‡ã‚’è¿½åŠ ã—ã¾ã™ã€‚目次ã®ä¸Šã«ã¯è¿½åŠ ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/style_guide/index.rst:253 +#: ../../rst/dev_guide/style_guide/index.rst:255 msgid "use the ``:local:`` directive so the page's main header is not included" msgstr "ãã®ãƒšãƒ¼ã‚¸ã®ä¸»è¦ãªãƒ˜ãƒƒãƒ€ãƒ¼ãŒå«ã¾ã‚Œãªã„よã†ã« ``:local:`` ディレクティブを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:254 +#: ../../rst/dev_guide/style_guide/index.rst:256 msgid "do not include a title" msgstr "タイトルã¯é™¤å¤–ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:256 +#: ../../rst/dev_guide/style_guide/index.rst:258 msgid "The syntax is:" msgstr "構文ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:264 +#: ../../rst/dev_guide/style_guide/index.rst:266 msgid "Accessibility guidelines" msgstr "アクセシビリティã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" -#: ../../rst/dev_guide/style_guide/index.rst:266 +#: ../../rst/dev_guide/style_guide/index.rst:268 msgid "Ansible documentation has a goal to be more accessible. Use the following guidelines to help us reach this goal." msgstr "Ansible ドã‚ュメントã«ã¯ã€ã‚¢ã‚¯ã‚»ã‚¹ã—ã‚„ã™ãã™ã‚‹ã¨ã„ã†ç›®æ¨™ãŒã‚ã‚Šã¾ã™ã€‚次ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’使用ã™ã‚‹ã“ã¨ã§ã€ã“ã®ç›®æ¨™ã‚’é”æˆã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:276 +#: ../../rst/dev_guide/style_guide/index.rst:278 msgid "Images and alternative text" msgstr "イメージãŠã‚ˆã³ä»£æ›¿ãƒ†ã‚スト" -#: ../../rst/dev_guide/style_guide/index.rst:269 +#: ../../rst/dev_guide/style_guide/index.rst:271 msgid "Ensure all icons, images, diagrams, and non text elements have a meaningful alternative-text description. Do not include screen captures of CLI output. Use ``code-block`` instead." msgstr "ã™ã¹ã¦ã®ã‚¢ã‚¤ã‚³ãƒ³ã€ã‚¤ãƒ¡ãƒ¼ã‚¸ã€ãƒ€ã‚¤ã‚¢ã‚°ãƒ©ãƒ ã€ãŠã‚ˆã³éžãƒ†ã‚ストè¦ç´ ã«æ„味ã®ã‚る代替テã‚ストã®èª¬æ˜ŽãŒã‚ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。CLI 出力ã®ã‚¹ã‚¯ãƒªãƒ¼ãƒ³ã‚ャプãƒãƒ£ãƒ¼ã¯å«ã‚ãªã„ã§ãã ã•ã„。代ã‚ã‚Šã« ``code-block`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/style_guide/index.rst:279 +#: ../../rst/dev_guide/style_guide/index.rst:281 msgid "Links and hypertext" msgstr "リンクã¨ãƒã‚¤ãƒ‘ーテã‚スト" -#: ../../rst/dev_guide/style_guide/index.rst:279 +#: ../../rst/dev_guide/style_guide/index.rst:281 msgid "URLs and cross-reference links have descriptive text that conveys information about the content of the linked target. See :ref:`style_links` for how to format links." msgstr "URL ã¨ç›¸äº’å‚照リンクã«ã¯ã€ãƒªãƒ³ã‚¯å…ˆã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã®å†…容ã«é–¢ã™ã‚‹æƒ…å ±ã‚’ä¼ãˆã‚‹èª¬æ˜Žãƒ†ã‚ストãŒã‚ã‚Šã¾ã™ã€‚リンクã®å½¢å¼ã«ã¤ã„ã¦ã¯ã€:ref:`style_links` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/style_guide/index.rst:297 +#: ../../rst/dev_guide/style_guide/index.rst:299 msgid "Tables" msgstr "Tables" -#: ../../rst/dev_guide/style_guide/index.rst:282 +#: ../../rst/dev_guide/style_guide/index.rst:284 msgid "Tables have a simple, logical reading order from left to right, and top to bottom. Tables include a header row and avoid empty or blank table cells. Label tables with a descriptive title." msgstr "テーブルã«ã¯ã€è«–ç†çš„ãªèªã¿å–ã‚Šé †åºãŒã‚ã‚Šã€å·¦ã‹ã‚‰å³ã€ä¸Šã‹ã‚‰ä¸‹ã«èªã¿å–ã‚Šã¾ã™ã€‚テーブルã«ã¯ãƒ˜ãƒƒãƒ€ãƒ¼è¡ŒãŒå«ã¾ã‚Œã€ç©ºã®ãƒ†ãƒ¼ãƒ–ルセルや空白ã®ãƒ†ãƒ¼ãƒ–ルセルを回é¿ã—ã¾ã™ã€‚テーブルã«ã¯èª¬æ˜Žçš„ãªã‚¿ã‚¤ãƒˆãƒ«ã‚’ラベル付ã‘ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:303 +#: ../../rst/dev_guide/style_guide/index.rst:305 msgid "Colors and other visual information" msgstr "色やãã®ä»–ã®è¦–è¦šæƒ…å ±" -#: ../../rst/dev_guide/style_guide/index.rst:300 +#: ../../rst/dev_guide/style_guide/index.rst:302 msgid "Avoid instructions that rely solely on sensory characteristics. For example, do not use ``Click the square, blue button to continue.``" msgstr "感覚特性ã®ã¿ã«ä¾å˜ã™ã‚‹å‘½ä»¤ã¯å›žé¿ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``Click the square, blue button to continue.`` ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/dev_guide/style_guide/index.rst:301 +#: ../../rst/dev_guide/style_guide/index.rst:303 msgid "Convey information by methods and not by color alone." msgstr "色ã ã‘ã§ã¯ãªãã€ãƒ¡ã‚½ãƒƒãƒ‰ã«ã‚ˆã‚Šæƒ…å ±ã‚’ä¼ãˆã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:302 +#: ../../rst/dev_guide/style_guide/index.rst:304 msgid "Ensure there is sufficient contrast between foreground and background text or graphical elements in images and diagrams." msgstr "イメージや図ã®å…¨æ™¯ã¨èƒŒæ™¯ã®ãƒ†ã‚ストやグラフィックè¦ç´ ã®é–“ã«ã€å分ãªã‚³ãƒ³ãƒˆãƒ©ã‚¹ãƒˆãŒã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:303 +#: ../../rst/dev_guide/style_guide/index.rst:305 msgid "Instructions for navigating through an interface make sense without directional indicators such as left, right, above, and below." msgstr "インターフェイス上を移動ã™ã‚‹é †åºã¯ã€å·¦ã€å³ã€ä¸Šã€ä¸‹ãªã©ã®æ–¹å‘インジケーターãŒãªãã¦ã‚‚ç†è§£ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:306 +#: ../../rst/dev_guide/style_guide/index.rst:308 msgid "Accessibility resources" msgstr "アクセシビリティーリソース" -#: ../../rst/dev_guide/style_guide/index.rst:308 +#: ../../rst/dev_guide/style_guide/index.rst:310 msgid "Use the following resources to help test your documentation changes:" msgstr "以下ã®ãƒªã‚½ãƒ¼ã‚¹ã‚’使用ã—ã¦ã€ãƒ‰ã‚ュメントã®å¤‰æ›´ã‚’テストã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:310 +#: ../../rst/dev_guide/style_guide/index.rst:312 msgid "`axe DevTools browser extension <https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd?hl=en-US&_ga=2.98933278.1490638154.1645821120-953800914.1645821120>`_ - Highlights accessibility issues on a website page." msgstr "`axe DevTools browser extension <https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd?hl=en-US&_ga=2.98933278.1490638154.1645821120-953800914.1645821120>`_ - Web サイトã®ãƒšãƒ¼ã‚¸ä¸Šã§ã‚¢ã‚¯ã‚»ã‚·ãƒ“リティーã®å•é¡Œã‚’強調表示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:311 +#: ../../rst/dev_guide/style_guide/index.rst:313 msgid "`WAVE browser extension <https://wave.webaim.org/extension/>`_ from WebAIM - another accessibility tester." msgstr "WebAIM ã‹ã‚‰ã® `WAVE browser extension <https://wave.webaim.org/extension/>`_ - 別ã®ã‚¢ã‚¯ã‚»ã‚·ãƒ“リティーテスター。" -#: ../../rst/dev_guide/style_guide/index.rst:312 +#: ../../rst/dev_guide/style_guide/index.rst:314 msgid "`Orca screen reader <https://help.gnome.org/users/orca/stable/>`_ - Common tool used by people with vision impairments." msgstr "`Orca screen reader <https://help.gnome.org/users/orca/stable/>`_ - 視覚障害をæŒã¤ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒä½¿ç”¨ã™ã‚‹ä¸€èˆ¬çš„ãªãƒ„ール。" -#: ../../rst/dev_guide/style_guide/index.rst:313 +#: ../../rst/dev_guide/style_guide/index.rst:315 msgid "`color filter <https://www.toptal.com/designers/colorfilter/>`_ - For color-blind testing." msgstr "`color filter <https://www.toptal.com/designers/colorfilter/>`_ - 色覚検査用。" -#: ../../rst/dev_guide/style_guide/index.rst:316 +#: ../../rst/dev_guide/style_guide/index.rst:318 msgid "More resources" msgstr "å‚考資料" -#: ../../rst/dev_guide/style_guide/index.rst:318 +#: ../../rst/dev_guide/style_guide/index.rst:320 msgid "These pages offer more help with grammatical, stylistic, and technical rules for documentation." msgstr "以下ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€ãƒ‰ã‚ュメントã«é–¢ã™ã‚‹æ–‡æ³•ã€ã‚¹ã‚¿ã‚¤ãƒ«ã€ãŠã‚ˆã³æŠ€è¡“çš„ãªãƒ«ãƒ¼ãƒ«ã‚’紹介ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/style_guide/index.rst:333 +#: ../../rst/dev_guide/style_guide/index.rst:335 msgid ":ref:`community_documentation_contributions`" msgstr ":ref:`community_documentation_contributions`" -#: ../../rst/dev_guide/style_guide/index.rst:334 +#: ../../rst/dev_guide/style_guide/index.rst:336 msgid "How to contribute to the Ansible documentation" msgstr "Ansible ドã‚ュメントã¸ã®è²¢çŒ®æ–¹æ³•" -#: ../../rst/dev_guide/style_guide/index.rst:335 +#: ../../rst/dev_guide/style_guide/index.rst:337 msgid ":ref:`testing_documentation_locally`" msgstr ":ref:`testing_documentation_locally`" -#: ../../rst/dev_guide/style_guide/index.rst:336 +#: ../../rst/dev_guide/style_guide/index.rst:338 msgid "How to build the Ansible documentation" msgstr "Ansible ドã‚ュメントã®ãƒ“ルド方法" -#: ../../rst/dev_guide/style_guide/index.rst:338 +#: ../../rst/dev_guide/style_guide/index.rst:340 msgid "#ansible-docs IRC chat channel" msgstr "IRC ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ« (#ansible-docs)" @@ -9426,7 +9176,7 @@ msgstr "アプリケーション" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:15 msgid "When used as a proper name, use the capitalization of the product, such as GNUPro or Source-Navigator. When used as a command, use lowercase as appropriate, such as \"To start GCC, type ``gcc``.\"" -msgstr "固有åè©žã¨ã—ã¦ä½¿ç”¨ã™ã‚‹å ´åˆã¯ã€GNUPro ã¾ãŸã¯ Source-Navigator ã®ã‚ˆã†ã«è£½å“ã®å¤§æ–‡å—を使用ã—ã¾ã™ã€‚コマンドã¨ã—ã¦ä½¿ç”¨ã™ã‚‹å ´åˆã¯ã€ã€ŒTo start GCC, type ``gcc``.ã€(GCC ã‚’èµ·å‹•ã™ã‚‹å ´åˆã¯ã€``gcc`` を入力ã—ã¾ã™) ã®ã‚ˆã†ã«ã€é©åˆ‡ãªå°æ–‡å—を使用ã—ã¾ã™ã€‚" +msgstr "固有åè©žã¨ã—ã¦ä½¿ç”¨ã™ã‚‹å ´åˆã¯ã€GNUPro ã¾ãŸã¯ Source-Navigator ã®ã‚ˆã†ã«è£½å“ã®å¤§æ–‡å—を使用ã—ã¾ã™ã€‚コマンドã¨ã—ã¦ä½¿ç”¨ã™ã‚‹å ´åˆã¯ã€\"To start GCC, type ``gcc``\" ã®ã‚ˆã†ã«ã€é©åˆ‡ãªå°æ–‡å—を使用ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:19 msgid "\"vi\" is always lowercase." @@ -9715,7 +9465,7 @@ msgstr "é©åˆ‡ã§ã™ã€‚コマンドをå‚ç…§ã—ã¦ã„ã‚‹å ´åˆ (ãŸã¨ãˆã°ã€ŒT #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:169 msgid "Login" -msgstr "Login" +msgstr "ãƒã‚°ã‚¤ãƒ³" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:170 msgid "A noun used to refer to the login prompt, such as \"At the login prompt, enter your username.\"" @@ -9904,7 +9654,7 @@ msgstr "US" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:269 msgid "User" -msgstr "User" +msgstr "ユーザー" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:270 msgid "When referring to the reader, use \"you\" instead of \"user.\" For example, \"The user must...\" is incorrect. Use \"You must...\" instead. If referring to more than one user, calling the collection \"users\" is acceptable, such as \"Other users may wish to access your database.\"" @@ -9912,7 +9662,7 @@ msgstr "èªã¿æ‰‹ã‚’示ã™å ´åˆã¯ã€ã€Œuserã€ã§ã¯ãªã「youã€ã‚’使用ã #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:273 msgid "Username" -msgstr "Username" +msgstr "ユーザーå" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:274 msgid "Correct. Do not use \"user name.\"" @@ -9960,7 +9710,7 @@ msgstr "é©åˆ‡ã§ã™ã€‚「webserverã€ã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。ãŸã¨ #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:297 msgid "Website" -msgstr "Website" +msgstr "Web サイト" #: ../../rst/dev_guide/style_guide/spelling_word_choice.rst:298 msgid "Correct. Do not use \"web site\" or \"Web site.\" For example, \"The Ansible website contains ...\"" @@ -10275,7 +10025,6 @@ msgid "This style guide incorporates current Ansible resources and information s msgstr "ã“ã®ã‚¹ã‚¿ã‚¤ãƒ«ã‚¬ã‚¤ãƒ‰ã«ã¯ã€ç¾åœ¨ã® Ansible リソースã¨æƒ…å ±ãŒçµ„ã¿è¾¼ã¾ã‚Œã¦ã„ã‚‹ãŸã‚ã€ã‚µã‚¤ãƒˆã¨ãƒ‰ã‚ュメント全体ã®ä¸€è²«æ€§ã‚’ä¿ã¤ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/testing.rst:5 -#: ../../rst/dev_guide/testing_running_locally.rst:7 msgid "Testing Ansible" msgstr "Ansible ã®ãƒ†ã‚¹ãƒˆ" @@ -10308,27 +10057,18 @@ msgid "At a high level we have the following classifications of tests:" msgstr "テストã¯ã€å¤§ãã分ã‘ã¦ä»¥ä¸‹ã®ã‚ˆã†ã«åˆ†é¡žã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/testing.rst -#: ../../rst/dev_guide/testing/sanity/compile.rst:2 -msgid "compile" -msgstr "コンパイル" +msgid "sanity" +msgstr "å¥å…¨æ€§" #: ../../rst/dev_guide/testing.rst:30 -msgid ":ref:`testing_compile`" -msgstr ":ref:`testing_compile`" +msgid ":ref:`testing_sanity`" +msgstr ":ref:`testing_sanity`" #: ../../rst/dev_guide/testing.rst:31 -msgid "Test python code against a variety of Python versions." -msgstr "ã•ã¾ã–ã¾ãª Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—㦠python コードをテストã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing.rst -msgid "sanity" -msgstr "å¥å…¨æ€§" - -#: ../../rst/dev_guide/testing.rst:34 msgid "Sanity tests are made up of scripts and tools used to perform static code analysis." msgstr "å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¯ã€é™çš„コード分æžã®å®Ÿè¡Œã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚¹ã‚¯ãƒªãƒ—トãŠã‚ˆã³ãƒ„ールã§æ§‹æˆã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:35 +#: ../../rst/dev_guide/testing.rst:32 msgid "The primary purpose of these tests is to enforce Ansible coding standards and requirements." msgstr "ã“れらã®ãƒ†ã‚¹ãƒˆã®ä¸»ãªç›®çš„ã¯ã€Ansible コーディングã®ä»•æ§˜ãŠã‚ˆã³è¦ä»¶ã‚’é©ç”¨ã™ã‚‹ã“ã¨ã§ã™ã€‚" @@ -10336,7 +10076,11 @@ msgstr "ã“れらã®ãƒ†ã‚¹ãƒˆã®ä¸»ãªç›®çš„ã¯ã€Ansible コーディングã®ä msgid "integration" msgstr "çµ±åˆ" -#: ../../rst/dev_guide/testing.rst:38 +#: ../../rst/dev_guide/testing.rst:34 +msgid ":ref:`testing_integration`" +msgstr ":ref:`testing_integration`" + +#: ../../rst/dev_guide/testing.rst:35 msgid "Functional tests of modules and Ansible core functionality." msgstr "モジュールãŠã‚ˆã³ Ansible コア機能ã®æ©Ÿèƒ½ãƒ†ã‚¹ãƒˆ" @@ -10344,228 +10088,224 @@ msgstr "モジュールãŠã‚ˆã³ Ansible コア機能ã®æ©Ÿèƒ½ãƒ†ã‚¹ãƒˆ" msgid "units" msgstr "ユニット" -#: ../../rst/dev_guide/testing.rst:40 +#: ../../rst/dev_guide/testing.rst:37 #: ../../rst/dev_guide/testing_units_modules.rst:567 msgid ":ref:`testing_units`" msgstr ":ref:`testing_units`" -#: ../../rst/dev_guide/testing.rst:41 +#: ../../rst/dev_guide/testing.rst:38 msgid "Tests directly against individual parts of the code base." msgstr "コードベースã®å€‹ã€…ã®éƒ¨åˆ†ã«å¯¾ã—ã¦ç›´æŽ¥ãƒ†ã‚¹ãƒˆã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:45 +#: ../../rst/dev_guide/testing.rst:42 msgid "Testing within GitHub & Azure Pipelines" msgstr "GitHub ãŠã‚ˆã³ Azure Pipeline ã§ã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing.rst:49 +#: ../../rst/dev_guide/testing.rst:46 msgid "Organization" msgstr "組織" -#: ../../rst/dev_guide/testing.rst:51 +#: ../../rst/dev_guide/testing.rst:48 msgid "When Pull Requests (PRs) are created they are tested using Azure Pipelines, a Continuous Integration (CI) tool. Results are shown at the end of every PR." msgstr "プルè¦æ±‚ (PR: Pull Requests) ãŒä½œæˆã•ã‚Œã‚‹ã¨ã€ç¶™ç¶šçš„çµ±åˆ (CI) ツールã§ã‚ã‚‹ Azure Pipeline を使用ã—ã¦ãƒ†ã‚¹ãƒˆãŒè¡Œã‚ã‚Œã¾ã™ã€‚çµæžœã¯ã™ã¹ã¦ã® PR ã®æœ€å¾Œã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:53 +#: ../../rst/dev_guide/testing.rst:50 msgid "When Azure Pipelines detects an error and it can be linked back to a file that has been modified in the PR then the relevant lines will be added as a GitHub comment. For example:" msgstr "Azure Pipeline ãŒã‚¨ãƒ©ãƒ¼ã‚’検出ã—ã€ãれ㌠PR ã§å¤‰æ›´ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã«ãƒªãƒ³ã‚¯ã•ã‚Œã‚‹ã¨ã€é–¢é€£ã™ã‚‹è¡ŒãŒ GitHub ã®ã‚³ãƒ¡ãƒ³ãƒˆã¨ã—ã¦è¿½åŠ ã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:64 +#: ../../rst/dev_guide/testing.rst:61 msgid "From the above example we can see that ``--test pep8`` and ``--test validate-modules`` have identified an issue. The commands given allow you to run the same tests locally to ensure you've fixed all issues without having to push your changes to GitHub and wait for Azure Pipelines, for example:" msgstr "上記ã®ä¾‹ã‹ã‚‰ã€``--test pep8`` ãŠã‚ˆã³ ``--test validate-modules`` ãŒå•é¡Œã‚’特定ã—ãŸã“ã¨ãŒåˆ†ã‹ã‚Šã¾ã™ã€‚指定ã•ã‚ŒãŸã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã™ã‚‹ã¨ã€åŒã˜ãƒ†ã‚¹ãƒˆã‚’ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã—ã¦ã€å¤‰æ›´ã‚’ GitHub ã«ãƒ—ッシュã—㦠Azure Pipeline ã‚’å¾…ã¤ã“ã¨ãªãã€ã™ã¹ã¦ã®å•é¡Œã‚’ä¿®æ£ã—ãŸã“ã¨ã‚’確èªã§ãã¾ã™ã€‚次ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:66 +#: ../../rst/dev_guide/testing.rst:63 msgid "If you haven't already got Ansible available, use the local checkout by running:" msgstr "Ansible ãŒã¾ã 利用ã§ãるよã†ã«ãªã£ã¦ã„ãªã„å ´åˆã¯ã€ãƒãƒ¼ã‚«ãƒ«ã§ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã‚’実行ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing.rst:72 +#: ../../rst/dev_guide/testing.rst:69 msgid "Then run the tests detailed in the GitHub comment:" msgstr "次ã«ã€GitHub コメントã§èª¬æ˜Žã™ã‚‹ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:79 +#: ../../rst/dev_guide/testing.rst:76 msgid "If there isn't a GitHub comment stating what's failed you can inspect the results by clicking on the \"Details\" button under the \"checks have failed\" message at the end of the PR." msgstr "GitHub ã®ã‚³ãƒ¡ãƒ³ãƒˆã«ä½•ãŒå¤±æ•—ã—ãŸã‹ãŒæ›¸ã‹ã‚Œã¦ã„ãªã„å ´åˆã¯ã€PR ã®æœ«å°¾ã«ã‚る「checks have failedã€ã¨ã„ã†ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®ä¸‹ã«ã‚る「Detailsã€ãƒœã‚¿ãƒ³ã‚’クリックã—ã¦çµæžœã‚’確èªã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:82 +#: ../../rst/dev_guide/testing.rst:79 msgid "Rerunning a failing CI job" msgstr "失敗ã—㟠CI ジョブã®å†å®Ÿè¡Œ" -#: ../../rst/dev_guide/testing.rst:84 +#: ../../rst/dev_guide/testing.rst:81 msgid "Occasionally you may find your PR fails due to a reason unrelated to your change. This could happen for several reasons, including:" msgstr "時折ã€å¤‰æ›´ã¨ã¯é–¢ä¿‚ã®ãªã„ç†ç”±ã§ PR ãŒå¤±æ•—ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ãªç†ç”±ãŒè€ƒãˆã‚‰ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:86 +#: ../../rst/dev_guide/testing.rst:83 msgid "a temporary issue accessing an external resource, such as a yum or git repo" msgstr "yum ã‚„ git リãƒã‚¸ãƒˆãƒªãƒ¼ãªã©ã®å¤–部リソースã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹éš›ã«ä¸€æ™‚çš„ã«å•é¡ŒãŒç™ºç”Ÿã—ãŸå ´åˆã€‚" -#: ../../rst/dev_guide/testing.rst:87 +#: ../../rst/dev_guide/testing.rst:84 msgid "a timeout creating a virtual machine to run the tests on" msgstr "テストを実行ã™ã‚‹ãŸã‚ã®ä»®æƒ³ãƒžã‚·ãƒ³ã‚’作æˆã™ã‚‹ã‚¿ã‚¤ãƒ アウト。" -#: ../../rst/dev_guide/testing.rst:89 +#: ../../rst/dev_guide/testing.rst:86 msgid "If either of these issues appear to be the case, you can rerun the Azure Pipelines test by:" msgstr "ã“れらã®å•é¡Œã®ã„ãšã‚Œã‹ãŒã‚±ãƒ¼ã‚¹ã¨ã—ã¦è¡¨ç¤ºã•ã‚Œã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã‚’実行ã—㦠Azure Pipelines テストをå†å®Ÿè¡Œã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:91 +#: ../../rst/dev_guide/testing.rst:88 msgid "adding a comment with ``/rebuild`` (full rebuild) or ``/rebuild_failed`` (rebuild only failed CI nodes) to the PR" msgstr "``/rebuild`` (完全ãªå†æ§‹ç¯‰) ã¾ãŸã¯ ``/rebuild_failed`` (構築ã«å¤±æ•—ã—㟠CI ノードã®ã¿ã®å†æ§‹ç¯‰) ã§ã®ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã™ã‚‹" -#: ../../rst/dev_guide/testing.rst:92 +#: ../../rst/dev_guide/testing.rst:89 msgid "closing and re-opening the PR (full rebuild)" msgstr "PR ã‚’é–‰ã˜ã¦å†åº¦é–‹ã (完全ãªå†æ§‹ç¯‰)" -#: ../../rst/dev_guide/testing.rst:93 +#: ../../rst/dev_guide/testing.rst:90 msgid "making another change to the PR and pushing to GitHub" msgstr "PR ã«ä½•ã‚‰ã‹ã®å¤‰æ›´ã‚’åŠ ãˆã¦ GitHub ã«ãƒ—ッシュã™ã‚‹" -#: ../../rst/dev_guide/testing.rst:95 +#: ../../rst/dev_guide/testing.rst:92 msgid "If the issue persists, please contact us in the ``#ansible-devel`` chat channel (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat/>`_)." msgstr "ãã‚Œã§ã‚‚å•é¡ŒãŒè§£æ±ºã—ãªã„å ´åˆã¯ã€``#ansible-devel`` ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã§ãŠå•ã„åˆã‚ã›ãã ã•ã„（ansible.imã§Matrixを使用ã€ã¾ãŸã¯`irc.libera.chat <https://libera.chat/>`_ã§IRCを使用）。" -#: ../../rst/dev_guide/testing.rst:99 +#: ../../rst/dev_guide/testing.rst:96 msgid "How to test a PR" msgstr "PR をテストã™ã‚‹æ–¹æ³•" -#: ../../rst/dev_guide/testing.rst:101 +#: ../../rst/dev_guide/testing.rst:98 msgid "Ideally, code should add tests that prove that the code works. That's not always possible and tests are not always comprehensive, especially when a user doesn't have access to a wide variety of platforms, or is using an API or web service. In these cases, live testing against real equipment can be more valuable than automation that runs against simulated interfaces. In any case, things should always be tested manually the first time as well." msgstr "ç†æƒ³çš„ã«ã¯ã€ã‚³ãƒ¼ãƒ‰ãŒæ©Ÿèƒ½ã™ã‚‹ã“ã¨ã‚’証明ã™ã‚‹ãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚特ã«ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒã•ã¾ã–ã¾ãªãƒ—ラットフォームã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããªã„å ´åˆã€ã¾ãŸã¯ API ã‚„ Web サービスを使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã“ã‚ŒãŒå¿…ãšã—ã‚‚å¯èƒ½ã§ã¯ãªãã€ãƒ†ã‚¹ãƒˆã‚‚å¿…ãšã—も包括的ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã“ã®ã‚ˆã†ãªå ´åˆã¯ã€ã‚·ãƒŸãƒ¥ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã•ã‚ŒãŸã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã«å¯¾ã—ã¦å®Ÿè¡Œã•ã‚Œã‚‹è‡ªå‹•åŒ–よりもã€å®Ÿéš›ã®æ©Ÿå™¨ã‚’使用ã—ãŸãƒ©ã‚¤ãƒ–テストã®æ–¹ãŒæœ‰ç›Šã¨ãªã‚Šã¾ã™ã€‚ã„ãšã‚Œã«ã›ã‚ˆã€æœ€åˆã®æ®µéšŽã§ã‚‚常ã«æ‰‹å‹•ã§ãƒ†ã‚¹ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:103 +#: ../../rst/dev_guide/testing.rst:100 msgid "Thankfully, helping to test Ansible is pretty straightforward, assuming you are familiar with how Ansible works." msgstr "Ansible ã®å‹•ä½œã‚’熟知ã—ã¦ã„ã‚Œã°ã€Ansible ã®ãƒ†ã‚¹ãƒˆã‚’手ä¼ã†ã“ã¨ã¯éžå¸¸ã«ç°¡å˜ã§ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:106 +#: ../../rst/dev_guide/testing.rst:103 msgid "Setup: Checking out a Pull Request" msgstr "è¨å®š: プルè¦æ±‚ã®ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆ" -#: ../../rst/dev_guide/testing.rst:108 +#: ../../rst/dev_guide/testing.rst:105 msgid "You can do this by:" msgstr "ã“ã‚Œã¯ã€ä»¥ä¸‹ã®æ–¹æ³•ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:110 +#: ../../rst/dev_guide/testing.rst:107 msgid "checking out Ansible" msgstr "Ansible ã®ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆ" -#: ../../rst/dev_guide/testing.rst:111 +#: ../../rst/dev_guide/testing.rst:108 msgid "fetching the proposed changes into a test branch" msgstr "æ案ã•ã‚ŒãŸå¤‰æ›´ã‚’テストブランãƒã«å–å¾—" -#: ../../rst/dev_guide/testing.rst:112 +#: ../../rst/dev_guide/testing.rst:109 msgid "testing" msgstr "テスト" -#: ../../rst/dev_guide/testing.rst:113 +#: ../../rst/dev_guide/testing.rst:110 msgid "commenting on that particular issue on GitHub" msgstr "GitHub ã«ç‰¹å®šã®å•é¡Œã«ã¤ã„ã¦ã®ã‚³ãƒ¡ãƒ³ãƒˆ" -#: ../../rst/dev_guide/testing.rst:115 +#: ../../rst/dev_guide/testing.rst:112 msgid "Here's how:" msgstr "以下ã«ã€å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:118 +#: ../../rst/dev_guide/testing.rst:115 msgid "Testing source code from GitHub pull requests sent to us does have some inherent risk, as the source code sent may have mistakes or malicious code that could have a negative impact on your system. We recommend doing all testing on a virtual machine, whether a cloud instance, or locally. Some users like Vagrant or Docker for this, but they are optional. It is also useful to have virtual machines of different Linux or other flavors, since some features (for example, package managers such as apt or yum) are specific to those OS versions." msgstr "GitHub ã®ãƒ—ルè¦æ±‚ã‹ã‚‰é€ã‚‰ã‚Œã¦ããŸã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‚’テストã™ã‚‹ã“ã¨ã«ã¯ãƒªã‚¹ã‚¯ãŒä¼´ã„ã¾ã™ã€‚é€ã‚‰ã‚Œã¦ããŸã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã«ã¯ã€é–“é•ã„や悪æ„ã®ã‚るコードãŒå«ã¾ã‚Œã¦ã„ã¦ã€ã‚·ã‚¹ãƒ†ãƒ ã«å½±éŸ¿ã‚’åŠã¼ã™å¯èƒ½æ€§ãŒã‚ã‚‹ã‹ã‚‰ã§ã™ã€‚ã™ã¹ã¦ã®ãƒ†ã‚¹ãƒˆã¯ã€ä»®æƒ³ãƒžã‚·ãƒ³ä¸Šã§è¡Œã†ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚クラウドインスタンスã§ã‚‚ãƒãƒ¼ã‚«ãƒ«ã§ã‚‚ã‹ã¾ã„ã¾ã›ã‚“。ã“ã®ãŸã‚ã« Vagrant ã‚„ Docker を好むユーザーもã„ã¾ã™ãŒã€ã“れらã¯ä»»æ„ã§ã™ã€‚ã¾ãŸã€ã„ãã¤ã‹ã®æ©Ÿèƒ½ (ãŸã¨ãˆã°ã€apt ã‚„ yum ãªã©ã®ãƒ‘ッケージマãƒãƒ¼ã‚¸ãƒ£ãƒ¼) ã¯ã€ãれら㮠OS ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å›ºæœ‰ã®ã‚‚ã®ã§ã‚ã‚‹ãŸã‚ã€ç•°ãªã‚‹ Linux ã‚„ãã®ä»–ã®ãƒ•ãƒ¬ãƒ¼ãƒãƒ¼ã®ä»®æƒ³ãƒžã‚·ãƒ³ã‚’用æ„ã—ã¦ãŠãã¨ä¾¿åˆ©ã§ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:125 +#: ../../rst/dev_guide/testing.rst:122 msgid "Create a fresh area to work:" msgstr "作æ¥ç”¨ã«æ–°ã—ã„é ˜åŸŸã‚’ä½œæˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:132 -msgid "Next, find the pull request you'd like to test and make note of its number. It will look something like this::" +#: ../../rst/dev_guide/testing.rst:129 +msgid "Next, find the pull request you'd like to test and make note of its number. It will look something like this:" msgstr "次ã«ã€ãƒ†ã‚¹ãƒˆã™ã‚‹ãƒ—ルè¦æ±‚を見ã¤ã‘ã¦ã€ãã®ç•ªå·ã‚’書ãç•™ã‚ã¾ã™ã€‚次ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:136 +#: ../../rst/dev_guide/testing.rst:135 msgid "Only test ``ansible:devel``" msgstr "``ansible:devel`` ã®ã¿ã‚’テストã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:138 +#: ../../rst/dev_guide/testing.rst:137 msgid "It is important that the PR request target be ``ansible:devel``, as we do not accept pull requests into any other branch. Dot releases are cherry-picked manually by Ansible staff." msgstr "ä»–ã®ãƒ–ランãƒã¸ã®ãƒ—ルè¦æ±‚ã¯ä½¿ç”¨ã§ããªã„ãŸã‚ã€PR è¦æ±‚ã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã¯ ``ansible:devel`` ã«ã™ã‚‹ã“ã¨ãŒé‡è¦ã§ã™ã€‚ドットリリースã¯ã€Ansible ã®ã‚¹ã‚¿ãƒƒãƒ•ãŒå…¥å¿µã«é¸æŠžã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:140 +#: ../../rst/dev_guide/testing.rst:139 msgid "Use the pull request number when you fetch the proposed changes and create your branch for testing:" msgstr "æ案ã•ã‚ŒãŸå¤‰æ›´ã‚’å–å¾—ã—ã€ãƒ†ã‚¹ãƒˆç”¨ã«ãƒ–ランãƒã‚’作æˆã™ã‚‹ã¨ãã«ãƒ—ルè¦æ±‚番å·ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:147 +#: ../../rst/dev_guide/testing.rst:146 msgid "The first command fetches the proposed changes from the pull request and creates a new branch named ``testing_PRXXXX``, where the XXXX is the actual number associated with the pull request (for example, 65381). The second command checks out the newly created branch." msgstr "1 ã¤ç›®ã®ã‚³ãƒžãƒ³ãƒ‰ã¯ãƒ—ルè¦æ±‚ã‹ã‚‰æ案ã•ã‚ŒãŸå¤‰æ›´ã‚’å–å¾—ã—ã€``testing_PRXXXX`` ã¨ã„ã†åå‰ã®æ–°è¦ãƒ–ランãƒã‚’作æˆã—ã¾ã™ã€‚XXXX ã¯ãƒ—ルè¦æ±‚ã«é–¢é€£ã™ã‚‹å®Ÿéš›ã®ç•ªå· (例: 65381) ã§ã™ã€‚2 ã¤ç›®ã®ã‚³ãƒžãƒ³ãƒ‰ã¯ã€æ–°ãŸã«ä½œæˆã•ã‚ŒãŸãƒ–ランãƒã‚’ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:150 +#: ../../rst/dev_guide/testing.rst:149 msgid "If the GitHub user interface shows that the pull request will not merge cleanly, we do not recommend proceeding if you are not somewhat familiar with git and coding, as you will have to resolve a merge conflict. This is the responsibility of the original pull request contributor." msgstr "GitHub ユーザーインターフェースã§ã€ãƒ—ルè¦æ±‚ãŒæ£å¸¸ã«ãƒžãƒ¼ã‚¸ã•ã‚Œãªã„ã¨ç¤ºã•ã‚ŒãŸå ´åˆã¯ã€ãƒžãƒ¼ã‚¸ã®ç«¶åˆã‚’解決ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ãŸã‚ã€git ãŠã‚ˆã³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã«ã‚ã¾ã‚Šç²¾é€šã—ã¦ã„ãªã„å ´åˆã¯ã€ç¶šè¡Œã—ãªã„ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã¯ã€å…ƒã®ãƒ—ルè¦æ±‚ã®æŠ•ç¨¿è€…ã®è²¬ä»»ã§ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:153 +#: ../../rst/dev_guide/testing.rst:152 msgid "Some users do not create feature branches, which can cause problems when they have multiple, unrelated commits in their version of ``devel``. If the source looks like ``someuser:devel``, make sure there is only one commit listed on the pull request." msgstr "一部ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯æ©Ÿèƒ½ãƒ–ランãƒã‚’作æˆã—ãªã„ãŸã‚ã€``devel`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«é–¢é€£æ€§ã®ãªã„コミットãŒè¤‡æ•°ã‚ã‚‹å ´åˆã«ã€å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ソース㌠``someuser:devel`` ã®ã‚ˆã†ã«è¡¨ç¤ºã•ã‚Œã‚‹å ´åˆã¯ã€ãƒ—ルè¦æ±‚ã«è¨˜è¼‰ã•ã‚Œã¦ã„るコミット㌠1 ã¤ã ã‘ã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing.rst:155 +#: ../../rst/dev_guide/testing.rst:154 msgid "The Ansible source includes a script that allows you to use Ansible directly from source without requiring a full installation that is frequently used by developers on Ansible." msgstr "Ansible ã®ã‚½ãƒ¼ã‚¹ã«ã¯ã€Ansible ã®é–‹ç™ºè€…ãŒé »ç¹ã«ä½¿ç”¨ã™ã‚‹ãƒ•ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’å¿…è¦ã¨ã›ãšã€ã‚½ãƒ¼ã‚¹ã‹ã‚‰ç›´æŽ¥ Ansible を使用ã™ã‚‹ã‚ˆã†ã«ã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:158 +#: ../../rst/dev_guide/testing.rst:157 msgid "Simply source it (to use the Linux/Unix terminology) to begin using it immediately:" msgstr "ソースを作æˆã™ã‚‹ã ã‘ (Linux/Unix ã®ç”¨èªžã‚’使用ã™ã‚‹ãŸã‚ã«) ã§ã€ã™ãã«ä½¿ã„始ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:164 +#: ../../rst/dev_guide/testing.rst:163 msgid "This script modifies the ``PYTHONPATH`` environment variables (along with a few other things), which will be temporarily set as long as your shell session is open." msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€``PYTHONPATH`` 環境変数を変更ã—ã¾ã™ (ä»–ã«ã‚‚ã„ãã¤ã‹ã‚ã‚Šã¾ã™)。ã“ã‚Œã¯ã€ã‚·ã‚§ãƒ«ã‚»ãƒƒã‚·ãƒ§ãƒ³ãŒé–‹ã„ã¦ã„ã‚‹é–“ã¯ä¸€æ™‚çš„ã«è¨å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:168 +#: ../../rst/dev_guide/testing.rst:167 msgid "Testing the Pull Request" msgstr "プルè¦æ±‚ã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing.rst:170 +#: ../../rst/dev_guide/testing.rst:169 msgid "At this point, you should be ready to begin testing!" msgstr "ã“ã®æ™‚点ã§ãƒ†ã‚¹ãƒˆã‚’開始ã™ã‚‹æº–å‚™ãŒæ•´ã„ã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/testing.rst:172 +#: ../../rst/dev_guide/testing.rst:171 msgid "Some ideas of what to test are:" msgstr "何をテストã™ã‚‹ã‹ã®ã‚¢ã‚¤ãƒ‡ã‚¢ã‚’ã„ãã¤ã‹æŒ™ã’ã¦ã¿ã¾ã—ょã†ã€‚" -#: ../../rst/dev_guide/testing.rst:174 +#: ../../rst/dev_guide/testing.rst:173 msgid "Create a test Playbook with the examples in and check if they function correctly" msgstr "例題をå«ã‚€ãƒ†ã‚¹ãƒˆ Playbook を作æˆã—ã€ãれらãŒæ£ã—ã機能ã™ã‚‹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:175 +#: ../../rst/dev_guide/testing.rst:174 msgid "Test to see if any Python backtraces returned (that's a bug)" msgstr "Python ã®ãƒãƒƒã‚¯ãƒˆãƒ¬ãƒ¼ã‚¹ãŒè¿”ã•ã‚Œã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’テストã—ã¾ã™ (ã“ã‚Œã¯ãƒã‚°ã§ã™)。" -#: ../../rst/dev_guide/testing.rst:176 +#: ../../rst/dev_guide/testing.rst:175 msgid "Test on different operating systems, or against different library versions" msgstr "ç•°ãªã‚‹ã‚ªãƒšãƒ¬ãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚·ã‚¹ãƒ†ãƒ ã§ã€ã¾ãŸã¯ç•°ãªã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒ©ã‚¤ãƒ–ラリーã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:179 +#: ../../rst/dev_guide/testing.rst:178 msgid "Run sanity tests" msgstr "å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œ" -#: ../../rst/dev_guide/testing.rst:185 +#: ../../rst/dev_guide/testing.rst:184 msgid "More information: :ref:`testing_sanity`" msgstr "è©³ç´°æƒ…å ±: :ref:`testing_sanity`" -#: ../../rst/dev_guide/testing.rst:188 +#: ../../rst/dev_guide/testing.rst:187 msgid "Run unit tests" msgstr "ユニットテストã®å®Ÿè¡Œ" -#: ../../rst/dev_guide/testing.rst:194 +#: ../../rst/dev_guide/testing.rst:193 msgid "More information: :ref:`testing_units`" msgstr "è©³ç´°æƒ…å ±: :ref:`testing_units`" -#: ../../rst/dev_guide/testing.rst:197 +#: ../../rst/dev_guide/testing.rst:196 msgid "Run integration tests" msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œ" -#: ../../rst/dev_guide/testing.rst:203 +#: ../../rst/dev_guide/testing.rst:202 msgid "More information: :ref:`testing_integration`" msgstr "è©³ç´°æƒ…å ±: :ref:`testing_integration`" -#: ../../rst/dev_guide/testing.rst:205 +#: ../../rst/dev_guide/testing.rst:204 msgid "Any potential issues should be added as comments on the pull request (and it's acceptable to comment if the feature works as well), remembering to include the output of ``ansible --version``" msgstr "潜在的ãªå•é¡ŒãŒã‚ã‚Œã°ã€ãƒ—ルè¦æ±‚ã«ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (機能ãŒæ£å¸¸ã«å‹•ä½œã™ã‚‹å ´åˆã‚‚コメントã—ã¦ã‚‚ã‹ã¾ã„ã¾ã›ã‚“)。忘れãšã« ``ansible --version`` ã®å‡ºåŠ›ã‚’転載ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing.rst:207 -msgid "Example::" -msgstr "例:" - -#: ../../rst/dev_guide/testing.rst:211 +#: ../../rst/dev_guide/testing.rst:212 msgid "If the PR does not resolve the issue, or if you see any failures from the unit/integration tests, just include that output instead:" msgstr "PR ãŒå•é¡Œã‚’解決ã—ãªã„å ´åˆã‚„ã€ãƒ¦ãƒ‹ãƒƒãƒˆ/çµ±åˆãƒ†ã‚¹ãƒˆã§ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—ãŸå ´åˆã¯ã€ä»£ã‚ã‚Šã«ãã®å‡ºåŠ›ã‚’転載ã—ã¦ãã ã•ã„。" @@ -10593,23 +10333,23 @@ msgstr "StackTrace" msgid "some other output" msgstr "some other output" -#: ../../rst/dev_guide/testing.rst:224 +#: ../../rst/dev_guide/testing.rst:225 msgid "Code Coverage Online" msgstr "オンラインã®ã‚³ãƒ¼ãƒ‰ã‚«ãƒãƒ¬ãƒ¼ã‚¸" -#: ../../rst/dev_guide/testing.rst:226 +#: ../../rst/dev_guide/testing.rst:227 msgid "`The online code coverage reports <https://codecov.io/gh/ansible/ansible>`_ are a good way to identify areas for testing improvement in Ansible. By following red colors you can drill down through the reports to find files which have no tests at all. Adding both integration and unit tests which show clearly how code should work, verify important Ansible functions and increase testing coverage in areas where there is none is a valuable way to help improve Ansible." msgstr "`オンラインコードカãƒãƒ¬ãƒ¼ã‚¸ãƒ¬ãƒãƒ¼ãƒˆ <https://codecov.io/gh/ansible/ansible>`_ ã¯ã€Ansible ã§ãƒ†ã‚¹ãƒˆãŒå‘上ã™ã‚‹é ˜åŸŸã‚’特定ã™ã‚‹ã®ãŒé©åˆ‡ãªæ–¹æ³•ã§ã™ã€‚赤ã„色ã«å¾“ã†ã“ã¨ã§ã€ãƒ¬ãƒãƒ¼ãƒˆã‚’掘り下ã’ã¦ã€ãƒ†ã‚¹ãƒˆãŒã¾ã£ãŸããªã„ファイルを見ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚コードãŒã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã™ã‚‹ã‹ã‚’明確ã«ç¤ºã™çµ±åˆãƒ†ã‚¹ãƒˆã¨ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã®ä¸¡æ–¹ã‚’è¿½åŠ ã—ã€é‡è¦ãª Ansible 関数を検証ã—ã€å˜åœ¨ã—ãªã„é ˜åŸŸã§ãƒ†ã‚¹ãƒˆç¯„囲を拡大ã™ã‚‹ã“ã¨ã¯ã€Ansible ã®æ”¹å–„ã«å½¹ç«‹ã¤è²´é‡ãªæ–¹æ³•ã§ã™ã€‚" -#: ../../rst/dev_guide/testing.rst:233 +#: ../../rst/dev_guide/testing.rst:234 msgid "The code coverage reports only cover the ``devel`` branch of Ansible where new feature development takes place. Pull requests and new code will be missing from the codecov.io coverage reports so local reporting is needed. Most ``ansible-test`` commands allow you to collect code coverage, this is particularly useful to indicate where to extend testing. See :ref:`testing_running_locally` for more information." msgstr "コードカãƒãƒ¬ãƒƒã‚¸ãƒ¬ãƒãƒ¼ãƒˆã¯ã€æ–°ã—ã„機能開発ãŒè¡Œã‚れる Ansible ã® ``devel`` ブランãƒã®ã¿ã‚’対象ã¨ã—ã¾ã™ã€‚プルè¦æ±‚ãŠã‚ˆã³æ–°è¦ã‚³ãƒ¼ãƒ‰ã¯ codecov.io ã®ã‚«ãƒãƒ¬ãƒƒã‚¸ãƒ¬ãƒãƒ¼ãƒˆã«å«ã¾ã‚Œãªã„ãŸã‚ã€ãƒãƒ¼ã‚«ãƒ«ãƒ¬ãƒãƒ¼ãƒˆãŒå¿…è¦ã«ãªã‚‹ã‚ˆã†ã§ã™ã€‚ã»ã¨ã‚“ã©ã® ``ansible-test`` コマンドã§ã¯ã€ã‚³ãƒ¼ãƒ‰ã‚«ãƒãƒ¬ãƒƒã‚¸ã‚’åŽé›†ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ†ã‚¹ãƒˆã‚’æ‹¡å¼µã™ã‚‹å ´æ‰€ã‚’示ã™ã®ã«ç‰¹ã«å½¹ã«ç«‹ã¡ã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`testing_running_locally`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing.rst:241 +#: ../../rst/dev_guide/testing.rst:242 msgid "Want to know more about testing?" msgstr "テストã«é–¢ã™ã‚‹è©³ç´°æƒ…å ±" -#: ../../rst/dev_guide/testing.rst:243 +#: ../../rst/dev_guide/testing.rst:244 msgid "If you'd like to know more about the plans for improving testing Ansible then why not join the `Testing Working Group <https://github.com/ansible/community/blob/main/meetings/README.md>`_." msgstr "Ansible テストを改善ã™ã‚‹è©³ç´°ãªè¨ˆç”»ã‚’確èªã—ãŸã„å ´åˆã¯ã€`Testing Working Group <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã”å‚åŠ ãã ã•ã„。" @@ -10746,8 +10486,60 @@ msgid "See :ref:`collection_changelogs` for details." msgstr "詳ã—ãã¯ã€:ref:`collection_changelogs` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/testing/sanity/compile.rst:4 -msgid "See :ref:`testing_compile` for more information." -msgstr "詳細ã¯ã€ã€Œ:ref:`testing_compile`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "compile" +msgstr "コンパイル" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:6 +msgid "All Python source files must successfully compile using all supported Python versions." +msgstr "ã™ã¹ã¦ã® Python ソースファイルã¯ã€ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã—ã¦æ£å¸¸ã«ã‚³ãƒ³ãƒ‘イルã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:10 +msgid "The list of supported Python versions is dependent on the version of ``ansible-core`` that you are using. Make sure you consult the version of the documentation which matches your ``ansible-core`` version." +msgstr "サãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒªã‚¹ãƒˆã¯ã€ä½¿ç”¨ã—ã¦ã„ã‚‹ ``ansible-core`` ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã‚ˆã‚Šç•°ãªã‚Šã¾ã™ã€‚使用ã—ã¦ã„ã‚‹ ``ansible-core`` ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ä¸€è‡´ã™ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:13 +msgid "Controller code, including plugins in Ansible Collections, must support the following Python versions:" +msgstr "Ansible コレクションã®ãƒ—ラグインをå«ã‚ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã¯æ¬¡ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’サãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:15 +msgid "3.11" +msgstr "3.11" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:16 +msgid "3.10" +msgstr "3.10" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:17 +msgid "3.9" +msgstr "3.9" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:19 +msgid "Code which runs on targets (``modules`` and ``module_utils``) must support all controller supported Python versions, as well as the additional Python versions supported only on targets:" +msgstr "ターゲット上ã§å®Ÿè¡Œã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰ (``modules`` 㨠``module_utils``) ã¯ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã€ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã§ã®ã¿ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹è¿½åŠ ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’サãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:22 +msgid "3.8" +msgstr "3.8" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:23 +msgid "3.7" +msgstr "3.7" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:24 +msgid "3.6" +msgstr "3.6" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:25 +msgid "3.5" +msgstr "3.5" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:26 +msgid "2.7" +msgstr "2.7" + +#: ../../rst/dev_guide/testing/sanity/compile.rst:30 +msgid "Ansible Collections can be `configured <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/config/config.yml>`_ to support a subset of the target-only Python versions." +msgstr "Ansible コレクションã¯ã€`configured <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/config/config.yml>`_ ターゲットã®ã¿ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚µãƒ–セットをサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/configure-remoting-ps1.rst:2 msgid "configure-remoting-ps1" @@ -10804,7 +10596,7 @@ msgid "Most Python files should include the following boilerplate at the top of msgstr "ã»ã¨ã‚“ã©ã® Python ファイルã«ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®ä¸Šéƒ¨ã€ã‚³ãƒ¡ãƒ³ãƒˆãƒ˜ãƒƒãƒ€ãƒ¼ã®ç›´å¾Œã«æ¬¡ã® boilerplate ã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:11 -msgid "This uses Python 3 semantics for absolute vs relative imports, division, and print. By doing this, we can write code which is portable between Python 2 and Python 3 by following the Python 3 semantics." +msgid "This uses Python 3 semantics for absolute versus relative imports, division, and print. By doing this, we can write code which is portable between Python 2 and Python 3 by following the Python 3 semantics." msgstr "ã“ã“ã§ã¯ã€çµ¶å¯¾çš„インãƒãƒ¼ãƒˆã¨ç›¸å¯¾çš„インãƒãƒ¼ãƒˆã€é™¤ç®—ã€ãŠã‚ˆã³å‡ºåŠ›ã« Python 3 セマンティクスを使用ã—ã¾ã™ã€‚Python 3 セマンティクスã«å¾“ã£ã¦ã€Python 2 㨠Python 3 ã®é–“ã§ç§»æ¤å¯èƒ½ãªã‚³ãƒ¼ãƒ‰ã‚’作æˆã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:18 @@ -10813,7 +10605,7 @@ msgstr "Python 2 ã¯ã€``import copy`` ã®ã‚ˆã†ãªãƒ•ã‚¡ã‚¤ãƒ«åã®ã€Œimport〠#: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:28 msgid "`Absolute and relative imports <https://www.python.org/dev/peps/pep-0328>`_" -msgstr "`絶対ãŠã‚ˆã³ç›¸å¯¾ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ <https://www.python.org/dev/peps/pep-0328>`_" +msgstr "`Absolute and relative imports <https://www.python.org/dev/peps/pep-0328>`_" #: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:33 msgid "In Python 2, the division operator (``/``) returns integer values when used with integers. If there was a remainder, this part would be left off (aka, `floor division`). In Python 3, the division operator (``/``) always returns a floating point number. Code that needs to calculate the integer portion of the quotient needs to switch to using the floor division operator (`//`) instead." @@ -10821,7 +10613,7 @@ msgstr "Python 2 ã§ã¯ã€é™¤ç®—演算å (``/``) ã¯ã€æ•´æ•°ã¨å…±ã«ä½¿ç”¨ã™ #: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:40 msgid "`Changing the division operator <https://www.python.org/dev/peps/pep-0238>`_" -msgstr "`除算演算åã®å¤‰æ›´ <https://www.python.org/dev/peps/pep-0238>`_" +msgstr "`Changing the division operator <https://www.python.org/dev/peps/pep-0238>`_" #: ../../rst/dev_guide/testing/sanity/future-import-boilerplate.rst:45 msgid "In Python 2, :func:`python:print` is a keyword. In Python 3, :func:`python3:print` is a function with different parameters. Using this ``__future__`` allows using the Python 3 print semantics everywhere." @@ -10881,7 +10673,7 @@ msgstr "ignore ファイルã®å ´æ‰€ã¯ã€ãƒ†ã‚¹ãƒˆã™ã‚‹ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ç¨®é¡ #: ../../rst/dev_guide/testing/sanity/ignores.rst:41 msgid "Ansible Collections" -msgstr "Ansible コレクション" +msgstr "Ansible Collections" #: ../../rst/dev_guide/testing/sanity/ignores.rst:43 msgid "Since sanity tests change between Ansible releases, a separate ignore file is needed for each Ansible major release." @@ -10920,51 +10712,51 @@ msgid "The second column specifies the sanity test that the entry applies to. Th msgstr "2 列目ã¯ã€ã‚¨ãƒ³ãƒˆãƒªãƒ¼ãŒé©ç”¨ã•ã‚Œã‚‹å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’指定ã—ã¾ã™ã€‚ã“ã‚ŒãŒå¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®åå‰ã«ãªã‚Šã¾ã™ã€‚Python ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å›ºæœ‰ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’使用ã™ã‚‹å ´åˆã¯ã€åå‰ã«ãƒ€ãƒƒã‚·ãƒ¥ (``-``) ã¨é–¢é€£ã™ã‚‹ Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒå«ã¾ã‚Œã¾ã™ã€‚åå‰ä»˜ãテストãŒã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã‚’使用ã™ã‚‹å ´åˆã¯ã€ç„¡è¦–ã™ã‚‹ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã‚’コãƒãƒ³ (``:``) ã§åŒºåˆ‡ã£ã¦ãƒ†ã‚¹ãƒˆã®åå‰ã«è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/ignores.rst:74 -msgid "Below are some example ignore entries for an Ansible collection::" -msgstr "以下ã®ä¾‹ã¯ã€Ansible コレクション㮠ignore エントリーã®ä¾‹ã§ã™ã€‚" +msgid "Below are some example ignore entries for an Ansible collection:" +msgstr "以下ã¯ã€Ansible コレクション㮠ignore エントリーã®ä¾‹ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:80 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:82 msgid "It is also possible to skip a sanity test for a specific file. This is done by adding ``!skip`` after the sanity test name in the second column. When this is done, no error code is included, even if the sanity test uses error codes." msgstr "特定ファイルã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’スã‚ップã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€2 番目ã®ã‚³ãƒ©ãƒ ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆåã®å¾Œã« ``!skip`` ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§è¡Œã„ã¾ã™ã€‚ã“れを行ã†ã¨ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã§ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã‚’使用ã—ã¦ã‚‚ã€ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã¯å«ã¾ã‚Œã¾ã›ã‚“。" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:84 -msgid "Below are some example skip entries for an Ansible collection::" -msgstr "以下ã¯ã€Ansible コレクションã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’スã‚ップã™ã‚‹ä¾‹ã§ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/ignores.rst:86 +msgid "Below are some example skip entries for an Ansible collection:" +msgstr "以下ã¯ã€Ansible コレクション㮠skip エントリーã®ä¾‹ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:89 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:93 #: ../../rst/dev_guide/testing_sanity.rst:56 msgid "See the full list of :ref:`sanity tests <all_sanity_tests>`, which details the various tests and details how to fix identified issues." msgstr "å„種テストや特定ã•ã‚ŒãŸå•é¡Œã‚’解決ã™ã‚‹æ–¹æ³•ã®è©³ç´°ã¯ã€ã€Œ:ref:`å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ <all_sanity_tests>`ã€ã®ä¸€è¦§ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:92 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:96 msgid "Ignore File Errors" msgstr "ignore ファイルエラー" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:94 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:98 msgid "There are various errors that can be reported for the ignore file itself:" msgstr "ignore ファイル自体ã«ã¤ã„ã¦å ±å‘Šã§ãã‚‹ã•ã¾ã–ã¾ãªã‚¨ãƒ©ãƒ¼ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:96 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:100 msgid "syntax errors parsing the ignore file" msgstr "ignore ファイルを解æžã™ã‚‹æ§‹æ–‡ã‚¨ãƒ©ãƒ¼" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:97 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:101 msgid "references a file path that does not exist" msgstr "å˜åœ¨ã—ãªã„ファイルパスをå‚ç…§" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:98 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:102 msgid "references to a sanity test that does not exist" msgstr "å˜åœ¨ã—ãªã„å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¸ã®å‚ç…§" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:99 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:103 msgid "ignoring an error that does not occur" msgstr "発生ã—ãªã„エラーを無視" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:100 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:104 msgid "ignoring a file which is skipped" msgstr "スã‚ップã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã‚’無視" -#: ../../rst/dev_guide/testing/sanity/ignores.rst:101 +#: ../../rst/dev_guide/testing/sanity/ignores.rst:105 msgid "duplicate entries" msgstr "é‡è¤‡ã‚¨ãƒ³ãƒˆãƒªãƒ¼" @@ -10973,58 +10765,103 @@ msgid "import" msgstr "import" #: ../../rst/dev_guide/testing/sanity/import.rst:4 -msgid "Ansible allows unchecked imports of some libraries from specific directories, listed at the bottom of this section. Import all other Python libraries in a try/except ImportError block to support sanity tests such as ``validate-modules`` and to allow Ansible to give better error messages to the user. To import a library in a try/except ImportError block:" -msgstr "Ansible ã§ã¯ã€ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸‹éƒ¨ã«è¨˜è¼‰ã•ã‚Œã¦ã„る特定ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰ã€ã„ãã¤ã‹ã®ãƒ©ã‚¤ãƒ–ラリーを確èªã›ãšã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚``validate-modules`` ãªã©ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’サãƒãƒ¼ãƒˆã—ã€Ansible ãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã«é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’表示ã§ãるよã†ã«ã™ã‚‹ãŸã‚ã€try/except ImportError ブãƒãƒƒã‚¯ã§ä»–ã®ã™ã¹ã¦ã® Python ライブラリーをインãƒãƒ¼ãƒˆã—ã¾ã™ã€‚try/except ImportError ブãƒãƒƒã‚¯ã§ãƒ©ã‚¤ãƒ–ラリをインãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€æ¬¡ã‚’è¡Œã„ã¾ã™ã€‚" +msgid "Ansible :ref:`allows unchecked imports<allowed_unchecked_imports>` of some libraries from specific directories. Importing any other Python library requires :ref:`handling import errors<handling_import_errors>`. This enables support for sanity tests such as :ref:`testing_validate-modules` and provides better error messages to the user." +msgstr "Ansible ã§ã¯ã€ç‰¹å®šã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰ã®ä¸€éƒ¨ãƒ©ã‚¤ãƒ–ラリー㮠:ref:`allows unchecked imports<allowed_unchecked_imports>` ãŒå¯èƒ½ã§ã™ã€‚ä»–ã® Python ライブラリーをインãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€:ref:`handling import errors<handling_import_errors>` ãŒå¿…è¦ã§ã™ã€‚ãã®ãŸã‚ã€:ref:`testing_validate-modules` ãªã©ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¸ã®ã‚µãƒãƒ¼ãƒˆãŒå¯èƒ½ã«ãªã‚Šã€ã‚ˆã‚Šé©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’ユーザーã«æä¾›ã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:6 -msgid "In modules:" -msgstr "モジュールã®å ´åˆ:" +#: ../../rst/dev_guide/testing/sanity/import.rst:11 +msgid "Handling import errors" +msgstr "インãƒãƒ¼ãƒˆã‚¨ãƒ©ãƒ¼ã®å‡¦ç†" -#: ../../rst/dev_guide/testing/sanity/import.rst:33 -msgid "In plugins:" -msgstr "プラグインã®å ´åˆ:" +#: ../../rst/dev_guide/testing/sanity/import.rst:14 +msgid "In modules" +msgstr "モジュールã®å ´åˆ" + +#: ../../rst/dev_guide/testing/sanity/import.rst:16 +#: ../../rst/dev_guide/testing/sanity/import.rst:51 +msgid "Instead of using ``import another_library``:" +msgstr "``import another_library`` ã®ä»£ã‚ã‚Šã¨ã—ã¦:" + +#: ../../rst/dev_guide/testing/sanity/import.rst:35 +msgid "The ``missing_required_lib`` import above will be used below." +msgstr "上記㮠``missing_required_lib`` インãƒãƒ¼ãƒˆã¯ä»¥ä¸‹ã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/import.rst:37 +msgid "Then in the module code:" +msgstr "モジュールコードã®å ´åˆ:" + +#: ../../rst/dev_guide/testing/sanity/import.rst:49 +msgid "In plugins" +msgstr "プラグインã®å ´åˆ" + +#: ../../rst/dev_guide/testing/sanity/import.rst:62 +msgid "Then in the plugin code, for example in ``__init__`` of the plugin:" +msgstr "プラグインコード (例: プラグイン㮠``__init__``) ã®å ´åˆ:" + +#: ../../rst/dev_guide/testing/sanity/import.rst:70 +msgid "When used as base classes" +msgstr "ベースクラスã¨ã—ã¦ä½¿ç”¨ã™ã‚‹å ´åˆ" + +#: ../../rst/dev_guide/testing/sanity/import.rst:74 +msgid "This solution builds on the previous two examples. Make sure to pick the appropriate one before continuing with this solution." +msgstr "ã“ã®ã‚½ãƒªãƒ¥ãƒ¼ã‚·ãƒ§ãƒ³ã¯ã€å‰ã® 2 ã¤ã®ä¾‹ã«åŸºã¥ã„ã¦ã„ã¾ã™ã€‚ã“ã®ã‚½ãƒªãƒ¥ãƒ¼ã‚·ãƒ§ãƒ³ã‚’続行ã™ã‚‹å‰ã«ã€å¿…ãšé©åˆ‡ãªã‚‚ã®ã‚’é¸æŠžã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing/sanity/import.rst:58 +#: ../../rst/dev_guide/testing/sanity/import.rst:77 +msgid "Sometimes an import is used in a base class, for example:" +msgstr "インãƒãƒ¼ãƒˆã¯åŸºæœ¬ã‚¯ãƒ©ã‚¹ã§ä½¿ç”¨ã•ã‚Œã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚以下ã¯ãã®ä¾‹ã§ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/import.rst:86 +msgid "One option is make the entire class definition conditional:" +msgstr "オプション㮠1 ã¤ã¨ã—ã¦ã€ã‚¯ãƒ©ã‚¹å®šç¾©å…¨ä½“ã‚’æ¡ä»¶ä»˜ãã«ã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/import.rst:94 +msgid "Another option is to define a substitute base class by modifying the exception handler:" +msgstr "もㆠ1 ã¤ã®ã‚ªãƒ—ションã¨ã—ã¦ã€ä¾‹å¤–ãƒãƒ³ãƒ‰ãƒ©ãƒ¼ã‚’変更ã—ã¦ä»£æ›¿ã®ãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ã‚’定義ã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/import.rst:108 +msgid "Allowed unchecked imports" +msgstr "未確èªã‚¤ãƒ³ãƒãƒ¼ãƒˆã®è¨±å¯" + +#: ../../rst/dev_guide/testing/sanity/import.rst:110 msgid "Ansible allows the following unchecked imports from these specific directories:" msgstr "Ansible ã§ã¯ã€ã“れらã®ç‰¹å®šã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰æ¬¡ã®æœªç¢ºèªã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’許å¯ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:60 +#: ../../rst/dev_guide/testing/sanity/import.rst:112 msgid "ansible-core:" msgstr "ansible-core:" -#: ../../rst/dev_guide/testing/sanity/import.rst:62 +#: ../../rst/dev_guide/testing/sanity/import.rst:114 msgid "For ``lib/ansible/modules/`` and ``lib/ansible/module_utils/``, unchecked imports are only allowed from the Python standard library;" msgstr "``lib/ansible/modules/`` ãŠã‚ˆã³ ``lib/ansible/module_utils/`` ã®å ´åˆã€æœªç¢ºèªã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ Python 標準ライブラリーã§ã®ã¿åˆ©ç”¨å¯èƒ½ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:63 +#: ../../rst/dev_guide/testing/sanity/import.rst:115 msgid "For ``lib/ansible/plugins/``, unchecked imports are only allowed from the Python standard library, from public dependencies of ansible-core, and from ansible-core itself;" msgstr "``lib/ansible/plugins/`` ã§ã¯ã€æœªç¢ºèªã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ã€Python 標準ライブラリーã€ansible-core ã®ãƒ‘ブリックä¾å˜é–¢ä¿‚ã€ãŠã‚ˆã³ ansible-core 自体ã‹ã‚‰ã®ã¿è¨±å¯ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:65 +#: ../../rst/dev_guide/testing/sanity/import.rst:117 msgid "collections:" msgstr "コレクション:" -#: ../../rst/dev_guide/testing/sanity/import.rst:67 +#: ../../rst/dev_guide/testing/sanity/import.rst:119 msgid "For ``plugins/modules/`` and ``plugins/module_utils/``, unchecked imports are only allowed from the Python standard library;" msgstr "``plugins/modules/`` ãŠã‚ˆã³ ``plugins/module_utils/`` ã®å ´åˆã€æœªç¢ºèªã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ Python 標準ライブラリーã§ã®ã¿åˆ©ç”¨å¯èƒ½ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:68 +#: ../../rst/dev_guide/testing/sanity/import.rst:120 msgid "For other directories in ``plugins/`` (see `the community collection requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#modules-plugins>`_ for a list), unchecked imports are only allowed from the Python standard library, from public dependencies of ansible-core, and from ansible-core itself." msgstr "``plugins/`` ã®ãã®ä»–ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ (一覧ã¯ã€Œ`the community collection requirements <https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#modules-plugins>`_ã€ã‚’å‚ç…§) ã§ã¯ã€æœªç¢ºèªã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ Python 標準ライブラリーã€ansible-core ã®ãƒ‘ブリックä¾å˜é–¢ä¿‚ã€ãŠã‚ˆã³ ansible-core 自体ã‹ã‚‰ã®ã¿è¨±å¯ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:70 +#: ../../rst/dev_guide/testing/sanity/import.rst:122 msgid "Public dependencies of ansible-core are:" msgstr "ansible-core ã®ãƒ‘ブリックä¾å˜é–¢ä¿‚ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/import.rst:72 +#: ../../rst/dev_guide/testing/sanity/import.rst:124 msgid "Jinja2" msgstr "Jinja2" -#: ../../rst/dev_guide/testing/sanity/import.rst:73 +#: ../../rst/dev_guide/testing/sanity/import.rst:125 msgid "PyYAML" msgstr "PyYAML" -#: ../../rst/dev_guide/testing/sanity/import.rst:74 +#: ../../rst/dev_guide/testing/sanity/import.rst:126 msgid "MarkupSafe (as a dependency of Jinja2)" msgstr "MarkupSafe (Jinja2 ã®ä¾å˜é–¢ä¿‚ã¨ã—ã¦)" @@ -11094,6 +10931,7 @@ msgid "When selecting a group for a new test, use the same group as existing tes msgstr "æ–°è¦ãƒ†ã‚¹ãƒˆç”¨ã«ã‚°ãƒ«ãƒ¼ãƒ—ã‚’é¸æŠžã™ã‚‹å ´åˆã¯ã€è¿½åŠ ã™ã‚‹æ—¢å˜ã®ãƒ†ã‚¹ãƒˆã¨åŒæ§˜ã®ã‚°ãƒ«ãƒ¼ãƒ—を使用ã—ã¾ã™ã€‚複数ã®ã‚°ãƒ«ãƒ¼ãƒ—ãŒåˆ©ç”¨å¯èƒ½ãªå ´åˆã¯ã€ãƒ©ãƒ³ãƒ€ãƒ ã« 1 ã¤ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’é¸æŠžã—ã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:29 +#: ../../rst/dev_guide/testing_running_locally.rst:15 msgid "Setup" msgstr "è¨å®š" @@ -11110,7 +10948,6 @@ msgid "``setup/always/TARGET`` - Run the target ``TARGET`` before each target th msgstr "``setup/always/TARGET`` - å¿…è¦ãªå„ターゲットã®å‰ã«ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ ``TARGET`` を実行ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:37 -#: ../../rst/dev_guide/testing_running_locally.rst:18 msgid "Requirements" msgstr "è¦ä»¶" @@ -11246,175 +11083,179 @@ msgstr "``destructive`` - ``--docker`` ã¾ãŸã¯ ``--remote`` ãªã—㧠``--allo msgid "``hidden`` - Target is ignored. Usable as a dependency. Automatic for ``setup_`` and ``prepare_`` prefixed targets." msgstr "``hidden`` - ターゲットã¯ç„¡è¦–ã•ã‚Œã¾ã™ã€‚ä¾å˜é–¢ä¿‚ã¨ã—ã¦ä½¿ç”¨ã§ãã¾ã™ã€‚プレフィックス ``setup_`` ãŠã‚ˆã³ ``prepare_`` ãŒä»˜ã‘られãŸã‚¿ãƒ¼ã‚²ãƒƒãƒˆã«å¯¾ã™ã‚‹è‡ªå‹•åŒ–。" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:101 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:99 +msgid "``retry/never`` - Target is excluded from retries enabled by the ``--retry-on-error`` option." +msgstr "``retry/never`` - ターゲットã¯ã€``--retry-on-error`` オプションã«ã‚ˆã£ã¦æœ‰åŠ¹åŒ–ã•ã‚ŒãŸå†è©¦è¡Œã‹ã‚‰é™¤å¤–ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:102 msgid "Unstable" msgstr "Unstable" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:103 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:104 msgid "Tests which fail sometimes should be marked with the ``unstable`` alias until the instability has been fixed. These tests will continue to run for pull requests which modify the test or the module under test." msgstr "時々失敗ã™ã‚‹ãƒ†ã‚¹ãƒˆã¯ã€ä¸å®‰å®šæ€§ãŒä¿®æ£ã•ã‚Œã‚‹ã¾ã§ã€``unstable`` エイリアスã§ãƒžãƒ¼ã‚¯ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®ãƒ†ã‚¹ãƒˆã¯ã€ãƒ†ã‚¹ãƒˆã¾ãŸã¯ãƒ†ã‚¹ãƒˆå¯¾è±¡ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’変更ã™ã‚‹ãƒ—ルè¦æ±‚ã«å¯¾ã—ã¦å¼•ã続ã実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:106 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:107 msgid "This avoids unnecessary test failures for other pull requests, as well as tests on merge runs and nightly CI jobs." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ä»–ã®ãƒ—ルè¦æ±‚ã«å¯¾ã™ã‚‹ä¸è¦ãªãƒ†ã‚¹ãƒˆã®å¤±æ•—ã‚„ã€ãƒžãƒ¼ã‚¸ã®å®Ÿè¡ŒãŠã‚ˆã³æ¯Žå¤œã® CI ジョブã®ãƒ†ã‚¹ãƒˆã‚‚回é¿ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:108 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:109 msgid "There are two ways to run unstable tests manually:" msgstr "ä¸å®‰å®šãªãƒ†ã‚¹ãƒˆã‚’手動ã§å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã¯ 2 ã¤ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:110 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:111 msgid "Use the ``--allow-unstable`` option for ``ansible-test``" msgstr "``ansible-test`` ã«ã¯ ``--allow-unstable`` オプションを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:111 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:112 msgid "Prefix the test name with ``unstable/`` when passing it to ``ansible-test``." msgstr "ãれを ``ansible-test`` ã«æ¸¡ã™å ´åˆã¯ã€ãƒ†ã‚¹ãƒˆåã®å‰ã«ãƒ—レフィックス ``unstable/`` を付ã‘ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:113 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:114 msgid "Tests will be marked as unstable by a member of the Ansible Core Team. GitHub issues_ will be created to track each unstable test." msgstr "テストã¯ã€Ansible Core Team ã®ãƒ¡ãƒ³ãƒãƒ¼ã«ã‚ˆã£ã¦ Unstable ã¨è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚GitHub å•é¡Œ_ ãŒä½œæˆã•ã‚Œã€ä¸å®‰å®šãªå„テストを追跡ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:117 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:118 msgid "Disabled" -msgstr "Disabled" +msgstr "無効化" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:119 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:120 msgid "Tests which always fail should be marked with the ``disabled`` alias until they can be fixed." msgstr "常ã«å¤±æ•—ã™ã‚‹ãƒ†ã‚¹ãƒˆã§ã¯ã€ä¿®æ£ã•ã‚Œã‚‹ã¾ã§ã€``disabled`` ãªã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ãƒžãƒ¼ã‚¯ã•ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:121 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:122 msgid "Disabled tests are automatically skipped." msgstr "無効ã«ã•ã‚ŒãŸãƒ†ã‚¹ãƒˆã¯è‡ªå‹•çš„ã«ã‚¹ã‚ップã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:123 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:124 msgid "There are two ways to run disabled tests manually:" msgstr "無効ã«ã•ã‚ŒãŸãƒ†ã‚¹ãƒˆã‚’手動ã§å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã¯ 2 ã¤ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:125 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:126 msgid "Use the ``--allow-disabled`` option for ``ansible-test``" msgstr "``ansible-test`` ã«ã¯ ``--allow-disabled`` オプションを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:126 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:127 msgid "Prefix the test name with ``disabled/`` when passing it to ``ansible-test``." msgstr "ãれを ``ansible-test`` ã«æ¸¡ã™å ´åˆã¯ã€ãƒ†ã‚¹ãƒˆåã®å‰ã«ãƒ—レフィックス ``disabled/`` を付ã‘ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:128 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:129 msgid "Tests will be marked as disabled by a member of the Ansible Core Team. GitHub issues_ will be created to track each disabled test." msgstr "テストã¯ã€Ansible Core Team ã®ãƒ¡ãƒ³ãƒãƒ¼ã«ã‚ˆã£ã¦ç„¡åŠ¹ã¨ãƒžãƒ¼ã‚¯ã•ã‚Œã¾ã™ã€‚GitHub å•é¡Œ_ ãŒä½œæˆã•ã‚Œã€ç„¡åŠ¹ã«ã•ã‚ŒãŸå„テストを追跡ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:132 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:133 msgid "Unsupported" msgstr "Unsupported" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:134 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:135 msgid "Tests which cannot be run in CI should be marked with the ``unsupported`` alias. Most tests can be supported through the use of simulators and/or cloud plugins." msgstr "CI ã§å®Ÿè¡Œã§ããªã„テストã«ã¯ã€``unsupported`` エイリアスã®ãƒžãƒ¼ã‚¯ã‚’付ã‘ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã»ã¨ã‚“ã©ã®ãƒ†ã‚¹ãƒˆã¯ã‚·ãƒŸãƒ¥ãƒ¬ãƒ¼ã‚¿ãƒ¼ã‚„クラウドプラグインを使用ã™ã‚‹ã“ã¨ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:137 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:138 msgid "However, if that is not possible then marking a test as unsupported will prevent it from running in CI." msgstr "ãŸã ã—ã€ãƒ†ã‚¹ãƒˆãŒä½¿ç”¨ã§ããªã„å ´åˆã¯ã€ãƒ†ã‚¹ãƒˆã‚’ unsupported ã¨è¡¨ç¤ºã™ã‚‹ã¨ã€CI ã§ãƒ†ã‚¹ãƒˆã‚’実行ã§ããªããªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:139 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:140 msgid "There are two ways to run unsupported tests manually:" msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡å¤–ã®ãƒ†ã‚¹ãƒˆã‚’手動ã§å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã¯ 2 ã¤ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:141 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:142 msgid "Use the ``--allow-unsupported`` option for ``ansible-test``" msgstr "``ansible-test`` ã«ã¯ ``--allow-unsupported`` オプションを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:142 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:143 msgid "Prefix the test name with ``unsupported/`` when passing it to ``ansible-test``." msgstr "ãれを ``ansible-test`` ã«æ¸¡ã™å ´åˆã¯ã€ãƒ†ã‚¹ãƒˆåã®å‰ã«ãƒ—レフィックス ``unsupported/`` を付ã‘ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:144 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:145 msgid "Tests will be marked as unsupported by the contributor of the test." msgstr "テストã¯ã€ãƒ†ã‚¹ãƒˆã®è²¢çŒ®è€…ã«ã‚ˆã£ã¦ unsupported ã¨ãƒžãƒ¼ã‚¯ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:147 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:148 msgid "Cloud" msgstr "クラウド" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:149 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:150 msgid "Tests for cloud services and other modules that require access to external APIs usually require special support for testing in CI." msgstr "通常ã€å¤–部 API ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã‚’å¿…è¦ã¨ã™ã‚‹ã‚¯ãƒ©ã‚¦ãƒ‰ã‚µãƒ¼ãƒ“スãŠã‚ˆã³ãã®ä»–ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ†ã‚¹ãƒˆã«ã¯ã€CI ã§ã®ãƒ†ã‚¹ãƒˆã«ç‰¹åˆ¥ãªã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:151 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:152 msgid "These require an additional alias to indicate the required test plugin." msgstr "ã“れらã«ã¯ã€å¿…è¦ãªãƒ†ã‚¹ãƒˆãƒ—ラグインを指定ã™ã‚‹ãŸã‚ã«è¿½åŠ ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:153 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:154 msgid "Some of the available aliases are:" msgstr "利用å¯èƒ½ãªã‚¨ã‚¤ãƒªã‚¢ã‚¹ã«ã¯ã€ä»¥ä¸‹ã®ã‚‚ã®ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:155 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:156 msgid "``cloud/aws``" msgstr "``cloud/aws``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:156 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:157 msgid "``cloud/azure``" msgstr "``cloud/azure``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:157 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:158 msgid "``cloud/cs``" msgstr "``cloud/cs``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:158 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:159 msgid "``cloud/digitalocean``" msgstr "``cloud/digitalocean``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:159 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:160 msgid "``cloud/foreman``" msgstr "``cloud/foreman``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:160 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:161 msgid "``cloud/openshift``" msgstr "``cloud/openshift``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:161 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:162 msgid "``cloud/tower``" msgstr "``cloud/tower``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:162 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:163 msgid "``cloud/vcenter``" msgstr "``cloud/vcenter``" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:165 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:166 msgid "Untested" msgstr "未テスト" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:167 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:168 msgid "Every module and plugin should have integration tests, even if the tests cannot be run in CI." msgstr "テストを CI ã§å®Ÿè¡Œã§ããªã„å ´åˆã§ã‚‚ã€ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŠã‚ˆã³ãƒ—ラグインã«çµ±åˆãƒ†ã‚¹ãƒˆãŒå«ã¾ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:170 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:171 msgid "Issues" msgstr "å•é¡Œ" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:172 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:173 msgid "Tests that are marked as unstable_ or disabled_ will have an issue created to track the status of the test. Each issue will be assigned to one of the following projects:" msgstr "unstable_ ã¾ãŸã¯ disabled_ ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã¦ã„るテストã«ã¯ã€ãƒ†ã‚¹ãƒˆã®ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚’追跡ã™ã‚‹å•é¡ŒãŒä½œæˆã•ã‚Œã¾ã™ã€‚ãã‚Œãžã‚Œã®å•é¡Œã¯ä»¥ä¸‹ã®ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã®ã„ãšã‚Œã‹ã«å‰²ã‚Šå½“ã¦ã‚‰ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:175 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:176 msgid "`AWS <https://github.com/ansible/ansible/projects/21>`_" msgstr "`AWS <https://github.com/ansible/ansible/projects/21>`_" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:176 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:177 msgid "`Azure <https://github.com/ansible/ansible/projects/22>`_" msgstr "`Azure <https://github.com/ansible/ansible/projects/22>`_" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:177 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:178 msgid "`Windows <https://github.com/ansible/ansible/projects/23>`_" msgstr "`Windows <https://github.com/ansible/ansible/projects/23>`_" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:178 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:179 msgid "`General <https://github.com/ansible/ansible/projects/25>`_" msgstr "`General <https://github.com/ansible/ansible/projects/25>`_" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:181 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:182 msgid "Questions" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚" -#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:183 +#: ../../rst/dev_guide/testing/sanity/integration-aliases.rst:184 msgid "For questions about integration tests reach out to @mattclay or @gundalow on GitHub or the ``#ansible-devel`` chat channel (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat/>`_)." msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã«é–¢ã™ã‚‹è³ªå•ã¯ã€GitHub 㧠@mattclay ã‚‚ã—ã㯠@gundalowã€ã¾ãŸã¯``#ansible-devel``ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ï¼ˆansible.imã§Matrixを使用ã€ã¾ãŸã¯`irc.libera.chat <https://libera.chat/>`_ã§IRCを使用）ã«ãŠå•ã„åˆã‚ã›ãã ã•ã„。" @@ -11461,8 +11302,8 @@ msgid "Additionally, the following code is checked against Python versions suppo msgstr "ã¾ãŸã€ä»¥ä¸‹ã®ã‚³ãƒ¼ãƒ‰ã¯ã€ç®¡ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã§ã®ã¿ã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—ã¦ç¢ºèªã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/mypy.rst:14 -msgid "See https://mypy.readthedocs.io/en/stable/ for additional details." -msgstr "詳細㯠https://mypy.readthedocs.io/en/stable/ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "See `the mypy documentation <https://mypy.readthedocs.io/en/stable/>`_" +msgstr "「`the mypy documentation <https://mypy.readthedocs.io/en/stable/>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/testing/sanity/no-assert.rst:2 msgid "no-assert" @@ -11770,7 +11611,7 @@ msgid "It makes it so one can't jump into the middle of a file and know whether msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ•ã‚¡ã‚¤ãƒ«ã®é€”ä¸ã«ã‚¸ãƒ£ãƒ³ãƒ—ã—ã¦ã€è£¸ã®ãƒªãƒ†ãƒ©ãƒ«æ–‡å—列ãŒãƒã‚¤ãƒˆæ–‡å—列ãªã®ã‹ãƒ†ã‚スト文å—列ãªã®ã‹ã‚’知るã“ã¨ãŒã§ããªããªã‚Šã¾ã™ã€‚プãƒã‚°ãƒ©ãƒžãƒ¼ã¯ã€æœ€åˆã«ãƒ•ã‚¡ã‚¤ãƒ«ã®å…ˆé ã‚’ãƒã‚§ãƒƒã‚¯ã—ã¦ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆãŒå˜åœ¨ã™ã‚‹ã‹ã©ã†ã‹ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/no-unicode-literals.rst:10 -msgid "It removes the ability to define native strings (a string which should be a byte string on python2 and a text string on python3) via a string literal." +msgid "It removes the ability to define native strings (a string which should be a byte string on python2 and a text string on python3) by a string literal." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€æ–‡å—列リテラルを介ã—ã¦ãƒã‚¤ãƒ†ã‚£ãƒ–æ–‡å—列 (python2 ã§ã¯ãƒã‚¤ãƒˆæ–‡å—列ã€python3 ã§ã¯ãƒ†ã‚スト文å—列ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚‹æ–‡å—列) を定義ã™ã‚‹æ©Ÿèƒ½ãŒå‰Šé™¤ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/no-unicode-literals.rst:12 @@ -11857,17 +11698,25 @@ msgstr "package-data" msgid "Verifies that the combination of ``MANIFEST.in`` and ``package_data`` from ``setup.py`` properly installs data files from within ``lib/ansible``" msgstr "``setup.py`` ã‹ã‚‰ ``MANIFEST.in`` 㨠``package_data`` を組ã¿åˆã‚ã›ã¦ã€``lib/ansible`` 内ã‹ã‚‰ãƒ‡ãƒ¼ã‚¿ãƒ•ã‚¡ã‚¤ãƒ«ãŒé©åˆ‡ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/pep8.rst:2 +#: ../../rst/dev_guide/testing/sanity/pep8.rst:4 msgid "pep8" msgstr "pep8" -#: ../../rst/dev_guide/testing/sanity/pep8.rst:4 +#: ../../rst/dev_guide/testing/sanity/pep8.rst:6 msgid "Python static analysis for PEP 8 style guideline compliance." msgstr "PEP 8 スタイルã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚³ãƒ³ãƒ—ライアンスã«å¯¾ã™ã‚‹ Python é™çš„分æžã§ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/pep8.rst:6 -msgid "See :ref:`testing_pep8` for more information." -msgstr "詳細ã¯ã€ã€Œ:ref:`testing_pep8`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing/sanity/pep8.rst:8 +msgid "`PEP 8`_ style guidelines are enforced by `pycodestyle`_ on all python files in the repository by default." +msgstr "`PEP 8`_ スタイルã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«ã‚ã‚‹ã™ã¹ã¦ã® python ファイル㧠`pycodestyle`_ ã«ã‚ˆã£ã¦å¼·åˆ¶ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/pep8.rst:11 +msgid "Running locally" +msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®å®Ÿè¡Œ" + +#: ../../rst/dev_guide/testing/sanity/pep8.rst:13 +msgid "The `PEP 8`_ check can be run locally as follows:" +msgstr "`PEP 8`_ ãƒã‚§ãƒƒã‚¯ã¯ã€æ¬¡ã®ã‚ˆã†ã«ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" #: ../../rst/dev_guide/testing/sanity/pslint.rst:2 msgid "pslint" @@ -12086,168 +11935,1163 @@ msgstr "use-compat-six" msgid "Use ``six`` from ``module_utils`` instead of ``six``." msgstr "``six`` ã®ä»£ã‚ã‚Šã« ``module_utils`` ã‹ã‚‰ ``six`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:2 -#: ../../rst/dev_guide/testing_validate-modules.rst:7 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:4 +#: ../../rst/dev_guide/testing_validate-modules.rst:5 msgid "validate-modules" msgstr "validate-modules" -#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:4 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:6 msgid "Analyze modules for common issues in code and documentation." msgstr "コードãŠã‚ˆã³ãƒ‰ã‚ュメントã®ä¸€èˆ¬çš„ãªå•é¡Œã«ã¤ã„ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’分æžã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:6 -msgid "See :ref:`testing_validate-modules` for more information." -msgstr "詳細ã¯ã€ã€Œ:ref:`testing_validate-modules`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:12 +msgid "Usage" +msgstr "使用法" -#: ../../rst/dev_guide/testing/sanity/yamllint.rst:2 -msgid "yamllint" -msgstr "yamllint" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:21 +msgid "Help" +msgstr "ヘルプ" -#: ../../rst/dev_guide/testing/sanity/yamllint.rst:4 -msgid "Check YAML files for syntax and formatting issues." -msgstr "YAML ファイルã«ãŠã‘る構文ãŠã‚ˆã³ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã®å•é¡Œã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:23 +msgid "Type ``ansible-test sanity validate-modules -h`` to display help for using this sanity test." +msgstr "``ansible-test sanity validate-modules -h`` を入力ã™ã‚‹ã¨ã€ã“ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’使用ã™ã‚‹ãŸã‚ã®ãƒ˜ãƒ«ãƒ—ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_compile.rst:7 -msgid "Compile Tests" -msgstr "コンパイルテスト" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:28 +msgid "Extending validate-modules" +msgstr "validate-modules ã®æ‹¡å¼µ" -#: ../../rst/dev_guide/testing_compile.rst:12 -#: ../../rst/dev_guide/testing_httptester.rst:10 -msgid "Overview" -msgstr "概è¦" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:30 +msgid "The ``validate-modules`` tool has a `schema.py <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py>`_ that is used to validate the YAML blocks, such as ``DOCUMENTATION`` and ``RETURNS``." +msgstr "``validate-modules`` ツールã«ã¯ã€``DOCUMENTATION``ã€``RETURNS`` ãªã©ã® YAML ブãƒãƒƒã‚¯ã®æ¤œè¨¼ã«ä½¿ç”¨ã•ã‚Œã‚‹ `schema.py <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py>`_ ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_compile.rst:14 -msgid "Compile tests check source files for valid syntax on all supported python versions:" -msgstr "コンパイルテストã§ã¯ã€ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã® python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã€ã‚½ãƒ¼ã‚¹ãƒ•ã‚¡ã‚¤ãƒ«ã®æ§‹æ–‡ãŒæœ‰åŠ¹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:34 +msgid "Codes" +msgstr "コード" -#: ../../rst/dev_guide/testing_compile.rst:16 -msgid "2.4 (Ansible 2.3 only)" -msgstr "2.4 (Ansible 2.3 ã®ã¿)" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:37 +msgid "**Error Code**" +msgstr "**エラーコード**" -#: ../../rst/dev_guide/testing_compile.rst:17 -msgid "2.6" -msgstr "2.6" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:37 +msgid "**Type**" +msgstr "**タイプ**" -#: ../../rst/dev_guide/testing_compile.rst:18 -msgid "2.7" -msgstr "2.7" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:37 +msgid "**Level**" +msgstr "**レベル**" -#: ../../rst/dev_guide/testing_compile.rst:19 -msgid "3.5" -msgstr "3.5" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:37 +msgid "**Sample Message**" +msgstr "**開始メッセージ**" -#: ../../rst/dev_guide/testing_compile.rst:20 -msgid "3.6" -msgstr "3.6" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:39 +msgid "ansible-deprecated-module" +msgstr "ansible-deprecated-module" -#: ../../rst/dev_guide/testing_compile.rst:21 -msgid "3.7" -msgstr "3.7" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:39 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:40 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:41 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:43 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:44 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:45 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:46 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:47 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:48 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:49 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:50 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:51 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:52 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:53 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:54 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:55 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:56 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:59 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:62 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:63 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:64 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:65 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:66 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:67 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:68 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:69 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:70 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:72 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:73 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:75 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:76 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:77 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:78 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:79 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:84 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:85 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:86 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:87 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:88 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:92 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:94 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:95 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:96 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:97 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:98 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:99 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:100 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:103 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:107 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:108 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:109 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:112 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:114 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:120 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:121 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:122 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:123 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:124 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:125 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:126 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:127 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:128 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:129 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:130 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:131 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:132 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:133 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:134 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:135 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:136 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:137 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:138 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:139 +msgid "Documentation" +msgstr "ドã‚ュメント" -#: ../../rst/dev_guide/testing_compile.rst:22 -msgid "3.8" -msgstr "3.8" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:39 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:40 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:41 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:42 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:43 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:44 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:45 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:46 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:47 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:48 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:49 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:50 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:51 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:52 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:53 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:54 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:55 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:56 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:57 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:58 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:59 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:61 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:62 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:63 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:64 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:65 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:66 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:67 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:68 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:69 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:70 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:71 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:72 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:73 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:74 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:75 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:77 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:78 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:79 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:81 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:82 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:83 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:84 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:86 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:87 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:88 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:89 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:90 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:91 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:92 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:93 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:94 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:95 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:96 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:97 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:98 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:99 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:100 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:101 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:102 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:103 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:104 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:105 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:106 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:107 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:108 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:109 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:110 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:112 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:113 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:115 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:116 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:117 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:118 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:119 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:120 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:121 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:122 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:123 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:124 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:125 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:126 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:127 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:128 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:129 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:130 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:131 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:132 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:133 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:134 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:135 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:136 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:137 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:138 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:139 +msgid "Error" +msgstr "エラー" -#: ../../rst/dev_guide/testing_compile.rst:23 -msgid "3.9" -msgstr "3.9" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:39 +msgid "A module is deprecated and supposed to be removed in the current or an earlier Ansible version" +msgstr "モジュールã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã® Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" -#: ../../rst/dev_guide/testing_compile.rst:25 -msgid "NOTE: In Ansible 2.4 and earlier the compile test was provided by a dedicated sub-command ``ansible-test compile`` instead of a sanity test using ``ansible-test sanity --test compile``." -msgstr "注記: Ansible 2.4 以å‰ã§ã¯ã€``ansible-test sanity --test compile`` を使用ã™ã‚‹å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®ä»£ã‚ã‚Šã«ã€ã‚³ãƒ³ãƒ‘イルテストãŒå°‚用ã®ã‚µãƒ–コマンド ``ansible-test compile`` ã«ã‚ˆã£ã¦æä¾›ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:40 +msgid "collection-deprecated-module" +msgstr "collection-deprecated-module" -#: ../../rst/dev_guide/testing_compile.rst:28 -msgid "Running compile tests locally" -msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®ã‚³ãƒ³ãƒ‘イルテストã®å®Ÿè¡Œ" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:40 +msgid "A module is deprecated and supposed to be removed in the current or an earlier collection version" +msgstr "モジュールã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" -#: ../../rst/dev_guide/testing_compile.rst:30 -msgid "Compile tests can be run across the whole code base by doing:" -msgstr "コンパイルテストを実行ã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚ˆã†ã«ã€ã‚³ãƒ¼ãƒ‰ãƒ™ãƒ¼ã‚¹å…¨ä½“ã§ãƒ†ã‚¹ãƒˆã‚’実行ã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:41 +msgid "ansible-deprecated-version" +msgstr "ansible-deprecated-version" -#: ../../rst/dev_guide/testing_compile.rst:38 -#: ../../rst/dev_guide/testing_units.rst:38 -msgid "Against a single file by doing:" -msgstr "1 ã¤ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«å¯¾ã—ã¦ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:41 +msgid "A feature is deprecated and supposed to be removed in the current or an earlier Ansible version" +msgstr "機能ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã® Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" -#: ../../rst/dev_guide/testing_compile.rst:44 -#: ../../rst/dev_guide/testing_units.rst:44 -msgid "Or against a specific Python version by doing:" -msgstr "ã¾ãŸã¯ã€ç‰¹å®šã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—ã¦ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:42 +msgid "ansible-module-not-initialized" +msgstr "ansible-module-not-initialized" -#: ../../rst/dev_guide/testing_compile.rst:50 -msgid "For advanced usage see the help:" -msgstr "高度ãªä½¿ç”¨æ–¹æ³•ã¯ã€ãƒ˜ãƒ«ãƒ—ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:42 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:82 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:83 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:106 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:113 +msgid "Syntax" +msgstr "構文" -#: ../../rst/dev_guide/testing_compile.rst:58 -#: ../../rst/dev_guide/testing_units.rst:68 -msgid "Installing dependencies" -msgstr "ä¾å˜é–¢ä¿‚ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:42 +msgid "Execution of the module did not result in initialization of AnsibleModule" +msgstr "モジュールを実行ã—ã¦ã‚‚ã€AnsibleModule ã¯åˆæœŸåŒ–ã•ã‚Œãªã‹ã£ãŸã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:43 +msgid "collection-deprecated-version" +msgstr "collection-deprecated-version" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:43 +msgid "A feature is deprecated and supposed to be removed in the current or an earlier collection version" +msgstr "機能ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:44 +msgid "deprecated-date" +msgstr "deprecated-date" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:44 +msgid "A date before today appears as ``removed_at_date`` or in ``deprecated_aliases``" +msgstr "今日よりå‰ã®æ—¥ä»˜ã¯ã€``removed_at_date`` よã†ã«è¡¨ç¤ºã•ã‚Œã‚‹ã‹ã€``deprecated_aliases`` ã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:45 +msgid "deprecation-mismatch" +msgstr "deprecation-mismatch" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:45 +msgid "Module marked as deprecated or removed in at least one of the filename, its metadata, or in DOCUMENTATION (setting DOCUMENTATION.deprecated for deprecation or removing all Documentation for removed) but not in all three places." +msgstr "ファイルåã€ãã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã€ã¾ãŸã¯ DOCUMENTATION ã®å°‘ãªãã¨ã‚‚ 1 㤠(全箇所ã§ã¯ãªã„) ã§éžæŽ¨å¥¨ã¾ãŸã¯å‰Šé™¤æ¸ˆã¿ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (éžæŽ¨å¥¨ã®å ´åˆã¯ DOCUMENTATION.deprecated ã‚’è¨å®šã—ã€å‰Šé™¤ã®å ´åˆã¯ã™ã¹ã¦ã®ãƒ‰ã‚ュメントを削除ã™ã‚‹) ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:46 +msgid "doc-choices-do-not-match-spec" +msgstr "doc-choices-do-not-match-spec" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:46 +msgid "Value for \"choices\" from the argument_spec does not match the documentation" +msgstr "argument_spec ã®ã€Œchoicesã€ã®å€¤ãŒãƒ‰ã‚ュメントã¨ä¸€è‡´ã—ãªã„。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:47 +msgid "doc-choices-incompatible-type" +msgstr "doc-choices-incompatible-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:47 +msgid "Choices value from the documentation is not compatible with type defined in the argument_spec" +msgstr "ドã‚ュメンテーションã®é¸æŠžå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:48 +msgid "doc-default-does-not-match-spec" +msgstr "doc-default-does-not-match-spec" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:48 +msgid "Value for \"default\" from the argument_spec does not match the documentation" +msgstr "argument_spec ã®ã€Œdefaultã€ã®å€¤ãŒãƒ‰ã‚ュメントã¨ä¸€è‡´ã—ãªã„。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:49 +msgid "doc-default-incompatible-type" +msgstr "doc-default-incompatible-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:49 +msgid "Default value from the documentation is not compatible with type defined in the argument_spec" +msgstr "ドã‚ュメンテーションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:50 +msgid "doc-elements-invalid" +msgstr "doc-elements-invalid" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:50 +msgid "Documentation specifies elements for argument, when \"type\" is not ``list``." +msgstr "ドã‚ュメントã§ã¯ã€ã€Œtypeã€ãŒ ``list`` ã§ã¯ãªã„å ´åˆã«ã€å¼•æ•°ã®è¦ç´ を指定ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:51 +msgid "doc-elements-mismatch" +msgstr "doc-elements-mismatch" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:51 +msgid "Argument_spec defines elements different than documentation does" +msgstr "argument_spec ã¯ãƒ‰ã‚ュメントã¨ã¯ç•°ãªã‚‹ã‚¿ã‚¤ãƒ—を定義ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:52 +msgid "doc-missing-type" +msgstr "doc-missing-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:52 +msgid "Documentation doesn't specify a type but argument in ``argument_spec`` use default type (``str``)" +msgstr "ドã‚ュメントã§ã¯ã‚¿ã‚¤ãƒ—ã‚’ã—ã¦ã„ã¾ã›ã‚“ãŒã€``argument_spec`` ã®å¼•æ•°ãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆåž‹ (``str``) を使用ã—ã¦ã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:53 +msgid "doc-required-mismatch" +msgstr "doc-required-mismatch" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:53 +msgid "argument in argument_spec is required but documentation says it is not, or vice versa" +msgstr "arguments_spec ã®å¼•æ•°ã¯å¿…é ˆã§ã™ãŒã€ãƒ‰ã‚ュメントã«ã¯å¿…é ˆã§ã¯ãªã„ (ã¾ãŸã¯ arguments_spec ã®å¼•æ•°ã¯å¿…é ˆã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ãƒ‰ã‚ュメントã«ã¯å¿…é ˆ) ã¨è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:54 +msgid "doc-type-does-not-match-spec" +msgstr "doc-type-does-not-match-spec" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:54 +msgid "Argument_spec defines type different than documentation does" +msgstr "argument_spec ãŒãƒ‰ã‚ュメントã¨ã¯ç•°ãªã‚‹ã‚¿ã‚¤ãƒ—を定義ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:55 +msgid "documentation-error" +msgstr "documentation-error" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:55 +msgid "Unknown ``DOCUMENTATION`` error" +msgstr "ä¸æ˜Žãª ``DOCUMENTATION`` エラー" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:56 +msgid "documentation-syntax-error" +msgstr "documentation-syntax-error" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:56 +msgid "Invalid ``DOCUMENTATION`` schema" +msgstr "無効㪠``DOCUMENTATION`` スã‚ーマ" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:57 +msgid "illegal-future-imports" +msgstr "illegal-future-imports" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:57 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:58 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:61 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:80 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:81 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:89 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:90 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:91 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:111 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:115 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:116 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:117 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:118 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:119 +msgid "Imports" +msgstr "インãƒãƒ¼ãƒˆ" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:57 +msgid "Only the following ``from __future__`` imports are allowed: ``absolute_import``, ``division``, and ``print_function``." +msgstr "``absolute_import``ã€``division``ã€ãŠã‚ˆã³ ``print_function`` ã® ``from __future__`` インãƒãƒ¼ãƒˆã®ã¿ãŒè¨±å¯ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:58 +msgid "import-before-documentation" +msgstr "import-before-documentation" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:58 +msgid "Import found before documentation variables. All imports must appear below ``DOCUMENTATION``/``EXAMPLES``/``RETURN``" +msgstr "ドã‚ュメント変数ã®å‰ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚ã™ã¹ã¦ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ã€``DOCUMENTATION``/``EXAMPLES``/``RETURN`` ã®ä¸‹ã«è¡¨ç¤ºã•ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:59 +msgid "import-error" +msgstr "import-error" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:59 +msgid "``Exception`` attempting to import module for ``argument_spec`` introspection" +msgstr "``Exception`` ãŒã€``argument_spec`` イントãƒã‚¹ãƒšã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’試行ä¸" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:60 +msgid "import-placement" +msgstr "import-placement" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:60 +msgid "Locations" +msgstr "å ´æ‰€" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:60 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:76 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:80 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:85 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:111 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:114 +msgid "Warning" +msgstr "è¦å‘Š" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:60 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:61 +msgid "Imports should be directly below ``DOCUMENTATION``/``EXAMPLES``/``RETURN``" +msgstr "インãƒãƒ¼ãƒˆã¯ã€``DOCUMENTATION``/``EXAMPLES``/``RETURN`` ã®ã™ã後ã«é…ç½®ã—ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:61 +msgid "imports-improper-location" +msgstr "imports-improper-location" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:62 +msgid "incompatible-choices" +msgstr "incompatible-choices" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:62 +msgid "Choices value from the argument_spec is not compatible with type defined in the argument_spec" +msgstr "argument_spec ã®é¸æŠžå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:63 +msgid "incompatible-default-type" +msgstr "incompatible-default-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:63 +msgid "Default value from the argument_spec is not compatible with type defined in the argument_spec" +msgstr "argument_spec ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:64 +msgid "invalid-argument-name" +msgstr "invalid-argument-name" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:64 +msgid "Argument in argument_spec must not be one of 'message', 'syslog_facility' as it is used internally by Ansible Core Engine" +msgstr "argument_spec ã®å¼•æ•°ã¯ã€Ansible Core Engine ã«ã‚ˆã£ã¦å†…部ã§ä½¿ç”¨ã•ã‚Œã‚‹ãŸã‚ã€ã€Œmessageã€ã€ã€Œsyslog_facilityã€ã®ã„ãšã‚Œã‹ã«ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:65 +msgid "invalid-argument-spec" +msgstr "invalid-argument-spec" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:65 +msgid "Argument in argument_spec must be a dictionary/hash when used" +msgstr "argument_spec ã®å¼•æ•°ã‚’使用ã™ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¾ãŸã¯ãƒãƒƒã‚·ãƒ¥ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:66 +msgid "invalid-argument-spec-options" +msgstr "invalid-argument-spec-options" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:66 +msgid "Suboptions in argument_spec are invalid" +msgstr "argument_spec ã®ã‚µãƒ–オプションã¯ç„¡åŠ¹ã§ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:67 +msgid "invalid-documentation" +msgstr "invalid-documentation" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:67 +msgid "``DOCUMENTATION`` is not valid YAML" +msgstr "``DOCUMENTATION`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:68 +msgid "invalid-documentation-markup" +msgstr "invalid-documentation-markup" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:68 +msgid "``DOCUMENTATION`` or ``RETURN`` contains invalid markup" +msgstr "``DOCUMENTATION`` ã¾ãŸã¯ã€``RETURN`` ã«ç„¡åŠ¹ãªãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ—ãŒå«ã¾ã‚Œã¦ã„ã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:69 +msgid "invalid-documentation-options" +msgstr "invalid-documentation-options" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:69 +msgid "``DOCUMENTATION.options`` must be a dictionary/hash when used" +msgstr "``DOCUMENTATION.options`` を使用ã™ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼/ãƒãƒƒã‚·ãƒ¥ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:70 +msgid "invalid-examples" +msgstr "invalid-examples" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:70 +msgid "``EXAMPLES`` is not valid YAML" +msgstr "``EXAMPLES`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:71 +msgid "invalid-extension" +msgstr "invalid-extension" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:71 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:74 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:110 +msgid "Naming" +msgstr "命åè¦å‰‡" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:71 +msgid "Official Ansible modules must have a ``.py`` extension for python modules or a ``.ps1`` for powershell modules" +msgstr "å…¬å¼ã® Ansible モジュールã§ã¯ã€python モジュールã®æ‹¡å¼µå㯠``.py`` ã§ã€powershell モジュールã®æ‹¡å¼µå㯠``.ps1`` ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:72 +msgid "invalid-module-schema" +msgstr "invalid-module-schema" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:72 +msgid "``AnsibleModule`` schema validation error" +msgstr "``AnsibleModule`` スã‚ーマ検証エラー" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:73 +msgid "invalid-removal-version" +msgstr "invalid-removal-version" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:73 +msgid "The version at which a feature is supposed to be removed cannot be parsed (for collections, it must be a `semantic version <https://semver.org/>`_)" +msgstr "機能ãŒå‰Šé™¤ã•ã‚Œã‚‹ã“ã¨ã«ãªã£ã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯è§£æžã§ãã¾ã›ã‚“ (コレクションã®å ´åˆã€`semantic version <https://semver.org/>` ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:74 +msgid "invalid-requires-extension" +msgstr "invalid-requires-extension" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:74 +msgid "Module ``#AnsibleRequires -CSharpUtil`` should not end in .cs, Module ``#Requires`` should not end in .psm1" +msgstr "モジュール ``#AnsibleRequires -CSharpUtil`` ã®æœ«å°¾ã‚’ .cs ã«ã—ãªã„ã§ãã ã•ã„。モジュール ``#Requires`` ã®æœ«å°¾ã‚’ .psm1 ã«ã—ãªã„ã§ãã ã•ã„。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:75 +msgid "missing-doc-fragment" +msgstr "missing-doc-fragment" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:75 +msgid "``DOCUMENTATION`` fragment missing" +msgstr "``DOCUMENTATION`` フラグメントãŒã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:76 +msgid "missing-existing-doc-fragment" +msgstr "missing-existing-doc-fragment" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:76 +msgid "Pre-existing ``DOCUMENTATION`` fragment missing" +msgstr "æ—¢å˜ã® ``DOCUMENTATION`` フラグメントãŒã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:77 +msgid "missing-documentation" +msgstr "missing-documentation" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:77 +msgid "No ``DOCUMENTATION`` provided" +msgstr "``DOCUMENTATION`` ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:78 +msgid "missing-examples" +msgstr "missing-examples" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:78 +msgid "No ``EXAMPLES`` provided" +msgstr "``EXAMPLES`` ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:79 +msgid "missing-gplv3-license" +msgstr "missing-gplv3-license" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:79 +msgid "GPLv3 license header not found" +msgstr "GPLv3 ライセンスヘッダーãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã§ã—ãŸ" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:80 +msgid "missing-module-utils-basic-import" +msgstr "missing-module-utils-basic-import" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:80 +msgid "Did not find ``ansible.module_utils.basic`` import" +msgstr "``ansible.module_utils.basic`` インãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã§ã—ãŸ" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:81 +msgid "missing-module-utils-import-csharp-requirements" +msgstr "missing-module-utils-import-csharp-requirements" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:81 +msgid "No ``Ansible.ModuleUtils`` or C# Ansible util requirements/imports found" +msgstr "``Ansible.ModuleUtils`` ã¾ãŸã¯ C# Ansible ユーティリティー㮠è¦ä»¶/インãƒãƒ¼ãƒˆãŒã‚ã‚Šã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:82 +msgid "missing-powershell-interpreter" +msgstr "missing-powershell-interpreter" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:82 +msgid "Interpreter line is not ``#!powershell``" +msgstr "インタープリター行㯠``#!powershell`` ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:83 +msgid "missing-python-interpreter" +msgstr "missing-python-interpreter" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:83 +msgid "Interpreter line is not ``#!/usr/bin/python``" +msgstr "インタープリター行㯠``#!/usr/bin/python`` ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:84 +msgid "missing-return" +msgstr "missing-return" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:84 +msgid "No ``RETURN`` documentation provided" +msgstr "``RETURN`` ã®ãƒ‰ã‚ュメントã¯æä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:85 +msgid "missing-return-legacy" +msgstr "missing-return-legacy" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:85 +msgid "No ``RETURN`` documentation provided for legacy module" +msgstr "レガシーモジュールã«ã¯ ``RETURN`` ã®ãƒ‰ã‚ュメントãŒã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:86 +msgid "missing-suboption-docs" +msgstr "missing-suboption-docs" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:86 +msgid "Argument in argument_spec has sub-options but documentation does not define sub-options" +msgstr "argument_spec ã®å¼•æ•°ã«ã¯ã‚µãƒ–オプションョンãŒã‚ã‚Šã¾ã™ãŒã€ãƒ‰ã‚ュメントã§ã¯ã‚µãƒ–オプションãŒå®šç¾©ã•ã‚Œã¦ã„ã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:87 +msgid "module-incorrect-version-added" +msgstr "module-incorrect-version-added" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:87 +msgid "Module level ``version_added`` is incorrect" +msgstr "モジュールレベル ``version_added`` ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:88 +msgid "module-invalid-version-added" +msgstr "module-invalid-version-added" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:88 +msgid "Module level ``version_added`` is not a valid version number" +msgstr "モジュールレベル㮠``version_added`` ã¯ã€æœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:89 +msgid "module-utils-specific-import" +msgstr "module-utils-specific-import" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:89 +msgid "``module_utils`` imports should import specific components, not ``*``" +msgstr "``module_utils`` ã¯ã€``*`` ã§ã¯ãªãã€ç‰¹å®šã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã‚’インãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:90 +msgid "multiple-utils-per-requires" +msgstr "multiple-utils-per-requires" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:90 +msgid "``Ansible.ModuleUtils`` requirements do not support multiple modules per statement" +msgstr "``Ansible.ModuleUtils`` è¦ä»¶ã¯ã€ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã”ã¨ã«è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’サãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:91 +msgid "multiple-csharp-utils-per-requires" +msgstr "multiple-csharp-utils-per-requires" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:91 +msgid "Ansible C# util requirements do not support multiple utils per statement" +msgstr "C# ユーティリティーè¦ä»¶ã¯ã€ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã”ã¨ã«è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’サãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:92 +msgid "no-default-for-required-parameter" +msgstr "no-default-for-required-parameter" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:92 +msgid "Option is marked as required but specifies a default. Arguments with a default should not be marked as required" +msgstr "オプションã¯å¿…é ˆã¨è˜åˆ¥ã•ã‚Œã¾ã™ãŒã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®å¼•æ•°ã‚’指定ã—ã¾ã™ã€‚デフォルトã®å¼•æ•°ã¯å¿…é ˆã¨è˜åˆ¥ã—ãªã„ã§ãã ã•ã„。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:93 +msgid "no-log-needed" +msgstr "no-log-needed" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:93 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:101 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:102 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:104 +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:105 +msgid "Parameters" +msgstr "パラメーター" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:93 +msgid "Option name suggests that the option contains a secret value, while ``no_log`` is not specified for this option in the argument spec. If this is a false positive, explicitly set ``no_log=False``" +msgstr "オプションåã¯ã€ã‚ªãƒ—ションã«ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆå€¤ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’示唆ã—ã¦ã„ã¾ã™ãŒã€å¼•æ•°ä»•æ§˜ã§ã¯ã“ã®ã‚ªãƒ—ションã«å¯¾ã—㦠``no_log`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã¾ã›ã‚“。ã“ã®ã‚ªãƒ—ションãŒèª¤æ¤œå‡ºã®å ´åˆã¯æ˜Žç¤ºçš„ã« ``no_log=False`` ã«è¨å®šã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:94 +msgid "nonexistent-parameter-documented" +msgstr "nonexistent-parameter-documented" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:94 +msgid "Argument is listed in DOCUMENTATION.options, but not accepted by the module" +msgstr "引数㯠DOCUMENTATION.options ã«ä¸€è¦§è¡¨ç¤ºã•ã‚Œã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯å—ã‘入れられã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:95 +msgid "option-incorrect-version-added" +msgstr "option-incorrect-version-added" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:95 +msgid "``version_added`` for new option is incorrect" +msgstr "æ–°ã—ã„オプション㮠``version_added`` ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:96 +msgid "option-invalid-version-added" +msgstr "option-invalid-version-added" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:96 +msgid "``version_added`` for option is not a valid version number" +msgstr "``version_added`` オプションãŒæœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:97 +msgid "parameter-invalid" +msgstr "parameter-invalid" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:97 +msgid "Argument in argument_spec is not a valid python identifier" +msgstr "argument_spec ã®å¼•æ•°ã¯æœ‰åŠ¹ãª python è˜åˆ¥åã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:98 +msgid "parameter-invalid-elements" +msgstr "parameter-invalid-elements" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:98 +msgid "Value for \"elements\" is valid only when value of \"type\" is ``list``" +msgstr "「elementsã€ã®å€¤ã¯ã€ã€Œtypeã€ã®å€¤ãŒ ``list`` ã§ã‚ã‚‹å ´åˆã«é™ã‚Šæœ‰åŠ¹ã§ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:99 +msgid "implied-parameter-type-mismatch" +msgstr "implied-parameter-type-mismatch" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:99 +msgid "Argument_spec implies ``type=\"str\"`` but documentation defines it as different data type" +msgstr "argument_spec ã«ã¯ ``type=\"str\"`` ã®æ„ãŒå«ã¾ã‚Œã¾ã™ãŒã€ãƒ‰ã‚ュメントã§ã¯ã€åˆ¥ã®ãƒ‡ãƒ¼ã‚¿åž‹ã¨ã—ã¦æŒ‡å®šã•ã‚Œã¦ã„ã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:100 +msgid "parameter-type-not-in-doc" +msgstr "parameter-type-not-in-doc" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:100 +msgid "Type value is defined in ``argument_spec`` but documentation doesn't specify a type" +msgstr "タイプ値㯠``argument_spec`` ã§å®šç¾©ã•ã‚Œã¦ã„ã¾ã™ãŒã€ãƒ‰ã‚ュメントã¯ã‚¿ã‚¤ãƒ—を指定ã—ã¦ã„ã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:101 +msgid "parameter-alias-repeated" +msgstr "parameter-alias-repeated" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:101 +msgid "argument in argument_spec has at least one alias specified multiple times in aliases" +msgstr "argument_spec ã®å¼•æ•°ã«ã¯ã€ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã«è¤‡æ•°å›žæŒ‡å®šã•ã‚ŒãŸã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒ 1 ã¤ä»¥ä¸Šå«ã¾ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:102 +msgid "parameter-alias-self" +msgstr "parameter-alias-self" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:102 +msgid "argument in argument_spec is specified as its own alias" +msgstr "argument_spec ã®å¼•æ•°ã¯ã€ç‹¬è‡ªã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¨ã—ã¦æŒ‡å®šã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:103 +msgid "parameter-documented-multiple-times" +msgstr "parameter-documented-multiple-times" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:103 +msgid "argument in argument_spec with aliases is documented multiple times" +msgstr "エイリアスをæŒã¤ argument_spec ã®å¼•æ•°ãŒè¤‡æ•°å›žæ–‡æ›¸åŒ–ã•ã‚Œã¦ã„ã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:104 +msgid "parameter-list-no-elements" +msgstr "parameter-list-no-elements" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:104 +msgid "argument in argument_spec \"type\" is specified as ``list`` without defining \"elements\"" +msgstr "argument_spec「typeã€ã®å¼•æ•°ã¯ã€ã€Œè¦ç´ ã€ã‚’定義ã›ãšã« ``list`` ã®ã‚ˆã†ã«æŒ‡å®šã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:105 +msgid "parameter-state-invalid-choice" +msgstr "parameter-state-invalid-choice" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:105 +msgid "Argument ``state`` includes ``get``, ``list`` or ``info`` as a choice. Functionality should be in an ``_info`` or (if further conditions apply) ``_facts`` module." +msgstr "引数 ``state`` ã«ã¯ã€``get``ã€``list``ã€ã¾ãŸã¯ ``info`` ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚機能性㯠``_info`` ã¾ãŸã¯ (è¿½åŠ ã®æ¡ä»¶ãŒé©ç”¨ã•ã‚Œã‚‹å ´åˆã¯) ``_facts`` モジュールã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:106 +msgid "python-syntax-error" +msgstr "python-syntax-error" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:106 +msgid "Python ``SyntaxError`` while parsing module" +msgstr "モジュールã®è§£æžä¸ã® Python ``SyntaxError``" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:107 +msgid "removal-version-must-be-major" +msgstr "removal-version-must-be-major" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:107 +msgid "According to the semantic versioning specification (https://semver.org/), the only versions in which features are allowed to be removed are major versions (x.0.0)" +msgstr "セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ä»•æ§˜ (https://semver.org/) ã«ã‚ˆã‚‹ã¨ã€æ©Ÿèƒ½ã®å‰Šé™¤ãŒè¨±å¯ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (x.0.0) ã®ã¿ã§ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:108 +msgid "return-syntax-error" +msgstr "return-syntax-error" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:108 +msgid "``RETURN`` is not valid YAML, ``RETURN`` fragments missing or invalid" +msgstr "``RETURN`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“。``RETURN`` フラグメントãŒè¦‹ã¤ã‹ã‚‰ãªã„ã‹ã€ç„¡åŠ¹ã§ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:109 +msgid "return-invalid-version-added" +msgstr "return-invalid-version-added" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:109 +msgid "``version_added`` for return value is not a valid version number" +msgstr "戻り値㮠``version_added`` ã¯ã€æœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:110 +msgid "subdirectory-missing-init" +msgstr "subdirectory-missing-init" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:110 +msgid "Ansible module subdirectories must contain an ``__init__.py``" +msgstr "Ansible モジュールã®ã‚µãƒ–ディレクトリーã«ã¯ ``__init__.py`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:111 +msgid "try-except-missing-has" +msgstr "try-except-missing-has" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:111 +msgid "Try/Except ``HAS_`` expression missing" +msgstr "try/Except ``HAS_`` å¼ãŒãªã„" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:112 +msgid "undocumented-parameter" +msgstr "undocumented-parameter" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:112 +msgid "Argument is listed in the argument_spec, but not documented in the module" +msgstr "引数㌠argument_spec ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ãŒã€ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯æ–‡æ›¸åŒ–ã•ã‚Œã¦ã„ã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:113 +msgid "unidiomatic-typecheck" +msgstr "unidiomatic-typecheck" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:113 +msgid "Type comparison using ``type()`` found. Use ``isinstance()`` instead" +msgstr "``type()`` を使用ã—ãŸã‚¿ã‚¤ãƒ—比較。代ã‚ã‚Šã« ``isinstance()`` を使用ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:114 +msgid "unknown-doc-fragment" +msgstr "unknown-doc-fragment" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:114 +msgid "Unknown pre-existing ``DOCUMENTATION`` error" +msgstr "ä¸æ˜Žãªæ—¢å˜ã® ``DOCUMENTATION`` エラー" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:115 +msgid "use-boto3" +msgstr "use-boto3" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:115 +msgid "``boto`` import found, new modules should use ``boto3``" +msgstr "``boto`` インãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« ``boto3`` を使用ã—ã¦ãã ã•ã„" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:116 +msgid "use-fail-json-not-sys-exit" +msgstr "use-fail-json-not-sys-exit" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:116 +msgid "``sys.exit()`` call found. Should be ``exit_json``/``fail_json``" +msgstr "``sys.exit()`` 呼ã³å‡ºã—ãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚``exit_json``/``fail_json`` ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:117 +msgid "use-module-utils-urls" +msgstr "use-module-utils-urls" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:117 +msgid "``requests`` import found, should use ``ansible.module_utils.urls`` instead" +msgstr "``requests`` インãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚代ã‚ã‚Šã« ``ansible.module_utils.urls`` を使用ã—ã¦ãã ã•ã„" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:118 +msgid "use-run-command-not-os-call" +msgstr "use-run-command-not-os-call" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:118 +msgid "``os.call`` used instead of ``module.run_command``" +msgstr "``module.run_command`` ã®ä»£ã‚ã‚Šã«ã€``os.call`` を使用ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:119 +msgid "use-run-command-not-popen" +msgstr "use-run-command-not-popen" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:119 +msgid "``subprocess.Popen`` used instead of ``module.run_command``" +msgstr "``module.run_command`` ã®ä»£ã‚ã‚Šã«ã€``subprocess.Popen`` を使用ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:120 +msgid "use-short-gplv3-license" +msgstr "use-short-gplv3-license" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:120 +msgid "GPLv3 license header should be the :ref:`short form <copyright>` for new modules" +msgstr "GPLv3 ライセンスヘッダーã¯ã€æ–°ã—ã„モジュール㮠:ref:`çŸç¸®å½¢ <copyright>` ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:121 +msgid "mutually_exclusive-type" +msgstr "mutually_exclusive-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:121 +msgid "mutually_exclusive entry contains non-string value" +msgstr "mutually_exclusive エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:122 +msgid "mutually_exclusive-collision" +msgstr "mutually_exclusive-collision" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:122 +msgid "mutually_exclusive entry has repeated terms" +msgstr "mutually_exclusive エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:123 +msgid "mutually_exclusive-unknown" +msgstr "mutually_exclusive-unknown" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:123 +msgid "mutually_exclusive entry contains option which does not appear in argument_spec (potentially an alias of an option?)" +msgstr "mutually_exclusive エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:124 +msgid "required_one_of-type" +msgstr "required_one_of-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:124 +msgid "required_one_of entry contains non-string value" +msgstr "required_one_of エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:125 +msgid "required_one_of-collision" +msgstr "required_one_of-collision" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:125 +msgid "required_one_of entry has repeated terms" +msgstr "required_one_of エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:126 +msgid "required_one_of-unknown" +msgstr "required_one_of-unknown" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:126 +msgid "required_one_of entry contains option which does not appear in argument_spec (potentially an alias of an option?)" +msgstr "required_one_of エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:127 +msgid "required_together-type" +msgstr "required_together-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:127 +msgid "required_together entry contains non-string value" +msgstr "required_together エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:128 +msgid "required_together-collision" +msgstr "required_together-collision" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:128 +msgid "required_together entry has repeated terms" +msgstr "required_together エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:129 +msgid "required_together-unknown" +msgstr "required_together-unknown" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:129 +msgid "required_together entry contains option which does not appear in argument_spec (potentially an alias of an option?)" +msgstr "required_together エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:130 +msgid "required_if-is_one_of-type" +msgstr "required_if-is_one_of-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:130 +msgid "required_if entry has a fourth value which is not a bool" +msgstr "required_if エントリーã«ã¯ bool ã§ã¯ãªã„ 4 ã¤ç›®ã®å€¤ãŒã‚ã‚‹" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:131 +msgid "required_if-requirements-type" +msgstr "required_if-requirements-type" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:131 +msgid "required_if entry has a third value (requirements) which is not a list or tuple" +msgstr "required_if エントリーã«ã¯ã€ãƒªã‚¹ãƒˆã¾ãŸã¯ã‚¿ãƒ—ルã§ã¯ãªã„ 3 ã¤ã®å€¤ (å¿…é ˆ) ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:132 +msgid "required_if-requirements-collision" +msgstr "required_if-requirements-collision" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:132 +msgid "required_if entry has repeated terms in requirements" +msgstr "required_if エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:133 +msgid "required_if-requirements-unknown" +msgstr "required_if-requirements-unknown" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:133 +msgid "required_if entry's requirements contains option which does not appear in argument_spec (potentially an alias of an option?)" +msgstr "required_if エントリーã®è¦ä»¶ã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:134 +msgid "required_if-unknown-key" +msgstr "required_if-unknown-key" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:134 +msgid "required_if entry's key does not appear in argument_spec (potentially an alias of an option?)" +msgstr "required_if エントリーã®ã‚ー㌠argument_spec ã«è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:135 +msgid "required_if-key-in-requirements" +msgstr "required_if-key-in-requirements" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:135 +msgid "required_if entry contains its key in requirements list/tuple" +msgstr "required_if エントリーã«ã¯è¦ä»¶ãƒªã‚¹ãƒˆ/タプルã®ã‚ーãŒå«ã¾ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:136 +msgid "required_if-value-type" +msgstr "required_if-value-type" -#: ../../rst/dev_guide/testing_compile.rst:60 -msgid "``ansible-test`` has a number of dependencies , for ``compile`` tests we suggest running the tests with ``--local``, which is the default" -msgstr "``ansible-test`` ã«ã¯ã„ãã¤ã‹ã®ä¾å˜é–¢ä¿‚ãŒã‚ã‚Šã¾ã™ã€‚``compile`` テストã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚ã‚‹ ``--local`` を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:136 +msgid "required_if entry's value is not of the type specified for its key" +msgstr "required_if エントリーã®å€¤ã¯ã€ã‚ーã«æŒ‡å®šã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã§ã¯ã‚ã‚Šã¾ã›ã‚“" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:137 +msgid "required_by-collision" +msgstr "required_by-collision" -#: ../../rst/dev_guide/testing_compile.rst:62 -msgid "The dependencies can be installed using the ``--requirements`` argument. For example:" -msgstr "ä¾å˜é–¢ä¿‚ã¯ã€``--requirements`` 引数を使用ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:137 +msgid "required_by entry has repeated terms" +msgstr "required_by エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:138 +msgid "required_by-unknown" +msgstr "required_by-unknown" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:138 +msgid "required_by entry contains option which does not appear in argument_spec (potentially an alias of an option?)" +msgstr "required_by エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:139 +msgid "version-added-must-be-major-or-minor" +msgstr "version-added-must-be-major-or-minor" + +#: ../../rst/dev_guide/testing/sanity/validate-modules.rst:139 +msgid "According to the semantic versioning specification (https://semver.org/), the only versions in which features are allowed to be added are major and minor versions (x.y.0)" +msgstr "セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ä»•æ§˜ (https://semver.org/) ã«ã‚ˆã‚‹ã¨ã€æ©Ÿèƒ½ã®è¿½åŠ ãŒè¨±å¯ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŠã‚ˆã³ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (x.y.0) ã®ã¿ã§ã™" + +#: ../../rst/dev_guide/testing/sanity/yamllint.rst:2 +msgid "yamllint" +msgstr "yamllint" + +#: ../../rst/dev_guide/testing/sanity/yamllint.rst:4 +msgid "Check YAML files for syntax and formatting issues." +msgstr "YAML ファイルã«ãŠã‘る構文ãŠã‚ˆã³ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã®å•é¡Œã‚’確èªã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_compile.rst:6 +msgid "Compile Tests" +msgstr "コンパイルテスト" -#: ../../rst/dev_guide/testing_compile.rst:70 -msgid "The full list of requirements can be found at `test/lib/ansible_test/_data/requirements <https://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/_data/requirements>`_. Requirements files are named after their respective commands. See also the `constraints <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/requirements/constraints.txt>`_ applicable to all commands." -msgstr "è¦ä»¶ã®ä¸€è¦§ã¯ `test/lib/ansible_test/_data/requirements <https://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/_data/requirements>`_ ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€å„コマンドã«ã¡ãªã‚“ã§åå‰ãŒä»˜ã‘られã¦ã„ã¾ã™ã€‚全コマンドã«é©ç”¨ã•ã‚Œã‚‹ `制約 <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/requirements/constraints.txt>`_ ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing_compile.rst:8 +msgid "This page has moved to :ref:`testing_compile`." +msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã¯ :ref:`testing_compile` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/testing_compile.rst:74 -msgid "Extending compile tests" -msgstr "コンパイルテストã®æ‹¡å¼µ" +#: ../../rst/dev_guide/testing_documentation.rst:8 +msgid "Testing plugin documentation" +msgstr "プラグインドã‚ュメントã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing_compile.rst:76 -msgid "If you believe changes are needed to the compile tests please add a comment on the `Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ so it can be discussed." -msgstr "コンパイルテストã«å¤‰æ›´ãŒå¿…è¦ãªå ´åˆã¯ã€`Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ãã ã•ã„。ãã®å†…容ã«ã¤ã„ã¦è©±ã—åˆã†ã“ã¨ãŒã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_documentation.rst:10 +msgid "A quick test while developing is to use ``ansible-doc -t <plugin_type> <name>`` to see if it renders, you might need to add ``-M /path/to/module`` if the module is not somewhere Ansible expects to find it." +msgstr "開発ä¸ã®ç°¡å˜ãªãƒ†ã‚¹ãƒˆã¨ã—ã¦ã€``ansible-doc -t <plugin_type> <name>`` を使用ã—ã¦ãƒ¬ãƒ³ãƒ€ãƒªãƒ³ã‚°ã•ã‚Œã‚‹ã‹ã©ã†ã‹ã‚’確èªã§ãã¾ã™ã€‚Ansible ãŒæœŸå¾…ã™ã‚‹å ´æ‰€ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãªã„å ´åˆã€``-M /path/to/module`` ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚‚ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:9 -msgid "Before you submit a module for inclusion in the main Ansible repo, you must test your module documentation for correct HTML rendering and to ensure that the argspec matches the documentation in your Python file. The community pages offer more information on :ref:`testing reStructuredText documentation <testing_documentation_locally>`." -msgstr "メイン㮠Ansible リãƒã‚¸ãƒˆãƒªãƒ¼ã«çµ„ã¿è¾¼ã‚€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’é€ä¿¡ã™ã‚‹å‰ã«ã€æ£ã—ã„ HTML レンダリングã¤ã„ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントをテストã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€argspec ㌠Python ファイルã®ãƒ‰ã‚ュメントã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚コミュニティーページã§ã¯ã€ã€Œ:ref:`reStructuredText ドã‚ュメントã®ãƒ†ã‚¹ãƒˆ <testing_documentation_locally>`ã€ã®è©³ç´°ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_documentation.rst:12 +msgid "Before you submit a plugin for inclusion in Ansible, you must test your documentation for correct HTML rendering and for modules to ensure that the argspec matches the documentation in your Python file. The community pages offer more information on :ref:`testing reStructuredText documentation <testing_documentation_locally>`." +msgstr "Ansible ã«çµ„ã¿è¾¼ã‚€ãƒ—ラグインをé€ä¿¡ã™ã‚‹å‰ã«ã€æ£ã—ã„ HTML レンダリングã¨ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã¤ã„ã¦ãƒ‰ã‚ュメントをテストã—ã€argspec ㌠Python ファイルã®ãƒ‰ã‚ュメントã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãƒšãƒ¼ã‚¸ã® :ref:`testing reStructuredText documentation <testing_documentation_locally>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing_documentation.rst:11 -msgid "To check the HTML output of your module documentation:" -msgstr "モジュールドã‚ュメント㮠HTML 出力を確èªã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_documentation.rst:15 +msgid "For example, to check the HTML output of your module documentation:" +msgstr "ãŸã¨ãˆã°ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメント㮠HTML 出力を確èªã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:13 +#: ../../rst/dev_guide/testing_documentation.rst:17 msgid "Ensure working :ref:`development environment <environment_setup>`." msgstr ":ref:`開発環境 <environment_setup>` ãŒç¨¼åƒã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:14 -#: ../../rst/dev_guide/testing_documentation.rst:28 +#: ../../rst/dev_guide/testing_documentation.rst:18 +#: ../../rst/dev_guide/testing_documentation.rst:32 msgid "Install required Python packages (drop '--user' in venv/virtualenv):" msgstr "å¿…è¦ãª Python パッケージをインストールã—ã¾ã™ (venv/virtualenv ã«ã€Œ--userã€ã‚’ドãƒãƒƒãƒ—ã—ã¾ã™)。" -#: ../../rst/dev_guide/testing_documentation.rst:21 -msgid "Ensure your module is in the correct directory: ``lib/ansible/modules/$CATEGORY/mymodule.py``." -msgstr "モジュールãŒæ£ã—ã„ディレクトリー (``lib/ansible/modules/$CATEGORY/mymodule.py``) ã«ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_documentation.rst:25 +msgid "Ensure your module is in the correct directory: ``lib/ansible/modules/mymodule.py`` or in a configured path." +msgstr "モジュールãŒæ£ã—ã„ディレクトリー (``lib/ansible/modules/mymodule.py``)ã€ã¾ãŸã¯è¨å®šã•ã‚ŒãŸãƒ‘スã«ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:22 +#: ../../rst/dev_guide/testing_documentation.rst:26 msgid "Build HTML from your module documentation: ``MODULES=mymodule make webdocs``." msgstr "モジュールドã‚ュメント ``MODULES=mymodule make webdocs`` ã‹ã‚‰ HTML を構築ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:23 +#: ../../rst/dev_guide/testing_documentation.rst:27 msgid "To build the HTML documentation for multiple modules, use a comma-separated list of module names: ``MODULES=mymodule,mymodule2 make webdocs``." msgstr "複数ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã® HTML ドã‚ュメントを作æˆã™ã‚‹ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šãƒªã‚¹ãƒˆã‚’使用ã—ã¾ã™ (``MODULES=mymodule,mymodule2 make webdocs``)。" -#: ../../rst/dev_guide/testing_documentation.rst:24 +#: ../../rst/dev_guide/testing_documentation.rst:28 msgid "View the HTML page at ``file:///path/to/docs/docsite/_build/html/modules/mymodule_module.html``." msgstr "``file:///path/to/docs/docsite/_build/html/modules/mymodule_module.html`` 㧠HTML ページを表示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:26 +#: ../../rst/dev_guide/testing_documentation.rst:30 msgid "To ensure that your module documentation matches your ``argument_spec``:" msgstr "モジュールã®ãƒ‰ã‚ュメント㌠``argument_spec`` ã¨é©åˆã™ã‚‹ã‚ˆã†ã«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_documentation.rst:34 -msgid "run the ``validate-modules`` test::" +#: ../../rst/dev_guide/testing_documentation.rst:38 +msgid "run the ``validate-modules`` test:" msgstr "``validate-modules`` テストを実行ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_documentation.rst:44 +msgid "For other plugin types the steps are similar, just adjusting names and paths to the specific type." +msgstr "ä»–ã®ãƒ—ラグインタイプã®å ´åˆã‚‚æ‰‹é †ã¯åŒã˜ã§ã™ãŒã€åå‰ã¨ãƒ‘スã®ã‚¿ã‚¤ãƒ—ã®ã¿é©å®œèª¿æ•´ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + #: ../../rst/dev_guide/testing_httptester.rst:5 msgid "httptester" msgstr "httptester" +#: ../../rst/dev_guide/testing_httptester.rst:10 +msgid "Overview" +msgstr "概è¦" + #: ../../rst/dev_guide/testing_httptester.rst:12 msgid "``httptester`` is a docker container used to host certain resources required by :ref:`testing_integration`. This is to avoid CI tests requiring external resources (such as git or package repos) which, if temporarily unavailable, would cause tests to fail." msgstr "``httptester`` ã¯ã€:ref:`testing_integration` ã§å¿…è¦ãªç‰¹å®šã®ãƒªã‚½ãƒ¼ã‚¹ã‚’ホストã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã‚‹ docker コンテナーã§ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€(git やパッケージリãƒã‚¸ãƒˆãƒªãƒ¼ãªã©ã®) 外部リソースを必è¦ã¨ã™ã‚‹ CI テストãŒå›žé¿ã•ã‚Œã€ä¸€æ™‚çš„ã«åˆ©ç”¨ã§ããªããªã‚‹ã¨ãƒ†ã‚¹ãƒˆãŒå¤±æ•—ã—ã¾ã™ã€‚" @@ -12286,7 +13130,7 @@ msgstr "httptester ã®æ‹¡å¼µ" #: ../../rst/dev_guide/testing_httptester.rst:28 msgid "If you have sometime to improve ``httptester`` please add a comment on the `Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ to avoid duplicated effort." -msgstr "``httptester`` を改善ã™ã‚‹ã‚¿ã‚¤ãƒŸãƒ³ã‚°ãŒã‚ã‚‹å ´åˆã¯ã€é‡è¤‡ä½œæ¥ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€`Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¾ã™ã€‚" +msgstr "``httptester`` を改善ã™ã‚‹ã‚¿ã‚¤ãƒŸãƒ³ã‚°ãŒã‚ã‚‹å ´åˆã¯ã€é‡è¤‡ä½œæ¥ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€`Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ãã ã•ã„。" #: ../../rst/dev_guide/testing_integration.rst:11 msgid "The Ansible integration Test system." @@ -12318,7 +13162,7 @@ msgstr "python パッケージ ``argcomplete`` をインストールã—ã€ã‚¢ã‚¯ #: ../../rst/dev_guide/testing_integration.rst:30 msgid "Configuration" -msgstr "è¨å®š" +msgstr "Configuration (構æˆ)" #: ../../rst/dev_guide/testing_integration.rst:33 msgid "ansible-test command" @@ -12409,7 +13253,7 @@ msgid "Running these tests may result in changes to your Windows host, so don't msgstr "ã“れらã®ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã¨ã€Windows ホストãŒå¤‰æ›´ã«ãªã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€å®Ÿç¨¼åƒç’°å¢ƒã‚„é‡è¦ãª Windows 環境ã§ã¯å®Ÿè¡Œã—ãªã„ã§ãã ã•ã„。" #: ../../rst/dev_guide/testing_integration.rst:125 -msgid "Enable PowerShell Remoting (run on the Windows host via Remote Desktop):" +msgid "Enable PowerShell Remoting (run on the Windows host by a Remote Desktop):" msgstr "PowerShell Remoting を有効ã«ã—ã¾ã™ (リモートデスクトップを介ã—㦠Windows ホストã§å®Ÿè¡Œã—ã¾ã™)。" #: ../../rst/dev_guide/testing_integration.rst:131 @@ -12429,6 +13273,7 @@ msgid "If you have a Linux system with Docker or Podman installed, running integ msgstr "Dockerã¾ãŸã¯Podman ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸ Linux システムをãŠæŒã¡ã®å ´åˆã¯ã€Ansible ã®ç¶™ç¶šçš„çµ±åˆ (CI) システムã§ä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹ã‚‚ã®ã¨åŒã˜ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã‚’使用ã—ã¦çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" #: ../../rst/dev_guide/testing_integration.rst:150 +#: ../../rst/dev_guide/testing_running_locally.rst:279 msgid "Podman" msgstr "Podman" @@ -12469,328 +13314,536 @@ msgid "The list is under the **target docker images and supported python version msgstr "ã“ã®ä¸€è¦§ã¯ã€**target docker images and supported python version** ã®è¦‹å‡ºã—ã®ä¸‹ã«ã‚ã‚Šã¾ã™ã€‚" #: ../../rst/dev_guide/testing_integration.rst:191 -msgid "Legacy Cloud Tests" -msgstr "レガシーã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ†ã‚¹ãƒˆ" - -#: ../../rst/dev_guide/testing_integration.rst:193 -msgid "Some of the cloud tests run as normal integration tests, and others run as legacy tests; see the :ref:`testing_integration_legacy` page for more information." -msgstr "一部ã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ†ã‚¹ãƒˆã¯é€šå¸¸ã®çµ±åˆãƒ†ã‚¹ãƒˆã¨ã—ã¦å®Ÿè¡Œã—ã€ãã®ä»–ã¯ãƒ¬ã‚¬ã‚·ãƒ¼ãƒ†ã‚¹ãƒˆã¨ã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`testing_integration_legacy`ã€ã®ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" - -#: ../../rst/dev_guide/testing_integration.rst:198 msgid "Other configuration for Cloud Tests" msgstr "クラウドテストã®ãã®ä»–ã®è¨å®š" -#: ../../rst/dev_guide/testing_integration.rst:200 +#: ../../rst/dev_guide/testing_integration.rst:193 msgid "In order to run some tests, you must provide access credentials in a file named ``cloud-config-aws.yml`` or ``cloud-config-cs.ini`` in the test/integration directory. Corresponding .template files are available for for syntax help. The newer AWS tests now use the file test/integration/cloud-config-aws.yml" msgstr "test/integration ディレクトリーã«ã‚ã‚‹ ``cloud-config-aws.yml`` ã¾ãŸã¯ ``cloud-config-cs.ini`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚るアクセスèªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚構文ヘルプã§ã¯ã€å¯¾å¿œã™ã‚‹ .template ファイルを利用ã§ãã¾ã™ã€‚æ–°ã—ã„ AWS テストã§ã¯ã€test/integration/cloud-config-aws.yml ファイルãŒä½¿ç”¨ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/testing_integration.rst:206 -#: ../../rst/dev_guide/testing_integration_legacy.rst:60 +#: ../../rst/dev_guide/testing_integration.rst:199 msgid "IAM policies for AWS" msgstr "AWS ã® IAM ãƒãƒªã‚·ãƒ¼" -#: ../../rst/dev_guide/testing_integration.rst:208 +#: ../../rst/dev_guide/testing_integration.rst:201 msgid "Ansible needs fairly wide ranging powers to run the tests in an AWS account. This rights can be provided to a dedicated user. These need to be configured before running the test." msgstr "Ansible ã¯ã€AWS アカウントã§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ãŸã‚ã«éžå¸¸ã«å¹…広ã„権é™ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚ã“ã®æ¨©é™ã¯å°‚用ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«æä¾›ã§ãã¾ã™ã€‚ã“れらã®æ¨©é™ã¯ã€ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹å‰ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration.rst:211 +#: ../../rst/dev_guide/testing_integration.rst:204 msgid "testing-policies" msgstr "testing-policies" -#: ../../rst/dev_guide/testing_integration.rst:213 +#: ../../rst/dev_guide/testing_integration.rst:206 msgid "The GitHub repository `mattclay/aws-terminator <https://github.com/mattclay/aws-terminator/>`_ contains two sets of policies used for all existing AWS module integratoin tests. The `hacking/aws_config/setup_iam.yml` playbook can be used to setup two groups:" msgstr "GitHub リãƒã‚¸ãƒˆãƒªãƒ¼ `mattclay/aws-terminator <https://github.com/mattclay/aws-terminator/>`_ ã«ã¯ã€æ—¢å˜ã® AWS モジュールã®çµ±åˆãƒ†ã‚¹ãƒˆã«ä½¿ç”¨ã™ã‚‹ãƒãƒªã‚·ãƒ¼ã®ã‚»ãƒƒãƒˆãŒ 2 ã¤å«ã¾ã‚Œã¾ã™ã€‚Playbook `hacking/aws_config/setup_iam.yml` を使用ã™ã‚‹ã¨ã€2 ã¤ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration.rst:217 +#: ../../rst/dev_guide/testing_integration.rst:210 msgid "`ansible-integration-ci` will have the policies applied necessary to run any integration tests not marked as `unsupported` and are designed to mirror those used by Ansible's CI." msgstr "`ansible-integration-ci` ã¯ã€çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«å¿…è¦ã¨ãªã‚‹ãƒãƒªã‚·ãƒ¼ã‚’é©ç”¨ã™ã‚‹ã¨å…±ã«ã€`unsupported` ã¨è˜åˆ¥ã•ã‚Œãšã€Ansible ã® CI ã§ä½¿ç”¨ã•ã‚Œã‚‹ãƒŸãƒ©ãƒ¼ãƒªãƒ³ã‚°ç”¨ã«è¨è¨ˆã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration.rst:220 +#: ../../rst/dev_guide/testing_integration.rst:213 msgid "`ansible-integration-unsupported` will have the additional policies applied necessary to run the integration tests marked as `unsupported` including tests for managing IAM roles, users and groups." msgstr "`ansible-integration-unsupported` ã¯ã€IAM ãƒãƒ¼ãƒ«ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã€ãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—を管ç†ã™ã‚‹ãŸã‚ã®ãƒ†ã‚¹ãƒˆã‚’å«ã‚€ `unsupported` ã¨ãƒžãƒ¼ã‚¯ã•ã‚ŒãŸçµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«å¿…è¦ãªè¿½åŠ ã®ãƒãƒªã‚·ãƒ¼ãŒé©ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration.rst:224 +#: ../../rst/dev_guide/testing_integration.rst:217 msgid "Once the groups have been created, you'll need to create a user and make the user a member of these groups. The policies are designed to minimize the rights of that user. Please note that while this policy does limit the user to one region, this does not fully restrict the user (primarily due to the limitations of the Amazon ARN notation). The user will still have wide privileges for viewing account definitions, and will also able to manage some resources that are not related to testing (for example, AWS lambdas with different names). Tests should not be run in a primary production account in any case." msgstr "グループãŒä½œæˆã•ã‚ŒãŸã‚‰ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’作æˆã—ã¦ã€ãã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’ã“れらã®ã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒ¡ãƒ³ãƒãƒ¼ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãƒãƒªã‚·ãƒ¼ã¯ã€ãã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®æ¨©åˆ©ã‚’最å°é™ã«ã™ã‚‹ãŸã‚ã®ã‚‚ã®ã§ã™ã€‚ã“ã®ãƒãƒªã‚·ãƒ¼ã§ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’ 1 ã¤ã®åœ°åŸŸã«é™å®šã—ã¦ã„ã¾ã™ãŒã€ã“ã‚Œã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’完全ã«ã¯åˆ¶é™ã—ã¦ã„ãªã„ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„ (主㫠Amazon ARN 表記ã®åˆ¶é™ã«ã‚ˆã‚‹ã‚‚ã®ã§ã™)。ã“ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€ã‚¢ã‚«ã‚¦ãƒ³ãƒˆå®šç¾©ã‚’閲覧ã™ã‚‹ãŸã‚ã®åºƒã„権é™ã‚’æŒã£ã¦ãŠã‚Šã€ãƒ†ã‚¹ãƒˆã«é–¢ä¿‚ã®ãªã„ã„ãã¤ã‹ã®ãƒªã‚½ãƒ¼ã‚¹ (ãŸã¨ãˆã°ã€ç•°ãªã‚‹åå‰ã® AWS ラムダ) を管ç†ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã©ã®ã‚ˆã†ãªå ´åˆã§ã‚‚ã€ãƒ†ã‚¹ãƒˆã‚’実稼åƒç’°å¢ƒç”¨ã®ãƒ—ライマリーアカウントã§å®Ÿè¡Œã™ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/dev_guide/testing_integration.rst:232 -#: ../../rst/dev_guide/testing_integration_legacy.rst:78 +#: ../../rst/dev_guide/testing_integration.rst:225 msgid "Other Definitions required" msgstr "ãã®ä»–ã«å¿…è¦ãªå®šç¾©" -#: ../../rst/dev_guide/testing_integration.rst:234 -#: ../../rst/dev_guide/testing_integration_legacy.rst:80 +#: ../../rst/dev_guide/testing_integration.rst:227 msgid "Apart from installing the policy and giving it to the user identity running the tests, a lambda role `ansible_integration_tests` has to be created which has lambda basic execution privileges." msgstr "ãƒãƒªã‚·ãƒ¼ã‚’インストールã—ã¦ã€ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¦ã„るユーザ ID ã«ãれを付与ã™ã‚‹ã“ã¨ã¨ã¯åˆ¥ã«ã€ãƒ©ãƒ ダãƒãƒ¼ãƒ« `ansible_integration_tests` を作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ©ãƒ ダã®åŸºæœ¬çš„ãªå®Ÿè¡Œæ¨©é™ã‚’æŒã¡ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration.rst:240 +#: ../../rst/dev_guide/testing_integration.rst:233 msgid "Network Tests" msgstr "ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing_integration.rst:242 +#: ../../rst/dev_guide/testing_integration.rst:235 msgid "For guidance on writing network test see :ref:`testing_resource_modules`." msgstr "ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ†ã‚¹ãƒˆã®æ›¸ãè¾¼ã¿ã«é–¢ã™ã‚‹æƒ…å ±ã¯ã€ã€Œ:ref:`testing_resource_modules`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing_integration.rst:246 +#: ../../rst/dev_guide/testing_integration.rst:239 msgid "Where to find out more" msgstr "ãã®ä»–ã®è©³ç´°æƒ…å ±" -#: ../../rst/dev_guide/testing_integration.rst:248 +#: ../../rst/dev_guide/testing_integration.rst:241 msgid "If you'd like to know more about the plans for improving testing Ansible, join the `Testing Working Group <https://github.com/ansible/community/blob/main/meetings/README.md>`_." msgstr "Ansible テストを改善ã™ã‚‹è©³ç´°ãªè¨ˆç”»ã‚’確èªã—ãŸã„å ´åˆã¯ã€`Testing Working Group <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã”å‚åŠ ãã ã•ã„。" -#: ../../rst/dev_guide/testing_integration_legacy.rst:7 -msgid "Testing using the Legacy Integration system" -msgstr "レガシー統åˆã‚·ã‚¹ãƒ†ãƒ を使用ã—ãŸãƒ†ã‚¹ãƒˆ" +#: ../../rst/dev_guide/testing_pep8.rst:6 +msgid "PEP 8" +msgstr "PEP 8" -#: ../../rst/dev_guide/testing_integration_legacy.rst:11 -msgid "This page details how to run the integration tests that haven't been ported to the new ``ansible-test`` framework." -msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€æ–°ã—ã„ ``ansible-test`` フレームワークã«ç§»æ¤ã•ã‚Œã¦ã„ãªã„çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œæ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_pep8.rst:8 +msgid "This page has moved to :ref:`testing_pep8`." +msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã¯ :ref:`testing_pep8` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:13 -msgid "The following areas are still tested using the legacy ``make tests`` command:" -msgstr "以下ã®ã‚¨ãƒªã‚¢ã¯ã€ãƒ¬ã‚¬ã‚·ãƒ¼ã® ``make tests`` コマンドを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:7 +msgid "Testing Ansible and Collections" +msgstr "Ansible ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing_integration_legacy.rst:15 -msgid "amazon (some)" -msgstr "amazon (一部)" +#: ../../rst/dev_guide/testing_running_locally.rst:9 +msgid "This document describes how to run tests using ``ansible-test``." +msgstr "ã“ã®ãƒ‰ã‚ュメントã§ã¯ã€``ansible-test`` を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦èª¬æ˜Žã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:16 -msgid "azure" -msgstr "azure" +#: ../../rst/dev_guide/testing_running_locally.rst:17 +msgid "Before running ``ansible-test``, set up your environment for :ref:`testing_an_ansible_collection` or :ref:`testing_ansible_core`, depending on which scenario applies to you." +msgstr "``ansible-test`` を実行ã™ã‚‹å‰ã«ã€è©²å½“ã™ã‚‹ã‚·ãƒŠãƒªã‚ªã«å¿œã˜ã¦ :ref:`testing_an_ansible_collection` ã¾ãŸã¯ :ref:`testing_ansible_core` ã®ç’°å¢ƒã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:17 -msgid "cloudflare" -msgstr "cloudflare" +#: ../../rst/dev_guide/testing_running_locally.rst:22 +msgid "If you use ``git`` for version control, make sure the files you are working with are not ignored by ``git``. If they are, ``ansible-test`` will ignore them as well." +msgstr "è¬ã‚¸ãƒ§ãƒ³ç®¡ç†ã« ``git`` を使用ã™ã‚‹å ´åˆã€``git`` ãŒä½œæ¥ä¸ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’無視ã—ãªã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。無視ã™ã‚‹å ´åˆã€``ansible-test`` ã‚‚åŒæ§˜ã«ç„¡è¦–ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:18 -msgid "cloudscale" -msgstr "cloudscale" +#: ../../rst/dev_guide/testing_running_locally.rst:28 +msgid "Testing an Ansible Collection" +msgstr "Ansible コレクションã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing_integration_legacy.rst:19 -msgid "cloudstack" -msgstr "cloudstack" +#: ../../rst/dev_guide/testing_running_locally.rst:30 +msgid "If you are testing an Ansible Collection, you need a copy of the collection, preferably a git clone. For example, to work with the ``community.windows`` collection, follow these steps:" +msgstr "Ansible コレクションをテストã™ã‚‹å ´åˆã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®è¤‡è£½ (ã§ãれ㰠git クãƒãƒ¼ãƒ³) ãŒå¿…è¦ã§ã™ã€‚ãŸã¨ãˆã° ``community.windows`` コレクションã§ä½œæ¥ã™ã‚‹å ´åˆã€æ¬¡ã®æ‰‹é †ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:20 -msgid "consul" -msgstr "consul" +#: ../../rst/dev_guide/testing_running_locally.rst:33 +msgid "Clone the collection you want to test into a valid collection root:" +msgstr "テストã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’有効ãªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ«ãƒ¼ãƒˆã«è¤‡è£½ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:21 -msgid "exoscale" -msgstr "exoscale" +#: ../../rst/dev_guide/testing_running_locally.rst:41 +msgid "The path must end with ``/ansible_collections/{collection_namespace}/{collection_name}`` where ``{collection_namespace}`` is the namespace of the collection and ``{collection_name}`` is the collection name." +msgstr "パス㯠``/ansible_collections/{collection_namespace}/{collection_name}`` ã§çµ‚ã‚ã‚‹ã‚‚ã®ã¨ã—ã¾ã™ã€‚ã“ã®å ´åˆã® ``{collection_namespace}`` ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®åå‰ç©ºé–“ã€``{collection_name}`` ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã§ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:22 -msgid "gce" -msgstr "gce" +#: ../../rst/dev_guide/testing_running_locally.rst:44 +msgid "Clone any collections on which the collection depends:" +msgstr "コレクションãŒä¾å˜ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’複製ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:23 -msgid "jenkins" -msgstr "jenkins" +#: ../../rst/dev_guide/testing_running_locally.rst:52 +msgid "If your collection has any dependencies on other collections, they must be in the same collection root, since ``ansible-test`` will not use your configured collection roots (or other Ansible configuration)." +msgstr "``ansible-test`` ã§ã¯è¨å®šã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ«ãƒ¼ãƒˆ (ã¾ãŸã¯ä»–ã® Ansible è¨å®š) ã¯ä½¿ç”¨ã•ã‚Œãªã„ãŸã‚ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒä»–ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ä¾å˜ã—ã¦ã„ã‚‹å ´åˆã€ãれらã¯åŒã˜ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ«ãƒ¼ãƒˆã«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:24 -msgid "rackspace" -msgstr "rackspace" +#: ../../rst/dev_guide/testing_running_locally.rst:57 +msgid "See the collection's ``galaxy.yml`` for a list of possible dependencies." +msgstr "å¯èƒ½æ€§ã®ã‚ã‚‹ä¾å˜é–¢ä¿‚ã®ãƒªã‚¹ãƒˆã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® ``galaxy.yml`` ã§ç¢ºèªã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:26 -msgid "Over time the above list will be reduced as tests are ported to the ``ansible-test`` framework." -msgstr "テスト㌠``ansible-test`` フレームワークã«ç§»æ¤ã•ã‚Œã‚‹ã¨ã€ä¸Šè¨˜ã®ãƒªã‚¹ãƒˆã¯å¾ã€…ã«å°‘ãªããªã£ã¦ã„ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:59 +msgid "Switch to the directory where the collection to test resides:" +msgstr "テストã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒå˜åœ¨ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«åˆ‡ã‚Šæ›¿ãˆã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:30 -msgid "Running Cloud Tests" -msgstr "クラウドテストã®å®Ÿè¡Œ" +#: ../../rst/dev_guide/testing_running_locally.rst:68 +msgid "Testing ``ansible-core``" +msgstr "``ansible-core`` ã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/dev_guide/testing_integration_legacy.rst:32 -msgid "Cloud tests exercise capabilities of cloud modules (for example, ec2_key). These are not 'tests run in the cloud' so much as tests that use the cloud modules and are organized by cloud provider." -msgstr "クラウドテストã¯ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (ec2_key ãªã©) ã®æ©Ÿèƒ½ã‚’実行ã—ã¾ã™ã€‚ã“れらã¯ã€ã€Œã‚¯ãƒ©ã‚¦ãƒ‰ã§å®Ÿè¡Œã•ã‚Œã‚‹ãƒ†ã‚¹ãƒˆã€ã§ã¯ãªãã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ã«ã‚ˆã£ã¦ç·¨æˆã•ã‚ŒãŸãƒ†ã‚¹ãƒˆã§ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:70 +msgid "If you are testing ``ansible-core`` itself, you need a copy of the ``ansible-core`` source code, preferably a git clone. Having an installed copy of ``ansible-core`` is not sufficient or required. For example, to work with the ``ansible-core`` source cloned from GitHub, follow these steps:" +msgstr "``ansible-core`` をテストã—ã¦ã„ã‚‹å ´åˆã€``ansible-core`` ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®ã‚³ãƒ”ー (ã§ãれ㰠git クãƒãƒ¼ãƒ³) ãŒå¿…è¦ã§ã™ã€‚``ansible-core`` ã®ã‚³ãƒ”ーãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã ã‘ã§ã¯ä¸å分ãªå ´åˆãŒã‚ã‚Šã€ãã‚ŒãŒå¿…é ˆã§ã¯ãªã„å ´åˆã‚‚ã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€GitHub ã‹ã‚‰è¤‡è£½ã•ã‚ŒãŸ ``ansible-core``ソースを処ç†ã™ã‚‹å ´åˆã€æ¬¡ã®æ‰‹é †ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:36 -msgid "Some AWS tests may use environment variables. It is recommended to either unset any AWS environment variables( such as ``AWS_DEFAULT_PROFILE``, ``AWS_SECRET_ACCESS_KEY``, and so on) or be sure that the environment variables match the credentials provided in ``credentials.yml`` to ensure the tests run with consistency to their full capability on the expected account. See `AWS CLI docs <https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_ for information on creating a profile." -msgstr "AWS テストã«ã‚ˆã£ã¦ã¯ã€ç’°å¢ƒå¤‰æ•°ã‚’使用ã™ã‚‹ã‚‚ã®ã‚‚ã‚ã‚Šã¾ã™ã€‚AWS 環境変数 (``AWS_DEFAULT_PROFILE``ã€``AWS_SECRET_ACCESS_KEY`` ãªã©) ã®è¨å®šã‚’解除ã™ã‚‹ã‹ã€ç’°å¢ƒå¤‰æ•°ãŒ ``credentials.yml`` ã§æä¾›ã•ã‚Œã‚‹èªè¨¼æƒ…å ±ã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã—ã¦ã€äºˆæƒ³ã•ã‚Œã‚‹ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã®å®Œå…¨ãªæ©Ÿèƒ½ã«ä¸€è²«æ€§ã®ã‚るテストãŒå®Ÿè¡Œã•ã‚Œã‚‹ã‚ˆã†ã«ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚プãƒãƒ•ã‚¡ã‚¤ãƒ«ã®ä½œæˆã«é–¢ã™ã‚‹æƒ…å ±ã¯ã€`AWS CLI ドã‚ュメント <https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing_running_locally.rst:74 +msgid "Clone the ``ansible-core`` repository:" +msgstr "``ansible-core`` リãƒã‚¸ãƒˆãƒªãƒ¼ã®ã‚¯ãƒãƒ¼ãƒ³ã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:38 -msgid "Subsets of tests may be run by ``#commenting`` out unnecessary roles in the appropriate playbook, such as ``test/integration/amazon.yml``." -msgstr "テストã®ã‚µãƒ–セットã¯ã€é©åˆ‡ãª Playbook ã® ä¸è¦ãªãƒãƒ¼ãƒ«ã‚’ ``#commenting`` ã§ã‚³ãƒ¡ãƒ³ãƒˆã‚¢ã‚¦ãƒˆã™ã‚‹ã“ã¨ã§å®Ÿè¡Œã§ãã¾ã™ (例: ``test/integration/amazon.yml``)。" +#: ../../rst/dev_guide/testing_running_locally.rst:80 +msgid "Switch to the directory where the ``ansible-core`` source resides:" +msgstr "``ansible-core`` ソースãŒã‚るディレクトリーã«åˆ‡ã‚Šæ›¿ãˆã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:40 -msgid "In order to run cloud tests, you must provide access credentials in a file named ``credentials.yml``. A sample credentials file named ``credentials.template`` is available for syntax help." -msgstr "クラウドテストを実行ã™ã‚‹ã«ã¯ã€``credentials.yml`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚¢ã‚¯ã‚»ã‚¹èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚構文ヘルプã«ã¯ã€``credentials.template`` ã¨åå‰ã®ä»˜ã„ãŸã‚µãƒ³ãƒ—ルèªè¨¼æƒ…å ±ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åˆ©ç”¨ã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:86 +msgid "Add ``ansible-core`` programs to your ``PATH``:" +msgstr "``PATH`` ã« ``ansible-core`` プãƒã‚°ãƒ©ãƒ ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:44 -msgid "Provide cloud credentials:" -msgstr "クラウドèªè¨¼ã‚’æä¾›ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:94 +msgid "You can skip this step if you only need to run ``ansible-test``, and not other ``ansible-core`` programs. In that case, simply run ``bin/ansible-test`` from the root of the ``ansible-core`` source." +msgstr "実行ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã®ãŒ ``ansible-test`` ã®ã¿ã§ã€ãã®ä»–ã® ``ansible-core`` プãƒã‚°ãƒ©ãƒ ã¯å¿…è¦ãªã‘ã‚Œã°ã€ã“ã®æ‰‹é †ã¯çœç•¥ã§ãã¾ã™ã€‚ãã®å ´åˆã€``ansible-core`` ソースã®ãƒ«ãƒ¼ãƒˆã‹ã‚‰ ``bin/ansible-test`` を実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:53 -msgid "Other configuration" -msgstr "ãã®ä»–ã®è¨å®š" +#: ../../rst/dev_guide/testing_running_locally.rst:99 +msgid "If you have an installed version of ``ansible-core`` and are trying to run ``ansible-test`` from your ``PATH``, make sure the program found by your shell is the one from the ``ansible-core`` source:" +msgstr "``ansible-core`` ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ¸ˆã¿ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚ã‚Šã€è‡ªåˆ†ã® ``PATH`` ã‹ã‚‰ ``ansible-test`` ã®å®Ÿè¡Œã‚’試ã¿ã¦ã„ã‚‹å ´åˆã€ã‚·ã‚§ãƒ«ã«ã‚ˆã£ã¦æ¤œå‡ºã•ã‚ŒãŸãƒ—ãƒã‚°ãƒ©ãƒ ㌠``ansible-core`` ソースã‹ã‚‰ã®ã‚‚ã®ã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/dev_guide/testing_integration_legacy.rst:55 -msgid "In order to run some tests, you must provide access credentials in a file named ``credentials.yml``. A sample credentials file named ``credentials.template`` is available for syntax help." -msgstr "ã„ãã¤ã‹ã®ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€``credentials.yml`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚¢ã‚¯ã‚»ã‚¹èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚構文ヘルプã«ã¯ã€``credentials.template`` ã¨åå‰ã®ä»˜ã„ãŸã‚µãƒ³ãƒ—ルèªè¨¼æƒ…å ±ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åˆ©ç”¨ã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:107 +msgid "Commands" +msgstr "コマンド" -#: ../../rst/dev_guide/testing_integration_legacy.rst:62 -msgid "In order to run the tests in an AWS account ansible needs fairly wide ranging powers which can be provided to a dedicated user or temporary credentials using a specific policy configured in the AWS account." -msgstr "AWS アカウントã§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€Ansible ã«ã€AWS アカウントã§è¨å®šã•ã‚ŒãŸç‰¹å®šã®ãƒãƒªã‚·ãƒ¼ã‚’使用ã—ã¦ã€å°‚用ã®ãƒ¦ãƒ¼ã‚¶ã‚„一時的ãªèªè¨¼æƒ…å ±ã«æä¾›ã§ãã‚‹ã€ã‹ãªã‚Šåºƒç¯„囲ã®æ¨©é™ãŒå¿…è¦ã¨ãªã‚Šã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:109 +msgid "The most commonly used test commands are:" +msgstr "最も一般的ã«ä½¿ç”¨ã•ã‚Œã‚‹ãƒ†ã‚¹ãƒˆã‚³ãƒžãƒ³ãƒ‰ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:67 -msgid "testing-iam-policy.json.j2" -msgstr "testing-iam-policy.json.j2" +#: ../../rst/dev_guide/testing_running_locally.rst:111 +msgid "``ansible-test sanity`` - Run sanity tests (mostly linters and static analysis)." +msgstr "``ansible-test sanity`` - å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ (主ã«ãƒªãƒ³ã‚¿ãƒ¼ã¨é™çš„解æž) を実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:69 -msgid "The testing-iam-policy.json.j2 file contains a policy which can be given to the user running the tests to give close to minimum rights required to run the tests. Please note that this does not fully restrict the user; The user has wide privileges for viewing account definitions and is also able to manage some resources that are not related to testing (for example, AWS lambdas with different names) primarily due to the limitations of the Amazon ARN notation. At the very least the policy limits the user to one region, however tests should not be run in a primary production account in any case." -msgstr "testing-iam-policy.json.j2 ファイルã«ã¯ã€ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ä»˜ä¸Žã™ã‚‹ãƒãƒªã‚·ãƒ¼ãŒå«ã¾ã‚Œã¦ãŠã‚Šã€ãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«å¿…è¦ãªæœ€ä½Žé™ã®æ¨©é™ã«è¿‘ã„ã‚‚ã®ã‚’付与ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãªãŠã€ã“ã‚Œã¯å®Œå…¨ãªåˆ¶é™ã§ã¯ãªã„ãŸã‚注æ„ã—ã¦ãã ã•ã„。ã“ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€ã‚¢ã‚«ã‚¦ãƒ³ãƒˆå®šç¾©ã‚’閲覧ã™ã‚‹å¹…広ã„権é™ã‚’æŒã¡ã€ä¸»ã« Amazon ARN 表記ã®åˆ¶é™ã«ã‚ˆã‚Šã€ãƒ†ã‚¹ãƒˆã«é–¢ä¿‚ã®ãªã„一部ã®ãƒªã‚½ãƒ¼ã‚¹ (ãŸã¨ãˆã°ã€ç•°ãªã‚‹åå‰ã® AWS ラムダ) を管ç†ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚å°‘ãªãã¨ã‚‚ã€ã“ã®ãƒãƒªã‚·ãƒ¼ã§ã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’ 1 ã¤ã®ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã«é™å®šã—ã¦ã„ã¾ã™ãŒã€ã„ã‹ãªã‚‹å ´åˆã§ã‚‚ã€ãƒ†ã‚¹ãƒˆã¯å®Ÿç¨¼åƒç’°å¢ƒã®ãƒ—ライマリーアカウントã§å®Ÿè¡Œã™ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“。" +#: ../../rst/dev_guide/testing_running_locally.rst:112 +msgid "``ansible-test integration`` - Run integration tests." +msgstr "``ansible-test integration`` - çµ±åˆãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:86 -#: ../../rst/dev_guide/testing_units.rst:24 -msgid "Running Tests" -msgstr "テストã®å®Ÿè¡Œ" +#: ../../rst/dev_guide/testing_running_locally.rst:113 +msgid "``ansible-test units`` - Run unit tests." +msgstr "``ansible-test units`` - ユニットテストを実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:88 -msgid "The tests are invoked via a ``Makefile``." -msgstr "テスト㯠``Makefile`` 経由ã§å‘¼ã³å‡ºã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:115 +msgid "Run ``ansible-test --help`` to see a complete list of available commands." +msgstr "``ansible-test --help`` を実行ã—ã¦ã€ä½¿ç”¨å¯èƒ½ãªã‚³ãƒžãƒ³ãƒ‰ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:90 -msgid "If you haven't already got Ansible available use the local checkout by doing:" -msgstr "Ansible ãŒã¾ã 利用å¯èƒ½ã§ãªã„å ´åˆã¯ã€ä»¥ä¸‹ã®æ–¹æ³•ã§ãƒãƒ¼ã‚«ãƒ«ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã‚’使用ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:119 +msgid "For detailed help on a specific command, add the ``--help`` option after the command." +msgstr "特定コマンドã®è©³ã—ã„ヘルプã«ã¤ã„ã¦ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ã®å¾Œã« ``--help`` ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:96 -msgid "Run the tests by doing:" -msgstr "以下を実行ã—ã¦ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:122 +msgid "Environments" +msgstr "環境" -#: ../../rst/dev_guide/testing_integration_legacy.rst:108 -msgid "Possible cost of running cloud tests" -msgstr "クラウドテストã«ã‹ã‹ã‚‹å¯èƒ½æ€§ã®ã‚るコスト" +#: ../../rst/dev_guide/testing_running_locally.rst:124 +msgid "Most ``ansible-test`` commands support running in one or more isolated test environments to simplify testing." +msgstr "ã»ã¨ã‚“ã©ã® ``ansible-test`` コマンドã¯ã€ãƒ†ã‚¹ãƒˆã‚’ç°¡å˜ã«ã™ã‚‹ãŸã‚ã«ã€1 ã¤ä»¥ä¸Šã®åˆ†é›¢ãƒ†ã‚¹ãƒˆç’°å¢ƒã§ã®å®Ÿè¡Œã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_integration_legacy.rst:110 -msgid "Running cloud integration tests will create and destroy cloud resources. Running these tests may result in additional fees associated with your cloud account. Care is taken to ensure that created resources are removed. However, it is advisable to inspect your AWS console to ensure no unexpected resources are running." -msgstr "クラウド統åˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã¨ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒªã‚½ãƒ¼ã‚¹ãŒä½œæˆãŠã‚ˆã³ç ´æ£„ã•ã‚Œã¾ã™ã€‚ã“ã®ã‚ˆã†ãªãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã¨ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã«é–¢é€£ã™ã‚‹è¿½åŠ 料金ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚作æˆã•ã‚ŒãŸãƒªã‚½ãƒ¼ã‚¹ãŒç¢ºå®Ÿã«å‰Šé™¤ã•ã‚Œã‚‹ã‚ˆã†ã«æ³¨æ„ãŒæ‰•ã‚ã‚Œã¾ã™ã€‚ãŸã ã—ã€AWS コンソールを調ã¹ã¦ã€äºˆæœŸã—ãªã„リソースãŒå®Ÿè¡Œã—ã¦ã„ãªã„ã“ã¨ã‚’確èªã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:127 +msgid "Containers" +msgstr "コンテナー" -#: ../../rst/dev_guide/testing_pep8.rst:7 -msgid "PEP 8" -msgstr "PEP 8" +#: ../../rst/dev_guide/testing_running_locally.rst:129 +msgid "Containers are recommended for running sanity, unit and integration tests, since they provide consistent environments. Unit tests will be run with network isolation, which avoids unintentional dependencies on network resources." +msgstr "コンテナーã¯ä¸€è²«ã—ãŸç’°å¢ƒã‚’æä¾›ã™ã‚‹ãŸã‚ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã€ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã€çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ユニットテストã¯ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒªã‚½ãƒ¼ã‚¹ã¸ã®æ„図ã—ãªã„ä¾å˜ã‚’回é¿ã™ã‚‹ãŸã‚ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã‚’分離ã—ã¦å®Ÿè¡Œã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_pep8.rst:11 -msgid "`PEP 8`_ style guidelines are enforced by `pycodestyle`_ on all python files in the repository by default." -msgstr "`PEP 8`_ スタイルã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«ã‚ã‚‹ã™ã¹ã¦ã® python ファイル㧠`pycodestyle`_ ã«ã‚ˆã£ã¦å¼·åˆ¶ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:132 +msgid "The ``--docker`` option runs tests in a container using either Docker or Podman." +msgstr "``--docker`` オプションã¯ã€Docker ã¾ãŸã¯ Podman を使用ã—ã¦ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã§ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_pep8.rst:14 -msgid "Running Locally" -msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®å®Ÿè¡Œ" +#: ../../rst/dev_guide/testing_running_locally.rst:136 +msgid "If both Docker and Podman are installed, Docker will be used. To override this, set the environment variable ``ANSIBLE_TEST_PREFER_PODMAN`` to any non-empty value." +msgstr "Docker 㨠Podman ã®ä¸¡æ–¹ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€Docker ãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã“れをオーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã™ã‚‹ã«ã¯ã€ç’°å¢ƒå¤‰æ•° ``ANSIBLE_TEST_PREFER_PODMAN`` を空ã§ãªã„ä»»æ„ã®å€¤ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_pep8.rst:16 -msgid "The `PEP 8`_ check can be run locally with::" -msgstr "`PEP 8`_ ãƒã‚§ãƒƒã‚¯ã¯ã€ä»¥ä¸‹ã‚’使用ã—ã¦ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:140 +msgid "Choosing a container" +msgstr "コンテナーã®é¸æŠž" -#: ../../rst/dev_guide/testing_running_locally.rst:9 -msgid "This document describes how to:" -msgstr "本書ã§ã¯ã€ä»¥ä¸‹ã‚’è¡Œã†æ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:142 +msgid "Without an additional argument, the ``--docker`` option uses the ``default`` container. To use another container, specify it immediately after the ``--docker`` option." +msgstr "è¿½åŠ ã®å¼•æ•°ãŒãªã‘ã‚Œã°ã€``--docker`` オプション㯠``default`` コンテナーを使用ã—ã¾ã™ã€‚別ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã‚’使用ã™ã‚‹ã«ã¯ã€``--docker`` オプションã®ã™ã後ã«æŒ‡å®šã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:11 -msgid "Run tests locally using ``ansible-test``" -msgstr "``ansible-test`` を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:147 +msgid "The ``default`` container is recommended for all sanity and unit tests." +msgstr "``default`` コンテナーã¯ã€ã™ã¹ã¦ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¨ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã«æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:12 -msgid "Extend" -msgstr "æ‹¡å¼µ" +#: ../../rst/dev_guide/testing_running_locally.rst:149 +msgid "To see the list of supported containers, use the ``--help`` option with the ``ansible-test`` command you want to use." +msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®ãƒªã‚¹ãƒˆã‚’表示ã™ã‚‹ã«ã¯ã€ä½¿ç”¨ã™ã‚‹ ``ansible-test`` コマンド㧠``--help`` オプションを使用ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:20 -msgid "There are no special requirements for running ``ansible-test`` on Python 2.7 or later. The ``argparse`` package is required for Python 2.6. The requirements for each ``ansible-test`` command are covered later." -msgstr "Python 2.7 以é™ã«ã¯ã€``ansible-test`` を実行ã™ã‚‹ãŸã‚ã®ç‰¹åˆ¥ãªè¦ä»¶ãŒã‚ã‚Šã¾ã›ã‚“。Python 2.6 ã«ã¯ ``argparse`` パッケージãŒå¿…è¦ã§ã™ã€‚å„ ``ansible-test`` コマンドã®è¦ä»¶ã¯ã€å¾Œã§èª¬æ˜Žã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:153 +msgid "The list of available containers is dependent on the ``ansible-test`` command you are using." +msgstr "利用å¯èƒ½ãªã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®ãƒªã‚¹ãƒˆã¯ã€ä½¿ç”¨ã—ã¦ã„ã‚‹ ``ansible-test`` コマンドã«ã‚ˆã‚Šç•°ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:26 -msgid "Test Environments" -msgstr "テスト環境" +#: ../../rst/dev_guide/testing_running_locally.rst:155 +msgid "You can also specify your own container. When doing so, you will need to indicate the Python version in the container with the ``--python`` option." +msgstr "独自ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã‚’指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ãã®å ´åˆã¯ã€``--python`` オプションã§ã‚³ãƒ³ãƒ†ãƒŠãƒ¼å†…ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’示ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:28 -msgid "Most ``ansible-test`` commands support running in one or more isolated test environments to simplify testing." -msgstr "ã»ã¨ã‚“ã©ã® ``ansible-test`` コマンドã¯ã€ãƒ†ã‚¹ãƒˆã‚’ç°¡å˜ã«ã™ã‚‹ãŸã‚ã«ã€1 ã¤ä»¥ä¸Šã®åˆ†é›¢ãƒ†ã‚¹ãƒˆç’°å¢ƒã§ã®å®Ÿè¡Œã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:159 +msgid "Custom containers" +msgstr "カスタムコンテナー" + +#: ../../rst/dev_guide/testing_running_locally.rst:161 +msgid "When building custom containers, keep in mind the following requirements:" +msgstr "カスタムコンテナーを構築ã™ã‚‹éš›ã«ã¯ã€æ¬¡ã®è¦ä»¶ã«æ³¨æ„ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing_running_locally.rst:163 +msgid "The ``USER`` should be ``root``." +msgstr "``USER`` 㯠``root`` ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:164 +msgid "Use an ``init`` process, such as ``systemd``." +msgstr "``systemd`` ãªã©ã® ``init`` プãƒã‚»ã‚¹ã‚’使用ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:165 +msgid "Include ``sshd`` and accept connections on the default port of ``22``." +msgstr "``sshd`` ã‚’å«ã‚ã€``22`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãƒãƒ¼ãƒˆã§æŽ¥ç¶šã‚’許å¯ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:166 +msgid "Include a POSIX compatible ``sh`` shell which can be found on ``PATH``." +msgstr "``PATH`` ã§è¦‹ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã‚‹ POSIX 五感 ``sh`` シェルをå«ã‚ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:167 +msgid "Include a ``sleep`` utility which runs as a subprocess." +msgstr "サブプãƒã‚»ã‚¹ã¨ã—ã¦å®Ÿè¡Œã•ã‚Œã‚‹ ``sleep`` ユーティリティーをå«ã‚ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:168 +msgid "Include a supported version of Python." +msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å«ã‚ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:169 +msgid "Avoid using the ``VOLUME`` statement." +msgstr "``VOLUME`` statement ã®ä½¿ç”¨ã¯é¿ã‘ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing_running_locally.rst:172 +msgid "Docker and SELinux" +msgstr "Docker 㨠SELinux" + +#: ../../rst/dev_guide/testing_running_locally.rst:174 +msgid "Using Docker on a host with SELinux may require setting the system in permissive mode. Consider using Podman instead." +msgstr "SELinux を使用ã™ã‚‹ãƒ›ã‚¹ãƒˆã§ Docker を使用ã™ã‚‹ã«ã¯ã€ã‚·ã‚¹ãƒ†ãƒ ã‚’ permissive モードã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« Podman ã®ä½¿ç”¨ã‚’検討ã—ã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing_running_locally.rst:178 +msgid "Docker Desktop with WSL2" +msgstr "Docker Desktop 㨠WSL2" + +#: ../../rst/dev_guide/testing_running_locally.rst:180 +msgid "These instructions explain how to use ``ansible-test`` with WSL2 and Docker Desktop *without* ``systemd`` support." +msgstr "ã“れらã®æŒ‡ç¤ºã¯ã€``systemd`` サãƒãƒ¼ãƒˆ*ãªã—*ã§ã€``ansible-test`` 㧠WSL2 㨠Docker Desktop を使用ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦èª¬æ˜Žã—ã¦ã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:184 +msgid "If your WSL2 environment includes ``systemd`` support, these steps are not required." +msgstr "WSL2 環境㫠``systemd`` サãƒãƒ¼ãƒˆãŒå«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã€ã“れらã®æ‰‹é †ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing_running_locally.rst:189 +msgid "Configuration requirements" +msgstr "è¨å®šè¦ä»¶" + +#: ../../rst/dev_guide/testing_running_locally.rst:191 +msgid "Open Docker Desktop and go to the **Settings** screen." +msgstr "Docker Desktop ã‚’é–‹ãã€**Settings** ç”»é¢ã«ç§»å‹•ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:192 +msgid "On the the **General** tab:" +msgstr "**General** タブã§ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:194 +msgid "Uncheck the **Start Docker Desktop when you log in** checkbox." +msgstr "**Start Docker Desktop when you log in** ãƒã‚§ãƒƒã‚¯ãƒœãƒƒã‚¯ã‚¹ã‚’オフã«ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:195 +msgid "Check the **Use the WSL 2 based engine** checkbox." +msgstr "**Use the WSL 2 based engine** ãƒã‚§ãƒƒã‚¯ãƒœãƒƒã‚¯ã‚¹ã‚’オンã«ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:197 +msgid "On the **Resources** tab under the **WSL Integration** section:" +msgstr "**WSL Integration** セクション㮠**Resources** タブã§ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:199 +msgid "Enable distros you want to use under the **Enable integration with additional distros** section." +msgstr "**Enable integration with additional distros**セクションã§ã€ä½¿ç”¨ã™ã‚‹ distros を有効ã«ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:201 +msgid "Click **Apply and restart** if changes were made." +msgstr "変更ã—ãŸå ´åˆã¯ **Apply and restart** をクリックã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:206 +msgid "Setup instructions" +msgstr "è¨å®šæ‰‹é †" + +#: ../../rst/dev_guide/testing_running_locally.rst:210 +msgid "If all WSL instances have been stopped, these changes will need to be re-applied." +msgstr "ã™ã¹ã¦ã® WSL インスタンスãŒåœæ¢ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®å¤‰æ›´ã‚’å†åº¦é©ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:212 +msgid "Verify Docker Desktop is properly configured (see :ref:`configuration_requirements`)." +msgstr "Docker Desktop ãŒé©åˆ‡ã«è¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ (:ref:`configuration_requirements` å‚ç…§)。" + +#: ../../rst/dev_guide/testing_running_locally.rst:213 +msgid "Quit Docker Desktop if it is running:" +msgstr "実行ä¸ã®å ´åˆã¯ Docker Desktop を終了ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:215 +msgid "Right click the **Docker Desktop** taskbar icon." +msgstr "**Docker Desktop** タスクãƒãƒ¼ã‚¢ã‚¤ã‚³ãƒ³ã‚’å³ã‚¯ãƒªãƒƒã‚¯ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:216 +msgid "Click the **Quit Docker Desktop** option." +msgstr "**Quit Docker Desktop** オプションをクリックã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:218 +msgid "Stop any running WSL instances with the command:" +msgstr "次ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ã€å®Ÿè¡Œä¸ã® WSL インスタンスをåœæ¢ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:224 +msgid "Verify all WSL instances have stopped with the command:" +msgstr "次ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ã€ã™ã¹ã¦ã® WSL インスタンスãŒåœæ¢ã—ãŸã“ã¨ã‚’確èªã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:230 +msgid "Start a WSL instance and perform the following steps as ``root``:" +msgstr "WSL インスタンスを開始ã—ã€``root`` ã¨ã—ã¦æ¬¡ã®æ‰‹é †ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:232 +msgid "Verify the ``systemd`` subsystem is not registered:" +msgstr "``systemd`` サブシステムãŒç™»éŒ²ã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’検証ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:234 +msgid "Check for the ``systemd`` cgroup hierarchy with the following command:" +msgstr "次ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ã€``systemd`` cgroup 階層を確èªã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:240 +msgid "If any matches are found, re-check the :ref:`configuration_requirements` and follow the :ref:`setup_instructions` again." +msgstr "一致ã™ã‚‹ã‚‚ã®ãŒè¦‹ã¤ã‹ã£ãŸå ´åˆã¯ã€:ref:`configuration_requirements` ã‚’å†ç¢ºèªã—ã€å†åº¦ :ref:`setup_instructions` ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:32 -msgid "Remote" -msgstr "リモート" +#: ../../rst/dev_guide/testing_running_locally.rst:243 +msgid "Mount the ``systemd`` cgroup hierarchy with the following commands:" +msgstr "次ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦ã€``systemd`` cgroup 階層をマウントã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:34 -msgid "The ``--remote`` option runs tests in a cloud hosted environment. An API key is required to use this feature." -msgstr "``--remote`` オプションã¯ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ›ã‚¹ãƒˆç’°å¢ƒã§ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚ã“ã®æ©Ÿèƒ½ã‚’使用ã™ã‚‹ã«ã¯ API ã‚ーãŒå¿…è¦ã§ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:250 +msgid "Start Docker Desktop." +msgstr "Docker Desktop ã‚’èµ·å‹•ã—ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:37 -msgid "Recommended for integration tests." -msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã¸æŽ¨å¥¨äº‹é …" +#: ../../rst/dev_guide/testing_running_locally.rst:252 +msgid "You should now be able to use ``ansible-test`` with the ``--docker`` option." +msgstr "ã“ã‚Œã§ã€``--docker`` オプション㧠``ansible-test`` を使用ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:39 -msgid "See the `list of supported platforms and versions <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/remote.txt>`_ for additional details." -msgstr "詳細ã¯ã€ã€Œ`サãƒãƒ¼ãƒˆå¯¾è±¡ã®ãƒ—ラットフォームãŠã‚ˆã³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ä¸€è¦§ <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/remote.txt>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing_running_locally.rst:257 +msgid "Linux cgroup configuration" +msgstr "Linux cgroup è¨å®š" -#: ../../rst/dev_guide/testing_running_locally.rst:42 -msgid "Environment Variables" +#: ../../rst/dev_guide/testing_running_locally.rst:261 +msgid "These changes will need to be re-applied each time the container host is booted." +msgstr "ã“れらã®å¤‰æ›´ã¯ã€ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ãƒ›ã‚¹ãƒˆã‚’èµ·å‹•ã™ã‚‹ãŸã³ã«å†é©ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:263 +msgid "For certain container hosts and container combinations, additional setup on the container host may be required. In these situations ``ansible-test`` will report an error and provide additional instructions to run as ``root``:" +msgstr "特定ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ãƒ›ã‚¹ãƒˆã¨ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®çµ„ã¿åˆã‚ã›ã§ã¯ã€ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ãƒ›ã‚¹ãƒˆã§è¿½åŠ ã®ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—ãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ãã®ã‚ˆã†ãªçŠ¶æ³ã§ã¯ã€``ansible-test`` ãŒã‚¨ãƒ©ãƒ¼ã‚’å ±å‘Šã—ã€``root`` ã¨ã—ã¦å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«è¿½åŠ ã®æŒ‡ç¤ºã‚’出ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:271 +msgid "If you are using rootless Podman, an additional command must be run, also as ``root``. Make sure to substitute your user and group for ``{user}`` and ``{group}`` respectively:" +msgstr "rootless Podman を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€åŒæ§˜ã« ``root`` ã¨ã—ã¦è¿½åŠ ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚å¿…ãšãƒ¦ãƒ¼ã‚¶ãƒ¼ã¨ã‚°ãƒ«ãƒ¼ãƒ—ã‚’ã€ãã‚Œãžã‚Œ ``{user}`` 㨠``{group}`` ã«ç½®ãæ›ãˆã¦ãã ã•ã„。" + +#: ../../rst/dev_guide/testing_running_locally.rst:281 +msgid "When using Podman, you may need to stop existing Podman processes after following the :ref:`linux_cgroup_configuration` instructions. Otherwise Podman may be unable to see the new mount point." +msgstr "Podman を使用ã™ã‚‹å ´åˆã€:ref:`linux_cgroup_configuration` ã®æ‰‹é †ã‚’実行ã—ãŸå¾Œã«æ—¢å˜ã® Podman プãƒã‚»ã‚¹ã‚’åœæ¢ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ãã†ã—ãªã‘ã‚Œã°ã€Podman ãŒæ–°ã—ã„マウントãƒã‚¤ãƒ³ãƒˆã‚’èªè˜ã§ããªã„å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:284 +msgid "You can check to see if Podman is running by looking for ``podman`` and ``catatonit`` processes." +msgstr "Podman ãŒå®Ÿè¡Œã•ã‚Œã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’確èªã™ã‚‹ã«ã¯ã€``podman`` 㨠``catatonit`` ã®ãƒ—ãƒã‚»ã‚¹ã‚’確èªã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:287 +msgid "Remote virtual machines" +msgstr "リモート仮想マシン" + +#: ../../rst/dev_guide/testing_running_locally.rst:289 +msgid "Remote virtual machines are recommended for running integration tests not suitable for execution in containers." +msgstr "コンテナーã§ã®å®Ÿè¡Œã«é©ã—ã¦ã„ãªã„çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«ã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆä»®æƒ³ãƒžã‚·ãƒ³ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:291 +msgid "The ``--remote`` option runs tests in a cloud hosted ephemeral virtual machine." +msgstr "``--remote`` オプションを使用ã™ã‚‹ã¨ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã§ãƒ›ã‚¹ãƒˆã•ã‚ŒãŸä¸€æ™‚çš„ãªä»®æƒ³ãƒžã‚·ãƒ³ã§ãƒ†ã‚¹ãƒˆãŒå®Ÿè¡Œã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:295 +msgid "An API key is required to use this feature, unless running under an approved Azure Pipelines organization." +msgstr "承èªã•ã‚ŒãŸ Azure Pipelines 組織下ã§å®Ÿè¡Œã•ã‚Œã¦ã„ã‚‹å ´åˆã‚’除ãã€ã“ã®æ©Ÿèƒ½ã‚’使用ã™ã‚‹ã«ã¯ API ã‚ーãŒå¿…è¦ã§ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:297 +msgid "To see the list of supported systems, use the ``--help`` option with the ``ansible-test`` command you want to use." +msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡ã‚·ã‚¹ãƒ†ãƒ ã®ãƒªã‚¹ãƒˆã‚’表示ã™ã‚‹ã«ã¯ã€ä½¿ç”¨ã™ã‚‹ ``ansible-test`` コマンド㧠``--help`` オプションを使用ã—ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:301 +msgid "The list of available systems is dependent on the ``ansible-test`` command you are using." +msgstr "利用å¯èƒ½ãªã‚·ã‚¹ãƒ†ãƒ ã®ãƒªã‚¹ãƒˆã¯ã€ä½¿ç”¨ã—ã¦ã„ã‚‹ ``ansible-test`` コマンドã«ã‚ˆã‚Šç•°ãªã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:304 +msgid "Python virtual environments" +msgstr "Python 仮想環境" + +#: ../../rst/dev_guide/testing_running_locally.rst:306 +msgid "Python virtual environments provide a simple way to achieve isolation from the system and user Python environments. They are recommended for unit and integration tests when the ``--docker`` and ``--remote`` options cannot be used." +msgstr "Python 仮想環境を使用ã™ã‚‹ã¨ã€ã‚·ã‚¹ãƒ†ãƒ ãŠã‚ˆã³ãƒ¦ãƒ¼ã‚¶ãƒ¼ã® Python 環境ã‹ã‚‰ã®åˆ†é›¢ã‚’ç°¡å˜ã«å®Ÿç¾ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€``--docker`` ãŠã‚ˆã³ ``--remote`` オプションãŒä½¿ç”¨ã§ããªã„å ´åˆã®ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã¨çµ±åˆãƒ†ã‚¹ãƒˆã«æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:309 +msgid "The ``--venv`` option runs tests in a virtual environment managed by ``ansible-test``. Requirements are automatically installed before tests are run." +msgstr "``--venv`` オプションã¯ã€``ansible-test`` ã«ã‚ˆã£ã¦ç®¡ç†ã•ã‚Œã‚‹ä»®æƒ³ç’°å¢ƒã§ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚テストãŒå®Ÿè¡Œã•ã‚Œã‚‹å‰ã«ã€è¦ä»¶ãŒè‡ªå‹•çš„ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:313 +msgid "Composite environment arguments" +msgstr "複åˆç’°å¢ƒå¼•æ•°" + +#: ../../rst/dev_guide/testing_running_locally.rst:315 +msgid "The environment arguments covered in this document are sufficient for most use cases. However, some scenarios may require the additional flexibility offered by composite environment arguments." +msgstr "ã“ã®ãƒ‰ã‚ュメントã§èª¬æ˜Žã•ã‚Œã¦ã„る環境引数ã¯ã€ã»ã¨ã‚“ã©ã®ãƒ¦ãƒ¼ã‚¹ã‚±ãƒ¼ã‚¹ã§å分ã§ã™ã€‚ãŸã ã—ã€ä¸€éƒ¨ã®ã‚·ãƒŠãƒªã‚ªã§ã¯ã€è¤‡åˆç’°å¢ƒå¼•æ•°ã«ã‚ˆã£ã¦æä¾›ã•ã‚Œã‚‹è¿½åŠ ã®æŸ”軟性ãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:318 +msgid "The ``--controller`` and ``--target`` options are alternatives to the ``--docker``, ``--remote`` and ``--venv`` options." +msgstr "``--controller`` ãŠã‚ˆã³ ``--target`` オプションã¯ã€``--docker``ã€``--remote``ã€``--venv`` オプションã®ä»£ã‚ã‚Šã§ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:322 +msgid "When using the ``shell`` command, the ``--target`` option is replaced by three platform specific options." +msgstr "``shell`` コマンドを使用ã™ã‚‹å ´åˆã€``--target`` オプションã¯ã€3 ã¤ã®ãƒ—ラットフォーム固有オプションã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:324 +msgid "Add the ``--help`` option to your ``ansible-test`` command to learn more about the composite environment arguments." +msgstr "使用ã—ã¦ã„ã‚‹ ``ansible-test`` コマンド㫠``--help`` ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã™ã‚‹ã¨ã€è¤‡åˆç’°å¢ƒå¼•æ•°ã®è©³ç´°ã‚’確èªã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:327 +msgid "Additional Requirements" +msgstr "è¿½åŠ è¦ä»¶" + +#: ../../rst/dev_guide/testing_running_locally.rst:329 +msgid "Some ``ansible-test`` commands have additional requirements. You can use the ``--requirements`` option to automatically install them." +msgstr "ã„ãã¤ã‹ã® ``ansible-test`` コマンドã«ã¯ã€è¿½åŠ ã®è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚``--requirements`` オプションを使用ã—ã¦ã€ãれらã®è¿½åŠ è¦ä»¶ã‚’自動的ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_running_locally.rst:334 +msgid "When using a test environment managed by ``ansible-test`` the ``--requirements`` option is usually unnecessary." +msgstr "``ansible-test`` ãŒç®¡ç†ã™ã‚‹ãƒ†ã‚¹ãƒˆç’°å¢ƒã‚’利用ã™ã‚‹å ´åˆã€é€šå¸¸ã¯ ``--requirements`` オプションã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" + +#: ../../rst/dev_guide/testing_running_locally.rst:337 +msgid "Environment variables" msgstr "環境変数" -#: ../../rst/dev_guide/testing_running_locally.rst:44 +#: ../../rst/dev_guide/testing_running_locally.rst:339 msgid "When using environment variables to manipulate tests there some limitations to keep in mind. Environment variables are:" msgstr "環境変数を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’æ“作ã™ã‚‹éš›ã«ã¯ã€ä»¥ä¸‹ã®åˆ¶é™äº‹é …ã«ç•™æ„ã—ã¦ãã ã•ã„。環境変数ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:46 +#: ../../rst/dev_guide/testing_running_locally.rst:341 msgid "Not propagated from the host to the test environment when using the ``--docker`` or ``--remote`` options." msgstr "``--docker`` オプションã¾ãŸã¯ ``--remote`` オプションを使用ã™ã‚‹å ´åˆã¯ã€ãƒ›ã‚¹ãƒˆã‹ã‚‰ãƒ†ã‚¹ãƒˆç’°å¢ƒã«ä¼æ’ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/dev_guide/testing_running_locally.rst:47 +#: ../../rst/dev_guide/testing_running_locally.rst:342 msgid "Not exposed to the test environment unless enabled in ``test/lib/ansible_test/_internal/util.py`` in the ``common_environment`` function." msgstr "``common_environment`` 関数㮠``test/lib/ansible_test/_internal/util.py`` ã§æœ‰åŠ¹ã«ã•ã‚Œã¦ã„ãªã„é™ã‚Šã€ãƒ†ã‚¹ãƒˆç’°å¢ƒã«ã¯å…¬é–‹ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/dev_guide/testing_running_locally.rst:49 -msgid "Example: ``ANSIBLE_KEEP_REMOTE_FILES=1`` can be set when running ``ansible-test integration --venv``. However, using the ``--docker`` option would require running ``ansible-test shell`` to gain access to the Docker environment. Once at the shell prompt, the environment variable could be set and the tests executed. This is useful for debugging tests inside a container by following the :ref:`Debugging AnsibleModule-based modules <debugging_modules>` instructions." -msgstr "例: ``ansible-test integration --venv`` ã®å®Ÿè¡Œæ™‚ã« ``ANSIBLE_KEEP_REMOTE_FILES=1`` ã‚’è¨å®šã§ãã¾ã™ãŒã€``--docker`` オプションを使用ã™ã‚‹ã¨ã€``ansible-test shell`` を実行ã—ã€Docker 環境ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚シェルプãƒãƒ³ãƒ—トã§ã¯ã€ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¦ãƒ†ã‚¹ãƒˆã‚’è¡Œã†å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€:ref:`Debugging AnsibleModule-based modules <debugging_modules>` ã®æŒ‡ç¤ºã«å¾“ã£ã¦ã€ã‚³ãƒ³ãƒ†ãƒŠãƒ¼å†…ã§ãƒ†ã‚¹ãƒˆã‚’デãƒãƒƒã‚°ã™ã‚‹ä¸Šã§å½¹ç«‹ã¡ã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:344 +msgid "Example: ``ANSIBLE_KEEP_REMOTE_FILES=1`` can be set when running ``ansible-test integration --venv``. However, using the ``--docker`` option would require running ``ansible-test shell`` to gain access to the Docker environment. Once at the shell prompt, the environment variable could be set and the tests executed. This is useful for debugging tests inside a container by following the :ref:`debugging_modules` instructions." +msgstr "例: ``ansible-test integration --venv`` ã®å®Ÿè¡Œæ™‚ã« ``ANSIBLE_KEEP_REMOTE_FILES=1`` ã‚’è¨å®šã§ãã¾ã™ãŒã€``--docker`` オプションを使用ã™ã‚‹ã¨ã€``ansible-test shell`` を実行ã—ã€Docker 環境ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚シェルプãƒãƒ³ãƒ—トã§ã¯ã€ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¦ãƒ†ã‚¹ãƒˆã‚’è¡Œã†å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€:ref:`debugging_modules` ã®æŒ‡ç¤ºã«å¾“ã£ã¦ã€ã‚³ãƒ³ãƒ†ãƒŠãƒ¼å†…ã§ãƒ†ã‚¹ãƒˆã‚’デãƒãƒƒã‚°ã™ã‚‹ä¸Šã§å½¹ç«‹ã¡ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:55 -msgid "Interactive Shell" +#: ../../rst/dev_guide/testing_running_locally.rst:350 +msgid "Interactive shell" msgstr "インタラクティブシェル" -#: ../../rst/dev_guide/testing_running_locally.rst:57 +#: ../../rst/dev_guide/testing_running_locally.rst:352 msgid "Use the ``ansible-test shell`` command to get an interactive shell in the same environment used to run tests. Examples:" msgstr "``ansible-test shell`` コマンドを使用ã—ã¦ã€ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã®ã«ä½¿ç”¨ã™ã‚‹åŒã˜ç’°å¢ƒã§ã‚¤ãƒ³ã‚¿ãƒ©ã‚¯ãƒ†ã‚£ãƒ–シェルをå–å¾—ã—ã¾ã™ã€‚以下ã¯ä¾‹ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:59 +#: ../../rst/dev_guide/testing_running_locally.rst:354 msgid "``ansible-test shell --docker`` - Open a shell in the default docker container." msgstr "``ansible-test shell --docker`` - デフォルト㮠docker コンテナーã§ã‚·ã‚§ãƒ«ã‚’é–‹ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:60 -msgid "``ansible-test shell --venv --python 3.6`` - Open a shell in a Python 3.6 virtual environment." -msgstr "``ansible-test shell --venv --python 3.6`` - Python 3.6 仮想環境ã§ã‚·ã‚§ãƒ«ã‚’é–‹ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_running_locally.rst:355 +msgid "``ansible-test shell --venv --python 3.10`` - Open a shell in a Python 3.10 virtual environment." +msgstr "``ansible-test shell --venv --python 3.10`` - Python 3.10 仮想環境ã§ã‚·ã‚§ãƒ«ã‚’é–‹ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:64 -msgid "Code Coverage" +#: ../../rst/dev_guide/testing_running_locally.rst:358 +msgid "Code coverage" msgstr "コードã®å¯¾è±¡ç¯„囲" -#: ../../rst/dev_guide/testing_running_locally.rst:66 +#: ../../rst/dev_guide/testing_running_locally.rst:360 msgid "Code coverage reports make it easy to identify untested code for which more tests should be written. Online reports are available but only cover the ``devel`` branch (see :ref:`developing_testing`). For new code local reports are needed." msgstr "コードã®å¯¾è±¡ç¯„囲レãƒãƒ¼ãƒˆã¯ã€ã‚ˆã‚Šå¤šãã®ãƒ†ã‚¹ãƒˆãŒè¨˜è¿°ã•ã‚Œã‚‹ã¹ã未テストã®ã‚³ãƒ¼ãƒ‰ã‚’ç°¡å˜ã«è˜åˆ¥ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚オンラインレãƒãƒ¼ãƒˆãŒåˆ©ç”¨ã§ãã¾ã™ãŒã€``devel`` ブランãƒã®ã¿ã‚’扱ã„ã¾ã™ (:ref:`developing_testing` ã‚’å‚ç…§)。新è¦ã‚³ãƒ¼ãƒ‰ã®ãƒãƒ¼ã‚«ãƒ«ãƒ¬ãƒãƒ¼ãƒˆãŒå¿…è¦ãªå ´åˆã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:70 +#: ../../rst/dev_guide/testing_running_locally.rst:364 msgid "Add the ``--coverage`` option to any test command to collect code coverage data. If you aren't using the ``--venv`` or ``--docker`` options which create an isolated python environment then you may have to use the ``--requirements`` option to ensure that the correct version of the coverage module is installed:" msgstr "コードカãƒãƒ¬ãƒƒã‚¸ãƒ‡ãƒ¼ã‚¿ã‚’åŽé›†ã™ã‚‹ãƒ†ã‚¹ãƒˆã‚³ãƒžãƒ³ãƒ‰ã« ``--coverage`` ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã—ã¾ã™ã€‚分離ã—㟠python 環境を作æˆã™ã‚‹ ``--venv`` オプションã¾ãŸã¯ ``--docker`` オプションを使用ã—ã¦ã„ãªã„å ´åˆã¯ã€``--requirements`` オプションを使用ã—ã¦ã‚«ãƒãƒ¬ãƒƒã‚¸ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®æ£ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:83 +#: ../../rst/dev_guide/testing_running_locally.rst:376 #: ../../rst/dev_guide/testing_units.rst:197 msgid "Reports can be generated in several different formats:" msgstr "Report ã¯ã€è¤‡æ•°ã®å½¢å¼ã§ç”Ÿæˆã§ãã¾ã™ã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:85 +#: ../../rst/dev_guide/testing_running_locally.rst:378 #: ../../rst/dev_guide/testing_units.rst:199 msgid "``ansible-test coverage report`` - Console report." msgstr "``ansible-test coverage report`` - コンソールレãƒãƒ¼ãƒˆã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:86 +#: ../../rst/dev_guide/testing_running_locally.rst:379 #: ../../rst/dev_guide/testing_units.rst:200 msgid "``ansible-test coverage html`` - HTML report." msgstr "``ansible-test coverage html`` - HTML レãƒãƒ¼ãƒˆã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:87 +#: ../../rst/dev_guide/testing_running_locally.rst:380 #: ../../rst/dev_guide/testing_units.rst:201 msgid "``ansible-test coverage xml`` - XML report." msgstr "``ansible-test coverage xml`` - XML レãƒãƒ¼ãƒˆã€‚" -#: ../../rst/dev_guide/testing_running_locally.rst:89 -msgid "To clear data between test runs, use the ``ansible-test coverage erase`` command. For a full list of features see the online help:" -msgstr "テスト実行間ã®ãƒ‡ãƒ¼ã‚¿ã‚’消去ã™ã‚‹ã«ã¯ã€``ansible-test coverage erase`` コマンドを使用ã—ã¾ã™ã€‚機能ã®å…¨ä¸€è¦§ã«ã¤ã„ã¦ã¯ã€ã‚ªãƒ³ãƒ©ã‚¤ãƒ³ãƒ˜ãƒ«ãƒ—ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing_running_locally.rst:382 +msgid "To clear data between test runs, use the ``ansible-test coverage erase`` command." +msgstr "テストã®å®Ÿè¡Œé–“ã§ãƒ‡ãƒ¼ã‚¿ã‚’クリアã™ã‚‹ã«ã¯ã€``ansible-test coverage erase`` コマンドを使用ã—ã¾ã™ã€‚" #: ../../rst/dev_guide/testing_sanity.rst:11 msgid "Sanity tests are made up of scripts and tools used to perform static code analysis. The primary purpose of these tests is to enforce Ansible coding standards and requirements." @@ -12833,6 +13886,10 @@ msgstr "ユニットテストã¯ã€ç‰¹å®šã®ãƒ©ã‚¤ãƒ–ラリーã¾ãŸã¯ãƒ¢ã‚¸ãƒ¥ msgid "Unit tests can be found in `test/units <https://github.com/ansible/ansible/tree/devel/test/units>`_. Notice that the directory structure of the tests matches that of ``lib/ansible/``." msgstr "ユニットテスト㯠`test/units <https://github.com/ansible/ansible/tree/devel/test/units>`_ ã«ã‚ã‚Šã¾ã™ã€‚テストã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼æ§‹é€ ㌠``lib/ansible/`` ã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。" +#: ../../rst/dev_guide/testing_units.rst:24 +msgid "Running Tests" +msgstr "テストã®å®Ÿè¡Œ" + #: ../../rst/dev_guide/testing_units.rst:27 msgid "To run unit tests using docker, always use the default docker image by passing the ``--docker`` or ``--docker default`` argument." msgstr "docker を使用ã—ã¦ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€``--docker`` 引数ã¾ãŸã¯ ``--docker default`` 引数を渡ã™ã“ã¨ã§å¸¸ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® docker イメージを使用ã—ã¾ã™ã€‚" @@ -12841,6 +13898,14 @@ msgstr "docker を使用ã—ã¦ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€``--d msgid "The Ansible unit tests can be run across the whole code base by doing:" msgstr "Ansible ã®ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã¯ã€ä»¥ä¸‹ã®æ“作を実行ã—ã¦ã‚³ãƒ¼ãƒ‰ãƒ™ãƒ¼ã‚¹å…¨ä½“ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_units.rst:38 +msgid "Against a single file by doing:" +msgstr "1 ã¤ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«å¯¾ã—ã¦ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" + +#: ../../rst/dev_guide/testing_units.rst:44 +msgid "Or against a specific Python version by doing:" +msgstr "ã¾ãŸã¯ã€ç‰¹å®šã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—ã¦ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + #: ../../rst/dev_guide/testing_units.rst:50 msgid "If you are running unit tests against things other than modules, such as module utilities, specify the whole file path:" msgstr "モジュールユーティリティーãªã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä»¥å¤–ã®ã‚‚ã®ã«å¯¾ã—ã¦ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚’実行ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ãƒ‘ス全体を指定ã—ã¾ã™ã€‚" @@ -12853,6 +13918,10 @@ msgstr "高度ãªä½¿ç”¨æ–¹æ³•ã¯ã€ã‚ªãƒ³ãƒ©ã‚¤ãƒ³ãƒ˜ãƒ«ãƒ—ã‚’å‚ç…§ã—ã¦ãã msgid "You can also run tests in Ansible's continuous integration system by opening a pull request. This will automatically determine which tests to run based on the changes made in your pull request." msgstr "プルè¦æ±‚ã‚’é–‹ã„ã¦ã€Ansible ã®ç¶™ç¶šçš„çµ±åˆã‚·ã‚¹ãƒ†ãƒ ã§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ—ルè¦æ±‚ã§å®Ÿè¡Œã•ã‚ŒãŸå¤‰æ›´ã«åŸºã¥ã„ã¦ã€å®Ÿè¡Œã•ã‚Œã‚‹ãƒ†ã‚¹ãƒˆãŒè‡ªå‹•çš„ã«æ±ºå®šã•ã‚Œã¾ã™ã€‚" +#: ../../rst/dev_guide/testing_units.rst:68 +msgid "Installing dependencies" +msgstr "ä¾å˜é–¢ä¿‚ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" + #: ../../rst/dev_guide/testing_units.rst:70 msgid "If you are running ``ansible-test`` with the ``--docker`` or ``--venv`` option you do not need to install dependencies manually." msgstr "``--docker`` オプションã¾ãŸã¯ ``--venv`` オプションを指定ã—㦠``ansible-test`` を実行ã—ã¦ã„ã‚‹å ´åˆã¯ã€ä¾å˜é–¢ä¿‚を手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" @@ -13013,6 +14082,10 @@ msgstr "pytest ã®ãƒ‰ã‚ュメント - Ansible ユニットテストã®å®Ÿè¡Œã« msgid "Unit Testing Ansible Modules" msgstr "Ansible モジュールã®ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆ" +#: ../../rst/dev_guide/testing_units_modules.rst:14 +msgid "Introduction" +msgstr "ã¯ã˜ã‚ã«" + #: ../../rst/dev_guide/testing_units_modules.rst:16 msgid "This document explains why, how and when you should use unit tests for Ansible modules. The document doesn't apply to other parts of Ansible for which the recommendations are normally closer to the Python standard. There is basic documentation for Ansible unit tests in the developer guide :ref:`testing_units`. This document should be readable for a new Ansible module author. If you find it incomplete or confusing, please open a bug or ask for help on the #ansible-devel chat channel (using Matrix at ansible.im or using IRC at `irc.libera.chat <https://libera.chat/>`_)." msgstr "ã“ã®ãƒ‰ã‚ュメントã§ã¯ã€Ansible モジュールã«ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚’使用ã™ã‚‹ç†ç”±ã€æ–¹æ³•ã€ã‚¿ã‚¤ãƒŸãƒ³ã‚°ã‚’説明ã—ã¾ã™ã€‚ã“ã®ãƒ‰ã‚ュメントã¯ã€é€šå¸¸ Python ã®æ¨™æº–ã«è¿‘ã„æŽ¨å¥¨äº‹é …ã‚’æŒã¤ Ansible ã®ä»–ã®éƒ¨åˆ†ã«ã¯é©ç”¨ã•ã‚Œã¾ã›ã‚“。Ansible ã®ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã«é–¢ã™ã‚‹åŸºæœ¬çš„ãªãƒ‰ã‚ュメントã¯ã€é–‹ç™ºè€…ガイドã®ã€Œ:ref:`testing_units`ã€ã«ã‚ã‚Šã¾ã™ã€‚ã“ã®ãƒ‰ã‚ュメントã¯ã€æ–°ã—ã„ Ansible モジュールã®ä½œæˆè€…ã«ã¨ã£ã¦èªã¿ã‚„ã™ã„ã‚‚ã®ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。ä¸å®Œå…¨ã ã£ãŸã‚Šã€åˆ†ã‹ã‚Šã«ãã‹ã£ãŸã‚Šã—ãŸå ´åˆã¯ã€ãƒã‚°ã‚’å ±å‘Šã—ãŸã‚Šã€#ansible-develãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ« ã§åŠ©ã‘を求ã‚ãŸã‚Šã—ã¦ãã ã•ã„（ansible.imã§Matrixを使用ã€ã¾ãŸã¯`irc.libera.chat <https://libera.chat/>`_ã§IRCを使用）。" @@ -13385,1084 +14458,9 @@ msgstr "`'A Response to \"Why Most Unit Testing is Waste\"' <https://henrikwarne msgid "An response pointing to how to maintain the value of unit tests" msgstr "ユニットテストã®ä¾¡å€¤ã‚’ç¶æŒã™ã‚‹æ–¹æ³•ã‚’指摘ã—ãŸå›žç”" -#: ../../rst/dev_guide/testing_validate-modules.rst:11 -msgid "Python program to help test or validate Ansible modules." -msgstr "Ansible モジュールã®ãƒ†ã‚¹ãƒˆã¾ãŸã¯æ¤œè¨¼ã«å½¹ç«‹ã¤ Python プãƒã‚°ãƒ©ãƒ 。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:13 -msgid "``validate-modules`` is one of the ``ansible-test`` Sanity Tests, see :ref:`testing_sanity` for more information." -msgstr "``validate-modules`` ã¯ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ ``ansible-test`` ã®ã„ãšã‚Œã‹ã§ã™ã€‚詳細ã¯ã€ã€Œ:ref:`testing_sanity`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:15 -msgid "Originally developed by Matt Martz (@sivel)" -msgstr "本プãƒã‚°ãƒ©ãƒ ã¯ã€å…ƒã€… Matt Martz (@sivel) æ°ã«ã‚ˆã‚Šé–‹ç™ºã•ã‚Œã¾ã—ãŸã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:19 -msgid "Usage" -msgstr "使用法" - -#: ../../rst/dev_guide/testing_validate-modules.rst:28 -msgid "Help" -msgstr "ヘルプ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:53 -msgid "Extending validate-modules" -msgstr "validate-modules ã®æ‹¡å¼µ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:55 -msgid "The ``validate-modules`` tool has a `schema.py <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py>`_ that is used to validate the YAML blocks, such as ``DOCUMENTATION`` and ``RETURNS``." -msgstr "``validate-modules`` ツールã«ã¯ã€``DOCUMENTATION``ã€``RETURNS`` ãªã©ã® YAML ブãƒãƒƒã‚¯ã®æ¤œè¨¼ã«ä½¿ç”¨ã•ã‚Œã‚‹ `schema.py <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py>`_ ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:59 -msgid "Codes" -msgstr "コード" - -#: ../../rst/dev_guide/testing_validate-modules.rst:62 -msgid "**Error Code**" -msgstr "**エラーコード**" - -#: ../../rst/dev_guide/testing_validate-modules.rst:62 -msgid "**Type**" -msgstr "**タイプ**" - -#: ../../rst/dev_guide/testing_validate-modules.rst:62 -msgid "**Level**" -msgstr "**レベル**" - -#: ../../rst/dev_guide/testing_validate-modules.rst:62 -msgid "**Sample Message**" -msgstr "**開始メッセージ**" - -#: ../../rst/dev_guide/testing_validate-modules.rst:64 -msgid "ansible-deprecated-module" -msgstr "ansible-deprecated-module" - -#: ../../rst/dev_guide/testing_validate-modules.rst:64 -#: ../../rst/dev_guide/testing_validate-modules.rst:65 -#: ../../rst/dev_guide/testing_validate-modules.rst:66 -#: ../../rst/dev_guide/testing_validate-modules.rst:68 -#: ../../rst/dev_guide/testing_validate-modules.rst:69 -#: ../../rst/dev_guide/testing_validate-modules.rst:70 -#: ../../rst/dev_guide/testing_validate-modules.rst:71 -#: ../../rst/dev_guide/testing_validate-modules.rst:72 -#: ../../rst/dev_guide/testing_validate-modules.rst:73 -#: ../../rst/dev_guide/testing_validate-modules.rst:74 -#: ../../rst/dev_guide/testing_validate-modules.rst:75 -#: ../../rst/dev_guide/testing_validate-modules.rst:76 -#: ../../rst/dev_guide/testing_validate-modules.rst:77 -#: ../../rst/dev_guide/testing_validate-modules.rst:78 -#: ../../rst/dev_guide/testing_validate-modules.rst:79 -#: ../../rst/dev_guide/testing_validate-modules.rst:80 -#: ../../rst/dev_guide/testing_validate-modules.rst:81 -#: ../../rst/dev_guide/testing_validate-modules.rst:84 -#: ../../rst/dev_guide/testing_validate-modules.rst:87 -#: ../../rst/dev_guide/testing_validate-modules.rst:88 -#: ../../rst/dev_guide/testing_validate-modules.rst:89 -#: ../../rst/dev_guide/testing_validate-modules.rst:90 -#: ../../rst/dev_guide/testing_validate-modules.rst:91 -#: ../../rst/dev_guide/testing_validate-modules.rst:92 -#: ../../rst/dev_guide/testing_validate-modules.rst:93 -#: ../../rst/dev_guide/testing_validate-modules.rst:94 -#: ../../rst/dev_guide/testing_validate-modules.rst:95 -#: ../../rst/dev_guide/testing_validate-modules.rst:97 -#: ../../rst/dev_guide/testing_validate-modules.rst:98 -#: ../../rst/dev_guide/testing_validate-modules.rst:100 -#: ../../rst/dev_guide/testing_validate-modules.rst:101 -#: ../../rst/dev_guide/testing_validate-modules.rst:102 -#: ../../rst/dev_guide/testing_validate-modules.rst:103 -#: ../../rst/dev_guide/testing_validate-modules.rst:104 -#: ../../rst/dev_guide/testing_validate-modules.rst:109 -#: ../../rst/dev_guide/testing_validate-modules.rst:110 -#: ../../rst/dev_guide/testing_validate-modules.rst:111 -#: ../../rst/dev_guide/testing_validate-modules.rst:112 -#: ../../rst/dev_guide/testing_validate-modules.rst:113 -#: ../../rst/dev_guide/testing_validate-modules.rst:117 -#: ../../rst/dev_guide/testing_validate-modules.rst:119 -#: ../../rst/dev_guide/testing_validate-modules.rst:120 -#: ../../rst/dev_guide/testing_validate-modules.rst:121 -#: ../../rst/dev_guide/testing_validate-modules.rst:122 -#: ../../rst/dev_guide/testing_validate-modules.rst:123 -#: ../../rst/dev_guide/testing_validate-modules.rst:124 -#: ../../rst/dev_guide/testing_validate-modules.rst:125 -#: ../../rst/dev_guide/testing_validate-modules.rst:128 -#: ../../rst/dev_guide/testing_validate-modules.rst:132 -#: ../../rst/dev_guide/testing_validate-modules.rst:133 -#: ../../rst/dev_guide/testing_validate-modules.rst:134 -#: ../../rst/dev_guide/testing_validate-modules.rst:137 -#: ../../rst/dev_guide/testing_validate-modules.rst:139 -#: ../../rst/dev_guide/testing_validate-modules.rst:145 -#: ../../rst/dev_guide/testing_validate-modules.rst:146 -#: ../../rst/dev_guide/testing_validate-modules.rst:147 -#: ../../rst/dev_guide/testing_validate-modules.rst:148 -#: ../../rst/dev_guide/testing_validate-modules.rst:149 -#: ../../rst/dev_guide/testing_validate-modules.rst:150 -#: ../../rst/dev_guide/testing_validate-modules.rst:151 -#: ../../rst/dev_guide/testing_validate-modules.rst:152 -#: ../../rst/dev_guide/testing_validate-modules.rst:153 -#: ../../rst/dev_guide/testing_validate-modules.rst:154 -#: ../../rst/dev_guide/testing_validate-modules.rst:155 -#: ../../rst/dev_guide/testing_validate-modules.rst:156 -#: ../../rst/dev_guide/testing_validate-modules.rst:157 -#: ../../rst/dev_guide/testing_validate-modules.rst:158 -#: ../../rst/dev_guide/testing_validate-modules.rst:159 -#: ../../rst/dev_guide/testing_validate-modules.rst:160 -#: ../../rst/dev_guide/testing_validate-modules.rst:161 -#: ../../rst/dev_guide/testing_validate-modules.rst:162 -#: ../../rst/dev_guide/testing_validate-modules.rst:163 -#: ../../rst/dev_guide/testing_validate-modules.rst:164 -msgid "Documentation" -msgstr "ドã‚ュメント" - -#: ../../rst/dev_guide/testing_validate-modules.rst:64 -#: ../../rst/dev_guide/testing_validate-modules.rst:65 -#: ../../rst/dev_guide/testing_validate-modules.rst:66 -#: ../../rst/dev_guide/testing_validate-modules.rst:67 -#: ../../rst/dev_guide/testing_validate-modules.rst:68 -#: ../../rst/dev_guide/testing_validate-modules.rst:69 -#: ../../rst/dev_guide/testing_validate-modules.rst:70 -#: ../../rst/dev_guide/testing_validate-modules.rst:71 -#: ../../rst/dev_guide/testing_validate-modules.rst:72 -#: ../../rst/dev_guide/testing_validate-modules.rst:73 -#: ../../rst/dev_guide/testing_validate-modules.rst:74 -#: ../../rst/dev_guide/testing_validate-modules.rst:75 -#: ../../rst/dev_guide/testing_validate-modules.rst:76 -#: ../../rst/dev_guide/testing_validate-modules.rst:77 -#: ../../rst/dev_guide/testing_validate-modules.rst:78 -#: ../../rst/dev_guide/testing_validate-modules.rst:79 -#: ../../rst/dev_guide/testing_validate-modules.rst:80 -#: ../../rst/dev_guide/testing_validate-modules.rst:81 -#: ../../rst/dev_guide/testing_validate-modules.rst:82 -#: ../../rst/dev_guide/testing_validate-modules.rst:83 -#: ../../rst/dev_guide/testing_validate-modules.rst:84 -#: ../../rst/dev_guide/testing_validate-modules.rst:86 -#: ../../rst/dev_guide/testing_validate-modules.rst:87 -#: ../../rst/dev_guide/testing_validate-modules.rst:88 -#: ../../rst/dev_guide/testing_validate-modules.rst:89 -#: ../../rst/dev_guide/testing_validate-modules.rst:90 -#: ../../rst/dev_guide/testing_validate-modules.rst:91 -#: ../../rst/dev_guide/testing_validate-modules.rst:92 -#: ../../rst/dev_guide/testing_validate-modules.rst:93 -#: ../../rst/dev_guide/testing_validate-modules.rst:94 -#: ../../rst/dev_guide/testing_validate-modules.rst:95 -#: ../../rst/dev_guide/testing_validate-modules.rst:96 -#: ../../rst/dev_guide/testing_validate-modules.rst:97 -#: ../../rst/dev_guide/testing_validate-modules.rst:98 -#: ../../rst/dev_guide/testing_validate-modules.rst:99 -#: ../../rst/dev_guide/testing_validate-modules.rst:100 -#: ../../rst/dev_guide/testing_validate-modules.rst:102 -#: ../../rst/dev_guide/testing_validate-modules.rst:103 -#: ../../rst/dev_guide/testing_validate-modules.rst:104 -#: ../../rst/dev_guide/testing_validate-modules.rst:106 -#: ../../rst/dev_guide/testing_validate-modules.rst:107 -#: ../../rst/dev_guide/testing_validate-modules.rst:108 -#: ../../rst/dev_guide/testing_validate-modules.rst:109 -#: ../../rst/dev_guide/testing_validate-modules.rst:111 -#: ../../rst/dev_guide/testing_validate-modules.rst:112 -#: ../../rst/dev_guide/testing_validate-modules.rst:113 -#: ../../rst/dev_guide/testing_validate-modules.rst:114 -#: ../../rst/dev_guide/testing_validate-modules.rst:115 -#: ../../rst/dev_guide/testing_validate-modules.rst:116 -#: ../../rst/dev_guide/testing_validate-modules.rst:117 -#: ../../rst/dev_guide/testing_validate-modules.rst:118 -#: ../../rst/dev_guide/testing_validate-modules.rst:119 -#: ../../rst/dev_guide/testing_validate-modules.rst:120 -#: ../../rst/dev_guide/testing_validate-modules.rst:121 -#: ../../rst/dev_guide/testing_validate-modules.rst:122 -#: ../../rst/dev_guide/testing_validate-modules.rst:123 -#: ../../rst/dev_guide/testing_validate-modules.rst:124 -#: ../../rst/dev_guide/testing_validate-modules.rst:125 -#: ../../rst/dev_guide/testing_validate-modules.rst:126 -#: ../../rst/dev_guide/testing_validate-modules.rst:127 -#: ../../rst/dev_guide/testing_validate-modules.rst:128 -#: ../../rst/dev_guide/testing_validate-modules.rst:129 -#: ../../rst/dev_guide/testing_validate-modules.rst:130 -#: ../../rst/dev_guide/testing_validate-modules.rst:131 -#: ../../rst/dev_guide/testing_validate-modules.rst:132 -#: ../../rst/dev_guide/testing_validate-modules.rst:133 -#: ../../rst/dev_guide/testing_validate-modules.rst:134 -#: ../../rst/dev_guide/testing_validate-modules.rst:135 -#: ../../rst/dev_guide/testing_validate-modules.rst:137 -#: ../../rst/dev_guide/testing_validate-modules.rst:138 -#: ../../rst/dev_guide/testing_validate-modules.rst:140 -#: ../../rst/dev_guide/testing_validate-modules.rst:141 -#: ../../rst/dev_guide/testing_validate-modules.rst:142 -#: ../../rst/dev_guide/testing_validate-modules.rst:143 -#: ../../rst/dev_guide/testing_validate-modules.rst:144 -#: ../../rst/dev_guide/testing_validate-modules.rst:145 -#: ../../rst/dev_guide/testing_validate-modules.rst:146 -#: ../../rst/dev_guide/testing_validate-modules.rst:147 -#: ../../rst/dev_guide/testing_validate-modules.rst:148 -#: ../../rst/dev_guide/testing_validate-modules.rst:149 -#: ../../rst/dev_guide/testing_validate-modules.rst:150 -#: ../../rst/dev_guide/testing_validate-modules.rst:151 -#: ../../rst/dev_guide/testing_validate-modules.rst:152 -#: ../../rst/dev_guide/testing_validate-modules.rst:153 -#: ../../rst/dev_guide/testing_validate-modules.rst:154 -#: ../../rst/dev_guide/testing_validate-modules.rst:155 -#: ../../rst/dev_guide/testing_validate-modules.rst:156 -#: ../../rst/dev_guide/testing_validate-modules.rst:157 -#: ../../rst/dev_guide/testing_validate-modules.rst:158 -#: ../../rst/dev_guide/testing_validate-modules.rst:159 -#: ../../rst/dev_guide/testing_validate-modules.rst:160 -#: ../../rst/dev_guide/testing_validate-modules.rst:161 -#: ../../rst/dev_guide/testing_validate-modules.rst:162 -#: ../../rst/dev_guide/testing_validate-modules.rst:163 -#: ../../rst/dev_guide/testing_validate-modules.rst:164 -msgid "Error" -msgstr "エラー" - -#: ../../rst/dev_guide/testing_validate-modules.rst:64 -msgid "A module is deprecated and supposed to be removed in the current or an earlier Ansible version" -msgstr "モジュールã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã® Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:65 -msgid "collection-deprecated-module" -msgstr "collection-deprecated-module" - -#: ../../rst/dev_guide/testing_validate-modules.rst:65 -msgid "A module is deprecated and supposed to be removed in the current or an earlier collection version" -msgstr "モジュールã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:66 -msgid "ansible-deprecated-version" -msgstr "ansible-deprecated-version" - -#: ../../rst/dev_guide/testing_validate-modules.rst:66 -msgid "A feature is deprecated and supposed to be removed in the current or an earlier Ansible version" -msgstr "機能ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã® Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:67 -msgid "ansible-module-not-initialized" -msgstr "ansible-module-not-initialized" - -#: ../../rst/dev_guide/testing_validate-modules.rst:67 -#: ../../rst/dev_guide/testing_validate-modules.rst:107 -#: ../../rst/dev_guide/testing_validate-modules.rst:108 -#: ../../rst/dev_guide/testing_validate-modules.rst:131 -#: ../../rst/dev_guide/testing_validate-modules.rst:138 -msgid "Syntax" -msgstr "構文" - -#: ../../rst/dev_guide/testing_validate-modules.rst:67 -msgid "Execution of the module did not result in initialization of AnsibleModule" -msgstr "モジュールを実行ã—ã¦ã‚‚ã€AnsibleModule ã¯åˆæœŸåŒ–ã•ã‚Œãªã‹ã£ãŸã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:68 -msgid "collection-deprecated-version" -msgstr "collection-deprecated-version" - -#: ../../rst/dev_guide/testing_validate-modules.rst:68 -msgid "A feature is deprecated and supposed to be removed in the current or an earlier collection version" -msgstr "機能ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾è¡Œã¾ãŸã¯ãれ以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:69 -msgid "deprecated-date" -msgstr "deprecated-date" - -#: ../../rst/dev_guide/testing_validate-modules.rst:69 -msgid "A date before today appears as ``removed_at_date`` or in ``deprecated_aliases``" -msgstr "今日よりå‰ã®æ—¥ä»˜ã¯ã€``removed_at_date`` よã†ã«è¡¨ç¤ºã•ã‚Œã‚‹ã‹ã€``deprecated_aliases`` ã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:70 -msgid "deprecation-mismatch" -msgstr "deprecation-mismatch" - -#: ../../rst/dev_guide/testing_validate-modules.rst:70 -msgid "Module marked as deprecated or removed in at least one of the filename, its metadata, or in DOCUMENTATION (setting DOCUMENTATION.deprecated for deprecation or removing all Documentation for removed) but not in all three places." -msgstr "ファイルåã€ãã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã€ã¾ãŸã¯ DOCUMENTATION ã®å°‘ãªãã¨ã‚‚ 1 㤠(全箇所ã§ã¯ãªã„) ã§éžæŽ¨å¥¨ã¾ãŸã¯å‰Šé™¤æ¸ˆã¿ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (éžæŽ¨å¥¨ã®å ´åˆã¯ DOCUMENTATION.deprecated ã‚’è¨å®šã—ã€å‰Šé™¤ã®å ´åˆã¯ã™ã¹ã¦ã®ãƒ‰ã‚ュメントを削除ã™ã‚‹) ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:71 -msgid "doc-choices-do-not-match-spec" -msgstr "doc-choices-do-not-match-spec" - -#: ../../rst/dev_guide/testing_validate-modules.rst:71 -msgid "Value for \"choices\" from the argument_spec does not match the documentation" -msgstr "argument_spec ã®ã€Œchoicesã€ã®å€¤ãŒãƒ‰ã‚ュメントã¨ä¸€è‡´ã—ãªã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:72 -msgid "doc-choices-incompatible-type" -msgstr "doc-choices-incompatible-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:72 -msgid "Choices value from the documentation is not compatible with type defined in the argument_spec" -msgstr "ドã‚ュメンテーションã®é¸æŠžå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:73 -msgid "doc-default-does-not-match-spec" -msgstr "doc-default-does-not-match-spec" - -#: ../../rst/dev_guide/testing_validate-modules.rst:73 -msgid "Value for \"default\" from the argument_spec does not match the documentation" -msgstr "argument_spec ã®ã€Œdefaultã€ã®å€¤ãŒãƒ‰ã‚ュメントã¨ä¸€è‡´ã—ãªã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:74 -msgid "doc-default-incompatible-type" -msgstr "doc-default-incompatible-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:74 -msgid "Default value from the documentation is not compatible with type defined in the argument_spec" -msgstr "ドã‚ュメンテーションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:75 -msgid "doc-elements-invalid" -msgstr "doc-elements-invalid" - -#: ../../rst/dev_guide/testing_validate-modules.rst:75 -msgid "Documentation specifies elements for argument, when \"type\" is not ``list``." -msgstr "ドã‚ュメントã§ã¯ã€ã€Œtypeã€ãŒ ``list`` ã§ã¯ãªã„å ´åˆã«ã€å¼•æ•°ã®è¦ç´ を指定ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:76 -msgid "doc-elements-mismatch" -msgstr "doc-elements-mismatch" - -#: ../../rst/dev_guide/testing_validate-modules.rst:76 -msgid "Argument_spec defines elements different than documentation does" -msgstr "argument_spec ã¯ãƒ‰ã‚ュメントã¨ã¯ç•°ãªã‚‹ã‚¿ã‚¤ãƒ—を定義ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:77 -msgid "doc-missing-type" -msgstr "doc-missing-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:77 -msgid "Documentation doesn't specify a type but argument in ``argument_spec`` use default type (``str``)" -msgstr "ドã‚ュメントã§ã¯ã‚¿ã‚¤ãƒ—ã‚’ã—ã¦ã„ã¾ã›ã‚“ãŒã€``argument_spec`` ã®å¼•æ•°ãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆåž‹ (``str``) を使用ã—ã¦ã„ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:78 -msgid "doc-required-mismatch" -msgstr "doc-required-mismatch" - -#: ../../rst/dev_guide/testing_validate-modules.rst:78 -msgid "argument in argument_spec is required but documentation says it is not, or vice versa" -msgstr "arguments_spec ã®å¼•æ•°ã¯å¿…é ˆã§ã™ãŒã€ãƒ‰ã‚ュメントã«ã¯å¿…é ˆã§ã¯ãªã„ (ã¾ãŸã¯ arguments_spec ã®å¼•æ•°ã¯å¿…é ˆã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ãƒ‰ã‚ュメントã«ã¯å¿…é ˆ) ã¨è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:79 -msgid "doc-type-does-not-match-spec" -msgstr "doc-type-does-not-match-spec" - -#: ../../rst/dev_guide/testing_validate-modules.rst:79 -msgid "Argument_spec defines type different than documentation does" -msgstr "argument_spec ãŒãƒ‰ã‚ュメントã¨ã¯ç•°ãªã‚‹ã‚¿ã‚¤ãƒ—を定義ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:80 -msgid "documentation-error" -msgstr "documentation-error" - -#: ../../rst/dev_guide/testing_validate-modules.rst:80 -msgid "Unknown ``DOCUMENTATION`` error" -msgstr "ä¸æ˜Žãª ``DOCUMENTATION`` エラー" - -#: ../../rst/dev_guide/testing_validate-modules.rst:81 -msgid "documentation-syntax-error" -msgstr "documentation-syntax-error" - -#: ../../rst/dev_guide/testing_validate-modules.rst:81 -msgid "Invalid ``DOCUMENTATION`` schema" -msgstr "無効㪠``DOCUMENTATION`` スã‚ーマ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:82 -msgid "illegal-future-imports" -msgstr "illegal-future-imports" - -#: ../../rst/dev_guide/testing_validate-modules.rst:82 -#: ../../rst/dev_guide/testing_validate-modules.rst:83 -#: ../../rst/dev_guide/testing_validate-modules.rst:86 -#: ../../rst/dev_guide/testing_validate-modules.rst:105 -#: ../../rst/dev_guide/testing_validate-modules.rst:106 -#: ../../rst/dev_guide/testing_validate-modules.rst:114 -#: ../../rst/dev_guide/testing_validate-modules.rst:115 -#: ../../rst/dev_guide/testing_validate-modules.rst:116 -#: ../../rst/dev_guide/testing_validate-modules.rst:136 -#: ../../rst/dev_guide/testing_validate-modules.rst:140 -#: ../../rst/dev_guide/testing_validate-modules.rst:141 -#: ../../rst/dev_guide/testing_validate-modules.rst:142 -#: ../../rst/dev_guide/testing_validate-modules.rst:143 -#: ../../rst/dev_guide/testing_validate-modules.rst:144 -msgid "Imports" -msgstr "インãƒãƒ¼ãƒˆ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:82 -msgid "Only the following ``from __future__`` imports are allowed: ``absolute_import``, ``division``, and ``print_function``." -msgstr "``absolute_import``ã€``division``ã€ãŠã‚ˆã³ ``print_function`` ã® ``from __future__`` インãƒãƒ¼ãƒˆã®ã¿ãŒè¨±å¯ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:83 -msgid "import-before-documentation" -msgstr "import-before-documentation" - -#: ../../rst/dev_guide/testing_validate-modules.rst:83 -msgid "Import found before documentation variables. All imports must appear below ``DOCUMENTATION``/``EXAMPLES``/``RETURN``" -msgstr "ドã‚ュメント変数ã®å‰ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚ã™ã¹ã¦ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ã€``DOCUMENTATION``/``EXAMPLES``/``RETURN`` ã®ä¸‹ã«è¡¨ç¤ºã•ã‚Œã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:84 -msgid "import-error" -msgstr "import-error" - -#: ../../rst/dev_guide/testing_validate-modules.rst:84 -msgid "``Exception`` attempting to import module for ``argument_spec`` introspection" -msgstr "``Exception`` ãŒã€``argument_spec`` イントãƒã‚¹ãƒšã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’試行ä¸" - -#: ../../rst/dev_guide/testing_validate-modules.rst:85 -msgid "import-placement" -msgstr "import-placement" - -#: ../../rst/dev_guide/testing_validate-modules.rst:85 -msgid "Locations" -msgstr "å ´æ‰€" - -#: ../../rst/dev_guide/testing_validate-modules.rst:85 -#: ../../rst/dev_guide/testing_validate-modules.rst:101 -#: ../../rst/dev_guide/testing_validate-modules.rst:105 -#: ../../rst/dev_guide/testing_validate-modules.rst:110 -#: ../../rst/dev_guide/testing_validate-modules.rst:136 -#: ../../rst/dev_guide/testing_validate-modules.rst:139 -msgid "Warning" -msgstr "è¦å‘Š" - -#: ../../rst/dev_guide/testing_validate-modules.rst:85 -#: ../../rst/dev_guide/testing_validate-modules.rst:86 -msgid "Imports should be directly below ``DOCUMENTATION``/``EXAMPLES``/``RETURN``" -msgstr "インãƒãƒ¼ãƒˆã¯ã€``DOCUMENTATION``/``EXAMPLES``/``RETURN`` ã®ã™ã後ã«é…ç½®ã—ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:86 -msgid "imports-improper-location" -msgstr "imports-improper-location" - -#: ../../rst/dev_guide/testing_validate-modules.rst:87 -msgid "incompatible-choices" -msgstr "incompatible-choices" - -#: ../../rst/dev_guide/testing_validate-modules.rst:87 -msgid "Choices value from the argument_spec is not compatible with type defined in the argument_spec" -msgstr "argument_spec ã®é¸æŠžå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:88 -msgid "incompatible-default-type" -msgstr "incompatible-default-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:88 -msgid "Default value from the argument_spec is not compatible with type defined in the argument_spec" -msgstr "argument_spec ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€argument_spec ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:89 -msgid "invalid-argument-name" -msgstr "invalid-argument-name" - -#: ../../rst/dev_guide/testing_validate-modules.rst:89 -msgid "Argument in argument_spec must not be one of 'message', 'syslog_facility' as it is used internally by Ansible Core Engine" -msgstr "argument_spec ã®å¼•æ•°ã¯ã€Ansible Core Engine ã«ã‚ˆã£ã¦å†…部ã§ä½¿ç”¨ã•ã‚Œã‚‹ãŸã‚ã€ã€Œmessageã€ã€ã€Œsyslog_facilityã€ã®ã„ãšã‚Œã‹ã«ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:90 -msgid "invalid-argument-spec" -msgstr "invalid-argument-spec" - -#: ../../rst/dev_guide/testing_validate-modules.rst:90 -msgid "Argument in argument_spec must be a dictionary/hash when used" -msgstr "argument_spec ã®å¼•æ•°ã‚’使用ã™ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¾ãŸã¯ãƒãƒƒã‚·ãƒ¥ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:91 -msgid "invalid-argument-spec-options" -msgstr "invalid-argument-spec-options" - -#: ../../rst/dev_guide/testing_validate-modules.rst:91 -msgid "Suboptions in argument_spec are invalid" -msgstr "argument_spec ã®ã‚µãƒ–オプションã¯ç„¡åŠ¹ã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:92 -msgid "invalid-documentation" -msgstr "invalid-documentation" - -#: ../../rst/dev_guide/testing_validate-modules.rst:92 -msgid "``DOCUMENTATION`` is not valid YAML" -msgstr "``DOCUMENTATION`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:93 -msgid "invalid-documentation-markup" -msgstr "invalid-documentation-markup" - -#: ../../rst/dev_guide/testing_validate-modules.rst:93 -msgid "``DOCUMENTATION`` or ``RETURN`` contains invalid markup" -msgstr "``DOCUMENTATION`` ã¾ãŸã¯ã€``RETURN`` ã«ç„¡åŠ¹ãªãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ—ãŒå«ã¾ã‚Œã¦ã„ã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:94 -msgid "invalid-documentation-options" -msgstr "invalid-documentation-options" - -#: ../../rst/dev_guide/testing_validate-modules.rst:94 -msgid "``DOCUMENTATION.options`` must be a dictionary/hash when used" -msgstr "``DOCUMENTATION.options`` を使用ã™ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼/ãƒãƒƒã‚·ãƒ¥ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:95 -msgid "invalid-examples" -msgstr "invalid-examples" - -#: ../../rst/dev_guide/testing_validate-modules.rst:95 -msgid "``EXAMPLES`` is not valid YAML" -msgstr "``EXAMPLES`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:96 -msgid "invalid-extension" -msgstr "invalid-extension" - -#: ../../rst/dev_guide/testing_validate-modules.rst:96 -#: ../../rst/dev_guide/testing_validate-modules.rst:99 -#: ../../rst/dev_guide/testing_validate-modules.rst:135 -msgid "Naming" -msgstr "命åè¦å‰‡" - -#: ../../rst/dev_guide/testing_validate-modules.rst:96 -msgid "Official Ansible modules must have a ``.py`` extension for python modules or a ``.ps1`` for powershell modules" -msgstr "å…¬å¼ã® Ansible モジュールã§ã¯ã€python モジュールã®æ‹¡å¼µå㯠``.py`` ã§ã€powershell モジュールã®æ‹¡å¼µå㯠``.ps1`` ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:97 -msgid "invalid-module-schema" -msgstr "invalid-module-schema" - -#: ../../rst/dev_guide/testing_validate-modules.rst:97 -msgid "``AnsibleModule`` schema validation error" -msgstr "``AnsibleModule`` スã‚ーマ検証エラー" - -#: ../../rst/dev_guide/testing_validate-modules.rst:98 -msgid "invalid-removal-version" -msgstr "invalid-removal-version" - -#: ../../rst/dev_guide/testing_validate-modules.rst:98 -msgid "The version at which a feature is supposed to be removed cannot be parsed (for collections, it must be a semantic version, see https://semver.org/)" -msgstr "機能ãŒå‰Šé™¤ã•ã‚Œã‚‹ã“ã¨ã«ãªã£ã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯è§£æžã§ãã¾ã›ã‚“ (コレクションã®å ´åˆã€ã‚»ãƒžãƒ³ãƒ†ã‚£ãƒƒã‚¯ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚https://semver.org/ ã‚’å‚ç…§ã—ã¦ãã ã•ã„)。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:99 -msgid "invalid-requires-extension" -msgstr "invalid-requires-extension" - -#: ../../rst/dev_guide/testing_validate-modules.rst:99 -msgid "Module ``#AnsibleRequires -CSharpUtil`` should not end in .cs, Module ``#Requires`` should not end in .psm1" -msgstr "モジュール ``#AnsibleRequires -CSharpUtil`` ã®æœ«å°¾ã‚’ .cs ã«ã—ãªã„ã§ãã ã•ã„。モジュール ``#Requires`` ã®æœ«å°¾ã‚’ .psm1 ã«ã—ãªã„ã§ãã ã•ã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:100 -msgid "missing-doc-fragment" -msgstr "missing-doc-fragment" - -#: ../../rst/dev_guide/testing_validate-modules.rst:100 -msgid "``DOCUMENTATION`` fragment missing" -msgstr "``DOCUMENTATION`` フラグメントãŒã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:101 -msgid "missing-existing-doc-fragment" -msgstr "missing-existing-doc-fragment" - -#: ../../rst/dev_guide/testing_validate-modules.rst:101 -msgid "Pre-existing ``DOCUMENTATION`` fragment missing" -msgstr "æ—¢å˜ã® ``DOCUMENTATION`` フラグメントãŒã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:102 -msgid "missing-documentation" -msgstr "missing-documentation" - -#: ../../rst/dev_guide/testing_validate-modules.rst:102 -msgid "No ``DOCUMENTATION`` provided" -msgstr "``DOCUMENTATION`` ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:103 -msgid "missing-examples" -msgstr "missing-examples" - -#: ../../rst/dev_guide/testing_validate-modules.rst:103 -msgid "No ``EXAMPLES`` provided" -msgstr "``EXAMPLES`` ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:104 -msgid "missing-gplv3-license" -msgstr "missing-gplv3-license" - -#: ../../rst/dev_guide/testing_validate-modules.rst:104 -msgid "GPLv3 license header not found" -msgstr "GPLv3 ライセンスヘッダーãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã§ã—ãŸ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:105 -msgid "missing-module-utils-basic-import" -msgstr "missing-module-utils-basic-import" - -#: ../../rst/dev_guide/testing_validate-modules.rst:105 -msgid "Did not find ``ansible.module_utils.basic`` import" -msgstr "``ansible.module_utils.basic`` インãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã§ã—ãŸ" - -#: ../../rst/dev_guide/testing_validate-modules.rst:106 -msgid "missing-module-utils-import-csharp-requirements" -msgstr "missing-module-utils-import-csharp-requirements" - -#: ../../rst/dev_guide/testing_validate-modules.rst:106 -msgid "No ``Ansible.ModuleUtils`` or C# Ansible util requirements/imports found" -msgstr "``Ansible.ModuleUtils`` ã¾ãŸã¯ C# Ansible ユーティリティー㮠è¦ä»¶/インãƒãƒ¼ãƒˆãŒã‚ã‚Šã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:107 -msgid "missing-powershell-interpreter" -msgstr "missing-powershell-interpreter" - -#: ../../rst/dev_guide/testing_validate-modules.rst:107 -msgid "Interpreter line is not ``#!powershell``" -msgstr "インタープリター行㯠``#!powershell`` ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:108 -msgid "missing-python-interpreter" -msgstr "missing-python-interpreter" - -#: ../../rst/dev_guide/testing_validate-modules.rst:108 -msgid "Interpreter line is not ``#!/usr/bin/python``" -msgstr "インタープリター行㯠``#!/usr/bin/python`` ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:109 -msgid "missing-return" -msgstr "missing-return" - -#: ../../rst/dev_guide/testing_validate-modules.rst:109 -msgid "No ``RETURN`` documentation provided" -msgstr "``RETURN`` ã®ãƒ‰ã‚ュメントã¯æä¾›ã•ã‚Œã¦ã„ã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:110 -msgid "missing-return-legacy" -msgstr "missing-return-legacy" - -#: ../../rst/dev_guide/testing_validate-modules.rst:110 -msgid "No ``RETURN`` documentation provided for legacy module" -msgstr "レガシーモジュールã«ã¯ ``RETURN`` ã®ãƒ‰ã‚ュメントãŒã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:111 -msgid "missing-suboption-docs" -msgstr "missing-suboption-docs" - -#: ../../rst/dev_guide/testing_validate-modules.rst:111 -msgid "Argument in argument_spec has sub-options but documentation does not define sub-options" -msgstr "argument_spec ã®å¼•æ•°ã«ã¯ã‚µãƒ–オプションョンãŒã‚ã‚Šã¾ã™ãŒã€ãƒ‰ã‚ュメントã§ã¯ã‚µãƒ–オプションãŒå®šç¾©ã•ã‚Œã¦ã„ã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:112 -msgid "module-incorrect-version-added" -msgstr "module-incorrect-version-added" - -#: ../../rst/dev_guide/testing_validate-modules.rst:112 -msgid "Module level ``version_added`` is incorrect" -msgstr "モジュールレベル ``version_added`` ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:113 -msgid "module-invalid-version-added" -msgstr "module-invalid-version-added" - -#: ../../rst/dev_guide/testing_validate-modules.rst:113 -msgid "Module level ``version_added`` is not a valid version number" -msgstr "モジュールレベル㮠``version_added`` ã¯ã€æœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:114 -msgid "module-utils-specific-import" -msgstr "module-utils-specific-import" - -#: ../../rst/dev_guide/testing_validate-modules.rst:114 -msgid "``module_utils`` imports should import specific components, not ``*``" -msgstr "``module_utils`` ã¯ã€``*`` ã§ã¯ãªãã€ç‰¹å®šã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã‚’インãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:115 -msgid "multiple-utils-per-requires" -msgstr "multiple-utils-per-requires" - -#: ../../rst/dev_guide/testing_validate-modules.rst:115 -msgid "``Ansible.ModuleUtils`` requirements do not support multiple modules per statement" -msgstr "``Ansible.ModuleUtils`` è¦ä»¶ã¯ã€ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã”ã¨ã«è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’サãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:116 -msgid "multiple-csharp-utils-per-requires" -msgstr "multiple-csharp-utils-per-requires" - -#: ../../rst/dev_guide/testing_validate-modules.rst:116 -msgid "Ansible C# util requirements do not support multiple utils per statement" -msgstr "C# ユーティリティーè¦ä»¶ã¯ã€ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã”ã¨ã«è¤‡æ•°ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’サãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:117 -msgid "no-default-for-required-parameter" -msgstr "no-default-for-required-parameter" - -#: ../../rst/dev_guide/testing_validate-modules.rst:117 -msgid "Option is marked as required but specifies a default. Arguments with a default should not be marked as required" -msgstr "オプションã¯å¿…é ˆã¨è˜åˆ¥ã•ã‚Œã¾ã™ãŒã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®å¼•æ•°ã‚’指定ã—ã¾ã™ã€‚デフォルトã®å¼•æ•°ã¯å¿…é ˆã¨è˜åˆ¥ã—ãªã„ã§ãã ã•ã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:118 -msgid "no-log-needed" -msgstr "no-log-needed" - -#: ../../rst/dev_guide/testing_validate-modules.rst:118 -#: ../../rst/dev_guide/testing_validate-modules.rst:126 -#: ../../rst/dev_guide/testing_validate-modules.rst:127 -#: ../../rst/dev_guide/testing_validate-modules.rst:129 -#: ../../rst/dev_guide/testing_validate-modules.rst:130 -msgid "Parameters" -msgstr "パラメーター" - -#: ../../rst/dev_guide/testing_validate-modules.rst:118 -msgid "Option name suggests that the option contains a secret value, while ``no_log`` is not specified for this option in the argument spec. If this is a false positive, explicitly set ``no_log=False``" -msgstr "オプションåã¯ã€ã‚ªãƒ—ションã«ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆå€¤ãŒå«ã¾ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’示唆ã—ã¦ã„ã¾ã™ãŒã€å¼•æ•°ä»•æ§˜ã§ã¯ã“ã®ã‚ªãƒ—ションã«å¯¾ã—㦠``no_log`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã¾ã›ã‚“。ã“ã®ã‚ªãƒ—ションãŒèª¤æ¤œå‡ºã®å ´åˆã¯æ˜Žç¤ºçš„ã« ``no_log=False`` ã«è¨å®šã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:119 -msgid "nonexistent-parameter-documented" -msgstr "nonexistent-parameter-documented" - -#: ../../rst/dev_guide/testing_validate-modules.rst:119 -msgid "Argument is listed in DOCUMENTATION.options, but not accepted by the module" -msgstr "引数㯠DOCUMENTATION.options ã«ä¸€è¦§è¡¨ç¤ºã•ã‚Œã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯å—ã‘入れられã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:120 -msgid "option-incorrect-version-added" -msgstr "option-incorrect-version-added" - -#: ../../rst/dev_guide/testing_validate-modules.rst:120 -msgid "``version_added`` for new option is incorrect" -msgstr "æ–°ã—ã„オプション㮠``version_added`` ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:121 -msgid "option-invalid-version-added" -msgstr "option-invalid-version-added" - -#: ../../rst/dev_guide/testing_validate-modules.rst:121 -msgid "``version_added`` for option is not a valid version number" -msgstr "``version_added`` オプションãŒæœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:122 -msgid "parameter-invalid" -msgstr "parameter-invalid" - -#: ../../rst/dev_guide/testing_validate-modules.rst:122 -msgid "Argument in argument_spec is not a valid python identifier" -msgstr "argument_spec ã®å¼•æ•°ã¯æœ‰åŠ¹ãª python è˜åˆ¥åã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:123 -msgid "parameter-invalid-elements" -msgstr "parameter-invalid-elements" - -#: ../../rst/dev_guide/testing_validate-modules.rst:123 -msgid "Value for \"elements\" is valid only when value of \"type\" is ``list``" -msgstr "「elementsã€ã®å€¤ã¯ã€ã€Œtypeã€ã®å€¤ãŒ ``list`` ã§ã‚ã‚‹å ´åˆã«é™ã‚Šæœ‰åŠ¹ã§ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:124 -msgid "implied-parameter-type-mismatch" -msgstr "implied-parameter-type-mismatch" - -#: ../../rst/dev_guide/testing_validate-modules.rst:124 -msgid "Argument_spec implies ``type=\"str\"`` but documentation defines it as different data type" -msgstr "argument_spec ã«ã¯ ``type=\"str\"`` ã®æ„ãŒå«ã¾ã‚Œã¾ã™ãŒã€ãƒ‰ã‚ュメントã§ã¯ã€åˆ¥ã®ãƒ‡ãƒ¼ã‚¿åž‹ã¨ã—ã¦æŒ‡å®šã•ã‚Œã¦ã„ã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:125 -msgid "parameter-type-not-in-doc" -msgstr "parameter-type-not-in-doc" - -#: ../../rst/dev_guide/testing_validate-modules.rst:125 -msgid "Type value is defined in ``argument_spec`` but documentation doesn't specify a type" -msgstr "タイプ値㯠``argument_spec`` ã§å®šç¾©ã•ã‚Œã¦ã„ã¾ã™ãŒã€ãƒ‰ã‚ュメントã¯ã‚¿ã‚¤ãƒ—を指定ã—ã¦ã„ã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:126 -msgid "parameter-alias-repeated" -msgstr "parameter-alias-repeated" - -#: ../../rst/dev_guide/testing_validate-modules.rst:126 -msgid "argument in argument_spec has at least one alias specified multiple times in aliases" -msgstr "argument_spec ã®å¼•æ•°ã«ã¯ã€ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã«è¤‡æ•°å›žæŒ‡å®šã•ã‚ŒãŸã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒ 1 ã¤ä»¥ä¸Šå«ã¾ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:127 -msgid "parameter-alias-self" -msgstr "parameter-alias-self" - -#: ../../rst/dev_guide/testing_validate-modules.rst:127 -msgid "argument in argument_spec is specified as its own alias" -msgstr "argument_spec ã®å¼•æ•°ã¯ã€ç‹¬è‡ªã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¨ã—ã¦æŒ‡å®šã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:128 -msgid "parameter-documented-multiple-times" -msgstr "parameter-documented-multiple-times" - -#: ../../rst/dev_guide/testing_validate-modules.rst:128 -msgid "argument in argument_spec with aliases is documented multiple times" -msgstr "エイリアスをæŒã¤ argument_spec ã®å¼•æ•°ãŒè¤‡æ•°å›žæ–‡æ›¸åŒ–ã•ã‚Œã¦ã„ã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:129 -msgid "parameter-list-no-elements" -msgstr "parameter-list-no-elements" - -#: ../../rst/dev_guide/testing_validate-modules.rst:129 -msgid "argument in argument_spec \"type\" is specified as ``list`` without defining \"elements\"" -msgstr "argument_spec「typeã€ã®å¼•æ•°ã¯ã€ã€Œè¦ç´ ã€ã‚’定義ã›ãšã« ``list`` ã®ã‚ˆã†ã«æŒ‡å®šã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:130 -msgid "parameter-state-invalid-choice" -msgstr "parameter-state-invalid-choice" - -#: ../../rst/dev_guide/testing_validate-modules.rst:130 -msgid "Argument ``state`` includes ``get``, ``list`` or ``info`` as a choice. Functionality should be in an ``_info`` or (if further conditions apply) ``_facts`` module." -msgstr "引数 ``state`` ã«ã¯ã€``get``ã€``list``ã€ã¾ãŸã¯ ``info`` ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚機能性㯠``_info`` ã¾ãŸã¯ (è¿½åŠ ã®æ¡ä»¶ãŒé©ç”¨ã•ã‚Œã‚‹å ´åˆã¯) ``_facts`` モジュールã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:131 -msgid "python-syntax-error" -msgstr "python-syntax-error" - -#: ../../rst/dev_guide/testing_validate-modules.rst:131 -msgid "Python ``SyntaxError`` while parsing module" -msgstr "モジュールã®è§£æžä¸ã® Python ``SyntaxError``" - -#: ../../rst/dev_guide/testing_validate-modules.rst:132 -msgid "removal-version-must-be-major" -msgstr "removal-version-must-be-major" - -#: ../../rst/dev_guide/testing_validate-modules.rst:132 -msgid "According to the semantic versioning specification (https://semver.org/), the only versions in which features are allowed to be removed are major versions (x.0.0)" -msgstr "セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ä»•æ§˜ (https://semver.org/) ã«ã‚ˆã‚‹ã¨ã€æ©Ÿèƒ½ã®å‰Šé™¤ãŒè¨±å¯ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (x.0.0) ã®ã¿ã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:133 -msgid "return-syntax-error" -msgstr "return-syntax-error" - -#: ../../rst/dev_guide/testing_validate-modules.rst:133 -msgid "``RETURN`` is not valid YAML, ``RETURN`` fragments missing or invalid" -msgstr "``RETURN`` ã¯ã€æœ‰åŠ¹ãª YAML ã§ã¯ã‚ã‚Šã¾ã›ã‚“。``RETURN`` フラグメントãŒè¦‹ã¤ã‹ã‚‰ãªã„ã‹ã€ç„¡åŠ¹ã§ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:134 -msgid "return-invalid-version-added" -msgstr "return-invalid-version-added" - -#: ../../rst/dev_guide/testing_validate-modules.rst:134 -msgid "``version_added`` for return value is not a valid version number" -msgstr "戻り値㮠``version_added`` ã¯ã€æœ‰åŠ¹ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:135 -msgid "subdirectory-missing-init" -msgstr "subdirectory-missing-init" - -#: ../../rst/dev_guide/testing_validate-modules.rst:135 -msgid "Ansible module subdirectories must contain an ``__init__.py``" -msgstr "Ansible モジュールã®ã‚µãƒ–ディレクトリーã«ã¯ ``__init__.py`` ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:136 -msgid "try-except-missing-has" -msgstr "try-except-missing-has" - -#: ../../rst/dev_guide/testing_validate-modules.rst:136 -msgid "Try/Except ``HAS_`` expression missing" -msgstr "try/Except ``HAS_`` å¼ãŒãªã„" - -#: ../../rst/dev_guide/testing_validate-modules.rst:137 -msgid "undocumented-parameter" -msgstr "undocumented-parameter" - -#: ../../rst/dev_guide/testing_validate-modules.rst:137 -msgid "Argument is listed in the argument_spec, but not documented in the module" -msgstr "引数㌠argument_spec ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ãŒã€ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯æ–‡æ›¸åŒ–ã•ã‚Œã¦ã„ã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:138 -msgid "unidiomatic-typecheck" -msgstr "unidiomatic-typecheck" - -#: ../../rst/dev_guide/testing_validate-modules.rst:138 -msgid "Type comparison using ``type()`` found. Use ``isinstance()`` instead" -msgstr "``type()`` を使用ã—ãŸã‚¿ã‚¤ãƒ—比較。代ã‚ã‚Šã« ``isinstance()`` を使用ã—ã¦ãã ã•ã„。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:139 -msgid "unknown-doc-fragment" -msgstr "unknown-doc-fragment" - -#: ../../rst/dev_guide/testing_validate-modules.rst:139 -msgid "Unknown pre-existing ``DOCUMENTATION`` error" -msgstr "ä¸æ˜Žãªæ—¢å˜ã® ``DOCUMENTATION`` エラー" - -#: ../../rst/dev_guide/testing_validate-modules.rst:140 -msgid "use-boto3" -msgstr "use-boto3" - -#: ../../rst/dev_guide/testing_validate-modules.rst:140 -msgid "``boto`` import found, new modules should use ``boto3``" -msgstr "``boto`` インãƒãƒ¼ãƒˆãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« ``boto3`` を使用ã—ã¦ãã ã•ã„" - -#: ../../rst/dev_guide/testing_validate-modules.rst:141 -msgid "use-fail-json-not-sys-exit" -msgstr "use-fail-json-not-sys-exit" - -#: ../../rst/dev_guide/testing_validate-modules.rst:141 -msgid "``sys.exit()`` call found. Should be ``exit_json``/``fail_json``" -msgstr "``sys.exit()`` 呼ã³å‡ºã—ãŒè¦‹ã¤ã‹ã‚Šã¾ã—ãŸã€‚``exit_json``/``fail_json`` ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。" - -#: ../../rst/dev_guide/testing_validate-modules.rst:142 -msgid "use-module-utils-urls" -msgstr "use-module-utils-urls" - -#: ../../rst/dev_guide/testing_validate-modules.rst:142 -msgid "``requests`` import found, should use ``ansible.module_utils.urls`` instead" -msgstr "``requests`` インãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚代ã‚ã‚Šã« ``ansible.module_utils.urls`` を使用ã—ã¦ãã ã•ã„" - -#: ../../rst/dev_guide/testing_validate-modules.rst:143 -msgid "use-run-command-not-os-call" -msgstr "use-run-command-not-os-call" - -#: ../../rst/dev_guide/testing_validate-modules.rst:143 -msgid "``os.call`` used instead of ``module.run_command``" -msgstr "``module.run_command`` ã®ä»£ã‚ã‚Šã«ã€``os.call`` を使用ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:144 -msgid "use-run-command-not-popen" -msgstr "use-run-command-not-popen" - -#: ../../rst/dev_guide/testing_validate-modules.rst:144 -msgid "``subprocess.Popen`` used instead of ``module.run_command``" -msgstr "``module.run_command`` ã®ä»£ã‚ã‚Šã«ã€``subprocess.Popen`` を使用ã—ã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:145 -msgid "use-short-gplv3-license" -msgstr "use-short-gplv3-license" - -#: ../../rst/dev_guide/testing_validate-modules.rst:145 -msgid "GPLv3 license header should be the :ref:`short form <copyright>` for new modules" -msgstr "GPLv3 ライセンスヘッダーã¯ã€æ–°ã—ã„モジュール㮠:ref:`çŸç¸®å½¢ <copyright>` ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:146 -msgid "mutually_exclusive-type" -msgstr "mutually_exclusive-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:146 -msgid "mutually_exclusive entry contains non-string value" -msgstr "mutually_exclusive エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:147 -msgid "mutually_exclusive-collision" -msgstr "mutually_exclusive-collision" - -#: ../../rst/dev_guide/testing_validate-modules.rst:147 -msgid "mutually_exclusive entry has repeated terms" -msgstr "mutually_exclusive エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:148 -msgid "mutually_exclusive-unknown" -msgstr "mutually_exclusive-unknown" - -#: ../../rst/dev_guide/testing_validate-modules.rst:148 -msgid "mutually_exclusive entry contains option which does not appear in argument_spec (potentially an alias of an option?)" -msgstr "mutually_exclusive エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:149 -msgid "required_one_of-type" -msgstr "required_one_of-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:149 -msgid "required_one_of entry contains non-string value" -msgstr "required_one_of エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:150 -msgid "required_one_of-collision" -msgstr "required_one_of-collision" - -#: ../../rst/dev_guide/testing_validate-modules.rst:150 -msgid "required_one_of entry has repeated terms" -msgstr "required_one_of エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:151 -msgid "required_one_of-unknown" -msgstr "required_one_of-unknown" - -#: ../../rst/dev_guide/testing_validate-modules.rst:151 -msgid "required_one_of entry contains option which does not appear in argument_spec (potentially an alias of an option?)" -msgstr "required_one_of エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:152 -msgid "required_together-type" -msgstr "required_together-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:152 -msgid "required_together entry contains non-string value" -msgstr "required_together エントリーã«ã¯æ–‡å—列以外ã®å€¤ãŒå«ã¾ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:153 -msgid "required_together-collision" -msgstr "required_together-collision" - -#: ../../rst/dev_guide/testing_validate-modules.rst:153 -msgid "required_together entry has repeated terms" -msgstr "required_together エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:154 -msgid "required_together-unknown" -msgstr "required_together-unknown" - -#: ../../rst/dev_guide/testing_validate-modules.rst:154 -msgid "required_together entry contains option which does not appear in argument_spec (potentially an alias of an option?)" -msgstr "required_together エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:155 -msgid "required_if-is_one_of-type" -msgstr "required_if-is_one_of-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:155 -msgid "required_if entry has a fourth value which is not a bool" -msgstr "required_if エントリーã«ã¯ bool ã§ã¯ãªã„ 4 ã¤ç›®ã®å€¤ãŒã‚ã‚‹" - -#: ../../rst/dev_guide/testing_validate-modules.rst:156 -msgid "required_if-requirements-type" -msgstr "required_if-requirements-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:156 -msgid "required_if entry has a third value (requirements) which is not a list or tuple" -msgstr "required_if エントリーã«ã¯ã€ãƒªã‚¹ãƒˆã¾ãŸã¯ã‚¿ãƒ—ルã§ã¯ãªã„ 3 ã¤ã®å€¤ (å¿…é ˆ) ãŒã‚ã‚Šã¾ã™ã€‚" - -#: ../../rst/dev_guide/testing_validate-modules.rst:157 -msgid "required_if-requirements-collision" -msgstr "required_if-requirements-collision" - -#: ../../rst/dev_guide/testing_validate-modules.rst:157 -msgid "required_if entry has repeated terms in requirements" -msgstr "required_if エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:158 -msgid "required_if-requirements-unknown" -msgstr "required_if-requirements-unknown" - -#: ../../rst/dev_guide/testing_validate-modules.rst:158 -msgid "required_if entry's requirements contains option which does not appear in argument_spec (potentially an alias of an option?)" -msgstr "required_if エントリーã®è¦ä»¶ã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:159 -msgid "required_if-unknown-key" -msgstr "required_if-unknown-key" - -#: ../../rst/dev_guide/testing_validate-modules.rst:159 -msgid "required_if entry's key does not appear in argument_spec (potentially an alias of an option?)" -msgstr "required_if エントリーã®ã‚ー㌠argument_spec ã«è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:160 -msgid "required_if-key-in-requirements" -msgstr "required_if-key-in-requirements" - -#: ../../rst/dev_guide/testing_validate-modules.rst:160 -msgid "required_if entry contains its key in requirements list/tuple" -msgstr "required_if エントリーã«ã¯è¦ä»¶ãƒªã‚¹ãƒˆ/タプルã®ã‚ーãŒå«ã¾ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:161 -msgid "required_if-value-type" -msgstr "required_if-value-type" - -#: ../../rst/dev_guide/testing_validate-modules.rst:161 -msgid "required_if entry's value is not of the type specified for its key" -msgstr "required_if エントリーã®å€¤ã¯ã€ã‚ーã«æŒ‡å®šã•ã‚ŒãŸã‚¿ã‚¤ãƒ—ã§ã¯ã‚ã‚Šã¾ã›ã‚“" - -#: ../../rst/dev_guide/testing_validate-modules.rst:162 -msgid "required_by-collision" -msgstr "required_by-collision" - -#: ../../rst/dev_guide/testing_validate-modules.rst:162 -msgid "required_by entry has repeated terms" -msgstr "required_by エントリーãŒç¹°ã‚Šè¿”ã—使用ã•ã‚Œã¾ã™" - -#: ../../rst/dev_guide/testing_validate-modules.rst:163 -msgid "required_by-unknown" -msgstr "required_by-unknown" - -#: ../../rst/dev_guide/testing_validate-modules.rst:163 -msgid "required_by entry contains option which does not appear in argument_spec (potentially an alias of an option?)" -msgstr "required_by エントリーã«ã¯ã€argument_spec ã«è¡¨ç¤ºã•ã‚Œãªã„オプションãŒå«ã¾ã‚Œã¾ã™ (オプションã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã‹?)" - -#: ../../rst/dev_guide/testing_validate-modules.rst:164 -msgid "version-added-must-be-major-or-minor" -msgstr "version-added-must-be-major-or-minor" - -#: ../../rst/dev_guide/testing_validate-modules.rst:164 -msgid "According to the semantic versioning specification (https://semver.org/), the only versions in which features are allowed to be added are major and minor versions (x.y.0)" -msgstr "セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ä»•æ§˜ (https://semver.org/) ã«ã‚ˆã‚‹ã¨ã€æ©Ÿèƒ½ã®è¿½åŠ ãŒè¨±å¯ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŠã‚ˆã³ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (x.y.0) ã®ã¿ã§ã™" +#: ../../rst/dev_guide/testing_validate-modules.rst:7 +msgid "This page has moved to :ref:`testing_validate-modules`." +msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã¯ :ref:`testing_validate-modules` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" #~ msgid "All Python imports in ``lib/ansible/modules/`` and ``lib/ansible/module_utils/`` which are not from the Python standard library must be imported in a try/except ImportError block." #~ msgstr "" @@ -15835,4 +15833,586 @@ msgstr "セマンティックãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ä»•æ§˜ (https://semver.org/) ã #~ msgid "missing-python-doc" #~ msgstr "missing-python-doc" +#~ msgid "an :ref:`OpenStack module <OpenStack_module_development>`." +#~ msgstr ":ref:`OpenStack モジュール <OpenStack_module_development>`" + +#~ msgid "an :ref:`oVirt/RHV module <oVirt_module_development>`." +#~ msgstr ":ref:`oVirt/RHV モジュール <oVirt_module_development>`" + +#~ msgid "When reading the :ref:`developing_testing` documentation, there will be content that applies to running Ansible from source code via a git clone, which is typical of an Ansible developer. However, it's not always typical for an Ansible Collection author to be running Ansible from source but instead from a stable release, and to create Collections it is not necessary to run Ansible from source. Therefore, when references of dealing with `ansible-test` binary paths, command completion, or environment variables are presented throughout the :ref:`developing_testing` documentation; keep in mind that it is not needed for Ansible Collection Testing because the act of installing the stable release of Ansible containing `ansible-test` is expected to setup those things for you." +#~ msgstr ":ref:`developing_testing` ã®ãƒ‰ã‚ュメントをèªã‚€éš›ã€Ansible 開発者ã®å…¸åž‹çš„㪠git clone を使用ã—ã¦ã€ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã‹ã‚‰ Ansible を実行ã™ã‚‹ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ãŒã‚ã‚Šã¾ã™ã€‚ãŸã ã—ã€Ansible Collection ã®ä½œæˆè€…ãŒã‚½ãƒ¼ã‚¹ã‹ã‚‰ Ansible を実行ã™ã‚‹ã“ã¨ã¯å¸¸ã«ä¸€èˆ¬çš„ã§ã¯ãªãã€å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‹ã‚‰ã§ã¯ãªãã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’作æˆã™ã‚‹ã«ã¯ã€ã‚½ãƒ¼ã‚¹ã‹ã‚‰ Ansible を実行ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。ãã®ãŸã‚ã€`ansible-test` ãƒã‚¤ãƒŠãƒªãƒ¼ãƒ‘スã€ã‚³ãƒžãƒ³ãƒ‰è£œå®Œã€ã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã«ã¤ã„ã¦ã¯ã€:ref:`developing_testing` ドã‚ュメントã§æ示ã•ã‚Œã¾ã™ã€‚Ansible Collection Testing ã§ã¯ã“ã‚ŒãŒå¿…è¦ã‚ã‚Šã¾ã›ã‚“。`ansible-test` ã‚’å«ã‚€ Ansible ã®å®‰å®šã—ãŸãƒªãƒªãƒ¼ã‚¹ã‚’インストールã™ã‚‹ã«ã¯ã€ã“れらをセットアップã™ã‚‹ã“ã¨ãŒäºˆæƒ³ã•ã‚Œã‚‹ãŸã‚ã§ã™ã€‚" + +#~ msgid "Testing your collection ensures that your code works well and integrates well with the rest of the Ansible ecosystem. Your collection should pass the general compile and sanity tests for Ansible code. You should also add unit tests to cover the code in your collection and integration tests to cover the interactions between your collection and ansible-core." +#~ msgstr "コレクションã®ãƒ†ã‚¹ãƒˆã«ã‚ˆã‚Šã€ã‚³ãƒ¼ãƒ‰ãŒé©åˆ‡ã«æ©Ÿèƒ½ã—ã€Ansible エコシステムã®ä»–ã®éƒ¨åˆ†ã¨ã®çµ±åˆæ€§ãŒå‘上ã—ã¾ã™ã€‚コレクションã§ã¯ã€Ansible コードã®ä¸€èˆ¬çš„ãªã‚³ãƒ³ãƒ‘イルãŠã‚ˆã³å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’渡ã—ã¾ã™ã€‚ã¾ãŸã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã‚³ãƒ¼ãƒ‰ã«å¯¾å¿œã™ã‚‹ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã¨ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨ ansible-core ã¨ã®é–“ã®å¯¾è©±ã«å¯¾å¿œã™ã‚‹çµ±åˆãƒ†ã‚¹ãƒˆã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Compile and sanity tests" +#~ msgstr "コンパイルã¨å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ" + +#~ msgid "Although ``ansible-core`` (the code hosted in the `ansible/ansible repository <https://github.com/ansible/ansible>`_ on GitHub) includes a few plugins that can be swapped out via playbook directives or configuration, much of the code there is not modular. The documents here give insight into how the parts of ``ansible-core`` work together." +#~ msgstr "``ansible-core`` (GitHub ã® `ansible/ansible リãƒã‚¸ãƒˆãƒªãƒ¼ <https://github.com/ansible/ansible>`_ ã§ãƒ›ã‚¹ãƒˆã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰) ã«ã¯ã€Playbook ディレクティブã¾ãŸã¯è¨å®šã‚’介ã—ã¦ã‚¹ãƒ¯ãƒƒãƒ—ã§ãるプラグインãŒå«ã¾ã‚Œã¦ã„ã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«åŒ–ã•ã‚Œãªã„コードãŒå¤šãã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€``ansible-core`` ã®ä¸€éƒ¨ãŒé€£æºã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹ãƒ‰ã‚ュメントã§ã™ã€‚" + +#~ msgid "The three main options from the ``constructed`` documentation fragment are ``compose``, ``keyed_groups``, and ``groups``. See the ``constructed`` inventory plugin for examples on using these. ``compose`` is a dictionary of variable names and Jinja2 expressions. Once a host is added to inventory and any initial variables have been set, call the method ``_set_composite_vars`` to add composed host variables. If this is done before adding ``keyed_groups`` and ``groups``, the group generation will be able to use the composed variables." +#~ msgstr "``constructed`` ドã‚ュメントフラグ㮠3 ã¤ã®ä¸»è¦ãªã‚ªãƒ—ションã¯ã€``compose``ã€``keyed_groups``ã€ãŠã‚ˆã³ ``groups`` ã§ã™ã€‚ã“れらã®ä½¿ç”¨ä¾‹ã¯ã€``constructed`` インベントリープラグインをå‚ç…§ã—ã¦ãã ã•ã„。``compose`` ã¯ã€å¤‰æ•°åãŠã‚ˆã³ Jinja2 å¼ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã™ã€‚ホストãŒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«è¿½åŠ ã•ã‚Œã€åˆæœŸå¤‰æ•°ãŒè¨å®šã•ã‚Œã‚‹ã¨ã€``_set_composite_vars`` メソッドを呼ã³å‡ºã—ã¦æ§‹æˆã•ã‚ŒãŸãƒ›ã‚¹ãƒˆå¤‰æ•°ã‚’è¿½åŠ ã—ã¾ã™ã€‚``keyed_groups`` ãŠã‚ˆã³ ``groups`` ã‚’è¿½åŠ ã™ã‚‹å‰ã«ã“れを行ã†ã¨ã€ã‚°ãƒ«ãƒ¼ãƒ—ã®ç”Ÿæˆã¯æ§‹æˆã•ã‚ŒãŸå¤‰æ•°ã‚’使用ã§ãã¾ã™ã€‚" + +#~ msgid "Modules are reusable, standalone scripts that can be used by the Ansible API, the :command:`ansible` command, or the :command:`ansible-playbook` command. Modules provide a defined interface. Each module accepts arguments and returns information to Ansible by printing a JSON string to stdout before exiting. Modules execute on the target system (usually that means on a remote system) in separate processes. Modules are technically plugins, but for historical reasons we do not usually talk about \"module plugins\"." +#~ msgstr "モジュールã¯ã€Ansible APIã€:command:`ansible` コマンドã€ã¾ãŸã¯ :command:`ansible-playbook` コマンドã§ä½¿ç”¨ã§ãã‚‹å†åˆ©ç”¨å¯èƒ½ãªã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã‚¹ã‚¯ãƒªãƒ—トã§ã™ã€‚モジュールã¯ã€å®šç¾©ã•ã‚ŒãŸã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã‚’æä¾›ã—ã¾ã™ã€‚å„モジュールã¯å¼•æ•°ã‚’å—ã‘入れã€çµ‚了ã™ã‚‹å‰ã« JSON æ–‡å—列を stdout ã«å‡ºåŠ›ã—㦠Ansible ã«æƒ…å ±ã‚’è¿”ã—ã¾ã™ã€‚モジュールã¯ã€åˆ¥ã®ãƒ—ãƒã‚»ã‚¹ã§ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚·ã‚¹ãƒ†ãƒ (通常ã¯ãƒªãƒ¢ãƒ¼ãƒˆã‚·ã‚¹ãƒ†ãƒ 上) ã§å®Ÿè¡Œã•ã‚Œã¾ã™ã€‚モジュールã¯æŠ€è¡“çš„ã«ã¯ãƒ—ラグインã§ã™ãŒã€éŽåŽ»ã®çµŒç·¯ã‹ã‚‰ã€é€šå¸¸ã€Œãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ—ラグインã€ã¨ã¯å‘¼ã³ã¾ã›ã‚“。" + +#~ msgid "Currently, the ``ansible-doc`` command can parse module documentation only from modules written in Python. If you have a module written in a programming language other than Python, please write the documentation in a Python file adjacent to the module file." +#~ msgstr "ç¾åœ¨ã€``ansible-doc`` コマンドã¯ã€Python ã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‹ã‚‰ã®ã¿ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‰ã‚ュメントを解æžã§ãã¾ã™ã€‚Python 以外ã®ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã§è¨˜è¿°ã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã®æ¨ªã® Python ファイルã«ãƒ‰ã‚ュメントを作æˆã—ã¦ãã ã•ã„。" + +#~ msgid "Developing Cisco ACI modules" +#~ msgstr "Cisco ACI モジュールã®é–‹ç™º" + +#~ msgid "This is a brief walk-through of how to create new Cisco ACI modules for Ansible." +#~ msgstr "Ansible å‘ã‘ã«æ–°ã—ã„ Cisco ACI モジュールを作æˆã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹ç°¡å˜ãªã‚¦ã‚©ãƒ¼ã‚¯ã‚¹ãƒ«ãƒ¼ã§ã™ã€‚" + +#~ msgid "For more information about Cisco ACI, look at the :ref:`Cisco ACI user guide <aci_guide>`." +#~ msgstr "Cisco ACI ã®è©³ç´°ã¯ã€ã€Œ:ref:`Cisco ACI ユーザーガイド <aci_guide>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "The `cisco.aci collection <https://galaxy.ansible.com/cisco/aci>`_ already includes a large number of Cisco ACI modules, however the ACI object model is huge and covering all possible functionality would easily cover more than 1500 individual modules." +#~ msgstr "`cisco.aci collection <https://galaxy.ansible.com/cisco/aci>`_ ã«ã¯ã™ã§ã«å¤šæ•°ã® Cisco ACI モジュールãŒå«ã¾ã‚Œã¦ã„ã¾ã™ãŒã€ACI オブジェクトモデルã¯å¤§ããã€ã™ã¹ã¦ã®æ©Ÿèƒ½ã«å¯¾å¿œã™ã‚‹ãŸã‚ã€1500 以上ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’ç°¡å˜ã«å¯¾å¿œã§ãã¾ã™ã€‚" + +#~ msgid "If you need specific functionality, you have 2 options:" +#~ msgstr "特定ã®æ©Ÿèƒ½ãŒå¿…è¦ãªå ´åˆã¯ã€2 ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Learn the ACI object model and use the low-level APIC REST API using the :ref:`aci_rest <aci_rest_module>` module" +#~ msgstr "ACI オブジェクトモデルをå¦ç¿’ã—ã€ã€Œ:ref:`aci_rest <aci_rest_module>`ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦ä½Žãƒ¬ãƒ™ãƒ«ã® APIC REST API を使用ã—ã¾ã™ã€‚" + +#~ msgid "Write your own dedicated modules, which is actually quite easy" +#~ msgstr "独自ã®å°‚用モジュールを作æˆã™ã‚‹ã“ã¨ã¯ã€å®Ÿéš›ã«ã¯éžå¸¸ã«ç°¡å˜ã§ã™ã€‚" + +#~ msgid "`Ansible ACI collection <https://github.com/CiscoDevNet/ansible-aci>`_" +#~ msgstr "`Ansible ACI collection <https://github.com/CiscoDevNet/ansible-aci>`_" + +#~ msgid "Github repository of the ansible ACI collection" +#~ msgstr "Ansible ACI コレクション㮠GitHub リãƒã‚¸ãƒˆãƒªãƒ¼" + +#~ msgid ":ref:`hacking_collections`" +#~ msgstr ":ref:`collections`" + +#~ msgid "Information on how to contribute to collections." +#~ msgstr "コレクションã¸ã®è²¢çŒ®æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±ã€‚" + +#~ msgid "`ACI Fundamentals: ACI Policy Model <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/aci-fundamentals/b_ACI-Fundamentals/b_ACI-Fundamentals_chapter_010001.html>`_" +#~ msgstr "`ACI Fundamentals: ACI Policy Model <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/aci-fundamentals/b_ACI-Fundamentals/b_ACI-Fundamentals_chapter_010001.html>`_" + +#~ msgid "A good introduction to the ACI object model." +#~ msgstr "ACI オブジェクトモデルã®å„ªã‚ŒãŸæ¦‚è¦" + +#~ msgid "`APIC Management Information Model reference <https://developer.cisco.com/docs/apic-mim-ref/>`_" +#~ msgstr "`APIC Management Information Model reference <https://developer.cisco.com/docs/apic-mim-ref/>`_" + +#~ msgid "Complete reference of the APIC object model." +#~ msgstr "APIC オブジェクトモデルã®å®Œå…¨ãªãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹" + +#~ msgid "`APIC REST API Configuration Guide <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/2-x/rest_cfg/2_1_x/b_Cisco_APIC_REST_API_Configuration_Guide.html>`_" +#~ msgstr "`APIC REST API Configuration Guide <https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/2-x/rest_cfg/2_1_x/b_Cisco_APIC_REST_API_Configuration_Guide.html>`_" + +#~ msgid "Detailed guide on how the APIC REST API is designed and used, incl. many examples." +#~ msgstr "APIC REST API ã‚’è¨è¨ˆãŠã‚ˆã³ä½¿ç”¨ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦ã®è©³ç´°ã‚¬ã‚¤ãƒ‰ã€‚多数ã®ä¾‹ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "So let's look at how a typical ACI module is built up." +#~ msgstr "ãã‚Œã§ã¯ã€å…¸åž‹çš„㪠ACI モジュールãŒã©ã®ã‚ˆã†ã«æ§‹ç¯‰ã•ã‚Œã‚‹ã‹ã‚’見ã¦ã¿ã¾ã—ょã†ã€‚" + +#~ msgid "ACI module structure" +#~ msgstr "ACI ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«æ§‹é€ " + +#~ msgid "Importing objects from Python libraries" +#~ msgstr "Python ライブラリーã‹ã‚‰ã®ã‚ªãƒ–ジェクトã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" + +#~ msgid "The following imports are standard across ACI modules:" +#~ msgstr "以下ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã¯ã€ACI モジュール全体ã§æ¨™æº–ã®ã‚‚ã®ã§ã™ã€‚" + +#~ msgid "Defining the argument spec" +#~ msgstr "引数仕様ã®å®šç¾©" + +#~ msgid "The first line adds the standard connection parameters to the module. After that, the next section will update the ``argument_spec`` dictionary with module-specific parameters. The module-specific parameters should include:" +#~ msgstr "最åˆã®è¡Œã¯ã€æ¨™æº–ã®æŽ¥ç¶šãƒ‘ラメーターをモジュールã«è¿½åŠ ã—ã¾ã™ã€‚ãã®å¾Œã€ä»¥ä¸‹ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å›ºæœ‰ã®ãƒ‘ラメーター㧠``argument_spec`` ディクショナリーを更新ã—ã¾ã™ã€‚モジュール固有ã®ãƒ‘ラメーターã«ã¯ä»¥ä¸‹ãŒå«ã¾ã‚Œã¾ã™ã€‚" + +#~ msgid "the object_id (usually the name)" +#~ msgstr "object_id (通常ã¯åå‰)" + +#~ msgid "the configurable properties of the object" +#~ msgstr "オブジェクトã®è¨å®šå¯èƒ½ãªãƒ—ãƒãƒ‘ティー" + +#~ msgid "the parent object IDs (all parents up to the root)" +#~ msgstr "親オブジェクト ID (ルートã¾ã§ã®ã™ã¹ã¦ã®è¦ª)" + +#~ msgid "only child classes that are a 1-to-1 relationship (1-to-many/many-to-many require their own module to properly manage)" +#~ msgstr "1 対 1 ã®é–¢ä¿‚ã§ã‚ã‚‹åクラスã®ã¿ (1 対多/多対多ã§ã¯ã€ç‹¬è‡ªã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’é©åˆ‡ã«ç®¡ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)" + +#~ msgid "the state" +#~ msgstr "状態" + +#~ msgid "``state: absent`` to ensure object does not exist" +#~ msgstr "``state: absent``: オブジェクトãŒå˜åœ¨ã—ãªã„ã“ã¨ã‚’確èªã™ã‚‹" + +#~ msgid "``state: present`` to ensure the object and configs exist; this is also the default" +#~ msgstr "``state: present``: オブジェクトã¨è¨å®šãŒå˜åœ¨ã™ã‚‹ã“ã¨ã‚’確èªã™ã‚‹ (デフォルト)" + +#~ msgid "``state: query`` to retrieve information about objects in the class" +#~ msgstr "``state: query``: クラスã®ã‚ªãƒ–ジェクトã«é–¢ã™ã‚‹æƒ…å ±ã‚’å–å¾—ã™ã‚‹" + +#~ msgid "Do not provide default values for configuration arguments. Default values could cause unintended changes to the object." +#~ msgstr "è¨å®šå¼•æ•°ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’指定ã—ãªã„ã§ãã ã•ã„。デフォルト値ã«ã‚ˆã‚Šã€ã‚ªãƒ–ジェクトã¸ã®æ„図ã—ãªã„変更ãŒç”Ÿã˜ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Using the AnsibleModule object" +#~ msgstr "AnsibleModule オブジェクトã®ä½¿ç”¨" + +#~ msgid "The following section creates an AnsibleModule instance. The module should support check-mode, so we pass the ``argument_spec`` and ``supports_check_mode`` arguments. Since these modules support querying the APIC for all objects of the module's class, the object/parent IDs should only be required if ``state: absent`` or ``state: present``." +#~ msgstr "次ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€AnsibleModule インスタンスを作æˆã—ã¾ã™ã€‚モジュールã¯ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’サãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚‹ãŸã‚ã€``argument_spec`` 引数ãŠã‚ˆã³ ``supports_check_mode`` 引数を渡ã—ã¾ã™ã€‚ã“れらã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚¯ãƒ©ã‚¹ã®ã™ã¹ã¦ã®ã‚ªãƒ–ジェクトã«å¯¾ã™ã‚‹ APIC ã®ã‚¯ã‚¨ãƒªãƒ¼ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã€ã‚ªãƒ–ジェクト/親 ID ã¯ã€``state: absent`` ã¾ãŸã¯ ``state: present`` ã®å ´åˆã«é™ã‚Šå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" + +#~ msgid "Mapping variable definition" +#~ msgstr "マッピング変数定義" + +#~ msgid "Once the AnsibleModule object has been initiated, the necessary parameter values should be extracted from ``params`` and any data validation should be done. Usually the only params that need to be extracted are those related to the ACI object configuration and its child configuration. If you have integer objects that you would like to validate, then the validation should be done here, and the ``ACIModule.payload()`` method will handle the string conversion." +#~ msgstr "AnsibleModule オブジェクトãŒé–‹å§‹ã•ã‚ŒãŸã‚‰ã€å¿…è¦ãªãƒ‘ラメーターã®å€¤ã‚’ ``params`` ã‹ã‚‰æŠ½å‡ºã—ã€ãƒ‡ãƒ¼ã‚¿ã®æ¤œè¨¼ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚通常ã€æŠ½å‡ºã™ã‚‹å¿…è¦ãŒã‚る唯一ã®ãƒ‘ラメーター㌠ACI オブジェクトã®è¨å®šãŠã‚ˆã³ãã®åè¨å®šã«é–¢é€£ã™ã‚‹ãƒ‘ラメーターã®ã¿ã¨ãªã‚Šã¾ã™ã€‚検証ã™ã‚‹æ•´æ•°ã‚ªãƒ–ジェクトãŒã‚ã‚‹å ´åˆã¯ã€æ¤œè¨¼ã‚’è¡Œã†å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚データ検証ã¯ã“ã“ã§è¡Œã†å¿…è¦ãŒã‚ã‚Šã€``ACIModule.payload()`` メソッドã¯å¤‰æ›æ–‡å—列を処ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Using the ACIModule object" +#~ msgstr "ACIModule オブジェクトã®ä½¿ç”¨" + +#~ msgid "The ACIModule class handles most of the logic for the ACI modules. The ACIModule extends functionality to the AnsibleModule object, so the module instance must be passed into the class instantiation." +#~ msgstr "ACIModule クラスã¯ã€ACI モジュールã®ãƒã‚¸ãƒƒã‚¯ã®å¤§éƒ¨åˆ†ã‚’処ç†ã—ã¾ã™ã€‚ACIModule ã¯æ©Ÿèƒ½ã‚’ AnsibleModule オブジェクトã«æ‹¡å¼µã™ã‚‹ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã‚’クラスã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹åŒ–ã«æ¸¡ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "The ACIModule has six main methods that are used by the modules:" +#~ msgstr "ACIModule ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã‚‹ 6 ã¤ã®ä¸»ãªãƒ¡ã‚½ãƒƒãƒ‰ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "construct_url" +#~ msgstr "construct_url" + +#~ msgid "get_existing" +#~ msgstr "get_existing" + +#~ msgid "payload" +#~ msgstr "payload" + +#~ msgid "get_diff" +#~ msgstr "get_diff" + +#~ msgid "post_config" +#~ msgstr "post_config" + +#~ msgid "delete_config" +#~ msgstr "delete_config" + +#~ msgid "The first two methods are used regardless of what value is passed to the ``state`` parameter." +#~ msgstr "最åˆã® 2 ã¤ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€``state`` パラメーターã«æ¸¡ã•ã‚Œã‚‹å€¤ã«é–¢ä¿‚ãªã使用ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "Constructing URLs" +#~ msgstr "URL ã®æ§‹ç¯‰" + +#~ msgid "The ``construct_url()`` method is used to dynamically build the appropriate URL to interact with the object, and the appropriate filter string that should be appended to the URL to filter the results." +#~ msgstr "``construct_url()`` メソッドã¯ã€ã‚ªãƒ–ジェクトã¨å¯¾è©±ã™ã‚‹ãŸã‚ã«é©åˆ‡ãª URL ã¨ã€URL ã«è¿½åŠ ã—ã¦çµæžœã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’è¨å®šã™ã‚‹é©åˆ‡ãªãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列を動的ã«æ§‹ç¯‰ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "When the ``state`` is not ``query``, the URL is the base URL to access the APIC plus the distinguished name to access the object. The filter string will restrict the returned data to just the configuration data." +#~ msgstr "``state`` ㌠``query`` ã§ãªã„å ´åˆã€URL 㯠APIC ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãƒ™ãƒ¼ã‚¹ URL ã¨ã€ã‚ªãƒ–ジェクトã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãŸã‚ã®è˜åˆ¥åã§ã™ã€‚フィルター文å—列ã¯è¿”ã•ã‚ŒãŸãƒ‡ãƒ¼ã‚¿ã‚’è¨å®šãƒ‡ãƒ¼ã‚¿ã«ã®ã¿åˆ¶é™ã—ã¾ã™ã€‚" + +#~ msgid "When ``state`` is ``query``, the URL and filter string used depends on what parameters are passed to the object. This method handles the complexity so that it is easier to add new modules and so that all modules are consistent in what type of data is returned." +#~ msgstr "``state`` ㌠``query`` ã•ã‚Œã‚‹å ´åˆã€ä½¿ç”¨ã•ã‚Œã‚‹ URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列ã¯ã€ã‚ªãƒ–ジェクトã«æ¸¡ã•ã‚Œã‚‹ãƒ‘ラメーターã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚ã“ã®æ–¹æ³•ã¯è¤‡é›‘性を処ç†ã™ã‚‹ãŸã‚ã€æ–°ã—ã„モジュールã®è¿½åŠ ãŒå®¹æ˜“ã«ãªã‚Šã¾ã™ã€‚ã¾ãŸã€ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã©ã®ã‚¿ã‚¤ãƒ—ã®ãƒ‡ãƒ¼ã‚¿ã‚’è¿”ã™ã‹ã«ä¸€è²«æ€§ã‚’æŒãŸã›ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" + +#~ msgid "Our design goal is to take all ID parameters that have values, and return the most specific data possible. If you do not supply any ID parameters to the task, then all objects of the class will be returned. If your task does consist of ID parameters sed, then the data for the specific object is returned. If a partial set of ID parameters are passed, then the module will use the IDs that are passed to build the URL and filter strings appropriately." +#~ msgstr "ã“ã®è¨è¨ˆã®ç›®çš„ã¯ã€å€¤ãŒã‚ã‚‹ã™ã¹ã¦ã® ID パラメーターをå–ã‚Šã€æœ€ã‚‚具体的ãªãƒ‡ãƒ¼ã‚¿ã‚’è¿”ã™ã“ã¨ã§ã™ã€‚ID パラメーターをタスクã«æŒ‡å®šã—ãªã„ã¨ã€ã‚¯ãƒ©ã‚¹ã®ã™ã¹ã¦ã®ã‚ªãƒ–ジェクトãŒè¿”ã•ã‚Œã¾ã™ã€‚タスク㌠ID パラメーター sed ã§æ§‹æˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ç‰¹å®šã®ã‚ªãƒ–ジェクトã®ãƒ‡ãƒ¼ã‚¿ãŒè¿”ã•ã‚Œã¾ã™ã€‚ID パラメーターã®ä¸€éƒ¨ãŒæ¸¡ã•ã‚Œã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列をé©åˆ‡ã«ãƒ“ルドã™ã‚‹ãŸã‚ã«æ¸¡ã•ã‚ŒãŸ ID を使用ã—ã¾ã™ã€‚" + +#~ msgid "The ``construct_url()`` method takes 2 required arguments:" +#~ msgstr "``construct_url()`` メソッドã¯ã€å¿…è¦ãªå¼•æ•°ã‚’ 2 ã¤å–ã‚Šã¾ã™ã€‚" + +#~ msgid "**self** - passed automatically with the class instance" +#~ msgstr "**self** - クラスインスタンスã§è‡ªå‹•çš„ã«æ¸¡ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "**root_class** - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" +#~ msgstr "**root_class**: ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" + +#~ msgid "**aci_class**: The name of the class used by the APIC, for example ``fvTenant``" +#~ msgstr "**aci_class**: APIC ãŒä½¿ç”¨ã™ã‚‹ã‚¯ãƒ©ã‚¹å (例: ``fvTenant``)" + +#~ msgid "**aci_rn**: The relative name of the object, for example ``tn-ACME``" +#~ msgstr "**aci_rn**: オブジェクトã®ç›¸å¯¾å (例: ``tn-ACME``)" + +#~ msgid "**target_filter**: A dictionary with key-value pairs that make up the query string for selecting a subset of entries, for example ``{'name': 'ACME'}``" +#~ msgstr "**target_filter**: エントリーã®ã‚µãƒ–セットをé¸æŠžã™ã‚‹ã‚¯ã‚¨ãƒªãƒ¼æ–‡å—列を構æˆã™ã‚‹ã‚ーã¨å€¤ã®ãƒšã‚¢ã‚’æŒã¤ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ (例: ``{'name': 'ACME'}``)" + +#~ msgid "**module_object**: The particular object for this class, for example ``ACME``" +#~ msgstr "**module_object**: ã“ã®ã‚¯ãƒ©ã‚¹ã®ç‰¹å®šã®ã‚ªãƒ–ジェクト (例: ``ACME``)" + +#~ msgid "Some modules, like ``aci_tenant``, are the root class and so they would not need to pass any additional arguments to the method." +#~ msgstr "``aci_tenant`` ãªã©ã®ä¸€éƒ¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ root クラスã§ã‚ã‚‹ãŸã‚ã€ãƒ¡ã‚½ãƒƒãƒ‰ã«è¿½åŠ ã®å¼•æ•°ã‚’渡ã™å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" + +#~ msgid "The ``construct_url()`` method takes 4 optional arguments, the first three imitate the root class as described above, but are for child objects:" +#~ msgstr "``construct_url()`` メソッドã¯ã€4 ã¤ã®ä»»æ„ã®å¼•æ•°ã‚’å–ã‚Šã¾ã™ã€‚最åˆã® 3 ã¤ã®å¼•æ•°ãŒä¸Šè¨˜ã®ã‚ˆã†ã« root クラスを模倣ã—ã¾ã™ãŒã€ã“ã‚Œã¯åオブジェクト用ã§ã™ã€‚" + +#~ msgid "subclass_1 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" +#~ msgstr "subclass_1 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" + +#~ msgid "Example: Application Profile Class (AP)" +#~ msgstr "例: Application Profile Class (AP)" + +#~ msgid "subclass_2 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" +#~ msgstr "subclass_2 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" + +#~ msgid "Example: End Point Group (EPG)" +#~ msgstr "例: エンドãƒã‚¤ãƒ³ãƒˆã‚°ãƒ«ãƒ¼ãƒ— (EPG)" + +#~ msgid "subclass_3 - A dictionary consisting of ``aci_class``, ``aci_rn``, ``target_filter``, and ``module_object`` keys" +#~ msgstr "subclass_3 - ``aci_class`` ã‚ーã€``aci_rn`` ã‚ーã€``target_filter`` ã‚ーã€ãŠã‚ˆã³ ``module_object`` ã‚ーã§æ§‹æˆã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼" + +#~ msgid "Example: Binding a Contract to an EPG" +#~ msgstr "例: EPG ã¸ã®å¥‘ç´„ã®ãƒã‚¤ãƒ³ãƒ‰" + +#~ msgid "child_classes - The list of APIC names for the child classes supported by the modules." +#~ msgstr "child_classes - モジュールãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹åクラス㮠APIC åã®ãƒªã‚¹ãƒˆ" + +#~ msgid "This is a list, even if it is a list of one" +#~ msgstr "1 ã¤ã®ãƒªã‚¹ãƒˆã§ã‚ã£ã¦ã‚‚ã€ã“ã‚Œã¯ãƒªã‚¹ãƒˆã§ã™ã€‚" + +#~ msgid "These are the unfriendly names used by the APIC" +#~ msgstr "ã“れらã¯ã€APIC ãŒä½¿ç”¨ã™ã‚‹åˆ†ã‹ã‚Šã«ãã„åå‰ã§ã™ã€‚" + +#~ msgid "These are used to limit the returned child_classes when possible" +#~ msgstr "å¯èƒ½ãªå ´åˆã¯ã€è¿”ã•ã‚ŒãŸ child_classes を制é™ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "Example: ``child_classes=['fvRsBDSubnetToProfile', 'fvRsNdPfxPol']``" +#~ msgstr "例: ``child_classes=['fvRsBDSubnetToProfile', 'fvRsNdPfxPol']``" + +#~ msgid "Sometimes the APIC will require special characters ([, ], and -) or will use object metadata in the name (\"vlanns\" for VLAN pools); the module should handle adding special characters or joining of multiple parameters in order to keep expected inputs simple." +#~ msgstr "APIC ã¯ã€ç‰¹æ®Šæ–‡å— ([, ]ã€ãŠã‚ˆã³ -) ã‚’è¦æ±‚ã—ãŸã‚Šã€åå‰ã«ã‚ªãƒ–ジェクトã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ (「VLANã€ãƒ—ールã®å ´åˆã¯ã€Œvlannsã€) を使用ã—ãŸã‚Šã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚モジュールã¯ã€äºˆæƒ³ã•ã‚Œã‚‹å…¥åŠ›ã®å˜ç´”ã•ã«ä¿ã¤ãŸã‚ã«ã€ç‰¹æ®Šæ–‡å—ã®è¿½åŠ ã¾ãŸã¯è¤‡æ•°ã®ãƒ‘ラメーターã®çµåˆã‚’処ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Getting the existing configuration" +#~ msgstr "æ—¢å˜è¨å®šã®å–å¾—" + +#~ msgid "Once the URL and filter string have been built, the module is ready to retrieve the existing configuration for the object:" +#~ msgstr "URL ãŠã‚ˆã³ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼æ–‡å—列ãŒæ§‹ç¯‰ã•ã‚Œã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã‚ªãƒ–ジェクトã®æ—¢å˜ã®è¨å®šã‚’å–å¾—ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚" + +#~ msgid "``state: present`` retrieves the configuration to use as a comparison against what was entered in the task. All values that are different than the existing values will be updated." +#~ msgstr "``state: present`` ã¯ã€ã‚¿ã‚¹ã‚¯ã«å…¥åŠ›ã—ãŸå€¤ã¨æ¯”較ã¨ã—ã¦ä½¿ç”¨ã™ã‚‹è¨å®šã‚’å–å¾—ã—ã¾ã™ã€‚æ—¢å˜ã®å€¤ã¨ã¯ç•°ãªã‚‹å€¤ã¯ã™ã¹ã¦æ›´æ–°ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "``state: absent`` uses the existing configuration to see if the item exists and needs to be deleted." +#~ msgstr "``state: absent`` ã¯ã€æ—¢å˜ã®è¨å®šã‚’使用ã—ã¦é …ç›®ãŒå˜åœ¨ã—ã€å‰Šé™¤ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" + +#~ msgid "``state: query`` uses this to perform the query for the task and report back the existing data." +#~ msgstr "``state: query`` ã¯ã€ã“れを使用ã—ã¦ã‚¿ã‚¹ã‚¯ã®ã‚¯ã‚¨ãƒªãƒ¼ã‚’実行ã—ã€æ—¢å˜ã®ãƒ‡ãƒ¼ã‚¿ã‚’å ±å‘Šã—ã¾ã™ã€‚" + +#~ msgid "When state is present" +#~ msgstr "state ㌠present ã®å ´åˆ" + +#~ msgid "When ``state: present``, the module needs to perform a diff against the existing configuration and the task entries. If any value needs to be updated, then the module will make a POST request with only the items that need to be updated. Some modules have children that are in a 1-to-1 relationship with another object; for these cases, the module can be used to manage the child objects." +#~ msgstr "``state: present`` ã®å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯æ—¢å˜ã®è¨å®šã¨ã‚¿ã‚¹ã‚¯ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã«å¯¾ã—㦠diff を実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚値を更新ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯æ›´æ–°ãŒå¿…è¦ãªã‚¢ã‚¤ãƒ†ãƒ ã®ã¿ãŒå«ã¾ã‚Œã‚‹ POST è¦æ±‚ã‚’è¡Œã„ã¾ã™ã€‚モジュールã«ã‚ˆã£ã¦ã¯ã€åˆ¥ã®ã‚ªãƒ–ジェクト㨠1 対 1 ã®é–¢ä¿‚ã«ã‚ã‚‹åãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯åオブジェクトを管ç†ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" + +#~ msgid "Building the ACI payload" +#~ msgstr "ACI ペイãƒãƒ¼ãƒ‰ã®æ§‹ç¯‰" + +#~ msgid "The ``aci.payload()`` method is used to build a dictionary of the proposed object configuration. All parameters that were not provided a value in the task will be removed from the dictionary (both for the object and its children). Any parameter that does have a value will be converted to a string and added to the final dictionary object that will be used for comparison against the existing configuration." +#~ msgstr "``aci.payload()`` メソッドã¯ã€æ案ã•ã‚ŒãŸã‚ªãƒ–ジェクトè¨å®šã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼æ§‹ç¯‰ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚タスクã§å€¤ãŒæä¾›ã•ã‚Œã¦ã„ãªã„パラメーターã¯ã™ã¹ã¦ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ (オブジェクトã¨ãã®åã®ä¸¡æ–¹) ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚値ã®ã‚るパラメーターã¯æ–‡å—列ã«å¤‰æ›ã•ã‚Œã€æ—¢å˜ã®è¨å®šã¨ã®æ¯”較ã«ä½¿ç”¨ã•ã‚Œã‚‹æœ€çµ‚ディクショナリーオブジェクトã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "The ``aci.payload()`` method takes two required arguments and 1 optional argument, depending on if the module manages child objects." +#~ msgstr "``aci.payload()`` メソッドã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒåオブジェクトを管ç†ã™ã‚‹ã‹ã©ã†ã‹ã«å¿œã˜ã¦ã€2 ã¤ã®å¿…é ˆå¼•æ•°ã¨ã€1 ã¤ã®ä»»æ„ã®å¼•æ•°ã‚’å–ã‚Šã¾ã™ã€‚" + +#~ msgid "``aci_class`` is the APIC name for the object's class, for example ``aci_class='fvBD'``" +#~ msgstr "``aci_class`` ã¯ã€ã‚ªãƒ–ジェクトã®ã‚¯ãƒ©ã‚¹ã® APIC åã§ã™ã€‚ãŸã¨ãˆã°ã€``aci_class='fvBD'`` ã«ãªã‚Šã¾ã™ã€‚" + +#~ msgid "``class_config`` is the appropriate dictionary to be used as the payload for the POST request" +#~ msgstr "``class_config`` 㯠POST è¦æ±‚ã®ãƒšã‚¤ãƒãƒ¼ãƒ‰ã¨ã—ã¦ä½¿ç”¨ã™ã‚‹é©åˆ‡ãªãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã™ã€‚" + +#~ msgid "The keys should match the names used by the APIC." +#~ msgstr "ã‚ー㯠APIC ã§ä½¿ç”¨ã•ã‚Œã‚‹åå‰ã¨ä¸€è‡´ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "The values should be the corresponding value in ``module.params``; these are the variables defined above" +#~ msgstr "``module.params`` ã®å¯¾å¿œã™ã‚‹å€¤ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。ã“れらã¯ä¸Šã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã§ã™" + +#~ msgid "``child_configs`` is optional, and is a list of child config dictionaries." +#~ msgstr "``child_configs`` ã¯ä»»æ„ã§ã‚ã‚Šã€åè¨å®šã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ä¸€è¦§ã§ã™ã€‚" + +#~ msgid "The child configs include the full child object dictionary, not just the attributes configuration portion." +#~ msgstr "åè¨å®šã«ã¯ã€å±žæ€§è¨å®šéƒ¨åˆ†ã ã‘ã§ãªãã€å®Œå…¨ãªåオブジェクトディクショナリーãŒå«ã¾ã‚Œã¾ã™ã€‚" + +#~ msgid "The configuration portion is built the same way as the object." +#~ msgstr "è¨å®šéƒ¨åˆ†ã¯ã€ã‚ªãƒ–ジェクトã¨åŒã˜æ–¹æ³•ã§æ§‹ç¯‰ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "Performing the request" +#~ msgstr "è¦æ±‚ã®å®Ÿè¡Œ" + +#~ msgid "The ``get_diff()`` method is used to perform the diff, and takes only one required argument, ``aci_class``. Example: ``aci.get_diff(aci_class='fvBD')``" +#~ msgstr "``get_diff()`` メソッド㯠diff を実行ã—ã€å¿…è¦ãªå¼•æ•° ``aci_class`` ã‚’ 1 ã¤ã ã‘å–ã‚Šã¾ã™ã€‚ãŸã¨ãˆã° ``aci.get_diff(aci_class='fvBD')`` ã§ã™ã€‚" + +#~ msgid "The ``post_config()`` method is used to make the POST request to the APIC if needed. This method doesn't take any arguments and handles check mode. Example: ``aci.post_config()``" +#~ msgstr "``post_config()`` メソッドã¯ã€å¿…è¦ã«å¿œã˜ã¦ APIC ã¸ã® POST è¦æ±‚ã‚’è¡Œã†ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯å¼•æ•°ã‚’å—ã‘付ã‘ãšã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’処ç†ã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``aci.post_config()`` ã«ãªã‚Šã¾ã™ã€‚" + +#~ msgid "Example code" +#~ msgstr "サンプルコード" + +#~ msgid "When state is absent" +#~ msgstr "state ㌠absent ã®å ´åˆ" + +#~ msgid "If the task sets the state to absent, then the ``delete_config()`` method is all that is needed. This method does not take any arguments, and handles check mode." +#~ msgstr "タスク㌠state ã‚’ absent ã«è¨å®šã™ã‚‹ã¨ã€``delete_config()`` メソッドã®ã¿ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯å¼•æ•°ã‚’å–らãšã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’処ç†ã—ã¾ã™ã€‚" + +#~ msgid "To have the module exit, call the ACIModule method ``exit_json()``. This method automatically takes care of returning the common return values for you." +#~ msgstr "モジュールを終了ã™ã‚‹ã«ã¯ã€ACIModule メソッド ``exit_json()`` を呼ã³å‡ºã—ã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ä¸€èˆ¬çš„ãªæˆ»ã‚Šå€¤ã‚’è¿”ã™ã“ã¨ã‚’自動的ã«è¡Œã„ã¾ã™ã€‚" + +#~ msgid "Testing ACI library functions" +#~ msgstr "ACI ライブラリー関数ã®ãƒ†ã‚¹ãƒˆ" + +#~ msgid "You can test your ``construct_url()`` and ``payload()`` arguments without accessing APIC hardware by using the following python script:" +#~ msgstr "以下㮠python スクリプトを使用ã—ã¦ã€APIC ãƒãƒ¼ãƒ‰ã‚¦ã‚§ã‚¢ã«ã‚¢ã‚¯ã‚»ã‚¹ã›ãšã« ``construct_url()`` 引数ãŠã‚ˆã³ ``payload()`` 引数をテストã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#~ msgid "This will result in:" +#~ msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ä»¥ä¸‹ãŒç”Ÿæˆã•ã‚Œã¾ã™ã€‚" + +#~ msgid "Testing for sanity checks" +#~ msgstr "å¥å…¨æ€§ãƒã‚§ãƒƒã‚¯ã®ãƒ†ã‚¹ãƒˆ" + +#~ msgid "For legacy versions of ansible, you can run from your fork something like:" +#~ msgstr "Ansible ã®ãƒ¬ã‚¬ã‚·ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€æ¬¡ã®ã‚ˆã†ãªãƒ•ã‚©ãƒ¼ã‚¯ã‹ã‚‰å®Ÿè¡Œã§ãã¾ã™ã€‚" + +#~ msgid "Meanwhile, the ACI modules have moved into a collection. Please refer to the links below, which provide detailed guidance how to setup your environment and test the collection." +#~ msgstr "ACI モジュールã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»å‹•ã—ã¾ã—ãŸã€‚以下ã®ãƒªãƒ³ã‚¯ã‚’å‚ç…§ã—ã¦ãã ã•ã„。環境をè¨å®šã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’テストã™ã‚‹æ–¹æ³•ã®è©³ç´°ãªã‚¬ã‚¤ãƒ€ãƒ³ã‚¹ãŒè¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" + +#~ msgid "Information how to setup your environment to contribute to collections" +#~ msgstr "環境をè¨å®šã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«è²¢çŒ®ã™ã‚‹æ–¹æ³•" + +#~ msgid "Information on how to build sanity tests." +#~ msgstr "å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’構築ã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±" + +#~ msgid "You can run this:" +#~ msgstr "以下を実行ã§ãã¾ã™ã€‚" + +#~ msgid "You may need to add ``--python 2.7`` or ``--python 3.6`` in order to use the correct python version for performing tests." +#~ msgstr "テストã®å®Ÿè¡Œã«é©åˆ‡ãª python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã™ã‚‹ã«ã¯ã€``--python 2.7`` ã¾ãŸã¯ ``--python 3.6`` ã‚’è¿½åŠ ã—ãªã„ã¨ã„ã‘ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "You may want to edit the used inventory at *test/integration/inventory.networking* and add something like:" +#~ msgstr "*test/integration/inventory.networking* ã§ä½¿ç”¨ã•ã‚ŒãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’編集ã—ã€ä»¥ä¸‹ã®ã‚ˆã†ã«è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" + +#~ msgid "Information on how to build integration tests." +#~ msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã®æ§‹ç¯‰æ–¹æ³•ã«é–¢ã™ã‚‹æƒ…å ±ã€‚" + +#~ msgid "Testing for test coverage" +#~ msgstr "テストカãƒãƒ¬ãƒ¼ã‚¸ã®ãƒ†ã‚¹ãƒˆ" + +#~ msgid "Add the following to the new playbook file::" +#~ msgstr "以下を新ã—ã„ Playbook ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" + +#~ msgid "At present, the Ansiballz Framework cannot determine whether an import should be included if it is a relative import. Always use an absolute import that has :py:mod:`ansible.module_utils` in it to allow Ansiballz to determine that the file should be included." +#~ msgstr "ç¾çŠ¶ã€Aweraiballz Framework ã¯ã€ç›¸å¯¾ã‚¤ãƒ³ãƒãƒ¼ãƒˆã®å ´åˆã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚‹ã‹ã©ã†ã‹ã‚’判別ã§ãã¾ã›ã‚“。常ã«ã€ãã®ä¸ã« :py:mod:`ansible.module_utils` ãŒã‚る絶対インãƒãƒ¼ãƒˆã‚’使用ã—ã¦ã€ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åŒæ¢±ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã¨åˆ¤æ–ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#~ msgid "Boolean. Set to True whenever a parameter in a task or play specifies ``no_log``. Any module that calls :py:meth:`AnsibleModule.log` handles this automatically. If a module implements its own logging then it needs to check this value. To access in a module, instantiate an ``AnsibleModule`` and then check the value of :attr:`AnsibleModule.no_log`." +#~ msgstr "ブール値。タスクã¾ãŸã¯ãƒ—レイã®ãƒ‘ラメーターを ``no_log`` ã«æŒ‡å®šã—ãŸå ´åˆã¯å¸¸ã« True ã«è¨å®šã—ã¾ã™ã€‚:py:meth:`AnsibleModule.log` を呼ã³å‡ºã™ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒè‡ªå‹•çš„ã«ã“れを処ç†ã—ã¾ã™ã€‚モジュールãŒãã®ç‹¬è‡ªã®ãƒã‚®ãƒ³ã‚°ã‚’実装ã—ãŸå ´åˆã¯ã€ã“ã®å€¤ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule.no_log` ã®å€¤ã‚’確èªã—ã¾ã™ã€‚" + +#~ msgid "Boolean. Turns more verbose logging on or off and turns on logging of external commands that the module executes. If a module uses :py:meth:`AnsibleModule.debug` rather than :py:meth:`AnsibleModule.log` then the messages are only logged if ``_ansible_debug`` is set to ``True``. To set, add ``debug: True`` to :file:`ansible.cfg` or set the environment variable :envvar:`ANSIBLE_DEBUG`. To access in a module, instantiate an ``AnsibleModule`` and access :attr:`AnsibleModule._debug`." +#~ msgstr "ブール値。詳細ãªãƒã‚®ãƒ³ã‚°ã‚’オンã¾ãŸã¯ã‚ªãƒ•ã«ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå®Ÿè¡Œã™ã‚‹å¤–部コマンドã®ãƒã‚®ãƒ³ã‚°ã‚’有効ã«ã—ã¾ã™ã€‚モジュール㌠:py:meth:`AnsibleModule.log` ã§ã¯ãªã :py:meth:`AnsibleModule.debug` を使用ã™ã‚‹å ´åˆã¯ã€``_ansible_debug`` ㌠``True`` ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã®ã¿ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒãƒã‚°ã«è¨˜éŒ²ã•ã‚Œã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€``debug: True`` ã‚’ :file:`ansible.cfg` ã«è¿½åŠ ã™ã‚‹ã‹ã€ç’°å¢ƒå¤‰æ•° :envvar:`ANSIBLE_DEBUG` ã‚’è¨å®šã—ã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``AnsibleModule`` をインスタンス化ã—ã€:attr:`AnsibleModule._debug` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¾ã™ã€‚" + +#~ msgid "Boolean. If a module supports it, tells the module to show a unified diff of changes to be made to templated files. To set, pass the ``--diff`` command line option. To access in a module, instantiate an `AnsibleModule` and access :attr:`AnsibleModule._diff`." +#~ msgstr "ブール値。モジュールãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹å ´åˆã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å¯¾ã—ã€ãƒ†ãƒ³ãƒ—レート化ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ã«åŠ ãˆã‚‰ã‚ŒãŸå¤‰æ›´ã®å·®ç•°ã‚’çµ±åˆã™ã‚‹ã‚ˆã†ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æŒ‡ç¤ºã—ã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€``--diff`` コマンドラインオプションを渡ã—ã¾ã™ã€‚モジュールã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€`AnsibleModule` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule._diff` ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ã¦ãã ã•ã„。" + +#~ msgid "Unused. This value could be used for finer grained control over logging." +#~ msgstr "未使用。ã“ã®å€¤ã¯ã€ãƒã‚°ã‚’より細ã‹ã制御ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" + +#~ msgid "List. Names of filesystems which should have a special SELinux context. They are used by the `AnsibleModule` methods which operate on files (changing attributes, moving, and copying). To set, add a comma separated string of filesystem names in :file:`ansible.cfg`:" +#~ msgstr "一覧。特別㪠SELinux コンテã‚ストをæŒã¤å¿…è¦ãŒã‚るファイルシステムã®åå‰ã€‚åå‰ã¯ãƒ•ã‚¡ã‚¤ãƒ« (属性ã®å¤‰æ›´ã€ç§»å‹•ã€ã‚³ãƒ”ー) ã§æ“作ã™ã‚‹ `AnsibleModule` メソッドã«ã‚ˆã£ã¦ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€:file:`ansible.cfg` ã«ã€ãƒ•ã‚¡ã‚¤ãƒ«åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®æ–‡å—åˆ—ã‚’è¿½åŠ ã—ã¾ã™ã€‚" + +#~ msgid "This replaces :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` from :ref:`module_replacer`. In module replacer it was a comma separated string of filesystem names. Under Ansiballz it's an actual list." +#~ msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€:ref:`module_replacer` ã® :attr:`ansible.module_utils.basic.SELINUX_SPECIAL_FS` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚モジュール置æ›ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«åã®ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®æ–‡å—列ã§ã—ãŸã€‚Ansiballz ã¯ã€å®Ÿéš›ã®ãƒªã‚¹ãƒˆã«ãªã‚Šã¾ã™ã€‚" + +#~ msgid "This parameter controls which syslog facility Ansible module logs to. To set, change the ``syslog_facility`` value in :file:`ansible.cfg`. Most modules should just use :meth:`AnsibleModule.log` which will then make use of this. If a module has to use this on its own, it should instantiate an `AnsibleModule` and then retrieve the name of the syslog facility from :attr:`AnsibleModule._syslog_facility`. The Ansiballz code is less hacky than the old :ref:`module_replacer` code:" +#~ msgstr "ã“ã®ãƒ‘ラメーターã¯ã€Ansible モジュールãŒã©ã® syslog 機能ã«ãƒã‚°ã‚’記録ã™ã‚‹ã‹ã‚’制御ã—ã¾ã™ã€‚è¨å®šã™ã‚‹ã«ã¯ã€:file:`ansible.cfg` ã® ``syslog_facility`` ã®å€¤ã‚’変更ã—ã¾ã™ã€‚多ãã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã“れを利用ã™ã‚‹ :meth:`AnsibleModule.log` ã®ã¿ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚モジュールãŒç‹¬è‡ªã«ã“れを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€`AnsibleModule` をインスタンス化ã—ã¦ã€:attr:`AnsibleModule._syslog_facility` ã‹ã‚‰ syslog 機能ã®åå‰ã‚’å–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Ansiballz コードã¯å¤ã„ :ref:`module_replacer` コードよりもãƒãƒƒã‚ングã•ã‚Œã¾ã›ã‚“。" + +#~ msgid "This parameter passes the version of Ansible that runs the module. To access it, a module should instantiate an `AnsibleModule` and then retrieve it from :attr:`AnsibleModule.ansible_version`. This replaces :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` from :ref:`module_replacer`." +#~ msgstr "ã“ã®ãƒ‘ラメーターã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã™ã‚‹ Ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’渡ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãŸã‚ã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ `AnsibleModule` をインスタンス化ã—ã€:attr:`AnsibleModule.ansible_version` ã‹ã‚‰å–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€:ref:`module_replacer` ã® :attr:`ansible.module_utils.basic.ANSIBLE_VERSION` ã‚’ç½®ãæ›ãˆã¾ã™ã€‚" + +#~ msgid "Guidelines for Ansible Amazon AWS module development" +#~ msgstr "Ansible Amazon AWS モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" + +#~ msgid "This guide has moved to :ref:`ansible_collections.amazon.aws.docsite.dev_guide_intro`." +#~ msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.amazon.aws.docsite.dev_guide_intro` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" + +#~ msgid "OpenStack Ansible Modules" +#~ msgstr "OpenStack Ansible モジュール" + +#~ msgid "Please see the `OpenStack guidelines <https://opendev.org/openstack/ansible-collections-openstack/src/branch/master/docs/openstack_guidelines.rst>`_, for further information." +#~ msgstr "詳細ã¯ã€`OpenStack ガイドライン <https://opendev.org/openstack/ansible-collections-openstack/src/branch/master/docs/openstack_guidelines.rst>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "oVirt Ansible Modules" +#~ msgstr "oVirt Ansible モジュール" + +#~ msgid "Guidelines for VMware module development" +#~ msgstr "VMware モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" + +#~ msgid "This guide has moved to :ref:`ansible_collections.community.vmware.docsite.vmware_ansible_devguide`." +#~ msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.community.vmware.docsite.vmware_ansible_devguide` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" + +#~ msgid "Guidelines for VMware REST module development" +#~ msgstr "VMware REST モジュール開発ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³" + +#~ msgid "This guide has moved to :ref:`ansible_collections.vmware.vmware_rest.docsite.vmware_rest_devguide`." +#~ msgstr "ã“ã®ã‚¬ã‚¤ãƒ‰ã¯ :ref:`ansible_collections.vmware.vmware_rest.docsite.vmware_rest_devguide` ã«ç§»å‹•ã—ã¾ã—ãŸã€‚" + +#~ msgid "Test python code against a variety of Python versions." +#~ msgstr "ã•ã¾ã–ã¾ãª Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã—㦠python コードをテストã—ã¾ã™ã€‚" + +#~ msgid "Example::" +#~ msgstr "例:" + +#~ msgid "See :ref:`testing_compile` for more information." +#~ msgstr "詳細ã¯ã€ã€Œ:ref:`testing_compile`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Ansible allows unchecked imports of some libraries from specific directories, listed at the bottom of this section. Import all other Python libraries in a try/except ImportError block to support sanity tests such as ``validate-modules`` and to allow Ansible to give better error messages to the user. To import a library in a try/except ImportError block:" +#~ msgstr "Ansible ã§ã¯ã€ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸‹éƒ¨ã«è¨˜è¼‰ã•ã‚Œã¦ã„る特定ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‹ã‚‰ã€ã„ãã¤ã‹ã®ãƒ©ã‚¤ãƒ–ラリーを確èªã›ãšã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚``validate-modules`` ãªã©ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã‚’サãƒãƒ¼ãƒˆã—ã€Ansible ãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã«é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’表示ã§ãるよã†ã«ã™ã‚‹ãŸã‚ã€try/except ImportError ブãƒãƒƒã‚¯ã§ä»–ã®ã™ã¹ã¦ã® Python ライブラリーをインãƒãƒ¼ãƒˆã—ã¾ã™ã€‚try/except ImportError ブãƒãƒƒã‚¯ã§ãƒ©ã‚¤ãƒ–ラリをインãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€æ¬¡ã‚’è¡Œã„ã¾ã™ã€‚" + +#~ msgid "See :ref:`testing_pep8` for more information." +#~ msgstr "詳細ã¯ã€ã€Œ:ref:`testing_pep8`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Compile tests check source files for valid syntax on all supported python versions:" +#~ msgstr "コンパイルテストã§ã¯ã€ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã® python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã€ã‚½ãƒ¼ã‚¹ãƒ•ã‚¡ã‚¤ãƒ«ã®æ§‹æ–‡ãŒæœ‰åŠ¹ã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" + +#~ msgid "2.4 (Ansible 2.3 only)" +#~ msgstr "2.4 (Ansible 2.3 ã®ã¿)" + +#~ msgid "2.6" +#~ msgstr "2.6" + +#~ msgid "NOTE: In Ansible 2.4 and earlier the compile test was provided by a dedicated sub-command ``ansible-test compile`` instead of a sanity test using ``ansible-test sanity --test compile``." +#~ msgstr "注記: Ansible 2.4 以å‰ã§ã¯ã€``ansible-test sanity --test compile`` を使用ã™ã‚‹å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®ä»£ã‚ã‚Šã«ã€ã‚³ãƒ³ãƒ‘イルテストãŒå°‚用ã®ã‚µãƒ–コマンド ``ansible-test compile`` ã«ã‚ˆã£ã¦æä¾›ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" + +#~ msgid "Running compile tests locally" +#~ msgstr "ãƒãƒ¼ã‚«ãƒ«ã§ã®ã‚³ãƒ³ãƒ‘イルテストã®å®Ÿè¡Œ" + +#~ msgid "Compile tests can be run across the whole code base by doing:" +#~ msgstr "コンパイルテストを実行ã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚ˆã†ã«ã€ã‚³ãƒ¼ãƒ‰ãƒ™ãƒ¼ã‚¹å…¨ä½“ã§ãƒ†ã‚¹ãƒˆã‚’実行ã§ãã¾ã™ã€‚" + +#~ msgid "For advanced usage see the help:" +#~ msgstr "高度ãªä½¿ç”¨æ–¹æ³•ã¯ã€ãƒ˜ãƒ«ãƒ—ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "``ansible-test`` has a number of dependencies , for ``compile`` tests we suggest running the tests with ``--local``, which is the default" +#~ msgstr "``ansible-test`` ã«ã¯ã„ãã¤ã‹ã®ä¾å˜é–¢ä¿‚ãŒã‚ã‚Šã¾ã™ã€‚``compile`` テストã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚ã‚‹ ``--local`` を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "The dependencies can be installed using the ``--requirements`` argument. For example:" +#~ msgstr "ä¾å˜é–¢ä¿‚ã¯ã€``--requirements`` 引数を使用ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" + +#~ msgid "The full list of requirements can be found at `test/lib/ansible_test/_data/requirements <https://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/_data/requirements>`_. Requirements files are named after their respective commands. See also the `constraints <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/requirements/constraints.txt>`_ applicable to all commands." +#~ msgstr "è¦ä»¶ã®ä¸€è¦§ã¯ `test/lib/ansible_test/_data/requirements <https://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/_data/requirements>`_ ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€å„コマンドã«ã¡ãªã‚“ã§åå‰ãŒä»˜ã‘られã¦ã„ã¾ã™ã€‚全コマンドã«é©ç”¨ã•ã‚Œã‚‹ `制約 <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/requirements/constraints.txt>`_ ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Extending compile tests" +#~ msgstr "コンパイルテストã®æ‹¡å¼µ" + +#~ msgid "If you believe changes are needed to the compile tests please add a comment on the `Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ so it can be discussed." +#~ msgstr "コンパイルテストã«å¤‰æ›´ãŒå¿…è¦ãªå ´åˆã¯ã€`Testing Working Group Agenda <https://github.com/ansible/community/blob/main/meetings/README.md>`_ ã«ã‚³ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¦ãã ã•ã„。ãã®å†…容ã«ã¤ã„ã¦è©±ã—åˆã†ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#~ msgid "Legacy Cloud Tests" +#~ msgstr "レガシーã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ†ã‚¹ãƒˆ" + +#~ msgid "Some of the cloud tests run as normal integration tests, and others run as legacy tests; see the :ref:`testing_integration_legacy` page for more information." +#~ msgstr "一部ã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ†ã‚¹ãƒˆã¯é€šå¸¸ã®çµ±åˆãƒ†ã‚¹ãƒˆã¨ã—ã¦å®Ÿè¡Œã—ã€ãã®ä»–ã¯ãƒ¬ã‚¬ã‚·ãƒ¼ãƒ†ã‚¹ãƒˆã¨ã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`testing_integration_legacy`ã€ã®ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Testing using the Legacy Integration system" +#~ msgstr "レガシー統åˆã‚·ã‚¹ãƒ†ãƒ を使用ã—ãŸãƒ†ã‚¹ãƒˆ" + +#~ msgid "This page details how to run the integration tests that haven't been ported to the new ``ansible-test`` framework." +#~ msgstr "ã“ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€æ–°ã—ã„ ``ansible-test`` フレームワークã«ç§»æ¤ã•ã‚Œã¦ã„ãªã„çµ±åˆãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œæ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" + +#~ msgid "The following areas are still tested using the legacy ``make tests`` command:" +#~ msgstr "以下ã®ã‚¨ãƒªã‚¢ã¯ã€ãƒ¬ã‚¬ã‚·ãƒ¼ã® ``make tests`` コマンドを使用ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã™ã€‚" + +#~ msgid "amazon (some)" +#~ msgstr "amazon (一部)" + +#~ msgid "azure" +#~ msgstr "azure" + +#~ msgid "cloudflare" +#~ msgstr "cloudflare" + +#~ msgid "cloudscale" +#~ msgstr "cloudscale" + +#~ msgid "cloudstack" +#~ msgstr "cloudstack" + +#~ msgid "consul" +#~ msgstr "consul" + +#~ msgid "exoscale" +#~ msgstr "exoscale" + +#~ msgid "gce" +#~ msgstr "gce" + +#~ msgid "jenkins" +#~ msgstr "jenkins" + +#~ msgid "rackspace" +#~ msgstr "rackspace" + +#~ msgid "Over time the above list will be reduced as tests are ported to the ``ansible-test`` framework." +#~ msgstr "テスト㌠``ansible-test`` フレームワークã«ç§»æ¤ã•ã‚Œã‚‹ã¨ã€ä¸Šè¨˜ã®ãƒªã‚¹ãƒˆã¯å¾ã€…ã«å°‘ãªããªã£ã¦ã„ãã¾ã™ã€‚" + +#~ msgid "Running Cloud Tests" +#~ msgstr "クラウドテストã®å®Ÿè¡Œ" + +#~ msgid "Cloud tests exercise capabilities of cloud modules (for example, ec2_key). These are not 'tests run in the cloud' so much as tests that use the cloud modules and are organized by cloud provider." +#~ msgstr "クラウドテストã¯ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (ec2_key ãªã©) ã®æ©Ÿèƒ½ã‚’実行ã—ã¾ã™ã€‚ã“れらã¯ã€ã€Œã‚¯ãƒ©ã‚¦ãƒ‰ã§å®Ÿè¡Œã•ã‚Œã‚‹ãƒ†ã‚¹ãƒˆã€ã§ã¯ãªãã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ã«ã‚ˆã£ã¦ç·¨æˆã•ã‚ŒãŸãƒ†ã‚¹ãƒˆã§ã™ã€‚" + +#~ msgid "Some AWS tests may use environment variables. It is recommended to either unset any AWS environment variables( such as ``AWS_DEFAULT_PROFILE``, ``AWS_SECRET_ACCESS_KEY``, and so on) or be sure that the environment variables match the credentials provided in ``credentials.yml`` to ensure the tests run with consistency to their full capability on the expected account. See `AWS CLI docs <https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_ for information on creating a profile." +#~ msgstr "AWS テストã«ã‚ˆã£ã¦ã¯ã€ç’°å¢ƒå¤‰æ•°ã‚’使用ã™ã‚‹ã‚‚ã®ã‚‚ã‚ã‚Šã¾ã™ã€‚AWS 環境変数 (``AWS_DEFAULT_PROFILE``ã€``AWS_SECRET_ACCESS_KEY`` ãªã©) ã®è¨å®šã‚’解除ã™ã‚‹ã‹ã€ç’°å¢ƒå¤‰æ•°ãŒ ``credentials.yml`` ã§æä¾›ã•ã‚Œã‚‹èªè¨¼æƒ…å ±ã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’確èªã—ã¦ã€äºˆæƒ³ã•ã‚Œã‚‹ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã®å®Œå…¨ãªæ©Ÿèƒ½ã«ä¸€è²«æ€§ã®ã‚るテストãŒå®Ÿè¡Œã•ã‚Œã‚‹ã‚ˆã†ã«ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚プãƒãƒ•ã‚¡ã‚¤ãƒ«ã®ä½œæˆã«é–¢ã™ã‚‹æƒ…å ±ã¯ã€`AWS CLI ドã‚ュメント <https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Subsets of tests may be run by ``#commenting`` out unnecessary roles in the appropriate playbook, such as ``test/integration/amazon.yml``." +#~ msgstr "テストã®ã‚µãƒ–セットã¯ã€é©åˆ‡ãª Playbook ã® ä¸è¦ãªãƒãƒ¼ãƒ«ã‚’ ``#commenting`` ã§ã‚³ãƒ¡ãƒ³ãƒˆã‚¢ã‚¦ãƒˆã™ã‚‹ã“ã¨ã§å®Ÿè¡Œã§ãã¾ã™ (例: ``test/integration/amazon.yml``)。" + +#~ msgid "In order to run cloud tests, you must provide access credentials in a file named ``credentials.yml``. A sample credentials file named ``credentials.template`` is available for syntax help." +#~ msgstr "クラウドテストを実行ã™ã‚‹ã«ã¯ã€``credentials.yml`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚¢ã‚¯ã‚»ã‚¹èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚構文ヘルプã«ã¯ã€``credentials.template`` ã¨åå‰ã®ä»˜ã„ãŸã‚µãƒ³ãƒ—ルèªè¨¼æƒ…å ±ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åˆ©ç”¨ã§ãã¾ã™ã€‚" + +#~ msgid "Provide cloud credentials:" +#~ msgstr "クラウドèªè¨¼ã‚’æä¾›ã—ã¾ã™ã€‚" + +#~ msgid "In order to run some tests, you must provide access credentials in a file named ``credentials.yml``. A sample credentials file named ``credentials.template`` is available for syntax help." +#~ msgstr "ã„ãã¤ã‹ã®ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€``credentials.yml`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚¢ã‚¯ã‚»ã‚¹èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚構文ヘルプã«ã¯ã€``credentials.template`` ã¨åå‰ã®ä»˜ã„ãŸã‚µãƒ³ãƒ—ルèªè¨¼æƒ…å ±ãƒ•ã‚¡ã‚¤ãƒ«ã‚’åˆ©ç”¨ã§ãã¾ã™ã€‚" + +#~ msgid "In order to run the tests in an AWS account ansible needs fairly wide ranging powers which can be provided to a dedicated user or temporary credentials using a specific policy configured in the AWS account." +#~ msgstr "AWS アカウントã§ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã«ã¯ã€Ansible ã«ã€AWS アカウントã§è¨å®šã•ã‚ŒãŸç‰¹å®šã®ãƒãƒªã‚·ãƒ¼ã‚’使用ã—ã¦ã€å°‚用ã®ãƒ¦ãƒ¼ã‚¶ã‚„一時的ãªèªè¨¼æƒ…å ±ã«æä¾›ã§ãã‚‹ã€ã‹ãªã‚Šåºƒç¯„囲ã®æ¨©é™ãŒå¿…è¦ã¨ãªã‚Šã¾ã™ã€‚" + +#~ msgid "testing-iam-policy.json.j2" +#~ msgstr "testing-iam-policy.json.j2" + +#~ msgid "The testing-iam-policy.json.j2 file contains a policy which can be given to the user running the tests to give close to minimum rights required to run the tests. Please note that this does not fully restrict the user; The user has wide privileges for viewing account definitions and is also able to manage some resources that are not related to testing (for example, AWS lambdas with different names) primarily due to the limitations of the Amazon ARN notation. At the very least the policy limits the user to one region, however tests should not be run in a primary production account in any case." +#~ msgstr "testing-iam-policy.json.j2 ファイルã«ã¯ã€ãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ä»˜ä¸Žã™ã‚‹ãƒãƒªã‚·ãƒ¼ãŒå«ã¾ã‚Œã¦ãŠã‚Šã€ãƒ†ã‚¹ãƒˆã®å®Ÿè¡Œã«å¿…è¦ãªæœ€ä½Žé™ã®æ¨©é™ã«è¿‘ã„ã‚‚ã®ã‚’付与ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãªãŠã€ã“ã‚Œã¯å®Œå…¨ãªåˆ¶é™ã§ã¯ãªã„ãŸã‚注æ„ã—ã¦ãã ã•ã„。ã“ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€ã‚¢ã‚«ã‚¦ãƒ³ãƒˆå®šç¾©ã‚’閲覧ã™ã‚‹å¹…広ã„権é™ã‚’æŒã¡ã€ä¸»ã« Amazon ARN 表記ã®åˆ¶é™ã«ã‚ˆã‚Šã€ãƒ†ã‚¹ãƒˆã«é–¢ä¿‚ã®ãªã„一部ã®ãƒªã‚½ãƒ¼ã‚¹ (ãŸã¨ãˆã°ã€ç•°ãªã‚‹åå‰ã® AWS ラムダ) を管ç†ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚å°‘ãªãã¨ã‚‚ã€ã“ã®ãƒãƒªã‚·ãƒ¼ã§ã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’ 1 ã¤ã®ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã«é™å®šã—ã¦ã„ã¾ã™ãŒã€ã„ã‹ãªã‚‹å ´åˆã§ã‚‚ã€ãƒ†ã‚¹ãƒˆã¯å®Ÿç¨¼åƒç’°å¢ƒã®ãƒ—ライマリーアカウントã§å®Ÿè¡Œã™ã¹ãã§ã¯ã‚ã‚Šã¾ã›ã‚“。" + +#~ msgid "The tests are invoked via a ``Makefile``." +#~ msgstr "テスト㯠``Makefile`` 経由ã§å‘¼ã³å‡ºã•ã‚Œã¾ã™ã€‚" + +#~ msgid "If you haven't already got Ansible available use the local checkout by doing:" +#~ msgstr "Ansible ãŒã¾ã 利用å¯èƒ½ã§ãªã„å ´åˆã¯ã€ä»¥ä¸‹ã®æ–¹æ³•ã§ãƒãƒ¼ã‚«ãƒ«ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã‚’使用ã—ã¾ã™ã€‚" + +#~ msgid "Run the tests by doing:" +#~ msgstr "以下を実行ã—ã¦ãƒ†ã‚¹ãƒˆã‚’実行ã—ã¾ã™ã€‚" + +#~ msgid "Possible cost of running cloud tests" +#~ msgstr "クラウドテストã«ã‹ã‹ã‚‹å¯èƒ½æ€§ã®ã‚るコスト" + +#~ msgid "Running cloud integration tests will create and destroy cloud resources. Running these tests may result in additional fees associated with your cloud account. Care is taken to ensure that created resources are removed. However, it is advisable to inspect your AWS console to ensure no unexpected resources are running." +#~ msgstr "クラウド統åˆãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã¨ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒªã‚½ãƒ¼ã‚¹ãŒä½œæˆãŠã‚ˆã³ç ´æ£„ã•ã‚Œã¾ã™ã€‚ã“ã®ã‚ˆã†ãªãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã¨ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã«é–¢é€£ã™ã‚‹è¿½åŠ 料金ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚作æˆã•ã‚ŒãŸãƒªã‚½ãƒ¼ã‚¹ãŒç¢ºå®Ÿã«å‰Šé™¤ã•ã‚Œã‚‹ã‚ˆã†ã«æ³¨æ„ãŒæ‰•ã‚ã‚Œã¾ã™ã€‚ãŸã ã—ã€AWS コンソールを調ã¹ã¦ã€äºˆæœŸã—ãªã„リソースãŒå®Ÿè¡Œã—ã¦ã„ãªã„ã“ã¨ã‚’確èªã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "Run tests locally using ``ansible-test``" +#~ msgstr "``ansible-test`` を使用ã—ã¦ãƒ†ã‚¹ãƒˆã‚’ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã—ã¾ã™ã€‚" + +#~ msgid "Extend" +#~ msgstr "æ‹¡å¼µ" + +#~ msgid "There are no special requirements for running ``ansible-test`` on Python 2.7 or later. The ``argparse`` package is required for Python 2.6. The requirements for each ``ansible-test`` command are covered later." +#~ msgstr "Python 2.7 以é™ã«ã¯ã€``ansible-test`` を実行ã™ã‚‹ãŸã‚ã®ç‰¹åˆ¥ãªè¦ä»¶ãŒã‚ã‚Šã¾ã›ã‚“。Python 2.6 ã«ã¯ ``argparse`` パッケージãŒå¿…è¦ã§ã™ã€‚å„ ``ansible-test`` コマンドã®è¦ä»¶ã¯ã€å¾Œã§èª¬æ˜Žã—ã¾ã™ã€‚" + +#~ msgid "Remote" +#~ msgstr "リモート" + +#~ msgid "Recommended for integration tests." +#~ msgstr "çµ±åˆãƒ†ã‚¹ãƒˆã¸æŽ¨å¥¨äº‹é …" + +#~ msgid "See the `list of supported platforms and versions <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/remote.txt>`_ for additional details." +#~ msgstr "詳細ã¯ã€ã€Œ`サãƒãƒ¼ãƒˆå¯¾è±¡ã®ãƒ—ラットフォームãŠã‚ˆã³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ä¸€è¦§ <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/remote.txt>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Python program to help test or validate Ansible modules." +#~ msgstr "Ansible モジュールã®ãƒ†ã‚¹ãƒˆã¾ãŸã¯æ¤œè¨¼ã«å½¹ç«‹ã¤ Python プãƒã‚°ãƒ©ãƒ 。" + +#~ msgid "``validate-modules`` is one of the ``ansible-test`` Sanity Tests, see :ref:`testing_sanity` for more information." +#~ msgstr "``validate-modules`` ã¯ã€å¥å…¨æ€§ãƒ†ã‚¹ãƒˆ ``ansible-test`` ã®ã„ãšã‚Œã‹ã§ã™ã€‚詳細ã¯ã€ã€Œ:ref:`testing_sanity`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Originally developed by Matt Martz (@sivel)" +#~ msgstr "本プãƒã‚°ãƒ©ãƒ ã¯ã€å…ƒã€… Matt Martz (@sivel) æ°ã«ã‚ˆã‚Šé–‹ç™ºã•ã‚Œã¾ã—ãŸã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/galaxy.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/galaxy.po index dbdb6757..246e8494 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/galaxy.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/galaxy.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/galaxy/dev_guide.rst:5 msgid "Galaxy Developer Guide" @@ -30,7 +30,7 @@ msgstr "Galaxy ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä½œæˆ" #: ../../rst/galaxy/dev_guide.rst:19 msgid "Collections are a distribution format for Ansible content. You can use collections to package and distribute playbooks, roles, modules, and plugins. You can publish and use collections through `Ansible Galaxy <https://galaxy.ansible.com>`_." -msgstr "コレクションã¯ã€Ansible コンテンツã®ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューション形å¼ã§ã™ã€‚コレクションを使用ã—ã¦ã€Playbookã€ãƒãƒ¼ãƒ«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãƒ—ラグインをパッケージ化ãŠã‚ˆã³é…布ã§ãã¾ã™ã€‚`Ansible Galaxy <https://galaxy.ansible.com>`_ を介ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’公開ãŠã‚ˆã³ä½¿ç”¨ã§ãã¾ã™ã€‚" +msgstr "コレクションã¯ã€Ansible コンテンツã®ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューション形å¼ã§ã™ã€‚コレクションを使用ã—ã¦ã€Playbookã€ãƒãƒ¼ãƒ«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãŠã‚ˆã³ãƒ—ラグインをパッケージ化ãŠã‚ˆã³é…布ã§ãã¾ã™ã€‚`Ansible Galaxy <https://galaxy.ansible.com>`_ を介ã—ã¦ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’公開ãŠã‚ˆã³ä½¿ç”¨ã§ãã¾ã™ã€‚" #: ../../rst/galaxy/dev_guide.rst:22 msgid "See :ref:`developing_collections` for details on how to create collections." @@ -101,154 +101,150 @@ msgid "Authenticate with Galaxy" msgstr "Galaxy ã§ã®èªè¨¼" #: ../../rst/galaxy/dev_guide.rst:98 -msgid "Using the ``import``, ``delete`` and ``setup`` commands to manage your roles on the Galaxy website requires authentication, and the ``login`` command can be used to do just that. Before you can use the ``login`` command, you must create an account on the Galaxy website." -msgstr "Galaxy Web サイトã§ãƒãƒ¼ãƒ«ã‚’管ç†ã™ã‚‹ ``import`` コマンドã€``delete`` コマンドã€ãŠã‚ˆã³ ``setup`` コマンドを使用ã™ã‚‹ã«ã¯èªè¨¼ãŒå¿…è¦ã§ã€``login`` コマンドを使用ã—ã¦ã“れを行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚``login`` コマンドを使用ã™ã‚‹å‰ã«ã€Galaxy ã® Web サイトã§ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‚’作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "Using the ``import``, ``delete`` and ``setup`` commands to manage your roles on the Galaxy website requires authentication in the form of an API key, you must create an account on the Galaxy website." +msgstr "Galaxy Web サイトã§ãƒãƒ¼ãƒ«ã‚’管ç†ã™ã‚‹ ``import`` ãŠã‚ˆã³ ``delete``ã€``setup`` コマンドを使用ã™ã‚‹ã«ã¯ã€API ã‚ーã®å½¢å¼ã§ã®èªè¨¼ãŒå¿…è¦ã§ã™ã€‚Galaxy Web サイトã§ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‚’作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/galaxy/dev_guide.rst:100 +msgid "Log in to the Galaxy website and open the `Preferences <https://galaxy.ansible.com/me/preferences>`_ view." +msgstr "Galaxy ã® Web サイトã«ãƒã‚°ã‚¤ãƒ³ã—ã€`Preferences <https://galaxy.ansible.com/me/preferences>` _ ビューを開ãã¾ã™ã€‚" #: ../../rst/galaxy/dev_guide.rst:101 -msgid "The ``login`` command requires using your GitHub credentials. You can use your username and password, or you can create a `personal access token <https://help.github.com/articles/creating-an-access-token-for-command-line-use/>`_. If you choose to create a token, grant minimal access to the token, as it is used just to verify identify." -msgstr "``login`` コマンドã«ã¯ã€GitHub èªè¨¼æƒ…å ±ã‚’ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ユーザーåã¨ãƒ‘スワードを使用ã™ã‚‹ã‹ã€`personal access token <https://help.github.com/articles/creating-an-access-token-for-command-line-use/>`_ を作æˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚トークンã®ä½œæˆã‚’é¸æŠžã—ãŸå ´åˆã¯ã€è˜åˆ¥ã‚’確èªã™ã‚‹ãŸã‚ã«ã®ã¿ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" +msgid "Select **Show API key** and then copy it." +msgstr "**Show API key** ã‚’é¸æŠžã—ã¦ã‚³ãƒ”ーã—ã¾ã™ã€‚" #: ../../rst/galaxy/dev_guide.rst:103 -msgid "The following shows authenticating with the Galaxy website using a GitHub username and password:" -msgstr "以下ã¯ã€GitHub ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼åã¨ãƒ‘スワードを使用ã—㟠Galaxy Web サイトã§ã®èªè¨¼ã‚’示ã—ã¦ã„ã¾ã™ã€‚" - -#: ../../rst/galaxy/dev_guide.rst:119 -msgid "When you choose to use your username and password, your password is not sent to Galaxy. It is used to authenticates with GitHub and create a personal access token. It then sends the token to Galaxy, which in turn verifies that your identity and returns a Galaxy access token. After authentication completes the GitHub token is destroyed." -msgstr "ユーザーåã¨ãƒ‘スワードã®ä½¿ç”¨ã‚’é¸æŠžã™ã‚‹ã¨ã€ãƒ‘スワード㯠Galaxy ã«é€ä¿¡ã•ã‚Œã¾ã›ã‚“。ã“れ㯠GitHub ã§èªè¨¼ã•ã‚Œã€å€‹äººã‚¢ã‚¯ã‚»ã‚¹ãƒˆãƒ¼ã‚¯ãƒ³ã‚’作æˆã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚次ã«ãƒˆãƒ¼ã‚¯ãƒ³ã‚’ Galaxy ã«é€ä¿¡ã—ã€ãã® ID を検証ã—ã€Galaxy アクセストークンを返ã—ã¾ã™ã€‚èªè¨¼ãŒå®Œäº†ã™ã‚‹ã¨ã€GitHub トークンãŒç ´æ£„ã•ã‚Œã¾ã™ã€‚" - -#: ../../rst/galaxy/dev_guide.rst:123 -msgid "If you do not want to use your GitHub password, or if you have two-factor authentication enabled with GitHub, use the ``--github-token`` option to pass a personal access token that you create." -msgstr "GitHub パスワードを使用ã—ãªã„å ´åˆã‚„ã€GitHub 㧠2 段階èªè¨¼ã‚’有効ã«ã—ã¦ã„ã‚‹å ´åˆã¯ã€``--github-token`` オプションを使用ã—ã¦ã€ä½œæˆã™ã‚‹å€‹äººç”¨ã‚¢ã‚¯ã‚»ã‚¹ãƒˆãƒ¼ã‚¯ãƒ³ã‚’渡ã—ã¾ã™ã€‚" +msgid "Save your token in the path set in the :ref:`GALAXY_TOKEN_PATH`." +msgstr ":ref:`GALAXY_TOKEN_PATH` ã§è¨å®šã—ãŸãƒ‘スã«ãƒˆãƒ¼ã‚¯ãƒ³ã‚’ä¿å˜ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:127 +#: ../../rst/galaxy/dev_guide.rst:107 msgid "Import a role" msgstr "ãƒãƒ¼ãƒ«ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" -#: ../../rst/galaxy/dev_guide.rst:129 +#: ../../rst/galaxy/dev_guide.rst:109 msgid "The ``import`` command requires that you first authenticate using the ``login`` command. Once authenticated you can import any GitHub repository that you own or have been granted access." msgstr "``import`` コマンドã§ã¯ã€æœ€åˆã« ``login`` コマンドを使用ã—ã¦èªè¨¼ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚èªè¨¼ã•ã‚Œã‚‹ã¨ã€æ‰€æœ‰ã¾ãŸã¯ã‚¢ã‚¯ã‚»ã‚¹ãŒä»˜ä¸Žã•ã‚ŒãŸ GitHub リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’ã™ã¹ã¦ã‚¤ãƒ³ãƒãƒ¼ãƒˆã§ãã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:131 +#: ../../rst/galaxy/dev_guide.rst:111 msgid "Use the following to import to role:" msgstr "以下を使用ã—ã¦ãƒãƒ¼ãƒ«ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:137 +#: ../../rst/galaxy/dev_guide.rst:117 msgid "By default the command will wait for Galaxy to complete the import process, displaying the results as the import progresses:" msgstr "デフォルトã§ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ã¯ Galaxy ãŒã‚¤ãƒ³ãƒãƒ¼ãƒˆãƒ—ãƒã‚»ã‚¹ã‚’完了ã™ã‚‹ã¾ã§å¾…æ©Ÿã—ã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆãŒé€²è¡Œã™ã‚‹ã«ã¤ã‚Œã¦çµæžœã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:155 +#: ../../rst/galaxy/dev_guide.rst:135 msgid "Branch" msgstr "ブランãƒ" -#: ../../rst/galaxy/dev_guide.rst:157 +#: ../../rst/galaxy/dev_guide.rst:137 msgid "Use the ``--branch`` option to import a specific branch. If not specified, the default branch for the repo will be used." msgstr "特定ã®ãƒ–ランãƒã‚’インãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€``--branch`` オプションを使用ã—ã¾ã™ã€‚指定ã—ãªã„å ´åˆã¯ã€ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãƒ–ランãƒãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:160 +#: ../../rst/galaxy/dev_guide.rst:140 msgid "Role name" msgstr "ãƒãƒ¼ãƒ«å" -#: ../../rst/galaxy/dev_guide.rst:162 +#: ../../rst/galaxy/dev_guide.rst:142 msgid "By default the name given to the role will be derived from the GitHub repository name. However, you can use the ``--role-name`` option to override this and set the name." msgstr "デフォルトã§ã¯ã€ãƒãƒ¼ãƒ«ã«æŒ‡å®šã•ã‚ŒãŸåå‰ã¯ GitHub リãƒã‚¸ãƒˆãƒªãƒ¼åã‹ã‚‰æ´¾ç”Ÿã—ã¾ã™ãŒã€``--role-name`` オプションを使用ã—ã¦ã“れを上書ãã—ã¦åå‰ã‚’è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:165 +#: ../../rst/galaxy/dev_guide.rst:145 msgid "No wait" msgstr "å¾…æ©Ÿãªã—" -#: ../../rst/galaxy/dev_guide.rst:167 +#: ../../rst/galaxy/dev_guide.rst:147 msgid "If the ``--no-wait`` option is present, the command will not wait for results. Results of the most recent import for any of your roles is available on the Galaxy web site by visiting *My Imports*." msgstr "``--no-wait`` オプションãŒå˜åœ¨ã™ã‚‹å ´åˆã¯ã€çµæžœã‚’å¾…ã¡ã¾ã›ã‚“。ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã«å¯¾ã™ã‚‹æœ€æ–°ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã®çµæžœã¯ã€*My Imports* ã«ç§»å‹•ã—㦠Galaxy Web サイトã§åˆ©ç”¨ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:170 +#: ../../rst/galaxy/dev_guide.rst:150 msgid "Delete a role" msgstr "ãƒãƒ¼ãƒ«ã®å‰Šé™¤" -#: ../../rst/galaxy/dev_guide.rst:172 +#: ../../rst/galaxy/dev_guide.rst:152 msgid "The ``delete`` command requires that you first authenticate using the ``login`` command. Once authenticated you can remove a role from the Galaxy web site. You are only allowed to remove roles where you have access to the repository in GitHub." msgstr "``delete`` コマンドã§ã¯ã€æœ€åˆã« ``login`` コマンドを使用ã—ã¦èªè¨¼ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚èªè¨¼ã•ã‚Œã‚‹ã¨ã€Galaxy Web サイトã‹ã‚‰ãƒãƒ¼ãƒ«ã‚’削除ã§ãã¾ã™ã€‚GitHub ã®ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã‚‹ãƒãƒ¼ãƒ«ã®ã¿ã‚’削除ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:174 +#: ../../rst/galaxy/dev_guide.rst:154 msgid "Use the following to delete a role:" msgstr "ãƒãƒ¼ãƒ«ã‚’削除ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:180 +#: ../../rst/galaxy/dev_guide.rst:160 msgid "This only removes the role from Galaxy. It does not remove or alter the actual GitHub repository." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€Galaxy ã‹ã‚‰ãƒãƒ¼ãƒ«ã®ã¿ãŒå‰Šé™¤ã•ã‚Œã¾ã™ã€‚実際㮠GitHub リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’削除ã—ãŸã‚Šã€å¤‰æ›´ã—ãŸã‚Šã—ã¾ã›ã‚“。" -#: ../../rst/galaxy/dev_guide.rst:184 +#: ../../rst/galaxy/dev_guide.rst:164 msgid "Travis integrations" msgstr "Travis çµ±åˆ" -#: ../../rst/galaxy/dev_guide.rst:186 +#: ../../rst/galaxy/dev_guide.rst:166 msgid "You can create an integration or connection between a role in Galaxy and `Travis <https://travis-ci.org>`_. Once the connection is established, a build in Travis will automatically trigger an import in Galaxy, updating the search index with the latest information about the role." msgstr "Galaxy 㨠`Travis <https://travis-ci.org>`_ ã®ãƒãƒ¼ãƒ«é–“ã®çµ±åˆã¾ãŸã¯ã‚³ãƒã‚¯ã‚·ãƒ§ãƒ³ã‚’作æˆã§ãã¾ã™ã€‚コãƒã‚¯ã‚·ãƒ§ãƒ³ãŒç¢ºç«‹ã•ã‚Œã‚‹ã¨ã€Travis ã®ãƒ“ルドãŒè‡ªå‹•çš„ã« Galaxy ã§ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’発生ã•ã›ã€ãƒãƒ¼ãƒ«ã«é–¢ã™ã‚‹æœ€æ–°æƒ…å ±ã§æ¤œç´¢ã‚¤ãƒ³ãƒ‡ãƒƒã‚¯ã‚¹ã‚’æ›´æ–°ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:189 +#: ../../rst/galaxy/dev_guide.rst:169 msgid "You create the integration using the ``setup`` command, but before an integration can be created, you must first authenticate using the ``login`` command; you will also need an account in Travis, and your Travis token. Once you're ready, use the following command to create the integration:" msgstr "``setup`` コマンドを使用ã—ã¦çµ±åˆã‚’作æˆã—ã¾ã™ãŒã€çµ±åˆã‚’作æˆã™ã‚‹å‰ã«ã€æœ€åˆã« ``login`` コマンドを使用ã—ã¦èªè¨¼ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Travis ãŠã‚ˆã³ Travis トークンã«ã‚‚アカウントãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚準備ãŒæ•´ã£ãŸã‚‰ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦çµ±åˆã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:196 +#: ../../rst/galaxy/dev_guide.rst:176 msgid "The setup command requires your Travis token, however the token is not stored in Galaxy. It is used along with the GitHub username and repo to create a hash as described in `the Travis documentation <https://docs.travis-ci.com/user/notifications/>`_. The hash is stored in Galaxy and used to verify notifications received from Travis." msgstr "setup コマンドã«ã¯ Travis トークンãŒå¿…è¦ã§ã™ãŒã€ãƒˆãƒ¼ã‚¯ãƒ³ã¯ Galaxy ã«ä¿å˜ã•ã‚Œã¦ã„ã¾ã›ã‚“。ã“ã‚Œã¯ã€`the Travis documentation <https://docs.travis-ci.com/user/notifications/>`_ ã§èª¬æ˜Žã•ã‚Œã¦ã„るよã†ã«ã€GitHub ユーザーåãŠã‚ˆã³ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã¨ã¨ã‚‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ãƒãƒƒã‚·ãƒ¥ã¯ Galaxy ã«æ ¼ç´ã•ã‚Œã€Travis ã‹ã‚‰å—ä¿¡ã—ãŸé€šçŸ¥ã®æ¤œè¨¼ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:199 +#: ../../rst/galaxy/dev_guide.rst:179 msgid "The setup command enables Galaxy to respond to notifications. To configure Travis to run a build on your repository and send a notification, follow the `Travis getting started guide <https://docs.travis-ci.com/user/getting-started/>`_." msgstr "setup コマンドを使用ã™ã‚‹ã¨ã€Galaxy ãŒé€šçŸ¥ã«å¿œç”ã—ã¾ã™ã€‚Travis ãŒãƒªãƒã‚¸ãƒˆãƒªãƒ¼ã§ãƒ“ルドを実行ã—ã€é€šçŸ¥ã‚’é€ä¿¡ã™ã‚‹ã‚ˆã†ã«è¨å®šã™ã‚‹ã«ã¯ã€`Travis getting started guide <https://docs.travis-ci.com/user/getting-started/>`_ ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:202 +#: ../../rst/galaxy/dev_guide.rst:182 msgid "To instruct Travis to notify Galaxy when a build completes, add the following to your .travis.yml file:" msgstr "ビルドã®å®Œäº†æ™‚ã« Galaxy ã«é€šçŸ¥ã™ã‚‹ã‚ˆã†ã« Travis ã«æŒ‡ç¤ºã™ã‚‹ã«ã¯ã€.travis.yml ファイルã«ä»¥ä¸‹ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:211 +#: ../../rst/galaxy/dev_guide.rst:191 msgid "List Travis integrations" msgstr "Travis çµ±åˆã®ä¸€è¦§è¡¨ç¤º" -#: ../../rst/galaxy/dev_guide.rst:213 +#: ../../rst/galaxy/dev_guide.rst:193 msgid "Use the ``--list`` option to display your Travis integrations:" msgstr "``--list`` オプションを使用ã—ã¦ã€Travis çµ±åˆã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:227 +#: ../../rst/galaxy/dev_guide.rst:207 msgid "Remove Travis integrations" msgstr "Travis çµ±åˆã®å‰Šé™¤" -#: ../../rst/galaxy/dev_guide.rst:229 +#: ../../rst/galaxy/dev_guide.rst:209 msgid "Use the ``--remove`` option to disable and remove a Travis integration:" msgstr "``--remove`` オプションを使用ã—ã¦ã€Travis çµ±åˆã‚’無効化ãŠã‚ˆã³å‰Šé™¤ã—ã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:235 +#: ../../rst/galaxy/dev_guide.rst:215 msgid "Provide the ID of the integration to be disabled. You can find the ID by using the ``--list`` option." msgstr "無効ã«ã™ã‚‹çµ±åˆã® ID を指定ã—ã¾ã™ã€‚``--list`` オプションを使用ã—㦠ID を検索ã§ãã¾ã™ã€‚" -#: ../../rst/galaxy/dev_guide.rst:239 ../../rst/galaxy/user_guide.rst:491 +#: ../../rst/galaxy/dev_guide.rst:219 ../../rst/galaxy/user_guide.rst:491 msgid ":ref:`collections`" msgstr ":ref:`collections`" -#: ../../rst/galaxy/dev_guide.rst:240 ../../rst/galaxy/user_guide.rst:492 +#: ../../rst/galaxy/dev_guide.rst:220 ../../rst/galaxy/user_guide.rst:492 msgid "Shareable collections of modules, playbooks and roles" msgstr "モジュールã€Playbookã€ãŠã‚ˆã³ãƒãƒ¼ãƒ«ã®å…±æœ‰å¯èƒ½ãªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³" -#: ../../rst/galaxy/dev_guide.rst:241 ../../rst/galaxy/user_guide.rst:493 +#: ../../rst/galaxy/dev_guide.rst:221 ../../rst/galaxy/user_guide.rst:493 msgid ":ref:`playbooks_reuse_roles`" msgstr ":ref:`playbooks_reuse_roles`" -#: ../../rst/galaxy/dev_guide.rst:242 +#: ../../rst/galaxy/dev_guide.rst:222 msgid "All about ansible roles" msgstr "Ansible ãƒãƒ¼ãƒ«ã«é–¢ã™ã‚‹ã™ã¹ã¦" -#: ../../rst/galaxy/dev_guide.rst:243 +#: ../../rst/galaxy/dev_guide.rst:223 msgid "`Mailing List <https://groups.google.com/group/ansible-project>`_" msgstr "`Mailing List <https://groups.google.com/group/ansible-project>`_" -#: ../../rst/galaxy/dev_guide.rst:244 +#: ../../rst/galaxy/dev_guide.rst:224 msgid "Questions? Help? Ideas? Stop by the list on Google Groups" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ案ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google グループã®ä¸€è¦§ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/galaxy/dev_guide.rst:245 +#: ../../rst/galaxy/dev_guide.rst:225 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" -#: ../../rst/galaxy/dev_guide.rst:246 +#: ../../rst/galaxy/dev_guide.rst:226 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -472,15 +468,15 @@ msgstr "``type: git`` ã§ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã™ã‚‹å ´åˆã€` msgid "You can also add roles to a ``requirements.yml`` file, under the ``roles`` key. The values follow the same format as a requirements file used in older Ansible releases." msgstr "``roles``ã‚ーã®ä¸‹ã«ã‚ã‚‹``requirements.yml``ファイルã«ãƒãƒ¼ãƒ«ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã®å€¤ã¯ã€å¤ã„ Ansible リリースã§ä½¿ç”¨ã•ã‚Œã‚‹è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã¨åŒã˜å½¢å¼ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:67 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:68 msgid "To install both roles and collections at the same time with one command, run the following:" msgstr "1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã§ã€ãƒãƒ¼ãƒ«ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’åŒæ™‚ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:73 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:74 msgid "Running ``ansible-galaxy collection install -r`` or ``ansible-galaxy role install -r`` will only install collections, or roles respectively." msgstr "``ansible-galaxy collection install -r`` ã¾ãŸã¯ ``ansible-galaxy role install -r`` を実行ã™ã‚‹ã¨ã€ãã‚Œãžã‚Œã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¾ãŸã¯ãƒãƒ¼ãƒ«ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/shared_snippets/installing_multiple_collections.txt:76 +#: ../../rst/shared_snippets/installing_multiple_collections.txt:77 msgid "Installing both roles and collections from the same requirements file will not work when specifying a custom collection or role install path. In this scenario the collections will be skipped and the command will process each like ``ansible-galaxy role install`` would." msgstr "カスタムコレクションã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãƒ‘スを指定ã™ã‚‹å ´åˆã€åŒã˜è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ãƒãƒ¼ãƒ«ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸¡æ–¹ã‚’インストールã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。今回ã®ä¾‹ã§ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¯çœç•¥ã•ã‚Œã€ã‚³ãƒžãƒ³ãƒ‰ã¯ ``ansible-galaxy role install`` ã®ã‚ˆã†ã«å‡¦ç†ã•ã‚Œã¾ã™ã€‚" @@ -1077,4 +1073,16 @@ msgstr "ã‚«ã‚¿ãƒã‚°é–¢é€£ã®æ“作を実行ã—ã¾ã™ã€‚" #~ msgid "Once a collection is found, any of its requirements are only searched within the same Galaxy instance as the parent collection. The install process will not search for a collection requirement in a different Galaxy instance." #~ msgstr "コレクションãŒè¦‹ã¤ã‹ã‚‹ã¨ã€ãã®è¦ä»¶ã¯è¦ªã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨åŒã˜ Galaxy インスタンス内ã§ã®ã¿æ¤œç´¢ã•ã‚Œã¾ã™ã€‚インストールプãƒã‚»ã‚¹ã§ã¯ã€åˆ¥ã® Galaxy インスタンスã§ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³è¦ä»¶ã‚’検索ã—ã¾ã›ã‚“。" +#~ msgid "The ``login`` command requires using your GitHub credentials. You can use your username and password, or you can create a `personal access token <https://help.github.com/articles/creating-an-access-token-for-command-line-use/>`_. If you choose to create a token, grant minimal access to the token, as it is used just to verify identify." +#~ msgstr "``login`` コマンドã«ã¯ã€GitHub èªè¨¼æƒ…å ±ã‚’ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ユーザーåã¨ãƒ‘スワードを使用ã™ã‚‹ã‹ã€`personal access token <https://help.github.com/articles/creating-an-access-token-for-command-line-use/>`_ を作æˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚トークンã®ä½œæˆã‚’é¸æŠžã—ãŸå ´åˆã¯ã€è˜åˆ¥ã‚’確èªã™ã‚‹ãŸã‚ã«ã®ã¿ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "The following shows authenticating with the Galaxy website using a GitHub username and password:" +#~ msgstr "以下ã¯ã€GitHub ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼åã¨ãƒ‘スワードを使用ã—㟠Galaxy Web サイトã§ã®èªè¨¼ã‚’示ã—ã¦ã„ã¾ã™ã€‚" + +#~ msgid "When you choose to use your username and password, your password is not sent to Galaxy. It is used to authenticates with GitHub and create a personal access token. It then sends the token to Galaxy, which in turn verifies that your identity and returns a Galaxy access token. After authentication completes the GitHub token is destroyed." +#~ msgstr "ユーザーåã¨ãƒ‘スワードã®ä½¿ç”¨ã‚’é¸æŠžã™ã‚‹ã¨ã€ãƒ‘スワード㯠Galaxy ã«é€ä¿¡ã•ã‚Œã¾ã›ã‚“。ã“れ㯠GitHub ã§èªè¨¼ã•ã‚Œã€å€‹äººã‚¢ã‚¯ã‚»ã‚¹ãƒˆãƒ¼ã‚¯ãƒ³ã‚’作æˆã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚次ã«ãƒˆãƒ¼ã‚¯ãƒ³ã‚’ Galaxy ã«é€ä¿¡ã—ã€ãã® ID を検証ã—ã€Galaxy アクセストークンを返ã—ã¾ã™ã€‚èªè¨¼ãŒå®Œäº†ã™ã‚‹ã¨ã€GitHub トークンãŒç ´æ£„ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "If you do not want to use your GitHub password, or if you have two-factor authentication enabled with GitHub, use the ``--github-token`` option to pass a personal access token that you create." +#~ msgstr "GitHub パスワードを使用ã—ãªã„å ´åˆã‚„ã€GitHub 㧠2 段階èªè¨¼ã‚’有効ã«ã—ã¦ã„ã‚‹å ´åˆã¯ã€``--github-token`` オプションを使用ã—ã¦ã€ä½œæˆã™ã‚‹å€‹äººç”¨ã‚¢ã‚¯ã‚»ã‚¹ãƒˆãƒ¼ã‚¯ãƒ³ã‚’渡ã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/getting_started.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/getting_started.po index bb8a403a..6675e2fd 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/getting_started.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/getting_started.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/getting_started/basic_concepts.rst:5 msgid "Ansible concepts" @@ -84,7 +84,7 @@ msgstr "管ç†ãƒ›ã‚¹ãƒˆã«é©ç”¨ã•ã‚Œã‚‹ã€Œã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã€ã®å®šç¾©ã€‚タス #: ../../rst/shared_snippets/basic_concepts.txt:43 msgid "Handlers" -msgstr "ãƒãƒ³ãƒ‰ãƒ©ãƒ¼" +msgstr "Handler (ãƒãƒ³ãƒ‰ãƒ©ãƒ¼)" #: ../../rst/shared_snippets/basic_concepts.txt:44 msgid "A special form of a Task, that only executes when notified by a previous task which resulted in a 'changed' status." @@ -135,7 +135,7 @@ msgid "In the previous section, you added managed nodes directly to the ``/etc/a msgstr "å‰ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ç®¡ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã‚’ ``/etc/ansible/hosts`` ファイルã«ç›´æŽ¥è¿½åŠ ã—ã¾ã—ãŸã€‚次ã¯ã€æŸ”軟性ã®å‘上ã€å†åˆ©ç”¨ã€ä»–ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¨ã®å…±æœ‰ã‚’å¯èƒ½ã«ã™ã‚‹ãŸã‚ã€ã‚½ãƒ¼ã‚¹ç®¡ç†ã«è¿½åŠ ã§ãるインベントリーファイルを作æˆã—ã¾ã™ã€‚" #: ../../rst/getting_started/get_started_inventory.rst:16 -msgid "Inventory files can be in ``INI`` or ``YAML`` format. For demonstration purposes this section uses ``YAML`` format only." +msgid "Inventory files can be in ``INI`` or ``YAML`` format. For demonstration purposes, this section uses ``YAML`` format only." msgstr "インベントリーファイル㯠``INI`` ã¾ãŸã¯ ``YAML`` å½¢å¼ã‚’使用ã§ãã¾ã™ã€‚デモンストレーションã¨ã—ã¦ã€ã“ã“ã§ã¯ ``YAML`` å½¢å¼ã®ã¿ã‚’使用ã—ã¾ã™ã€‚" #: ../../rst/getting_started/get_started_inventory.rst:19 @@ -404,6 +404,9 @@ msgstr "Ansible ãŒåˆ¶å¾¡ã™ã‚‹ãƒªãƒ¢ãƒ¼ãƒˆã‚·ã‚¹ãƒ†ãƒ ã¾ãŸã¯ãƒ›ã‚¹ãƒˆã€‚" msgid "A list of managed nodes that are logically organized. You create an inventory on the control node to describe host deployments to Ansible." msgstr "è«–ç†çš„ã«ç·¨æˆã•ã‚Œã‚‹ç®¡ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã®ä¸€è¦§ã€‚コントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’作æˆã—ã€Ansible ã«ãƒ›ã‚¹ãƒˆã®ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã‚’記述ã—ã¾ã™ã€‚" +msgid "Basic components of an Ansible environment include a control node, an inventory of managed nodes, and a module copied to each managed node." +msgstr "Ansible 環境ã®åŸºæœ¬ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã«ã¯ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã€ç®¡ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã€ãŠã‚ˆã³å„管ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã«ã‚³ãƒ”ーã•ã‚ŒãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå«ã¾ã‚Œã¾ã™ã€‚" + #: ../../rst/getting_started/index.rst:28 msgid "Ready to start using Ansible? Complete the following steps to get up and running:" msgstr "Ansible ã®ä½¿ç”¨ã‚’開始ã™ã‚‹æº–å‚™ãŒã§ãã¾ã—ãŸã‹ã€‚ãã‚Œã§ã¯ã€ä»¥ä¸‹ã®æ‰‹é †ã‚’実行ã—ã¦èµ·å‹•ã—ã¾ã—ょã†ã€‚" @@ -453,8 +456,8 @@ msgid "Demonstrations of different Ansible usecases" msgstr "å„種 Ansible ã®ãƒ¦ãƒ¼ã‚¹ã‚±ãƒ¼ã‚¹ã®ãƒ‡ãƒ¢" #: ../../rst/getting_started/index.rst:87 -msgid "`RHEL Labs <https://katacoda.com/rhel-labs>`_" -msgstr "`RHEL Labs <https://katacoda.com/rhel-labs>`_" +msgid "`Ansible Labs <https://www.ansible.com/products/ansible-training>`_" +msgstr "`Ansible Labs <https://www.ansible.com/products/ansible-training>`_" #: ../../rst/getting_started/index.rst:88 msgid "Labs to provide further knowledge on different topics" @@ -476,4 +479,7 @@ msgstr ":ref:`communication_irc`" msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" +#~ msgid "`RHEL Labs <https://katacoda.com/rhel-labs>`_" +#~ msgstr "`RHEL Labs <https://katacoda.com/rhel-labs>`_" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/installation_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/installation_guide.po index da40e472..022119df 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/installation_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/installation_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/installation_guide/index.rst:3 msgid "Installation Guide" @@ -130,8 +130,8 @@ msgid "You cannot use a Windows system for the Ansible control node. See :ref:`w msgstr "Ansible コントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã« Windows システムã¯ä½¿ç”¨ã§ãã¾ã›ã‚“。:ref:`windows_faq_ansible` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/installation_guide/installation_distros.rst:107 -msgid "`Installing Ansible on ARch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_" -msgstr "`Installing Ansible on ARch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_" +msgid "`Installing Ansible on Arch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_" +msgstr "`Installing Ansible on Arch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_" #: ../../rst/installation_guide/installation_distros.rst:108 msgid "Distro-specific installation on Arch Linux" @@ -214,7 +214,7 @@ msgid "The full list of options available is in :ref:`ansible-playbook` and :ref msgstr "利用å¯èƒ½ãªã‚ªãƒ—ションã®è©³ç´°ãªä¸€è¦§ã¯ã€Œ:ref:`ansible-playbook`ã€ãŠã‚ˆã³ã€Œ:ref:`ansible`ã€ã«ã‚ã‚Šã¾ã™ã€‚" #: ../../rst/installation_guide/intro_installation.rst:6 -#: ../../rst/installation_guide/intro_installation.rst:109 +#: ../../rst/installation_guide/intro_installation.rst:110 msgid "Installing Ansible" msgstr "Ansible ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" @@ -235,319 +235,319 @@ msgid "Managed node requirements" msgstr "管ç†ãƒŽãƒ¼ãƒ‰ã®è¦ä»¶" #: ../../rst/installation_guide/intro_installation.rst:25 -msgid "The *managed* node (the machine that Ansible is managing) does not require Ansible to be installed, but requires Python 2.7, or Python 3.5 - 3.11 to run Ansible library code." -msgstr "*マãƒãƒ¼ã‚¸ãƒ‰* ノード (Ansible ãŒç®¡ç†ã—ã¦ã„るマシン) ã«ã¯ Ansible をインストールã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€Ansible ライブラリーコードを実行ã™ã‚‹ã«ã¯ Python 2.7 ã¾ãŸã¯ Python 3.5 - 3.11 ãŒå¿…è¦ã§ã™ã€‚" +msgid "The *managed* node (the machine that Ansible is managing) does not require Ansible to be installed, but requires Python 2.7, or Python 3.5 - 3.11 to run Ansible library code. The managed node also needs a user account that can SSH to the node with an interactive POSIX shell." +msgstr "*管ç†å¯¾è±¡* ノード (Ansible ãŒç®¡ç†ã™ã‚‹ãƒžã‚·ãƒ³) ã¯ã€Ansible ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“ãŒã€Ansible ã®ãƒ©ã‚¤ãƒ–ラリーコードを実行ã™ã‚‹ãŸã‚ã« Python 2.7ã€ã¾ãŸã¯ Python 3.5〜3.11 ãŒå¿…è¦ã§ã™ã€‚ã¾ãŸã€ç®¡ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ã«ã¯ã€å¯¾è©±åž‹ POSIX シェルã§ãƒŽãƒ¼ãƒ‰ã« SSH 接続ã§ãるユーザーアカウントãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:29 +#: ../../rst/installation_guide/intro_installation.rst:30 msgid "Network modules are an exception and do not require Python on the managed device. See :ref:`network_modules`." msgstr "ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ä¾‹å¤–ã§ã€ç®¡ç†ãƒ‡ãƒã‚¤ã‚¹ã« Python ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。:ref:`network_modules` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:34 +#: ../../rst/installation_guide/intro_installation.rst:35 msgid "Node requirement summary" msgstr "ノードè¦ä»¶ã®æ¦‚è¦" -#: ../../rst/installation_guide/intro_installation.rst:36 +#: ../../rst/installation_guide/intro_installation.rst:37 msgid "The table below lists the current and historical versions of Python required on control and managed nodes." msgstr "以下ã®è¡¨ã¯ã€åˆ¶å¾¡ãŠã‚ˆã³ç®¡ç†ãƒŽãƒ¼ãƒ‰ã«å¿…è¦ãª Python ã®ç¾åœ¨ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨éŽåŽ»ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:42 +#: ../../rst/installation_guide/intro_installation.rst:43 msgid "ansible-core Version" msgstr "ansible-core ãƒãƒ¼ã‚¸ãƒ§ãƒ³" -#: ../../rst/installation_guide/intro_installation.rst:43 +#: ../../rst/installation_guide/intro_installation.rst:44 msgid "Control node Python" msgstr "コントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ Python" -#: ../../rst/installation_guide/intro_installation.rst:44 +#: ../../rst/installation_guide/intro_installation.rst:45 msgid "Managed node Python" msgstr "管ç†å¯¾è±¡ãƒŽãƒ¼ãƒ‰ Python" -#: ../../rst/installation_guide/intro_installation.rst:45 +#: ../../rst/installation_guide/intro_installation.rst:46 msgid "2.11" msgstr "2.11" -#: ../../rst/installation_guide/intro_installation.rst:46 +#: ../../rst/installation_guide/intro_installation.rst:47 msgid "Python 2.7, Python 3.5 - 3.9 `[†]`_" msgstr "Python 2.7, Python 3.5 - 3.9 `[†]`_" -#: ../../rst/installation_guide/intro_installation.rst:47 +#: ../../rst/installation_guide/intro_installation.rst:48 msgid "Python 2.6 - 2.7, Python 3.5 - 3.9" msgstr "Python 2.6 - 2.7, Python 3.5 - 3.9" -#: ../../rst/installation_guide/intro_installation.rst:48 +#: ../../rst/installation_guide/intro_installation.rst:49 msgid "2.12" msgstr "2.12" -#: ../../rst/installation_guide/intro_installation.rst:49 -#: ../../rst/installation_guide/intro_installation.rst:52 +#: ../../rst/installation_guide/intro_installation.rst:50 +#: ../../rst/installation_guide/intro_installation.rst:53 msgid "Python 3.8 - 3.10" msgstr "Python 3.8 - 3.10" -#: ../../rst/installation_guide/intro_installation.rst:50 +#: ../../rst/installation_guide/intro_installation.rst:51 msgid "Python 2.6 - 2.7, Python 3.5 - 3.10" msgstr "Python 2.6 - 2.7, Python 3.5 - 3.10" -#: ../../rst/installation_guide/intro_installation.rst:51 +#: ../../rst/installation_guide/intro_installation.rst:52 msgid "2.13" msgstr "2.13" -#: ../../rst/installation_guide/intro_installation.rst:53 +#: ../../rst/installation_guide/intro_installation.rst:54 msgid "Python 2.7, Python 3.5 - 3.10" msgstr "Python 2.7, Python 3.5 - 3.10" -#: ../../rst/installation_guide/intro_installation.rst:54 +#: ../../rst/installation_guide/intro_installation.rst:55 msgid "2.14" msgstr "2.14" -#: ../../rst/installation_guide/intro_installation.rst:55 +#: ../../rst/installation_guide/intro_installation.rst:56 msgid "Python 3.9 - 3.11" msgstr "Python 3.9 - 3.11" -#: ../../rst/installation_guide/intro_installation.rst:56 +#: ../../rst/installation_guide/intro_installation.rst:57 msgid "Python 2.7, Python 3.5 - 3.11" msgstr "Python 2.7, Python 3.5 - 3.11" -#: ../../rst/installation_guide/intro_installation.rst:58 +#: ../../rst/installation_guide/intro_installation.rst:59 msgid "_`[†]`: Has a soft requirement of Python 3.8 as not packaged for older versions" msgstr "_`[†]`: å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã¯ãƒ‘ッケージ化ã•ã‚Œã¦ã„ãªã„ãŸã‚ã€Python 3.8 ã®ã‚½ãƒ•ãƒˆè¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:65 +#: ../../rst/installation_guide/intro_installation.rst:66 msgid "Selecting an Ansible package and version to install" msgstr "インストールã™ã‚‹ Ansible パッケージãŠã‚ˆã³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®é¸æŠž" -#: ../../rst/installation_guide/intro_installation.rst:67 +#: ../../rst/installation_guide/intro_installation.rst:68 msgid "Ansible's community packages are distributed in two ways: a minimalist language and runtime package called ``ansible-core``, and a much larger \"batteries included\" package called ``ansible``, which adds a community-curated selection of :ref:`Ansible Collections <collections>` for automating a wide variety of devices. Choose the package that fits your needs; The following instructions use ``ansible``, but you can substitute ``ansible-core`` if you prefer to start with a more minimal package and separately install only the Ansible Collections you require. The ``ansible`` or ``ansible-core`` packages may be available in your operating systems package manager, and you are free to install these packages with your preferred method. These installation instructions only cover the officially supported means of installing the python package with ``pip``." msgstr "Ansible ã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãƒ‘ッケージã¯ã€``ansible-core`` ã¨å‘¼ã°ã‚Œã‚‹æœ€å°è¨€èªžãŠã‚ˆã³ãƒ©ãƒ³ã‚¿ã‚¤ãƒ パッケージã¨ã€``ansible`` ã¨å‘¼ã°ã‚Œã‚‹å¤§ããªã€Œãƒãƒƒãƒ†ãƒªãƒ¼ä»˜ãã€ãƒ‘ッケージ㮠2 ã¤ã®æ–¹æ³•ã§é…布ã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã‚Œã«ã¯ã€å¹…広ã„デãƒã‚¤ã‚¹ã®è‡ªå‹•åŒ–ã®ãŸã‚ã«ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãŒåŽ³é¸ã—㟠:ref:`Ansible Collections <collections>` ãŒè¿½åŠ ã•ã‚Œã¦ã„ã¾ã™ã€‚ニーズã«åˆã‚ã›ã¦ãƒ‘ッケージをé¸æŠžã—ã¦ãã ã•ã„。以下ã®æ‰‹é †ã§ã¯ ``ansible`` を使用ã—ã¦ã„ã¾ã™ãŒã€æœ€å°é™ã®ãƒ‘ッケージã§é–‹å§‹ã—ã¦å¿…è¦ãª Ansible コレクションã®ã¿å€‹åˆ¥ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å ´åˆã¯ ``ansible-core`` を使用ã§ãã¾ã™ã€‚``ansible`` パッケージã¾ãŸã¯ ``ansible-core`` パッケージã¯ã€ãŠä½¿ã„ã®ã‚ªãƒšãƒ¬ãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚·ã‚¹ãƒ†ãƒ パッケージマãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã§ä½¿ç”¨ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ãŠå¥½ã¿ã®æ–¹æ³•ã§ãƒ‘ッケージをインストールã—ã¦ãã ã•ã„。ã“れらã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ‰‹é †ã¯ã€``pip`` を使用ã—㦠Python パッケージをインストールã™ã‚‹ã€æ£å¼ãªã‚µãƒãƒ¼ãƒˆå¯¾è±¡ã®æ–¹æ³•ã«é™å®šã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:70 +#: ../../rst/installation_guide/intro_installation.rst:71 msgid "Installing and upgrading Ansible" msgstr "Ansible ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã¨ã‚¢ãƒƒãƒ—グレード" -#: ../../rst/installation_guide/intro_installation.rst:73 +#: ../../rst/installation_guide/intro_installation.rst:74 msgid "Locating Python" msgstr "Python ã®æ¤œç´¢" -#: ../../rst/installation_guide/intro_installation.rst:75 +#: ../../rst/installation_guide/intro_installation.rst:76 msgid "Locate and remember the path to the Python interpreter you wish to use to run Ansible. The following instructions refer to this Python as ``python3``. For example, if you've determined that you want the Python at ``/usr/bin/python3.9`` to be the one that you'll install Ansible under, specify that instead of ``python3``." msgstr "Ansible ã®å®Ÿè¡Œã«ä½¿ç”¨ã™ã‚‹ Python インタープリターã¸ã®ãƒ‘スを見ã¤ã‘ã¦è¦šãˆã¦ãŠã„ã¦ãã ã•ã„。以下ã®æ‰‹é †ã¯ã€ã“ã® Python ã‚’ ``python3`` ã¨ã—ã¦å‚ç…§ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``/usr/bin/python3.9`` ã® Python ã« Ansible をインストールã™ã‚‹å ´åˆã¯ã€``python3`` ã®ä»£ã‚ã‚Šã«ãã® Python を指定ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:78 +#: ../../rst/installation_guide/intro_installation.rst:79 msgid "Ensuring ``pip`` is available" msgstr "``pip`` ãŒåˆ©ç”¨å¯èƒ½ã‹ç¢ºèªã—ã¦ã„ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:80 +#: ../../rst/installation_guide/intro_installation.rst:81 msgid "To verify whether ``pip`` is already installed for your preferred Python:" msgstr "目的㮠Python 用㫠``pip`` ãŒã™ã§ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã‹ç¢ºèªã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:86 +#: ../../rst/installation_guide/intro_installation.rst:87 msgid "If all is well, you should see something like the following:" msgstr "ã™ã¹ã¦ãŒæ£å¸¸ãªå ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:93 +#: ../../rst/installation_guide/intro_installation.rst:94 msgid "If so, ``pip`` is available, and you can move on to the :ref:`next step <pip_install>`." msgstr "ãã®å ´åˆã¯ ``pip`` ãŒåˆ©ç”¨å¯èƒ½ã§ã™ã€‚:ref:`next step <pip_install>` ã«é€²ã‚“ã§ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:95 +#: ../../rst/installation_guide/intro_installation.rst:96 msgid "If you see an error like ``No module named pip``, you'll need to install ``pip`` under your chosen Python interpreter before proceeding. This may mean installing an additional OS package (for example, ``python3-pip``), or installing the latest ``pip`` directly from the Python Packaging Authority by running the following:" msgstr "``No module named pip`` ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•ã‚ŒãŸå ´åˆã¯ã€ç¶šè¡Œã™ã‚‹å‰ã«ã€é¸æŠžã—㟠Python インタープリター㫠``pip`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãã†ãªã‚‹ã¨ã€è¿½åŠ ã® OS パッケージ (例: ``python3-pip``) をインストールã™ã‚‹ã‹ã€ä»¥ä¸‹ã‚’実行ã—㦠Python Packaging Authority ã‹ã‚‰ç›´æŽ¥æœ€æ–°ã® ``pip`` をインストールã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:102 +#: ../../rst/installation_guide/intro_installation.rst:103 msgid "You may need to perform some additional configuration before you are able to run Ansible. See the Python documentation on `installing to the user site`_ for more information." msgstr "Ansible を実行ã™ã‚‹å‰ã«è¿½åŠ ã®è¨å®šãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€Python ドã‚ュメント「`ユーザーサイトã¸ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:111 +#: ../../rst/installation_guide/intro_installation.rst:112 msgid "Use ``pip`` in your selected Python environment to install the Ansible package of your choice for the current user:" msgstr "é¸æŠžã—㟠Python 環境㧠``pip`` を使用ã—ã€ç¾åœ¨ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ç”¨ã«é¸æŠžã—㟠Ansible パッケージをインストールã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:117 +#: ../../rst/installation_guide/intro_installation.rst:118 msgid "Alternately, you can install a specific version of ``ansible-core`` in this Python environment:" msgstr "ã¾ãŸã¯ã€ã“ã® Python 環境ã«ç‰¹å®šã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® ``ansible-core`` をインストールã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:126 +#: ../../rst/installation_guide/intro_installation.rst:127 msgid "Upgrading Ansible" msgstr "Ansible ã®ã‚¢ãƒƒãƒ—グレード" -#: ../../rst/installation_guide/intro_installation.rst:128 +#: ../../rst/installation_guide/intro_installation.rst:129 msgid "To upgrade an existing Ansible installation in this Python environment to the latest released version, simply add ``--upgrade`` to the command above:" msgstr "ã“ã® Python 環境ã®æ—¢å˜ã® Ansible インストールを最新ã®ãƒªãƒªãƒ¼ã‚¹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã«ã¯ã€ä¸Šè¨˜ã®ã‚³ãƒžãƒ³ãƒ‰ã« ``--upgrade`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:135 +#: ../../rst/installation_guide/intro_installation.rst:136 msgid "Confirming your installation" msgstr "インストールã®ç¢ºèª" -#: ../../rst/installation_guide/intro_installation.rst:137 +#: ../../rst/installation_guide/intro_installation.rst:138 msgid "You can test that Ansible is installed correctly by checking the version:" msgstr "ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã—ã¦ã€Ansible ãŒæ£ã—ãインストールã•ã‚ŒãŸã“ã¨ã‚’テストã§ãã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:143 +#: ../../rst/installation_guide/intro_installation.rst:144 msgid "The version displayed by this command is for the associated ``ansible-core`` package that has been installed." msgstr "ã“ã®ã‚³ãƒžãƒ³ãƒ‰ã§è¡¨ç¤ºã•ã‚Œã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€é–¢é€£ã™ã‚‹ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ¸ˆã¿ã® ``ansible-core`` パッケージã§ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:145 +#: ../../rst/installation_guide/intro_installation.rst:146 msgid "To check the version of the ``ansible`` package that has been installed:" msgstr "インストールã•ã‚Œã¦ã„ã‚‹ ``ansible`` パッケージã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:154 +#: ../../rst/installation_guide/intro_installation.rst:155 msgid "Installing for development" msgstr "開発用ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/installation_guide/intro_installation.rst:156 +#: ../../rst/installation_guide/intro_installation.rst:157 msgid "If you are testing new features, fixing bugs, or otherwise working with the development team on changes to the core code, you can install and run the source from GitHub." msgstr "新機能ã®ãƒ†ã‚¹ãƒˆã€ãƒã‚°ã®ä¿®æ£ã€ã¾ãŸã¯ã‚³ã‚¢ã‚³ãƒ¼ãƒ‰ã¸ã®å¤‰æ›´ã«å¯¾ã—ã¦é–‹ç™ºãƒãƒ¼ãƒ ã§ã®ä½œæ¥ã‚’è¡Œã†å ´åˆã¯ã€GitHub ã‹ã‚‰ã‚½ãƒ¼ã‚¹ã‚’インストールã—ã¦å®Ÿè¡Œã§ãã¾ã™ã€‚ã¦å®Ÿè¡Œã§ãã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:160 +#: ../../rst/installation_guide/intro_installation.rst:161 msgid "You should only install and run the ``devel`` branch if you are modifying ``ansible-core`` or trying out features under development. This is a rapidly changing source of code and can become unstable at any point." msgstr "開発時㫠``ansible-core`` を変更ã—ã€æ©Ÿèƒ½ã‚’試ã™å ´åˆã¯ã€``devel`` ブランãƒã®ã¿ã‚’インストールã—ã€å®Ÿè¡Œã—ã¦ãã ã•ã„。ã“ã®ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã¯æ€¥é€Ÿã«å¤‰åŒ–ã™ã‚‹ãŸã‚ã€ã„ã¤ã§ã‚‚ä¸å®‰å®šã«ãªã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:162 +#: ../../rst/installation_guide/intro_installation.rst:163 msgid "For more information on getting involved in the Ansible project, see the :ref:`ansible_community_guide`. For more information on creating Ansible modules and Collections, see the :ref:`developer_guide`." msgstr "Ansible プãƒã‚¸ã‚§ã‚¯ãƒˆã¸ã®è²¢çŒ®ã®è©³ç´°ã¯ã€ã€Œ:ref:`ansible_community_guide`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。Ansible モジュールãŠã‚ˆã³ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä½œæˆæ–¹æ³•ã¯ã€ã€Œ:ref:`developer_guide`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:167 +#: ../../rst/installation_guide/intro_installation.rst:168 msgid "Installing ``devel`` from GitHub with ``pip``" msgstr "``pip`` を使用ã—㟠GitHub ã‹ã‚‰ã® ``devel`` ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/installation_guide/intro_installation.rst:169 +#: ../../rst/installation_guide/intro_installation.rst:170 msgid "You can install the ``devel`` branch of ``ansible-core`` directly from GitHub with ``pip``:" msgstr "``pip`` を使用ã—ã¦ã€``ansible-core`` ã® ``devel`` ブランãƒã‚’直接 GitHub ã‹ã‚‰ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:175 +#: ../../rst/installation_guide/intro_installation.rst:176 msgid "You can replace ``devel`` in the URL mentioned above, with any other branch or tag on GitHub to install older versions of Ansible, tagged alpha or beta versions, and release candidates." msgstr "上記㮠URL ã® ``devel`` ã‚’ã€ä»–ã®ãƒ–ランãƒã¾ãŸã¯ GitHub ã®ã‚¿ã‚°ã«ç½®ãæ›ãˆã¦ã€å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansibleã€ã‚¿ã‚°ä»˜ã‘ã•ã‚ŒãŸ alpha ã¾ãŸã¯ beta ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã€ãŠã‚ˆã³ãƒªãƒªãƒ¼ã‚¹å€™è£œã‚’インストールã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:180 +#: ../../rst/installation_guide/intro_installation.rst:181 msgid "Running the ``devel`` branch from a clone" msgstr "クãƒãƒ¼ãƒ³ã‹ã‚‰ã® ``devel`` ブランãƒã®å®Ÿè¡Œ" -#: ../../rst/installation_guide/intro_installation.rst:182 +#: ../../rst/installation_guide/intro_installation.rst:183 msgid "``ansible-core`` is easy to run from source. You do not need ``root`` permissions to use it and there is no software to actually install. No daemons or database setup are required." msgstr "``ansible-core`` ソースã‹ã‚‰ã®å®Ÿè¡Œã¯ç°¡å˜ã§ã™ã€‚``root`` パーミッションã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。実際ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã¯ã‚ã‚Šã¾ã›ã‚“。デーモンやデータベースè¨å®šã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/installation_guide/intro_installation.rst:184 +#: ../../rst/installation_guide/intro_installation.rst:185 msgid "Clone the ``ansible-core`` repository" msgstr "``ansible-core`` リãƒã‚¸ãƒˆãƒªãƒ¼ã®ã‚¯ãƒãƒ¼ãƒ³ã‚’作æˆã—ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:191 +#: ../../rst/installation_guide/intro_installation.rst:192 msgid "Setup the Ansible environment" msgstr "Ansible 環境をè¨å®šã—ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:193 +#: ../../rst/installation_guide/intro_installation.rst:194 msgid "Using Bash" msgstr "Bash ã®ä½¿ç”¨" -#: ../../rst/installation_guide/intro_installation.rst:199 +#: ../../rst/installation_guide/intro_installation.rst:200 msgid "Using Fish" msgstr "Fish ã®ä½¿ç”¨" -#: ../../rst/installation_guide/intro_installation.rst:205 +#: ../../rst/installation_guide/intro_installation.rst:206 msgid "To suppress spurious warnings/errors, use ``-q``" msgstr "誤ã£ãŸè¦å‘Šã‚„エラーãŒè¡¨ç¤ºã•ã‚Œãªã„よã†ã«ã™ã‚‹ã«ã¯ã€``-q`` を使用ã—ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:211 +#: ../../rst/installation_guide/intro_installation.rst:212 msgid "Install Python dependencies" msgstr "Python ã®ä¾å˜é–¢ä¿‚をインストールã—ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:217 +#: ../../rst/installation_guide/intro_installation.rst:218 msgid "Update the ``devel`` branch of ``ansible-core`` on your local machine" msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒžã‚·ãƒ³ã§ ``ansible-core`` ã® ``devel`` ブランãƒã‚’æ›´æ–°ã—ã¾ã™" -#: ../../rst/installation_guide/intro_installation.rst:219 +#: ../../rst/installation_guide/intro_installation.rst:220 msgid "Use pull-with-rebase so any local changes are replayed." msgstr "pull-with-rebase を使用ã—ã¦ãƒãƒ¼ã‚«ãƒ«ã®å¤‰æ›´ãŒãƒªãƒ—レイã•ã‚Œã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:228 +#: ../../rst/installation_guide/intro_installation.rst:229 msgid "Adding Ansible command shell completion" msgstr "Ansible コマンドシェル補完ã®è¿½åŠ " -#: ../../rst/installation_guide/intro_installation.rst:230 +#: ../../rst/installation_guide/intro_installation.rst:231 msgid "You can add shell completion of the Ansible command line utilities by installing an optional dependency called ``argcomplete``. ``argcomplete`` supports bash, and has limited support for zsh and tcsh." msgstr "``argcomplete`` ã¨å‘¼ã°ã‚Œã‚‹ä»»æ„ã®ä¾å˜é–¢ä¿‚をインストールã—ã¦ã€Ansible コマンドラインユーティリティーã®ã‚·ã‚§ãƒ«è£œå®Œã‚’è¿½åŠ ã§ãã¾ã™ã€‚``argcomplete`` 㯠bash をサãƒãƒ¼ãƒˆã—ã€åˆ¶é™ä»˜ã㧠zsh ãŠã‚ˆã³ tcsh ã®ã‚µãƒãƒ¼ãƒˆã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:232 +#: ../../rst/installation_guide/intro_installation.rst:233 msgid "For more information about installation and configuration, see the `argcomplete documentation <https://kislyuk.github.io/argcomplete/>`_." msgstr "インストールã¨è¨å®šã®è©³ç´°ã¯ã€`argcomplete ドã‚ュメント <https://kislyuk.github.io/argcomplete/>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:235 +#: ../../rst/installation_guide/intro_installation.rst:236 msgid "Installing ``argcomplete``" msgstr "``argcomplete`` ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/installation_guide/intro_installation.rst:242 +#: ../../rst/installation_guide/intro_installation.rst:243 msgid "Configuring ``argcomplete``" msgstr "``argcomplete`` ã®è¨å®š" -#: ../../rst/installation_guide/intro_installation.rst:244 +#: ../../rst/installation_guide/intro_installation.rst:245 msgid "There are 2 ways to configure ``argcomplete`` to allow shell completion of the Ansible command line utilities: globally or per command." msgstr "Ansible コマンドラインユーティリティーã®ã‚·ã‚§ãƒ«è£œå®Œã‚’å¯èƒ½ã«ã™ã‚‹ ``argcomplete`` ã®è¨å®šæ–¹æ³•ã¯ã€2 通りã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:247 +#: ../../rst/installation_guide/intro_installation.rst:248 msgid "Global configuration" msgstr "ã‚°ãƒãƒ¼ãƒãƒ«è¨å®š" -#: ../../rst/installation_guide/intro_installation.rst:249 +#: ../../rst/installation_guide/intro_installation.rst:250 msgid "Global completion requires bash 4.2." msgstr "ã‚°ãƒãƒ¼ãƒãƒ«è£œå®Œã«ã¯ bash 4.2 ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:255 +#: ../../rst/installation_guide/intro_installation.rst:256 msgid "This will write a bash completion file to a user location. Use ``--dest`` to change the location or ``sudo`` to set up the completion globally." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€bash 補完ファイルãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã®ãƒã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã«æ›¸ãè¾¼ã¾ã‚Œã¾ã™ã€‚ãƒã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã‚’変更ã™ã‚‹ã«ã¯ ``--dest`` を使用ã—ã€è£œå®Œã®è¨å®šã¯ ``sudo`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:258 +#: ../../rst/installation_guide/intro_installation.rst:259 msgid "Per command configuration" msgstr "コマンドã”ã¨ã®è¨å®š" -#: ../../rst/installation_guide/intro_installation.rst:260 +#: ../../rst/installation_guide/intro_installation.rst:261 msgid "If you do not have bash 4.2, you must register each script independently." msgstr "bash 4.2 ãŒãªã„å ´åˆã¯ã€å„スクリプトを個別ã«ç™»éŒ²ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:274 +#: ../../rst/installation_guide/intro_installation.rst:275 msgid "You should place the above commands into your shells profile file such as ``~/.profile`` or ``~/.bash_profile``." msgstr "上記ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’ã€``~/.profile``ã€``~/.bash_profile`` ãªã©ã®ã‚·ã‚§ãƒ«ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã«ç½®ãå¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/installation_guide/intro_installation.rst:277 +#: ../../rst/installation_guide/intro_installation.rst:278 msgid "Using ``argcomplete`` with zsh or tcsh" msgstr "zsh ã¾ãŸã¯ tcsh 㧠``argcomplete`` を使用" -#: ../../rst/installation_guide/intro_installation.rst:279 +#: ../../rst/installation_guide/intro_installation.rst:280 msgid "See the `argcomplete documentation <https://kislyuk.github.io/argcomplete/>`_." msgstr "`argcomplete ドã‚ュメント <https://kislyuk.github.io/argcomplete/>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:284 +#: ../../rst/installation_guide/intro_installation.rst:285 msgid ":ref:`intro_adhoc`" msgstr ":ref:`intro_adhoc`" -#: ../../rst/installation_guide/intro_installation.rst:285 +#: ../../rst/installation_guide/intro_installation.rst:286 msgid "Examples of basic commands" msgstr "基本コマンドã®ä¾‹" -#: ../../rst/installation_guide/intro_installation.rst:286 +#: ../../rst/installation_guide/intro_installation.rst:287 msgid ":ref:`working_with_playbooks`" msgstr ":ref:`working_with_playbooks`" -#: ../../rst/installation_guide/intro_installation.rst:287 +#: ../../rst/installation_guide/intro_installation.rst:288 msgid "Learning ansible's configuration management language" msgstr "Ansible ã®è¨å®šç®¡ç†è¨€èªžã®æ¦‚è¦" -#: ../../rst/installation_guide/intro_installation.rst:288 +#: ../../rst/installation_guide/intro_installation.rst:289 msgid ":ref:`installation_faqs`" msgstr ":ref:`installation_faqs`" -#: ../../rst/installation_guide/intro_installation.rst:289 +#: ../../rst/installation_guide/intro_installation.rst:290 msgid "Ansible Installation related to FAQs" msgstr "FAQ ã«é–¢é€£ã™ã‚‹ Ansible インストール" -#: ../../rst/installation_guide/intro_installation.rst:290 +#: ../../rst/installation_guide/intro_installation.rst:291 msgid "`Mailing List <https://groups.google.com/group/ansible-project>`_" -msgstr "`メーリングリスト <https://groups.google.com/group/ansible-project>`_" +msgstr "`Mailing List <https://groups.google.com/group/ansible-project>`_" -#: ../../rst/installation_guide/intro_installation.rst:291 +#: ../../rst/installation_guide/intro_installation.rst:292 msgid "Questions? Help? Ideas? Stop by the list on Google Groups" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ案ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google グループã®ä¸€è¦§ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/installation_guide/intro_installation.rst:292 +#: ../../rst/installation_guide/intro_installation.rst:293 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" -#: ../../rst/installation_guide/intro_installation.rst:293 +#: ../../rst/installation_guide/intro_installation.rst:294 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory.po index 43adbb8c..460e557d 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-02-23 10:50+0100\n" +"POT-Creation-Date: 2022-11-03 09:23+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -21,38 +21,39 @@ msgid "Implicit 'localhost'" msgstr "暗黙的ãªã€Œlocalhostã€" #: ../../rst/inventory/implicit_localhost.rst:8 -msgid "When you try to reference a ``localhost`` and you don't have it defined in inventory, Ansible will create an implicit one for you.::" -msgstr "``localhost`` ã‚’å‚ç…§ã—よã†ã¨ã—ãŸã«ã‚‚ã‹ã‹ã‚らãšã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«ãã® localhost ãŒå®šç¾©ã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€Ansible ã«ã‚ˆã‚Šæš—黙的 localhost ãŒä½œæˆã•ã‚Œã¾ã™::" +msgid "When you try to reference a ``localhost`` and you don't have it defined in inventory, Ansible will create an implicit one for you.:" +msgstr "``localhost`` ã‚’å‚ç…§ã—よã†ã¨ã—ãŸã«ã‚‚ã‹ã‹ã‚らãšã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«ãã® localhost ãŒå®šç¾©ã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€Ansible ã«ã‚ˆã‚Šæš—黙的 localhost ãŒä½œæˆã•ã‚Œã¾ã™ã€‚:" -#: ../../rst/inventory/implicit_localhost.rst:16 -msgid "In a case like this (or ``local_action``) when Ansible needs to contact a 'localhost' but you did not supply one, we create one for you. This host is defined with specific connection variables equivalent to this in an inventory::" -msgstr "上記ã®ã‚ˆã†ãªå ´åˆ (ã¾ãŸã¯ ``local_action``) ã§ã€Ansible ãŒã€Œlocalhostã€ã«å•ã„åˆã‚ã›ã‚’ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã«ã‚‚ã‹ã‹ã‚らãšã€localhost を作æˆã—ã¦ã„ãªã„å ´åˆã«ã¯ã€Ansible 㧠localhost ãŒä½œæˆã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ›ã‚¹ãƒˆã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«ã‚ã‚‹ã‚‚ã®ã¨åŒç‰ã®ç‰¹å®šã®æŽ¥ç¶šå¤‰æ•°ã§å®šç¾©ã•ã‚Œã¾ã™::" +#: ../../rst/inventory/implicit_localhost.rst:18 +msgid "In a case like this (or ``local_action``) when Ansible needs to contact a 'localhost' but you did not supply one, we create one for you. This host is defined with specific connection variables equivalent to this in an inventory:" +msgstr "上記ã®ã‚ˆã†ãªå ´åˆ (ã¾ãŸã¯ ``local_action``) ã§ã€Ansible ãŒã€Œlocalhostã€ã«å•ã„åˆã‚ã›ã‚’ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã«ã‚‚ã‹ã‹ã‚らãšã€localhost を作æˆã—ã¦ã„ãªã„å ´åˆã«ã¯ã€Ansible 㧠localhost ãŒä½œæˆã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ›ã‚¹ãƒˆã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«ã‚ã‚‹ã‚‚ã®ã¨åŒç‰ã®ç‰¹å®šã®æŽ¥ç¶šå¤‰æ•°ã§å®šç¾©ã•ã‚Œã¾ã™:" -#: ../../rst/inventory/implicit_localhost.rst:26 +#: ../../rst/inventory/implicit_localhost.rst:30 msgid "This ensures that the proper connection and Python are used to execute your tasks locally. You can override the built-in implicit version by creating a ``localhost`` host entry in your inventory. At that point, all implicit behaviors are ignored; the ``localhost`` in inventory is treated just like any other host. Group and host vars will apply, including connection vars, which includes the ``ansible_python_interpreter`` setting. This will also affect ``delegate_to: localhost`` and ``local_action``, the latter being an alias to the former." msgstr "ã“ã®è¨å®šã«ã‚ˆã‚Šã€é©åˆ‡ãªæŽ¥ç¶šã¨ Python ãŒãƒãƒ¼ã‚«ãƒ«ã§ã‚¿ã‚¹ã‚¯ã‚’実行ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚ˆã†ã«ã¾ã™ã€‚インベントリー㫠``localhost`` ホストエントリーを作æˆã™ã‚‹ã¨ã€çµ„ã¿è¾¼ã¿ã®æš—黙的ホストã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’上書ãã§ãã¾ã™ã€‚ã“ã®æ™‚点ã§ã€æš—黙的ãªå‹•ä½œã¯ã™ã¹ã¦ç„¡è¦–ã•ã‚Œã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã® ``localhost`` ã¯ä»–ã®ãƒ›ã‚¹ãƒˆã¨åŒã˜ã‚ˆã†ã«å‡¦ç†ã•ã‚Œã¾ã™ã€‚グループãŠã‚ˆã³ãƒ›ã‚¹ãƒˆã®å¤‰æ•° (接続変数をå«ã‚€) ãŒé©ç”¨ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã¯ã€``ansible_python_interpreter`` è¨å®šãŒå«ã¾ã‚Œã¾ã™ã€‚グループãŠã‚ˆã³ãƒ›ã‚¹ãƒˆå¤‰æ•°ã®è¨å®šã¯ã€``delegate_to: localhost`` ãŠã‚ˆã³ ``local_action`` ã«ã‚‚é©ç”¨ã•ã‚Œã€``local_action`` 㯠``delegate_to: localhost`` ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory/implicit_localhost.rst:30 +#: ../../rst/inventory/implicit_localhost.rst:35 msgid "This host is not targetable via any group, however it will use vars from ``host_vars`` and from the 'all' group." msgstr "ã“ã®ãƒ›ã‚¹ãƒˆã‚’ターゲットã«ã§ãるグループã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€``host_vars`` ã¨ã€Œallã€ã‚°ãƒ«ãƒ¼ãƒ—ã®å¤‰æ•°ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/inventory/implicit_localhost.rst:31 +#: ../../rst/inventory/implicit_localhost.rst:36 msgid "Implicit localhost does not appear in the ``hostvars`` magic variable unless demanded, such as by ``\"{{ hostvars['localhost'] }}\"``." msgstr "``\"{{ hostvars['localhost'] }}\"`` ãªã©ã®è¦æ±‚ãŒãªã„é™ã‚Šã€æš—黙的㪠localhost 㯠``hostvars`` マジック変数ã«ã¯è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/inventory/implicit_localhost.rst:32 +#: ../../rst/inventory/implicit_localhost.rst:37 msgid "The ``inventory_file`` and ``inventory_dir`` magic variables are not available for the implicit localhost as they are dependent on **each inventory host**." msgstr "マジック変数 ``inventory_file`` ãŠã‚ˆã³ ``inventory_dir`` ã¯ã€**å„インベントリーホスト** ã«ä¾å˜ã—ã¦ã„ã‚‹ãŸã‚ã€æš—黙的㪠localhost ã§ã¯åˆ©ç”¨ã§ãã¾ã›ã‚“。" -#: ../../rst/inventory/implicit_localhost.rst:33 +#: ../../rst/inventory/implicit_localhost.rst:38 msgid "This implicit host also gets triggered by using ``127.0.0.1`` or ``::1`` as they are the IPv4 and IPv6 representations of 'localhost'." msgstr "ã“ã®æš—黙的ホストã¯ã€ã€Œlocalhostã€ã® IPv4 ãŠã‚ˆã³ IPv6 ã®è¡¨ç¾ã§ã‚ã‚‹ãŸã‚ã€``127.0.0.1`` ã¾ãŸã¯ ``::1`` を使用ã—ã¦ã‚‚発生ã—ã¾ã›ã‚“。" -#: ../../rst/inventory/implicit_localhost.rst:34 +#: ../../rst/inventory/implicit_localhost.rst:39 msgid "Even though there are many ways to create it, there will only ever be ONE implicit localhost, using the name first used to create it." msgstr "ãれを作æˆã™ã‚‹æ–¹æ³•ã¯å¤šæ•°ã‚ã‚Šã¾ã™ãŒã€æš—黙的㪠localhost 㯠1 ã¤ã ã‘å˜åœ¨ã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚最åˆã«ä½œæˆã—ãŸã¨ãã«ä½¿ç”¨ã—ãŸåå‰ãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory/implicit_localhost.rst:35 +#: ../../rst/inventory/implicit_localhost.rst:40 msgid "Having ``connection: local`` does NOT trigger an implicit localhost, you are just changing the connection for the ``inventory_hostname``." msgstr "``connection: local`` ãŒã‚ã£ã¦ã‚‚暗黙的㪠localhost ãŒä½œæˆã•ã‚Œãªã„å ´åˆã¯ã€``inventory_hostname`` ã®æŽ¥ç¶šã‚’変更ã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory_guide.po index 581da766..6507816f 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/inventory_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/inventory_guide/connection_details.rst:5 msgid "Connection methods and details" @@ -331,8 +331,8 @@ msgid "Other inventory scripts" msgstr "ãã®ä»–ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—ト" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:211 -msgid "In Ansible 2.10 and later, inventory scripts moved to their associated collections. Many are now in the `community.general scripts/inventory directory <https://github.com/ansible-collections/community.general/tree/main/scripts/inventory>`_. We recommend you use :ref:`inventory_plugins` instead." -msgstr "Ansible 2.10 以é™ã§ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯é–¢é€£ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»å‹•ã—ã¾ã—ãŸã€‚ç¾åœ¨ã€å¤šãã®ã‚¹ã‚¯ãƒªãƒ—ト㯠`community.general scripts/inventory directory <https://github.com/ansible-collections/community.general/tree/main/scripts/inventory>`_ ã«ã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« :ref:`inventory_plugins` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" +msgid "In Ansible 2.10 and later, inventory scripts moved to their associated collections. Many are now in the `ansible-community/contrib-scripts repository <https://github.com/ansible-community/contrib-scripts/tree/main/inventory>`_. We recommend you use :ref:`inventory_plugins` instead." +msgstr "Ansible 2.10 以é™ã§ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯é–¢é€£ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»å‹•ã—ã¾ã—ãŸã€‚ç¾åœ¨ã€å¤šãã®ã‚¹ã‚¯ãƒªãƒ—ト㯠`ansible-community/contrib-scripts repository <https://github.com/ansible-community/contrib-scripts/tree/main/inventory>`_ ã«ã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« :ref:`inventory_plugins` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:216 msgid "Using inventory directories and multiple inventory sources" @@ -371,25 +371,25 @@ msgid "All about static inventory files" msgstr "é™çš„インベントリーファイルã®è©³ç´°" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:257 -#: ../../rst/inventory_guide/intro_inventory.rst:832 +#: ../../rst/inventory_guide/intro_inventory.rst:838 #: ../../rst/inventory_guide/intro_patterns.rst:250 msgid "`Mailing List <https://groups.google.com/group/ansible-project>`_" msgstr "`Mailing List <https://groups.google.com/group/ansible-project>`_" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:258 -#: ../../rst/inventory_guide/intro_inventory.rst:833 +#: ../../rst/inventory_guide/intro_inventory.rst:839 #: ../../rst/inventory_guide/intro_patterns.rst:251 msgid "Questions? Help? Ideas? Stop by the list on Google Groups" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ案ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google グループã®ä¸€è¦§ã‚’ã”覧ãã ã•ã„。" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:259 -#: ../../rst/inventory_guide/intro_inventory.rst:834 +#: ../../rst/inventory_guide/intro_inventory.rst:840 #: ../../rst/inventory_guide/intro_patterns.rst:252 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" #: ../../rst/inventory_guide/intro_dynamic_inventory.rst:260 -#: ../../rst/inventory_guide/intro_inventory.rst:835 +#: ../../rst/inventory_guide/intro_inventory.rst:841 #: ../../rst/inventory_guide/intro_patterns.rst:253 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -471,652 +471,670 @@ msgid "You can create parent/child relationships among groups. Parent groups are msgstr "グループ間ã§è¦ª/å関係を作æˆã§ãã¾ã™ã€‚親グループã¯ã€ãƒã‚¹ãƒˆã•ã‚ŒãŸã‚°ãƒ«ãƒ¼ãƒ—ã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—ã®ã‚°ãƒ«ãƒ¼ãƒ—ã¨ã‚‚呼ã°ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€ã™ã¹ã¦ã®å®Ÿç¨¼åƒãƒ›ã‚¹ãƒˆãŒ ``atlanta_prod`` ã‚„ ``denver_prod`` ãªã©ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«ã™ã§ã«ã‚ã‚‹å ´åˆã¯ã€ã“れらã®å°è¦æ¨¡ãªã‚°ãƒ«ãƒ¼ãƒ—ã‚’å«ã‚€ ``production`` グループを作æˆã§ãã¾ã™ã€‚ã“ã®æ–¹æ³•ã§ã¯ã€åグループを編集ã—ã¦è¦ªã‚°ãƒ«ãƒ¼ãƒ—ã‹ã‚‰ãƒ›ã‚¹ãƒˆã‚’è¿½åŠ ã¾ãŸã¯å‰Šé™¤ã§ãã‚‹ãŸã‚ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ãŒè»½æ¸›ã•ã‚Œã¾ã™ã€‚" #: ../../rst/inventory_guide/intro_inventory.rst:130 -msgid "To create parent/child relationships for groups: * in INI format, use the ``:children`` suffix * in YAML format, use the ``children:`` entry" -msgstr "グループã®è¦ª/åã®é–¢ä¿‚を作æˆã™ã‚‹ã«ã¯ã€ * INI å½¢å¼ã®å ´åˆã«ã¯ ``:children`` ã®æŽ¥å°¾è¾žã‚’〠* YAML å½¢å¼ã®å ´åˆã¯ ``children:`` エントリーを使用ã—ã¾ã™ã€‚" +msgid "To create parent/child relationships for groups:" +msgstr "グループã®è¦ªå関係を作æˆã™ã‚‹ã«ã¯ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:134 +#: ../../rst/inventory_guide/intro_inventory.rst:132 +msgid "in INI format, use the ``:children`` suffix" +msgstr "INI å½¢å¼ã®å ´åˆã¯ã€``:children`` 接尾辞を使用ã—ã¾ã™ã€‚" + +#: ../../rst/inventory_guide/intro_inventory.rst:133 +msgid "in YAML format, use the ``children:`` entry" +msgstr "YAML å½¢å¼ã®å ´åˆã¯ã€``children:``エントリーを使用ã—ã¾ã™ã€‚" + +#: ../../rst/inventory_guide/intro_inventory.rst:135 msgid "Here is the same inventory as shown above, simplified with parent groups for the ``prod`` and ``test`` groups. The two inventory files give you the same results:" msgstr "``prod`` ãŠã‚ˆã³ ``test`` グループã®è¦ªã‚°ãƒ«ãƒ¼ãƒ—を使用ã—ã¦ç°¡ç´ 化ã•ã‚ŒãŸä¸Šè¨˜ã¨åŒã˜ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’示ã—ã¾ã™ã€‚2 ã¤ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ã€åŒã˜çµæžœãŒå¾—られã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:167 +#: ../../rst/inventory_guide/intro_inventory.rst:168 msgid "Child groups have a couple of properties to note:" msgstr "åグループã«ã¯ã€æ³¨æ„ã™ã¹ã以下ã®ãƒ—ãƒãƒ‘ティーãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:169 +#: ../../rst/inventory_guide/intro_inventory.rst:170 msgid "Any host that is member of a child group is automatically a member of the parent group." msgstr "åグループã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã‚るホストã¯ã€è‡ªå‹•çš„ã«è¦ªã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒ¡ãƒ³ãƒãƒ¼ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:170 +#: ../../rst/inventory_guide/intro_inventory.rst:171 msgid "Groups can have multiple parents and children, but not circular relationships." msgstr "グループã«è¤‡æ•°ã®è¦ªã¨åã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã™ãŒã€å¾ªç’°é–¢ä¿‚ã¯è¨å®šã§ãã¾ã›ã‚“。" -#: ../../rst/inventory_guide/intro_inventory.rst:171 +#: ../../rst/inventory_guide/intro_inventory.rst:172 msgid "Hosts can also be in multiple groups, but there will only be **one** instance of a host at runtime. Ansible merges the data from the multiple groups." msgstr "ホストã¯è¤‡æ•°ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«å±žã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€ãƒ›ã‚¹ãƒˆã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã¯ **1 ã¤** ã ã‘ã§ã‚ã‚Šã€Ansible ã¯è¤‡æ•°ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‹ã‚‰ã®ãƒ‡ãƒ¼ã‚¿ã‚’マージã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:174 +#: ../../rst/inventory_guide/intro_inventory.rst:175 msgid "Adding ranges of hosts" msgstr "ホスト範囲ã®è¿½åŠ " -#: ../../rst/inventory_guide/intro_inventory.rst:176 +#: ../../rst/inventory_guide/intro_inventory.rst:177 msgid "If you have a lot of hosts with a similar pattern, you can add them as a range rather than listing each hostname separately:" msgstr "åŒæ§˜ã®ãƒ‘ターンをæŒã¤ãƒ›ã‚¹ãƒˆãŒå¤šæ•°ã‚ã‚‹å ´åˆã¯ã€å„ホストåを個別ã«è¡¨ç¤ºã™ã‚‹ã®ã§ã¯ãªãã€ãƒ›ã‚¹ãƒˆã‚’範囲ã¨ã—ã¦è¿½åŠ ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:178 -#: ../../rst/inventory_guide/intro_inventory.rst:196 -#: ../../rst/inventory_guide/intro_inventory.rst:341 -#: ../../rst/inventory_guide/intro_inventory.rst:412 +#: ../../rst/inventory_guide/intro_inventory.rst:179 +#: ../../rst/inventory_guide/intro_inventory.rst:197 +#: ../../rst/inventory_guide/intro_inventory.rst:298 +#: ../../rst/inventory_guide/intro_inventory.rst:344 +#: ../../rst/inventory_guide/intro_inventory.rst:384 +#: ../../rst/inventory_guide/intro_inventory.rst:417 msgid "In INI:" msgstr "INI ã®å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:185 -#: ../../rst/inventory_guide/intro_inventory.rst:203 -#: ../../rst/inventory_guide/intro_inventory.rst:303 -#: ../../rst/inventory_guide/intro_inventory.rst:347 -#: ../../rst/inventory_guide/intro_inventory.rst:391 -#: ../../rst/inventory_guide/intro_inventory.rst:440 +#: ../../rst/inventory_guide/intro_inventory.rst:186 +#: ../../rst/inventory_guide/intro_inventory.rst:204 +#: ../../rst/inventory_guide/intro_inventory.rst:306 +#: ../../rst/inventory_guide/intro_inventory.rst:350 +#: ../../rst/inventory_guide/intro_inventory.rst:396 +#: ../../rst/inventory_guide/intro_inventory.rst:445 msgid "In YAML:" msgstr "YAML ã®å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:194 +#: ../../rst/inventory_guide/intro_inventory.rst:195 msgid "You can specify a stride (increments between sequence numbers) when defining a numeric range of hosts:" msgstr "ホストã®æ•°å€¤ç¯„囲を定義ã™ã‚‹éš›ã«ã€stride (シーケンス番å·é–“ã®å¢—分) を指定ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:212 +#: ../../rst/inventory_guide/intro_inventory.rst:213 msgid "The example above would make the subdomains www01, www03, www05, ..., www49 match, but not www00, www02, www50 and so on, because the stride (increment) is 2 units each step." msgstr "上記ã®ä¾‹ã§ã¯ã€stride (増分) ã¯ã‚¹ãƒ†ãƒƒãƒ—ã”ã¨ã« 2 ユニットã§ã‚ã‚‹ãŸã‚ã€ã‚µãƒ–ドメイン www01ã€www03ã€www05ã€..ã€www49 ã¯ä¸€è‡´ã—ã¾ã™ãŒã€www00ã€www02ã€www50 ãªã©ã¯ä¸€è‡´ã—ã¾ã›ã‚“。" -#: ../../rst/inventory_guide/intro_inventory.rst:214 +#: ../../rst/inventory_guide/intro_inventory.rst:215 msgid "For numeric patterns, leading zeros can be included or removed, as desired. Ranges are inclusive. You can also define alphabetic ranges:" msgstr "数値ã®ãƒ‘ターンã§ã¯ã€å¿…è¦ã«å¿œã˜ã¦å…ˆé ã«ã‚¼ãƒã‚’å«ã‚ã‚‹ã‹ã€ã¾ãŸã¯å‰Šé™¤ã§ãã¾ã™ã€‚範囲ã¯åŒ…å«çš„範囲も定義ã§ãã¾ã™ã€‚ã¾ãŸã€ã‚¢ãƒ«ãƒ•ã‚¡ãƒ™ãƒƒãƒˆã®ç¯„囲も定義ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:224 +#: ../../rst/inventory_guide/intro_inventory.rst:225 msgid "Passing multiple inventory sources" msgstr "複数ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã®æŒ‡å®š" -#: ../../rst/inventory_guide/intro_inventory.rst:226 +#: ../../rst/inventory_guide/intro_inventory.rst:227 msgid "You can target multiple inventory sources (directories, dynamic inventory scripts or files supported by inventory plugins) at the same time by giving multiple inventory parameters from the command line or by configuring :envvar:`ANSIBLE_INVENTORY`. This can be useful when you want to target normally separate environments, like staging and production, at the same time for a specific action." msgstr "コマンドラインã‹ã‚‰è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‘ラメーターを指定ã™ã‚‹ã‹ã€:envvar:`ANSIBLE_INVENTORY` ã‚’è¨å®šã™ã‚‹ã“ã¨ã§ã€è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒªã‚½ãƒ¼ã‚¹ (ディレクトリーã€å‹•çš„インベントリースクリプトã€ã¾ãŸã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインã«ã‚ˆã‚Šã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ãƒ•ã‚¡ã‚¤ãƒ«) ã‚’åŒæ™‚ã«å¯¾è±¡ã«æŒ‡å®šã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€ã‚¹ãƒ†ãƒ¼ã‚¸ç’°å¢ƒã‚„実稼åƒç’°å¢ƒãªã©ã€é€šå¸¸ã¯ç•°ãªã‚‹ç’°å¢ƒã‚’åŒæ™‚ã«å¯¾è±¡ã«æŒ‡å®šã«ã—ã¦ç‰¹å®šã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã‚’実行ã—ãŸã„å ´åˆã«ä¾¿åˆ©ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:231 +#: ../../rst/inventory_guide/intro_inventory.rst:232 msgid "To target two inventory sources from the command line:" msgstr "コマンドラインã‹ã‚‰ 2 ã¤ã®ã‚½ã‚¤ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’対象ã¨ã™ã‚‹ã«ã¯ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:240 +#: ../../rst/inventory_guide/intro_inventory.rst:241 msgid "Organizing inventory in a directory" msgstr "ディレクトリー内ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®æ•´ç†" -#: ../../rst/inventory_guide/intro_inventory.rst:242 +#: ../../rst/inventory_guide/intro_inventory.rst:243 msgid "You can consolidate multiple inventory sources in a single directory. The simplest version of this is a directory with multiple files instead of a single inventory file. A single file gets difficult to maintain when it gets too long. If you have multiple teams and multiple automation projects, having one inventory file per team or project lets everyone easily find the hosts and groups that matter to them." msgstr "複数ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’ 1 ã¤ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«çµ±åˆã§ãã¾ã™ã€‚ã“ã‚Œã®æœ€ã‚‚å˜ç´”ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€å˜ä¸€ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ãªãã€è¤‡æ•°ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’å«ã‚€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§ã™ã€‚1 ã¤ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒé•·ããªã‚Šã™ãŽã‚‹ã¨ã€ç®¡ç†ãŒé›£ã—ããªã‚Šã¾ã™ã€‚複数ã®ãƒãƒ¼ãƒ ã¨è¤‡æ•°ã®è‡ªå‹•åŒ–プãƒã‚¸ã‚§ã‚¯ãƒˆãŒã‚ã‚‹å ´åˆã€ãƒãƒ¼ãƒ ã¾ãŸã¯ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã”ã¨ã« 1 ã¤ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã™ã‚‹ã¨ã€èª°ã§ã‚‚é‡è¦ãªãƒ›ã‚¹ãƒˆã¨ã‚°ãƒ«ãƒ¼ãƒ—ã‚’ç°¡å˜ã«è¦‹ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:244 +#: ../../rst/inventory_guide/intro_inventory.rst:245 msgid "You can also combine multiple inventory source types in an inventory directory. This can be useful for combining static and dynamic hosts and managing them as one inventory. The following inventory directory combines an inventory plugin source, a dynamic inventory script, and a file with static hosts:" msgstr "ã¾ãŸã€è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚„ソースタイプを 1 ã¤ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ä¸‹ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’çµ±åˆã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€é™çš„ホストã¨å‹•çš„ホストを組ã¿åˆã‚ã›ã¦ã€1 ã¤ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã¨ã—ã¦ç®¡ç†ã™ã‚‹ã®ã«ä¾¿åˆ©ã§ã™ã€‚次ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインソースã€å‹•çš„インベントリースクリプトã€ãŠã‚ˆã³é™çš„ホストã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’組ã¿åˆã‚ã›ãŸã‚‚ã®ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:256 +#: ../../rst/inventory_guide/intro_inventory.rst:257 msgid "You can target this inventory directory as follows:" msgstr "ã“ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã¯ã€æ¬¡ã®ã‚ˆã†ã«ç°¡å˜ã«å¯¾è±¡ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:262 +#: ../../rst/inventory_guide/intro_inventory.rst:263 msgid "You can also configure the inventory directory in your ``ansible.cfg`` file. See :ref:`intro_configuration` for more details." msgstr "``ansible.cfg`` ファイル㧠inventory ディレクトリーをè¨å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚詳細ã¯ã€:ref:`intro_configuration` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:265 +#: ../../rst/inventory_guide/intro_inventory.rst:266 msgid "Managing inventory load order" msgstr "インベントリーã®èªã¿è¾¼ã¿é †åºã®ç®¡ç†" -#: ../../rst/inventory_guide/intro_inventory.rst:267 +#: ../../rst/inventory_guide/intro_inventory.rst:268 msgid "Ansible loads inventory sources in ASCII order according to the filenames. If you define parent groups in one file or directory and child groups in other files or directories, the files that define the child groups must be loaded first. If the parent groups are loaded first, you will see the error ``Unable to parse /path/to/source_of_parent_groups as an inventory source``." msgstr "Ansible ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«åã«å¾“ã£ã¦ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’ ASCII é †ã«èªã¿è¾¼ã¿ã¾ã™ã€‚親グループを他ã®ãƒ•ã‚¡ã‚¤ãƒ«ã¾ãŸã¯ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã® 1 ã¤ã¾ãŸã¯ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§å®šç¾©ã—ã€åグループを定義ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã‚’å…ˆã«èªã¿è¾¼ã‚€å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚親グループãŒæœ€åˆã«èªã¿è¾¼ã¾ã‚Œã‚‹ã¨ã€``Unable to parse /path/to/source_of_parent_groups as an inventory source`` ã¨ã„ã†ã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:269 +#: ../../rst/inventory_guide/intro_inventory.rst:270 msgid "For example, if you have a file called ``groups-of-groups`` that defines a ``production`` group with child groups defined in a file called ``on-prem``, Ansible cannot parse the ``production`` group. To avoid this problem, you can control the load order by adding prefixes to the files:" msgstr "ãŸã¨ãˆã°ã€``on-prem`` ã¨ã„ã†ãƒ•ã‚¡ã‚¤ãƒ«ã§å®šç¾©ã•ã‚ŒãŸåグループをæŒã¤ ``production`` グループを定義ã™ã‚‹ ``groups-of-groups`` ã¨ã„ã†ãƒ•ã‚¡ã‚¤ãƒ«ãŒã‚ã‚‹å ´åˆã€Ansible 㯠``production`` グループを解æžã§ãã¾ã›ã‚“。ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã«æŽ¥é è¾žã‚’è¿½åŠ ã—ã¦ã€èªã¿è¾¼ã¿é †åºã‚’制御ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:279 +#: ../../rst/inventory_guide/intro_inventory.rst:280 msgid "You can find examples of how to organize your inventories and group your hosts in :ref:`inventory_setup_examples`." msgstr "インベントリーを整ç†ã—ã€ãƒ›ã‚¹ãƒˆã‚’グループ化ã™ã‚‹æ–¹æ³•ã¯ã€:ref:`inventory_setup_examples` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:284 +#: ../../rst/inventory_guide/intro_inventory.rst:285 msgid "Adding variables to inventory" msgstr "インベントリーã¸ã®å¤‰æ•°ã®è¿½åŠ " -#: ../../rst/inventory_guide/intro_inventory.rst:286 +#: ../../rst/inventory_guide/intro_inventory.rst:287 msgid "You can store variable values that relate to a specific host or group in inventory. To start with, you may add variables directly to the hosts and groups in your main inventory file." msgstr "インベントリーã®ç‰¹å®šã®ãƒ›ã‚¹ãƒˆã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—ã«é–¢é€£ã™ã‚‹å¤‰æ•°å€¤ã‚’ä¿å˜ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã¾ãšã¯ã€ãƒ¡ã‚¤ãƒ³ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ›ã‚¹ãƒˆãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—ã«å¤‰æ•°ã‚’ç›´æŽ¥è¿½åŠ ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:288 +#: ../../rst/inventory_guide/intro_inventory.rst:289 msgid "We document adding variables in the main inventory file for simplicity. However, storing variables in separate host and group variable files is a more robust approach to describing your system policy. Setting variables in the main inventory file is only a shorthand. See :ref:`splitting_out_vars` for guidelines on storing variable values in individual files in the 'host_vars' directory. See :ref:`splitting_out_vars` for details." msgstr "簡略化ã®ç›®çš„ã§ã€ãƒ¡ã‚¤ãƒ³ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã«å¤‰æ•°ã‚’è¿½åŠ ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦èª¬æ˜Žã—ã¾ã™ã€‚ãŸã ã—ã€å¤‰æ•°ã‚’別々ã®ãƒ›ã‚¹ãƒˆå¤‰æ•°ãƒ•ã‚¡ã‚¤ãƒ«ã¨ã‚°ãƒ«ãƒ¼ãƒ—変数ファイルã«æ ¼ç´ã™ã‚‹æ–¹ãŒã€ã‚ˆã‚Šç¢ºå®Ÿã«ã‚·ã‚¹ãƒ†ãƒ ãƒãƒªã‚·ãƒ¼ã‚’記述ã§ãã¾ã™ã€‚メインã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã«å¤‰æ•°ã‚’è¨å®šã™ã‚‹ã“ã¨ã¯ã€çœç•¥å½¢ã«éŽãŽã¾ã›ã‚“。'host_vars' ディレクトリーã®å€‹åˆ¥ãƒ•ã‚¡ã‚¤ãƒ«ã«å¤‰æ•°ã‚’ä¿å˜ã™ã‚‹ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã¯ã€:ref:`splitting_out_vars` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。詳細ã¯ã€:ref:`splitting_out_vars` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:293 +#: ../../rst/inventory_guide/intro_inventory.rst:294 msgid "Assigning a variable to one machine: host variables" msgstr "ã‚るマシンã¸ã®å¤‰æ•°ã®å‰²ã‚Šå½“ã¦: ホスト変数" -#: ../../rst/inventory_guide/intro_inventory.rst:295 -msgid "You can easily assign a variable to a single host, then use it later in playbooks. You can do this directly in your inventory file. In INI:" -msgstr "1 å°ã®ãƒ›ã‚¹ãƒˆã«å¤‰æ•°ã‚’ç°¡å˜ã«å‰²ã‚Šå½“ã¦ã‚‹ã¨ã€å¾Œã§ Playbook ã§ä½¿ç”¨ã§ãã¾ã™ã€‚インベントリーファイルã§ç›´æŽ¥ã“れを実行ã§ãã¾ã™ã€‚INI ã§ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" +#: ../../rst/inventory_guide/intro_inventory.rst:296 +msgid "You can easily assign a variable to a single host, then use it later in playbooks. You can do this directly in your inventory file." +msgstr "1 å°ã®ãƒ›ã‚¹ãƒˆã«å¤‰æ•°ã‚’ç°¡å˜ã«å‰²ã‚Šå½“ã¦ã‚‹ã¨ã€å¾Œã§ Playbook ã§ä½¿ç”¨ã§ãã¾ã™ã€‚インベントリーファイルã§ç›´æŽ¥ã“れを実行ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:316 +#: ../../rst/inventory_guide/intro_inventory.rst:319 msgid "Unique values like non-standard SSH ports work well as host variables. You can add them to your Ansible inventory by adding the port number after the hostname with a colon:" msgstr "éžæ¨™æº–ã® SSH ãƒãƒ¼ãƒˆã®ã‚ˆã†ãªä¸€æ„ãªå€¤ã¯ã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ã¨ã—ã¦ã†ã¾ã機能ã—ã¾ã™ã€‚ホストåã®å¾Œã«ã‚³ãƒãƒ³ã‚’付ã‘ã¦ãƒãƒ¼ãƒˆç•ªå·ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã€Ansible インベントリーã«è¿½åŠ ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:322 +#: ../../rst/inventory_guide/intro_inventory.rst:325 msgid "Connection variables also work well as host variables:" msgstr "接続変数もホスト変数ã¨ã—ã¦æ©Ÿèƒ½ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:332 +#: ../../rst/inventory_guide/intro_inventory.rst:335 msgid "If you list non-standard SSH ports in your SSH config file, the ``openssh`` connection will find and use them, but the ``paramiko`` connection will not." msgstr "SSH è¨å®šãƒ•ã‚¡ã‚¤ãƒ«å†…ã«éžæ¨™æº–ã® SSH ãƒãƒ¼ãƒˆã®ä¸€è¦§ã‚’表示ã—ãŸå ´åˆã€``openssh`` 接続ã¯ãã®ãƒãƒ¼ãƒˆã‚’見ã¤ã‘ã¦ä½¿ç”¨ã—ã¾ã™ãŒã€``paramiko`` 接続ã¯è¡Œã‚ã‚Œã¾ã›ã‚“。" -#: ../../rst/inventory_guide/intro_inventory.rst:337 +#: ../../rst/inventory_guide/intro_inventory.rst:340 msgid "Inventory aliases" msgstr "インベントリーエイリアス" -#: ../../rst/inventory_guide/intro_inventory.rst:339 +#: ../../rst/inventory_guide/intro_inventory.rst:342 msgid "You can also define aliases in your inventory using host variables:" msgstr "ホスト変数を使用ã—ã¦ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’定義ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:357 +#: ../../rst/inventory_guide/intro_inventory.rst:360 msgid "In this example, running Ansible against the host alias \"jumper\" will connect to 192.0.2.50 on port 5555. See :ref:`behavioral inventory parameters <behavioral_parameters>` to further customize the connection to hosts." msgstr "ã“ã®ä¾‹ã§ã¯ã€ãƒ›ã‚¹ãƒˆã®åˆ¥å「jumperã€ã«å¯¾ã—㦠Ansible を実行ã™ã‚‹ã¨ã€ãƒãƒ¼ãƒˆ 5555 ã® 192.0.2.50 ã«æŽ¥ç¶šã•ã‚Œã¾ã™ã€‚ホストã¸ã®æŽ¥ç¶šã‚’ã•ã‚‰ã«ã‚«ã‚¹ã‚¿ãƒžã‚¤ã‚ºã™ã‚‹ã«ã¯ã€ã€Œ:ref:`behavioral inventory parameters <behavioral_parameters>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:360 +#: ../../rst/inventory_guide/intro_inventory.rst:363 msgid "Defining variables in INI format" msgstr "INI å½¢å¼ã§ã®å¤‰æ•°ã®å®šç¾©" -#: ../../rst/inventory_guide/intro_inventory.rst:362 +#: ../../rst/inventory_guide/intro_inventory.rst:365 msgid "Values passed in the INI format using the ``key=value`` syntax are interpreted differently depending on where they are declared:" msgstr "``key=value`` 構文を使用ã—㦠INI å½¢å¼ã§æ¸¡ã•ã‚Œã‚‹å€¤ãŒè§£é‡ˆã•ã‚Œã‚‹æ–¹æ³•ã¯ã€å®£è¨€ã•ã‚Œã‚‹å ´æ‰€ã«å¿œã˜ã¦ç•°ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:364 +#: ../../rst/inventory_guide/intro_inventory.rst:367 msgid "When declared inline with the host, INI values are interpreted as Python literal structures (strings, numbers, tuples, lists, dicts, booleans, None). Host lines accept multiple ``key=value`` parameters per line. Therefore they need a way to indicate that a space is part of a value rather than a separator. Values that contain whitespace can be quoted (single or double). See the `Python shlex parsing rules`_ for details." msgstr "ホストã®ã‚¤ãƒ³ãƒ©ã‚¤ãƒ³ã§å®£è¨€ã™ã‚‹ã¨ã€INI 値㯠Pythonã® ãƒªãƒ†ãƒ©ãƒ«æ§‹é€ (æ–‡å—列ã€æ•°å€¤ã€ã‚¿ãƒ—ルã€ãƒªã‚¹ãƒˆã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã€ãƒ–ール値ã€ãªã—) ã¨ã—ã¦è§£é‡ˆã•ã‚Œã¾ã™ã€‚ホストã®è¡Œã¯ã€1 è¡Œã«ã¤ã複数㮠``key=value`` パラメーターをå—ã‘付ã‘ã¾ã™ã€‚ãã®ãŸã‚ã€ã‚¹ãƒšãƒ¼ã‚¹ãŒåŒºåˆ‡ã‚Šæ–‡å—ã§ã¯ãªã値ã®ä¸€éƒ¨ã§ã‚ã‚‹ã“ã¨ã‚’示ã™æ–¹æ³•ãŒå¿…è¦ã§ã™ã€‚スペースãŒå«ã¾ã‚Œã‚‹å€¤ã‚’引用符(一é‡ã¾ãŸã¯äºŒé‡)ã§å›²ã‚€ã“ã¨ãŒã§ãã¾ã™ã€‚詳細ã¯ã€ `Python shlex 解æžãƒ«ãƒ¼ãƒ«`_ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:366 +#: ../../rst/inventory_guide/intro_inventory.rst:369 msgid "When declared in a ``:vars`` section, INI values are interpreted as strings. For example ``var=FALSE`` would create a string equal to 'FALSE'. Unlike host lines, ``:vars`` sections accept only a single entry per line, so everything after the ``=`` must be the value for the entry." msgstr "``:vars`` セクションã§å®£è¨€ã™ã‚‹ã¨ã€INI ã®å€¤ã¯æ–‡å—列ã¨ã—ã¦è§£é‡ˆã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€``var=FALSE`` 㯠FALSE ã¨ç‰ã—ã„æ–‡å—列を作æˆã—ã¾ã™ã€‚ホスト行ã¨ã¯ç•°ãªã‚Šã€``:vars`` セクションã¯è¡Œã”ã¨ã« 1 ã¤ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã®ã¿ã‚’許å¯ã™ã‚‹ãŸã‚ã€``=`` ã®å¾Œã«ç¶šãã™ã¹ã¦ã®ã‚‚ã®ãŒã‚¨ãƒ³ãƒˆãƒªãƒ¼ã®å€¤ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:368 +#: ../../rst/inventory_guide/intro_inventory.rst:371 msgid "If a variable value set in an INI inventory must be a certain type (for example, a string or a boolean value), always specify the type with a filter in your task. Do not rely on types set in INI inventories when consuming variables." msgstr "INI インベントリーã«è¨å®šã•ã‚Œã¦ã„る変数ã®å€¤ãŒç‰¹å®šã®åž‹ (æ–‡å—列やブール値ãªã©) ã§ãªã‘ã‚Œã°ãªã‚‰ãªã„å ´åˆã¯ã€å¿…ãšã‚¿ã‚¹ã‚¯ã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã§åž‹ã‚’指定ã—ã¦ãã ã•ã„。変数を使用ã™ã‚‹éš›ã«ã€INI インベントリーã«è¨å®šã•ã‚Œã¦ã„ã‚‹åž‹ã«é ¼ã‚‰ãªã„ã§ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:370 +#: ../../rst/inventory_guide/intro_inventory.rst:373 msgid "Consider using YAML format for inventory sources to avoid confusion on the actual type of a variable. The YAML inventory plugin processes variable values consistently and correctly." msgstr "変数ã®å®Ÿéš›ã®ã‚¿ã‚¤ãƒ—ã«é–¢ã™ã‚‹æ··ä¹±ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã« YAML å½¢å¼ã‚’使用ã™ã‚‹ã“ã¨ã‚’検討ã—ã¦ãã ã•ã„。YAML インベントリープラグインã¯å¤‰æ•°ã®å€¤ã‚’一貫ã—ã¦ã€æ£ã—ã処ç†ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:377 +#: ../../rst/inventory_guide/intro_inventory.rst:380 msgid "Assigning a variable to many machines: group variables" msgstr "多ãã®ãƒžã‚·ãƒ³ã¸ã®å¤‰æ•°ã®å‰²ã‚Šå½“ã¦: グループ変数" -#: ../../rst/inventory_guide/intro_inventory.rst:379 -msgid "If all hosts in a group share a variable value, you can apply that variable to an entire group at once. In INI:" -msgstr "グループ内ã®ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆãŒå¤‰æ•°ã®å€¤ã‚’共有ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãã®å¤‰æ•°ã‚’グループ全体ã«ä¸€åº¦ã«é©ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚INI ã®å ´åˆã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" +#: ../../rst/inventory_guide/intro_inventory.rst:382 +msgid "If all hosts in a group share a variable value, you can apply that variable to an entire group at once." +msgstr "グループ内ã®ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆãŒå¤‰æ•°ã®å€¤ã‚’共有ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãã®å¤‰æ•°ã‚’グループ全体ã«ä¸€åº¦ã«é©ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:403 +#: ../../rst/inventory_guide/intro_inventory.rst:408 msgid "Group variables are a convenient way to apply variables to multiple hosts at once. Before executing, however, Ansible always flattens variables, including inventory variables, to the host level. If a host is a member of multiple groups, Ansible reads variable values from all of those groups. If you assign different values to the same variable in different groups, Ansible chooses which value to use based on internal :ref:`rules for merging <how_we_merge>`." msgstr "グループ変数ã¯ã€è¤‡æ•°ã®ãƒ›ã‚¹ãƒˆã«ä¸€åº¦ã«å¤‰æ•°ã‚’é©ç”¨ã™ã‚‹ä¾¿åˆ©ãªæ–¹æ³•ã§ã™ã€‚ã—ã‹ã—ã€Ansible ã¯å®Ÿè¡Œå‰ã«ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã‚’å«ã‚€å¤‰æ•°ã‚’常ã«ãƒ›ã‚¹ãƒˆãƒ¬ãƒ™ãƒ«ã«ãƒ•ãƒ©ãƒƒãƒˆåŒ–ã—ã¾ã™ã€‚ホストãŒè¤‡æ•°ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«å±žã—ã¦ã„ã‚‹å ´åˆã€Ansible ã¯ãれらã®ã‚°ãƒ«ãƒ¼ãƒ—ã®ã™ã¹ã¦ã‹ã‚‰å¤‰æ•°ã®å€¤ã‚’èªã¿å–ã‚Šã¾ã™ã€‚ç•°ãªã‚‹ã‚°ãƒ«ãƒ¼ãƒ—ã§åŒã˜å¤‰æ•°ã«ç•°ãªã‚‹å€¤ã‚’割り当ã¦ãŸå ´åˆã€Ansible ã¯å†…部 :ref:`マージã®ãƒ«ãƒ¼ãƒ« <how_we_merge>` ã«åŸºã¥ã„ã¦ã©ã®å€¤ã‚’使用ã™ã‚‹ã‹ã‚’é¸æŠžã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:408 +#: ../../rst/inventory_guide/intro_inventory.rst:413 msgid "Inheriting variable values: group variables for groups of groups" msgstr "変数値ã®ç¶™æ‰¿: グループã®ã‚°ãƒ«ãƒ¼ãƒ—用グループ変数" -#: ../../rst/inventory_guide/intro_inventory.rst:410 +#: ../../rst/inventory_guide/intro_inventory.rst:415 msgid "You can apply variables to parent groups (nested groups or groups of groups) as well as to child groups. The syntax is the same: ``:vars`` for INI format and ``vars:`` for YAML format:" msgstr "åグループã ã‘ã§ãªãã€è¦ªã‚°ãƒ«ãƒ¼ãƒ— (ãƒã‚¹ãƒˆã•ã‚ŒãŸã‚°ãƒ«ãƒ¼ãƒ—ã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—ã®ã‚°ãƒ«ãƒ¼ãƒ—) ã«ã‚‚変数をé©ç”¨ã§ãã¾ã™ã€‚構文ã¯åŒã˜ã§ã™ (INI å½¢å¼ã¯ ``:vars``ã€YAML å½¢å¼ã¯ ``vars:``)。" -#: ../../rst/inventory_guide/intro_inventory.rst:467 +#: ../../rst/inventory_guide/intro_inventory.rst:472 msgid "A child group's variables will have higher precedence (override) a parent group's variables." msgstr "åグループã®å¤‰æ•°ã¯ã€è¦ªã‚°ãƒ«ãƒ¼ãƒ—ã®å¤‰æ•°ã‚ˆã‚Šã‚‚優先度ãŒé«˜ããªã‚Šã¾ã™ (オーãƒãƒ©ã‚¤ãƒ‰)。" -#: ../../rst/inventory_guide/intro_inventory.rst:472 +#: ../../rst/inventory_guide/intro_inventory.rst:477 msgid "Organizing host and group variables" msgstr "ホスト変数ã¨ã‚°ãƒ«ãƒ¼ãƒ—変数ã®æ•´ç†" -#: ../../rst/inventory_guide/intro_inventory.rst:474 +#: ../../rst/inventory_guide/intro_inventory.rst:479 msgid "Although you can store variables in the main inventory file, storing separate host and group variables files may help you organize your variable values more easily. You can also use lists and hash data in host and group variables files, which you cannot do in your main inventory file." msgstr "変数ã¯ãƒ¡ã‚¤ãƒ³ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã«ä¿å˜ã§ãã¾ã™ãŒã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ãƒ•ã‚¡ã‚¤ãƒ«ã¨ã‚°ãƒ«ãƒ¼ãƒ—変数ファイルを別々ã«ä¿å˜ã™ã‚‹ã¨ã€å¤‰æ•°å€¤ã‚’より簡å˜ã«æ•´ç†ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ホスト変数ファイルã¨ã‚°ãƒ«ãƒ¼ãƒ—変数ファイルã§ãƒªã‚¹ãƒˆã¨ãƒãƒƒã‚·ãƒ¥ãƒ‡ãƒ¼ã‚¿ã‚’使用ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€ã“ã‚Œã¯ãƒ¡ã‚¤ãƒ³ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ä½¿ç”¨ã§ãã¾ã›ã‚“。" -#: ../../rst/inventory_guide/intro_inventory.rst:476 +#: ../../rst/inventory_guide/intro_inventory.rst:481 msgid "Host and group variable files must use YAML syntax. Valid file extensions include '.yml', '.yaml', '.json', or no file extension. See :ref:`yaml_syntax` if you are new to YAML." msgstr "ホストãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—変数ファイルã¯ã€YAML 構文を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚有効ãªãƒ•ã‚¡ã‚¤ãƒ«æ‹¡å¼µåã«ã¯ã€.ymlã€.yamlã€.json ãŒå«ã¾ã‚Œã‚‹ã‹ã€ãƒ•ã‚¡ã‚¤ãƒ«æ‹¡å¼µåãŒã‚ã‚Šã¾ã›ã‚“。YAML を使用ã—ãŸã“ã¨ãŒãªã„å ´åˆã«ã¯ã€:ref:`yaml_syntax` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:478 +#: ../../rst/inventory_guide/intro_inventory.rst:483 msgid "Ansible loads host and group variable files by searching paths relative to the inventory file or the playbook file. If your inventory file at ``/etc/ansible/hosts`` contains a host named 'foosball' that belongs to two groups, 'raleigh' and 'webservers', that host will use variables in YAML files at the following locations:" msgstr "Ansible ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã¾ãŸã¯ Playbook ファイルã‹ã‚‰ã®ç›¸å¯¾ãƒ‘スを検索ã—ã¦ã€ãƒ›ã‚¹ãƒˆãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—変数ファイルをèªã¿è¾¼ã¿ã¾ã™ã€‚``/etc/ansible/hosts`` ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã«ã€Œfoosballã€ã¨ã„ã†åå‰ã®ãƒ›ã‚¹ãƒˆãŒã‚ã‚Šã€ãã‚ŒãŒã€Œraleighã€ã¨ã€Œwebserversã€ã¨ã„ㆠ2 ã¤ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«æ‰€å±žã—ã¦ã„ã‚‹å ´åˆã€ãã®ãƒ›ã‚¹ãƒˆã¯ä»¥ä¸‹ã®å ´æ‰€ã«ã‚ã‚‹ YAML ファイルã®å¤‰æ•°ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:486 +#: ../../rst/inventory_guide/intro_inventory.rst:491 msgid "For example, if you group hosts in your inventory by datacenter, and each datacenter uses its own NTP server and database server, you can create a file called ``/etc/ansible/group_vars/raleigh`` to store the variables for the ``raleigh`` group:" msgstr "ãŸã¨ãˆã°ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å†…ã®ãƒ›ã‚¹ãƒˆã‚’データセンターã”ã¨ã«ã¾ã¨ã‚ã€å„データセンターãŒç‹¬è‡ªã® NTP サーãƒãƒ¼ãŠã‚ˆã³ãƒ‡ãƒ¼ã‚¿ãƒ™ãƒ¼ã‚¹ã‚µãƒ¼ãƒãƒ¼ã‚’使用ã™ã‚‹å ´åˆã¯ã€``/etc/ansible/group_vars/raleigh`` ã¨ã„ã†åå‰ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’作æˆã—ã¦ã€``raleigh`` グループã®å¤‰æ•°ã‚’ä¿å˜ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:494 +#: ../../rst/inventory_guide/intro_inventory.rst:499 msgid "You can also create *directories* named after your groups or hosts. Ansible will read all the files in these directories in lexicographical order. An example with the 'raleigh' group:" msgstr "ã¾ãŸã€ã‚°ãƒ«ãƒ¼ãƒ—ã¾ãŸã¯ãƒ›ã‚¹ãƒˆã®åå‰ãŒä»˜ã‘られ㟠*ディレクトリー* も作æˆã§ãã¾ã™ã€‚Ansible ã¯ã€ã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«å«ã¾ã‚Œã‚‹ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’ディクショナリーã®é †ã«èªã¿è¾¼ã¿ã¾ã™ã€‚例ã§ã¯ã€ã€Œraleighã€ã‚°ãƒ«ãƒ¼ãƒ—を使用ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:501 +#: ../../rst/inventory_guide/intro_inventory.rst:506 msgid "All hosts in the 'raleigh' group will have the variables defined in these files available to them. This can be very useful to keep your variables organized when a single file gets too big, or when you want to use :ref:`Ansible Vault<playbooks_vault>` on some group variables." msgstr "「raleighã€ã‚°ãƒ«ãƒ¼ãƒ—ã®ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã¯ã€ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã§å®šç¾©ã•ã‚ŒãŸå¤‰æ•°ã‚’利用ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€1 ã¤ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒå¤§ãããªã‚Šã™ãŽãŸã¨ãã«ã€å¤‰æ•°ã‚’æ•´ç†ã—ã¦ãŠãã®ã«éžå¸¸ã«ä¾¿åˆ©ã§ã™ã€‚ã¾ãŸã€ã„ãã¤ã‹ã®ã‚°ãƒ«ãƒ¼ãƒ—変数㫠:ref:`Ansible Vault<playbooks_vault>` を使用ã—ãŸã„å ´åˆã«ã‚‚便利ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:505 +#: ../../rst/inventory_guide/intro_inventory.rst:510 msgid "For ``ansible-playbook`` you can also add ``group_vars/`` and ``host_vars/`` directories to your playbook directory. Other Ansible commands (for example, ``ansible``, ``ansible-console``, and so on) will only look for ``group_vars/`` and ``host_vars/`` in the inventory directory. If you want other commands to load group and host variables from a playbook directory, you must provide the ``--playbook-dir`` option on the command line. If you load inventory files from both the playbook directory and the inventory directory, variables in the playbook directory will override variables set in the inventory directory." msgstr "``ansible-playbook`` ã«é–¢ã—ã¦ã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ ``group_vars/``ãŠã‚ˆã³ ``host_vars/`` ã‚’ Playbook ディレクトリーã«è¿½åŠ ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ä»–ã® Ansible コマンド (ãŸã¨ãˆã°ã€``ansible``ã€``ansible-console`` ãªã©) ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼å†…ã® ``group_vars/`` 㨠``host_vars/`` ã®ã¿ã‚’探ã—ã¾ã™ã€‚ä»–ã®ã‚³ãƒžãƒ³ãƒ‰ã§ Playbook ディレクトリーã‹ã‚‰ã‚°ãƒ«ãƒ¼ãƒ—変数やホスト変数をèªã¿è¾¼ã‚€å ´åˆã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ ``--playbook-dir`` オプションを指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Playbook ディレクトリー㨠inventory ディレクトリーã®ä¸¡æ–¹ã‹ã‚‰ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã‚’èªã¿è¾¼ã‚“ã å ´åˆã€Playbook ディレクトリーã®å¤‰æ•°ã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§è¨å®šã•ã‚ŒãŸå¤‰æ•°ã‚ˆã‚Šã‚‚優先ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:508 +#: ../../rst/inventory_guide/intro_inventory.rst:513 msgid "Keeping your inventory file and variables in a git repo (or other version control) is an excellent way to track changes to your inventory and host variables." msgstr "git リãƒã‚¸ãƒˆãƒªãƒ¼ (ã¾ãŸã¯ä»–ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç®¡ç†) ã§ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ãŠã‚ˆã³å¤‰æ•°ã‚’ç¶æŒã™ã‚‹ã“ã¨ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãŠã‚ˆã³ãƒ›ã‚¹ãƒˆå¤‰æ•°ã¸ã®å¤‰æ›´ã‚’追跡ã™ã‚‹å„ªã‚ŒãŸæ–¹æ³•ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:514 +#: ../../rst/inventory_guide/intro_inventory.rst:519 msgid "How variables are merged" msgstr "変数をマージã™ã‚‹æ–¹æ³•" -#: ../../rst/inventory_guide/intro_inventory.rst:516 +#: ../../rst/inventory_guide/intro_inventory.rst:521 msgid "By default variables are merged/flattened to the specific host before a play is run. This keeps Ansible focused on the Host and Task, so groups don't really survive outside of inventory and host matching. By default, Ansible overwrites variables including the ones defined for a group and/or host (see :ref:`DEFAULT_HASH_BEHAVIOUR<DEFAULT_HASH_BEHAVIOUR>`). The order/precedence is (from lowest to highest):" msgstr "デフォルトã§ã¯ã€ãƒ—レイãŒå®Ÿè¡Œã•ã‚Œã‚‹å‰ã«ã€å¤‰æ•°ãŒç‰¹å®šã®ãƒ›ã‚¹ãƒˆã«ãƒžãƒ¼ã‚¸/フラット化ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€Ansible ã¯ãƒ›ã‚¹ãƒˆã¨ã‚¿ã‚¹ã‚¯ã«ç„¦ç‚¹ã‚’当ã¦ã¦ã„ã‚‹ãŸã‚ã€ã‚°ãƒ«ãƒ¼ãƒ—ã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã¨ãƒ›ã‚¹ãƒˆã®ä¸€è‡´ä»¥å¤–ã§ã¯å®Ÿéš›ã«ã¯å˜ç¶šã—ã¾ã›ã‚“。デフォルトã§ã¯ã€Ansible ã¯ã‚°ãƒ«ãƒ¼ãƒ—やホストã«å®šç¾©ã•ã‚ŒãŸã‚‚ã®ã‚’å«ã‚€å¤‰æ•°ã‚’上書ãã—ã¾ã™ (「:ref:`DEFAULT_HASH_BEHAVIOUR<DEFAULT_HASH_BEHAVIOUR>`ã€ã‚’å‚ç…§)。ãã®é †åº/å„ªå…ˆé †ä½ã¯ (低ã„ã‚‚ã®ã‹ã‚‰é«˜ã„ã‚‚ã®ã¸) ã¨ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:518 +#: ../../rst/inventory_guide/intro_inventory.rst:523 msgid "all group (because it is the 'parent' of all other groups)" msgstr "ã™ã¹ã¦ã®ã‚°ãƒ«ãƒ¼ãƒ— (ä»–ã®ã™ã¹ã¦ã®ã‚°ãƒ«ãƒ¼ãƒ—ã®ã€Œè¦ªã€ã§ã‚ã‚‹ãŸã‚)" -#: ../../rst/inventory_guide/intro_inventory.rst:519 +#: ../../rst/inventory_guide/intro_inventory.rst:524 msgid "parent group" msgstr "親グループ" -#: ../../rst/inventory_guide/intro_inventory.rst:520 +#: ../../rst/inventory_guide/intro_inventory.rst:525 msgid "child group" msgstr "åグループ" -#: ../../rst/inventory_guide/intro_inventory.rst:521 +#: ../../rst/inventory_guide/intro_inventory.rst:526 msgid "host" msgstr "host" -#: ../../rst/inventory_guide/intro_inventory.rst:523 +#: ../../rst/inventory_guide/intro_inventory.rst:528 msgid "By default Ansible merges groups at the same parent/child level in ASCII order, and variables from the last group loaded overwrite variables from the previous groups. For example, an a_group will be merged with b_group and b_group vars that match will overwrite the ones in a_group." msgstr "デフォルトã§ã¯ã€Ansible ã¯åŒã˜è¦ªåレベルã®ã‚°ãƒ«ãƒ¼ãƒ—ã‚’ ASCII é †ã«ãƒžãƒ¼ã‚¸ã—ã€æœ€å¾Œã«èªã¿è¾¼ã¾ã‚ŒãŸã‚°ãƒ«ãƒ¼ãƒ—ã®å¤‰æ•°ãŒãれ以å‰ã®ã‚°ãƒ«ãƒ¼ãƒ—ã‹ã‚‰ã®å¤‰æ•°ã‚’上書ãã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€a_group 㯠b_group ã«ãƒžãƒ¼ã‚¸ã•ã‚Œã€ä¸€è‡´ã™ã‚‹ b_group ã®å¤‰æ•°ãŒ a_group ã®å¤‰æ•°ã‚’上書ãã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:525 +#: ../../rst/inventory_guide/intro_inventory.rst:530 msgid "You can change this behavior by setting the group variable ``ansible_group_priority`` to change the merge order for groups of the same level (after the parent/child order is resolved). The larger the number, the later it will be merged, giving it higher priority. This variable defaults to ``1`` if not set. For example:" msgstr "ã“ã®å‹•ä½œã‚’変更ã™ã‚‹ã«ã¯ã€ã‚°ãƒ«ãƒ¼ãƒ—変数 ``ansible_group_priority`` ã‚’è¨å®šã—ã¦ã€åŒã˜ãƒ¬ãƒ™ãƒ«ã®ã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒžãƒ¼ã‚¸é †åºã‚’変更ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ (親åã®é †åºãŒè§£æ±ºã•ã‚ŒãŸå¾Œ)。数å—ãŒå¤§ãã„ã»ã©å¾Œã«ãƒžãƒ¼ã‚¸ã•ã‚Œã€å„ªå…ˆé †ä½ãŒé«˜ããªã‚Šã¾ã™ã€‚ã“ã®å¤‰æ•°ãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``1`` ã§ã™ã€‚ãŸã¨ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:537 +#: ../../rst/inventory_guide/intro_inventory.rst:542 msgid "In this example, if both groups have the same priority, the result would normally have been ``testvar == b``, but since we are giving the ``a_group`` a higher priority the result will be ``testvar == a``." msgstr "ã“ã®ä¾‹ã§ã¯ã€ä¸¡æ–¹ã®ã‚°ãƒ«ãƒ¼ãƒ—ã®å„ªå…ˆé †ä½ãŒåŒã˜å ´åˆã€çµæžœã¯é€šå¸¸ ``testvar == b`` ã«ãªã‚Šã¾ã™ãŒã€``a_group`` ã®å„ªå…ˆåº¦ãŒé«˜ã„ãŸã‚ã€çµæžœã¯ ``testvar == a`` ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:539 +#: ../../rst/inventory_guide/intro_inventory.rst:544 msgid "``ansible_group_priority`` can only be set in the inventory source and not in group_vars/, as the variable is used in the loading of group_vars." msgstr "``ansible_group_priority`` ã¯ã€group_vars ã®èªã¿è¾¼ã¿ã§ã“ã®å¤‰æ•°ãŒä½¿ç”¨ã•ã‚Œã‚‹ãŸã‚ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã§ã®ã¿è¨å®šã§ãã€group_vars/ ã§ã¯è¨å®šã§ãã¾ã›ã‚“。" -#: ../../rst/inventory_guide/intro_inventory.rst:542 +#: ../../rst/inventory_guide/intro_inventory.rst:547 msgid "Managing inventory variable load order" msgstr "インベントリー変数ã®èªã¿è¾¼ã¿é †åºã®ç®¡ç†" -#: ../../rst/inventory_guide/intro_inventory.rst:544 +#: ../../rst/inventory_guide/intro_inventory.rst:549 msgid "When using multiple inventory sources, keep in mind that any variable conflicts are resolved according to the rules described in :ref:`how_we_merge` and :ref:`ansible_variable_precedence`. You can control the merging order of variables in inventory sources to get the variable value you need." msgstr "複数ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’使用ã™ã‚‹å ´åˆã¯ã€variable ãŠã‚ˆã³ :ref:`how_we_merge` 㨠:ref:`ansible_variable_precedence` ã§èª¬æ˜Žã•ã‚Œã¦ã„るルールã«å¾“ã£ã¦å¤‰æ•°ã®ç«¶åˆãŒè§£æ±ºã•ã‚Œã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。インベントリーソースã§å¤‰æ•°ã®ãƒžãƒ¼ã‚¸é †åºã‚’制御ã—ã€å¿…è¦ãªå¤‰æ•°ã®å€¤ã‚’å–å¾—ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:547 -msgid "When you pass multiple inventory sources at the command line, Ansible merges variables in the order you pass those parameters. If ``[all:vars]`` in staging inventory defines ``myvar = 1`` and production inventory defines ``myvar = 2``, then: * Pass ``-i staging -i production`` to run the playbook with ``myvar = 2``. * Pass ``-i production -i staging`` to run the playbook with ``myvar = 1``." -msgstr "コマンドラインã§è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’渡ã™ã¨ã€Ansible ã¯ãれらã®ãƒ‘ラメーターを渡ã™é †åºã§å¤‰æ•°ã‚’マージã—ã¾ã™ã€‚ステージングインベントリー㮠``[all:vars]`` ㌠``myvar = 1`` を定義ã—ã€å®Ÿç¨¼åƒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãŒ ``myvar = 2`` を定義ã—ã¦ã„ã‚‹å ´åˆã«ã¯ã€* ``-i staging -i production`` を指定ã—㦠``myvar = 2`` 㧠Playbook を実行ã—ã¾ã™ã€‚* ``-i production -i staging`` を指定ã—㦠``myvar = 1`` 㧠Playbook を実行ã—ã¾ã™ã€‚" +#: ../../rst/inventory_guide/intro_inventory.rst:552 +msgid "When you pass multiple inventory sources at the command line, Ansible merges variables in the order you pass those parameters. If ``[all:vars]`` in staging inventory defines ``myvar = 1`` and production inventory defines ``myvar = 2``, then:" +msgstr "コマンドラインã§è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’渡ã™ã¨ã€Ansible ã¯ãれらã®ãƒ‘ラメーターを渡ã™é †åºã§å¤‰æ•°ã‚’マージã—ã¾ã™ã€‚ステージングインベントリー㮠``[all:vars]`` ㌠``myvar = 1`` を定義ã—ã€å®Ÿç¨¼åƒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãŒ ``myvar = 2`` を定義ã—ã¦ã„ã‚‹å ´åˆã«ã¯ã€" -#: ../../rst/inventory_guide/intro_inventory.rst:551 +#: ../../rst/inventory_guide/intro_inventory.rst:554 +msgid "Pass ``-i staging -i production`` to run the playbook with ``myvar = 2``." +msgstr "* ``-i staging -i production`` を渡ã—㦠``myvar = 2`` を指定ã—㦠Playbook を実行ã—ã¾ã™ã€‚" + +#: ../../rst/inventory_guide/intro_inventory.rst:555 +msgid "Pass ``-i production -i staging`` to run the playbook with ``myvar = 1``." +msgstr "* ``-i production -i staging`` を渡ã—㦠``myvar = 1`` を指定ã—㦠Playbook を実行ã—ã¾ã™ã€‚" + +#: ../../rst/inventory_guide/intro_inventory.rst:557 msgid "When you put multiple inventory sources in a directory, Ansible merges them in ASCII order according to the filenames. You can control the load order by adding prefixes to the files:" msgstr "ディレクトリーã«è¤‡æ•°ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚½ãƒ¼ã‚¹ã‚’é…ç½®ã™ã‚‹ã¨ã€Ansible ã¯ãƒ•ã‚¡ã‚¤ãƒ«åã«å¾“ã£ã¦ ASCII é †ã§ãƒžãƒ¼ã‚¸ã—ã¾ã™ã€‚ファイルã«æŽ¥é è¾žã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã€èªã¿è¾¼ã¿é †åºã‚’制御ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:562 +#: ../../rst/inventory_guide/intro_inventory.rst:568 msgid "If ``01-openstack.yml`` defines ``myvar = 1`` for the group ``all``, ``02-dynamic-inventory.py`` defines ``myvar = 2``, and ``03-static-inventory`` defines ``myvar = 3``, the playbook will be run with ``myvar = 3``." msgstr "``01-openstack.yml`` ãŒã‚°ãƒ«ãƒ¼ãƒ— ``all`` ã«å¯¾ã—㦠``myvar = 1`` を定義ã—ã€``02-dynamic-inventory.py`` ㌠``myvar = 2`` を定義ã—ã€``03-static-inventory`` ㌠``myvar = 3`` を定義ã—ãŸå ´åˆã¯ã€Playbook ㌠``myvar = 3`` ã§å®Ÿè¡Œã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:565 +#: ../../rst/inventory_guide/intro_inventory.rst:571 msgid "For more details on inventory plugins and dynamic inventory scripts see :ref:`inventory_plugins` and :ref:`intro_dynamic_inventory`." msgstr "インベントリープラグインãŠã‚ˆã³å‹•çš„インベントリースクリプトã®è©³ç´°ã¯ã€ã€Œ:ref:`inventory_plugins`ã€ãŠã‚ˆã³ã€Œ:ref:`intro_dynamic_inventory`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:570 +#: ../../rst/inventory_guide/intro_inventory.rst:576 msgid "Connecting to hosts: behavioral inventory parameters" msgstr "ホストã¸ã®æŽ¥ç¶š: 動作用インベントリーパラメーター" -#: ../../rst/inventory_guide/intro_inventory.rst:572 +#: ../../rst/inventory_guide/intro_inventory.rst:578 msgid "As described above, setting the following variables control how Ansible interacts with remote hosts." msgstr "上記ã®ã‚ˆã†ã«ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’è¨å®šã—ã¦ã€Ansible ãŒãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã¨å¯¾è©±ã™ã‚‹æ–¹æ³•ã‚’制御ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:574 +#: ../../rst/inventory_guide/intro_inventory.rst:580 msgid "Host connection:" msgstr "ホスト接続:" -#: ../../rst/inventory_guide/intro_inventory.rst:579 +#: ../../rst/inventory_guide/intro_inventory.rst:585 msgid "ansible_connection" msgstr "ansible_connection" -#: ../../rst/inventory_guide/intro_inventory.rst:579 +#: ../../rst/inventory_guide/intro_inventory.rst:585 msgid "Connection type to the host. This can be the name of any of ansible's connection plugins. SSH protocol types are ``smart``, ``ssh`` or ``paramiko``. The default is smart. Non-SSH based types are described in the next section." msgstr "ホストã¸ã®æŽ¥ç¶šã‚¿ã‚¤ãƒ—。ã“ã‚Œã¯ã€Ansible ã® connection プラグインã®åå‰ã§ã™ã€‚SSH プãƒãƒˆã‚³ãƒ«ã‚¿ã‚¤ãƒ—㯠``smart``ã€``ssh``ã€ã¾ãŸã¯ ``paramiko`` ã§ã™ã€‚デフォルト㯠smart ã§ã™ã€‚SSH ベース以外ã®ã‚¿ã‚¤ãƒ—ã¯æ¬¡ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:581 +#: ../../rst/inventory_guide/intro_inventory.rst:587 msgid "General for all connections:" msgstr "ã™ã¹ã¦ã®æŽ¥ç¶šã«å¯¾ã™ã‚‹ä¸€èˆ¬çš„ãªè¨å®š:" -#: ../../rst/inventory_guide/intro_inventory.rst:583 -#: ../../rst/inventory_guide/intro_inventory.rst:686 +#: ../../rst/inventory_guide/intro_inventory.rst:589 +#: ../../rst/inventory_guide/intro_inventory.rst:692 msgid "ansible_host" msgstr "ansible_host" -#: ../../rst/inventory_guide/intro_inventory.rst:584 +#: ../../rst/inventory_guide/intro_inventory.rst:590 msgid "The name of the host to connect to, if different from the alias you wish to give to it." msgstr "接続ã™ã‚‹ãƒ›ã‚¹ãƒˆã®åå‰ (割り当ã¦ãŸã„エイリアスã¨ç•°ãªã‚‹å ´åˆ)。" -#: ../../rst/inventory_guide/intro_inventory.rst:585 +#: ../../rst/inventory_guide/intro_inventory.rst:591 msgid "ansible_port" msgstr "ansible_port" -#: ../../rst/inventory_guide/intro_inventory.rst:586 +#: ../../rst/inventory_guide/intro_inventory.rst:592 msgid "The connection port number, if not the default (22 for ssh)" msgstr "デフォルトã§ã¯ãªã„å ´åˆ (ssh ã®å ´åˆã¯ 22) ã¯ã€æŽ¥ç¶šãƒãƒ¼ãƒˆç•ªå·ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:587 -#: ../../rst/inventory_guide/intro_inventory.rst:688 +#: ../../rst/inventory_guide/intro_inventory.rst:593 +#: ../../rst/inventory_guide/intro_inventory.rst:694 msgid "ansible_user" msgstr "ansible_user" -#: ../../rst/inventory_guide/intro_inventory.rst:588 +#: ../../rst/inventory_guide/intro_inventory.rst:594 msgid "The user name to use when connecting to the host" msgstr "ホストã«æŽ¥ç¶šã™ã‚‹éš›ã«ä½¿ç”¨ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼å。" -#: ../../rst/inventory_guide/intro_inventory.rst:591 +#: ../../rst/inventory_guide/intro_inventory.rst:597 msgid "ansible_password" msgstr "ansible_password" -#: ../../rst/inventory_guide/intro_inventory.rst:590 +#: ../../rst/inventory_guide/intro_inventory.rst:596 msgid "The password to use to authenticate to the host (never store this variable in plain text; always use a vault. See :ref:`tip_for_variables_and_vaults`)" msgstr "ホストã¸ã®èªè¨¼ã«ä½¿ç”¨ã™ã‚‹ãƒ‘スワード (ã“ã®å¤‰æ•°ã‚’平文ã§ä¿å˜ã—ãªã„ã§ãã ã•ã„。常㫠Valut を使用ã—ã¦ãã ã•ã„。「:ref:`tip_for_variables_and_vaults`ã€ã‚’å‚ç…§)。" -#: ../../rst/inventory_guide/intro_inventory.rst:593 +#: ../../rst/inventory_guide/intro_inventory.rst:599 msgid "Specific to the SSH connection:" msgstr "SSH 接続ã«å›ºæœ‰:" -#: ../../rst/inventory_guide/intro_inventory.rst:595 +#: ../../rst/inventory_guide/intro_inventory.rst:601 msgid "ansible_ssh_private_key_file" msgstr "ansible_ssh_private_key_file" -#: ../../rst/inventory_guide/intro_inventory.rst:596 +#: ../../rst/inventory_guide/intro_inventory.rst:602 msgid "Private key file used by ssh. Useful if using multiple keys and you don't want to use SSH agent." msgstr "ssh ãŒä½¿ç”¨ã™ã‚‹ç§˜å¯†éµãƒ•ã‚¡ã‚¤ãƒ«ã€‚複数ã®éµã‚’使用ã—ã€SSH エージェントを使用ã—ãŸããªã„å ´åˆã«ä¾¿åˆ©ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:599 +#: ../../rst/inventory_guide/intro_inventory.rst:605 msgid "ansible_ssh_common_args" msgstr "ansible_ssh_common_args" -#: ../../rst/inventory_guide/intro_inventory.rst:598 +#: ../../rst/inventory_guide/intro_inventory.rst:604 msgid "This setting is always appended to the default command line for :command:`sftp`, :command:`scp`, and :command:`ssh`. Useful to configure a ``ProxyCommand`` for a certain host (or group)." msgstr "ã“ã®è¨å®šã¯ã€å¸¸ã« :command:`sftp`ã€:command:`scp`ã€ãŠã‚ˆã³ :command:`ssh` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚特定ã®ãƒ›ã‚¹ãƒˆ (ã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—) ã« ``ProxyCommand`` ã‚’è¨å®šã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:601 +#: ../../rst/inventory_guide/intro_inventory.rst:607 msgid "ansible_sftp_extra_args" msgstr "ansible_sftp_extra_args" -#: ../../rst/inventory_guide/intro_inventory.rst:602 +#: ../../rst/inventory_guide/intro_inventory.rst:608 msgid "This setting is always appended to the default :command:`sftp` command line." msgstr "ã“ã®è¨å®šã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® :command:`sftp` コマンドラインã«å¸¸ã«ä»˜åŠ ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:603 +#: ../../rst/inventory_guide/intro_inventory.rst:609 msgid "ansible_scp_extra_args" msgstr "ansible_scp_extra_args" -#: ../../rst/inventory_guide/intro_inventory.rst:604 +#: ../../rst/inventory_guide/intro_inventory.rst:610 msgid "This setting is always appended to the default :command:`scp` command line." msgstr "ã“ã®è¨å®šã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® :command:`scp` コマンドラインã«å¸¸ã«ä»˜åŠ ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:605 +#: ../../rst/inventory_guide/intro_inventory.rst:611 msgid "ansible_ssh_extra_args" msgstr "ansible_ssh_extra_args" -#: ../../rst/inventory_guide/intro_inventory.rst:606 +#: ../../rst/inventory_guide/intro_inventory.rst:612 msgid "This setting is always appended to the default :command:`ssh` command line." msgstr "ã“ã®è¨å®šã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® :command:`ssh` コマンドラインã«å¸¸ã«ä»˜åŠ ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:607 +#: ../../rst/inventory_guide/intro_inventory.rst:613 msgid "ansible_ssh_pipelining" msgstr "ansible_ssh_pipelining" -#: ../../rst/inventory_guide/intro_inventory.rst:608 +#: ../../rst/inventory_guide/intro_inventory.rst:614 msgid "Determines whether or not to use SSH pipelining. This can override the ``pipelining`` setting in :file:`ansible.cfg`." msgstr "SSH パイプラインを使用ã™ã‚‹ã‹ã©ã†ã‹ã‚’決定ã—ã¾ã™ã€‚ã“れ㯠:file:`ansible.cfg` ã® ``pipelining`` ã®è¨å®šã‚’上書ãã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:611 +#: ../../rst/inventory_guide/intro_inventory.rst:617 msgid "ansible_ssh_executable (added in version 2.2)" msgstr "ansible_ssh_executable (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.2 ã§è¿½åŠ )" -#: ../../rst/inventory_guide/intro_inventory.rst:610 +#: ../../rst/inventory_guide/intro_inventory.rst:616 msgid "This setting overrides the default behavior to use the system :command:`ssh`. This can override the ``ssh_executable`` setting in :file:`ansible.cfg`." msgstr "ã“ã®è¨å®šã«ã‚ˆã‚Šã€ã‚·ã‚¹ãƒ†ãƒ ã® :command:`ssh` を使用ã™ã‚‹ã‚ˆã†ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®å‹•ä½œãŒä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€:file:`ansible.cfg` ã® ``ssh_executable`` è¨å®šã‚’上書ãã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:613 +#: ../../rst/inventory_guide/intro_inventory.rst:619 msgid "Privilege escalation (see :ref:`Ansible Privilege Escalation<become>` for further details):" msgstr "権é™ã®æ˜‡æ ¼ (詳細ã¯ã€Œ:ref:`Ansible 権é™æ˜‡æ ¼<become>`ã€ã‚’å‚ç…§):" -#: ../../rst/inventory_guide/intro_inventory.rst:615 -#: ../../rst/inventory_guide/intro_inventory.rst:690 +#: ../../rst/inventory_guide/intro_inventory.rst:621 +#: ../../rst/inventory_guide/intro_inventory.rst:696 msgid "ansible_become" msgstr "ansible_become" -#: ../../rst/inventory_guide/intro_inventory.rst:616 +#: ../../rst/inventory_guide/intro_inventory.rst:622 msgid "Equivalent to ``ansible_sudo`` or ``ansible_su``, allows to force privilege escalation" msgstr "``ansible_sudo`` ã¾ãŸã¯ ``ansible_su`` ã¨åŒç‰ã§ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€æ¨©é™æ˜‡æ ¼ã‚’強制ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:617 +#: ../../rst/inventory_guide/intro_inventory.rst:623 msgid "ansible_become_method" msgstr "ansible_become_method" -#: ../../rst/inventory_guide/intro_inventory.rst:618 +#: ../../rst/inventory_guide/intro_inventory.rst:624 msgid "Allows to set privilege escalation method" msgstr "権é™æ˜‡æ ¼ãƒ¡ã‚½ãƒƒãƒ‰ã®è¨å®šã‚’許å¯ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:619 +#: ../../rst/inventory_guide/intro_inventory.rst:625 msgid "ansible_become_user" msgstr "ansible_become_user" -#: ../../rst/inventory_guide/intro_inventory.rst:620 +#: ../../rst/inventory_guide/intro_inventory.rst:626 msgid "Equivalent to ``ansible_sudo_user`` or ``ansible_su_user``, allows to set the user you become through privilege escalation" msgstr "``ansible_sudo_user`` ã¾ãŸã¯ ``ansible_su_user`` ã¨åŒç‰ã§ã€æ¨©é™æ˜‡æ ¼ã«ã‚ˆã‚Š become ã‚’è¡Œã†ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:621 +#: ../../rst/inventory_guide/intro_inventory.rst:627 msgid "ansible_become_password" msgstr "ansible_become_password" -#: ../../rst/inventory_guide/intro_inventory.rst:622 +#: ../../rst/inventory_guide/intro_inventory.rst:628 msgid "Equivalent to ``ansible_sudo_password`` or ``ansible_su_password``, allows you to set the privilege escalation password (never store this variable in plain text; always use a vault. See :ref:`tip_for_variables_and_vaults`)" msgstr "``ansible_sudo_password`` ã¾ãŸã¯ ``ansible_su_password`` ã¨åŒç‰ã§ã€ç‰¹æ¨©æ˜‡æ ¼ãƒ‘スワードをè¨å®šã§ãã¾ã™ (ã“ã®å¤‰æ•°ã‚’平文ã§ä¿å˜ã›ãšã€å¸¸ã« vault を使用ã—ã¦ãã ã•ã„。「:ref:`tip_for_variables_and_vaults`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„)。" -#: ../../rst/inventory_guide/intro_inventory.rst:623 +#: ../../rst/inventory_guide/intro_inventory.rst:629 msgid "ansible_become_exe" msgstr "ansible_become_exe" -#: ../../rst/inventory_guide/intro_inventory.rst:624 +#: ../../rst/inventory_guide/intro_inventory.rst:630 msgid "Equivalent to ``ansible_sudo_exe`` or ``ansible_su_exe``, allows you to set the executable for the escalation method selected" msgstr "``ansible_sudo_exe`` ã¾ãŸã¯ ``ansible_su_exe`` ã¨åŒç‰ã§ã€é¸æŠžã—ãŸæ˜‡æ ¼ãƒ¡ã‚½ãƒƒãƒ‰ã®å®Ÿè¡Œãƒ•ã‚¡ã‚¤ãƒ«ã‚’è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:626 +#: ../../rst/inventory_guide/intro_inventory.rst:632 msgid "ansible_become_flags" msgstr "ansible_become_flags" -#: ../../rst/inventory_guide/intro_inventory.rst:626 +#: ../../rst/inventory_guide/intro_inventory.rst:632 msgid "Equivalent to ``ansible_sudo_flags`` or ``ansible_su_flags``, allows you to set the flags passed to the selected escalation method. This can be also set globally in :file:`ansible.cfg` in the ``sudo_flags`` option" msgstr "``ansible_sudo_flags`` ã¾ãŸã¯ ``ansible_su_flags`` ã¨åŒç‰ã§ã€é¸æŠžã•ã‚ŒãŸæ˜‡æ ¼æ–¹æ³•ã«æ¸¡ã•ã‚Œã‚‹ãƒ•ãƒ©ã‚°ã‚’è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“れ㯠``sudo_flags`` オプション㮠:file:`ansible.cfg` ã§ã‚‚ã‚°ãƒãƒ¼ãƒãƒ«ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:628 +#: ../../rst/inventory_guide/intro_inventory.rst:634 msgid "Remote host environment parameters:" msgstr "リモートホスト環境パラメーター:" -#: ../../rst/inventory_guide/intro_inventory.rst:636 +#: ../../rst/inventory_guide/intro_inventory.rst:642 msgid "ansible_shell_type" msgstr "ansible_shell_type" -#: ../../rst/inventory_guide/intro_inventory.rst:633 +#: ../../rst/inventory_guide/intro_inventory.rst:639 msgid "The shell type of the target system. You should not use this setting unless you have set the :ref:`ansible_shell_executable<ansible_shell_executable>` to a non-Bourne (sh) compatible shell. By default commands are formatted using ``sh``-style syntax. Setting this to ``csh`` or ``fish`` will cause commands executed on target systems to follow those shell's syntax instead." msgstr "ターゲットシステムã®ã‚·ã‚§ãƒ«ã‚¿ã‚¤ãƒ—。:ref:`ansible_shell_executable<ansible_shell_executable>` ã‚’ Bourne (sh) 以外ã®äº’æ›ã‚·ã‚§ãƒ«ã«è¨å®šã—ãªã„é™ã‚Šã€ã“ã®è¨å®šã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。デフォルトã§ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ã¯ ``sh`` スタイルã®æ§‹æ–‡ã‚’使用ã—ã¦ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã•ã‚Œã¾ã™ã€‚ã“れを ``csh`` ã¾ãŸã¯ ``fish`` ã«è¨å®šã™ã‚‹ã¨ã€ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚·ã‚¹ãƒ†ãƒ ã§å®Ÿè¡Œã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ãŒã‚·ã‚§ãƒ«ã®æ§‹æ–‡ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:645 +#: ../../rst/inventory_guide/intro_inventory.rst:651 msgid "ansible_python_interpreter" msgstr "ansible_python_interpreter" -#: ../../rst/inventory_guide/intro_inventory.rst:641 +#: ../../rst/inventory_guide/intro_inventory.rst:647 msgid "The target host python path. This is useful for systems with more than one Python or not located at :command:`/usr/bin/python` such as \\*BSD, or where :command:`/usr/bin/python` is not a 2.X series Python. We do not use the :command:`/usr/bin/env` mechanism as that requires the remote user's path to be set right and also assumes the :program:`python` executable is named python, where the executable might be named something like :program:`python2.6`." msgstr "ターゲットホスト㮠Python パス。ã“ã‚Œã¯ã€è¤‡æ•°ã® Python ãŒã‚るシステムã€\\*BSD ãªã©ã® :command:`/usr/bin/python` ã«ãªã„システムã€:command:`/usr/bin/python` ㌠2.X シリーズ㮠Python 以外ã®ã‚·ã‚¹ãƒ†ãƒ ã«å½¹ç«‹ã¡ã¾ã™ã€‚リモートユーザーã®ãƒ‘スをæ£ã—ãè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€:program:`python` 実行ファイルã®åå‰ãŒ python ã§ã‚ã‚‹ã¨æƒ³å®šã™ã‚‹ãŸã‚ã€:command:`/usr/bin/env` メカニズムã¯ä½¿ç”¨ã—ã¾ã›ã‚“。実行ファイルã®åå‰ã¯ :program:`python2.6` ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:649 +#: ../../rst/inventory_guide/intro_inventory.rst:655 msgid "ansible_*_interpreter" msgstr "ansible_*_interpreter" -#: ../../rst/inventory_guide/intro_inventory.rst:648 +#: ../../rst/inventory_guide/intro_inventory.rst:654 msgid "Works for anything such as ruby or perl and works just like :ref:`ansible_python_interpreter<ansible_python_interpreter>`. This replaces shebang of modules which will run on that host." msgstr "ruby ã‚„ perl ãªã©ã®ã‚らゆるもã®ã§å‹•ä½œã—ã€:ref:`ansible_python_interpreter<ansible_python_interpreter>` ã®ã‚ˆã†ã«æ©Ÿèƒ½ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãã®ãƒ›ã‚¹ãƒˆã§å®Ÿè¡Œã•ã‚Œã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚·ãƒãƒ³ã«ä»£ã‚ã‚‹ã‚‚ã®ã§ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:660 +#: ../../rst/inventory_guide/intro_inventory.rst:666 msgid "ansible_shell_executable" msgstr "ansible_shell_executable" -#: ../../rst/inventory_guide/intro_inventory.rst:656 +#: ../../rst/inventory_guide/intro_inventory.rst:662 msgid "This sets the shell the ansible controller will use on the target machine, overrides ``executable`` in :file:`ansible.cfg` which defaults to :command:`/bin/sh`. You should really only change it if is not possible to use :command:`/bin/sh` (in other words, if :command:`/bin/sh` is not installed on the target machine or cannot be run from sudo.)." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒžã‚·ãƒ³ã§ä½¿ç”¨ã™ã‚‹ã‚·ã‚§ãƒ«ã‚’è¨å®šã—ã€:file:`ansible.cfg` ã® ``executable`` を上書ãã—ã¾ã™ã€‚デフォルト㯠:command:`/bin/sh` ã§ã™ã€‚:command:`/bin/sh` を使用ã§ããªã„å ´åˆã«ã®ã¿å¤‰æ›´ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (ã¤ã¾ã‚Šã€:command:`/bin/sh` ãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒžã‚·ãƒ³ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ãªã„å ´åˆã€ã¾ãŸã¯ sudo ã‹ã‚‰å®Ÿè¡Œã§ããªã„å ´åˆ)。" -#: ../../rst/inventory_guide/intro_inventory.rst:662 +#: ../../rst/inventory_guide/intro_inventory.rst:668 msgid "Examples from an Ansible-INI host file:" msgstr "Ansible-INI ホストファイルã®ä¾‹:" -#: ../../rst/inventory_guide/intro_inventory.rst:672 +#: ../../rst/inventory_guide/intro_inventory.rst:678 msgid "Non-SSH connection types" msgstr "SSH 以外ã®æŽ¥ç¶šã‚¿ã‚¤ãƒ—" -#: ../../rst/inventory_guide/intro_inventory.rst:674 +#: ../../rst/inventory_guide/intro_inventory.rst:680 msgid "As stated in the previous section, Ansible executes playbooks over SSH but it is not limited to this connection type. With the host specific parameter ``ansible_connection=<connector>``, the connection type can be changed. The following non-SSH based connectors are available:" msgstr "å‰ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã—ãŸã‚ˆã†ã«ã€Ansible 㯠SSH 㧠Playbook を実行ã—ã¾ã™ãŒã€ã“ã®æŽ¥ç¶šã‚¿ã‚¤ãƒ—ã¯åˆ¶é™ã•ã‚Œã¦ã„ã¾ã›ã‚“。ホスト固有ã®ãƒ‘ラメーター ``ansible_connection=<connector>`` ã§ã¯ã€æŽ¥ç¶šã‚¿ã‚¤ãƒ—を変更ã§ãã¾ã™ã€‚次㮠SSH 以外ã®ã‚³ãƒã‚¯ã‚¿ãƒ¼ã‚’利用ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:678 +#: ../../rst/inventory_guide/intro_inventory.rst:684 msgid "**local**" msgstr "**local**" -#: ../../rst/inventory_guide/intro_inventory.rst:680 +#: ../../rst/inventory_guide/intro_inventory.rst:686 msgid "This connector can be used to deploy the playbook to the control machine itself." msgstr "ã“ã®ã‚³ãƒã‚¯ã‚¿ãƒ¼ã¯ã€Playbook をコントãƒãƒ¼ãƒ«ãƒžã‚·ãƒ³è‡ªä½“ã«ãƒ‡ãƒ—ãƒã‚¤ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:682 +#: ../../rst/inventory_guide/intro_inventory.rst:688 msgid "**docker**" msgstr "**docker**" -#: ../../rst/inventory_guide/intro_inventory.rst:684 +#: ../../rst/inventory_guide/intro_inventory.rst:690 msgid "This connector deploys the playbook directly into Docker containers using the local Docker client. The following parameters are processed by this connector:" msgstr "ã“ã®ã‚³ãƒã‚¯ã‚¿ãƒ¼ã¯ã€ãƒãƒ¼ã‚«ãƒ«ã® Docker クライアントを使用ã—㦠Playbook を直接 Docker コンテナーã«ãƒ‡ãƒ—ãƒã‚¤ã—ã¾ã™ã€‚以下ã®ãƒ‘ラメーターã¯ã“ã®ã‚³ãƒã‚¯ã‚¿ãƒ¼ã«ã‚ˆã£ã¦å‡¦ç†ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:687 +#: ../../rst/inventory_guide/intro_inventory.rst:693 msgid "The name of the Docker container to connect to." msgstr "接続先㮠Docker コンテナーã®åå‰ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:689 +#: ../../rst/inventory_guide/intro_inventory.rst:695 msgid "The user name to operate within the container. The user must exist inside the container." msgstr "コンテナー内ã§æ“作ã™ã‚‹ãŸã‚ã®ãƒ¦ãƒ¼ã‚¶å。ユーザーã¯ã‚³ãƒ³ãƒ†ãƒŠãƒ¼å†…ã«å˜åœ¨ã—ã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:691 +#: ../../rst/inventory_guide/intro_inventory.rst:697 msgid "If set to ``true`` the ``become_user`` will be used to operate within the container." msgstr "``true`` ã«è¨å®šã™ã‚‹ã¨ã€``become_user`` ã¯ã‚³ãƒ³ãƒ†ãƒŠãƒ¼å†…ã§å‹•ä½œã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:693 +#: ../../rst/inventory_guide/intro_inventory.rst:699 msgid "ansible_docker_extra_args" msgstr "ansible_docker_extra_args" -#: ../../rst/inventory_guide/intro_inventory.rst:693 +#: ../../rst/inventory_guide/intro_inventory.rst:699 msgid "Could be a string with any additional arguments understood by Docker, which are not command specific. This parameter is mainly used to configure a remote Docker daemon to use." msgstr "Docker ãŒèªè˜ã™ã‚‹è¿½åŠ ã®å¼•æ•°ã‚’æŒã¤æ–‡å—列を指定ã§ãã¾ã™ãŒã€ã“ã‚Œã¯ã‚³ãƒžãƒ³ãƒ‰å›ºæœ‰ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã“ã®ãƒ‘ラメーターã¯ä¸»ã«ã€ä½¿ç”¨ã™ã‚‹ãƒªãƒ¢ãƒ¼ãƒˆ Docker デーモンをè¨å®šã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:695 +#: ../../rst/inventory_guide/intro_inventory.rst:701 msgid "Here is an example of how to instantly deploy to created containers:" msgstr "以下ã¯ã€ä½œæˆã•ã‚ŒãŸã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã«å³æ™‚ã«ãƒ‡ãƒ—ãƒã‚¤ã™ã‚‹ä¾‹ã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:719 +#: ../../rst/inventory_guide/intro_inventory.rst:725 msgid "For a full list with available plugins and examples, see :ref:`connection_plugin_list`." msgstr "利用å¯èƒ½ãªãƒ—ラグインã¨ã‚µãƒ³ãƒ—ルã®ä¸€è¦§ã¯ã€ã€Œ:ref:`connection_plugin_list`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:721 +#: ../../rst/inventory_guide/intro_inventory.rst:727 msgid "If you're reading the docs from the beginning, this may be the first example you've seen of an Ansible playbook. This is not an inventory file. Playbooks will be covered in great detail later in the docs." msgstr "ドã‚ュメントを最åˆã‹ã‚‰èªã‚“ã§ã„ã‚‹å ´åˆã€ã“れ㯠Ansible Playbook ã‚’åˆã‚ã¦ç¢ºèªã—ãŸä¾‹ã§ã™ã€‚ã“ã‚Œã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ã‚ã‚Šã¾ã›ã‚“。Playbook ã¯ã€ãƒ‰ã‚ュメントã§å¾Œã»ã©è©³ç´°ã«èª¬æ˜Žã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:727 +#: ../../rst/inventory_guide/intro_inventory.rst:733 msgid "Inventory setup examples" msgstr "インベントリーã®è¨å®šä¾‹" -#: ../../rst/inventory_guide/intro_inventory.rst:729 +#: ../../rst/inventory_guide/intro_inventory.rst:735 msgid "See also :ref:`sample_setup`, which shows inventory along with playbooks and other Ansible artifacts." msgstr "Playbook ãŠã‚ˆã³ãã®ä»–ã® Ansible アーティファクトã¨ã¨ã‚‚ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚’表示ã™ã‚‹ã€Œ:ref:`sample_setup`ã€ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/inventory_guide/intro_inventory.rst:734 +#: ../../rst/inventory_guide/intro_inventory.rst:740 msgid "Example: One inventory per environment" msgstr "例: å„環境㫠1 ã¤ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼" -#: ../../rst/inventory_guide/intro_inventory.rst:736 +#: ../../rst/inventory_guide/intro_inventory.rst:742 msgid "If you need to manage multiple environments it's sometimes prudent to have only hosts of a single environment defined per inventory. This way, it is harder to, for instance, accidentally change the state of nodes inside the \"test\" environment when you actually wanted to update some \"staging\" servers." msgstr "複数ã®ç’°å¢ƒã‚’管ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã”ã¨ã« 1 ã¤ã®ç’°å¢ƒã®ãƒ›ã‚¹ãƒˆã®ã¿ã‚’定義ã™ã‚‹ã“ã¨ãŒè³¢æ˜Žãªå ´åˆãŒã‚ã‚Šã¾ã™ã€‚ã“ã†ã™ã‚‹ã“ã¨ã§ã€ãŸã¨ãˆã°ã€å®Ÿéš›ã«ã¯ã€Œã‚¹ãƒ†ãƒ¼ã‚¸ãƒ³ã‚°ã€ã‚µãƒ¼ãƒãƒ¼ã‚’æ›´æ–°ã—ãŸã„ã®ã«ã€èª¤ã£ã¦ã€Œãƒ†ã‚¹ãƒˆã€ç’°å¢ƒå†…ã®ãƒŽãƒ¼ãƒ‰ã®çŠ¶æ…‹ã‚’変更ã—ã¦ã—ã¾ã†ã“ã¨ãŒèµ·ã“ã‚Šã«ãããªã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:742 +#: ../../rst/inventory_guide/intro_inventory.rst:748 msgid "For the example mentioned above you could have an :file:`inventory_test` file:" msgstr "å‰è¿°ã®ä¾‹ã§ã¯ã€:file:`inventory_test` ã¨ã„ã†ãƒ•ã‚¡ã‚¤ãƒ«ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:756 +#: ../../rst/inventory_guide/intro_inventory.rst:762 msgid "That file only includes hosts that are part of the \"test\" environment. Define the \"staging\" machines in another file called :file:`inventory_staging`:" msgstr "ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€ã€Œãƒ†ã‚¹ãƒˆã€ç’°å¢ƒã«å«ã¾ã‚Œã‚‹ãƒ›ã‚¹ãƒˆã®ã¿ãŒå«ã¾ã‚Œã¾ã™ã€‚:file:`inventory_staging` ã¨å‘¼ã°ã‚Œã‚‹åˆ¥ã®ãƒ•ã‚¡ã‚¤ãƒ«ã®ã€Œã‚¹ãƒ†ãƒ¼ã‚¸ãƒ³ã‚°ã€ãƒžã‚·ãƒ³ã‚’定義ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:771 +#: ../../rst/inventory_guide/intro_inventory.rst:777 msgid "To apply a playbook called :file:`site.yml` to all the app servers in the test environment, use the following command:" msgstr "`site.yml` ã¨ã„ã†åå‰ã® Playbook をテスト環境ã®ã™ã¹ã¦ã®ã‚¢ãƒ—リケーションサーãƒãƒ¼ã«é©ç”¨ã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:782 +#: ../../rst/inventory_guide/intro_inventory.rst:788 msgid "Example: Group by function" msgstr "例: 機能別ã«ã‚°ãƒ«ãƒ¼ãƒ—化" -#: ../../rst/inventory_guide/intro_inventory.rst:784 +#: ../../rst/inventory_guide/intro_inventory.rst:790 msgid "In the previous section you already saw an example for using groups in order to cluster hosts that have the same function. This allows you, for instance, to define firewall rules inside a playbook or role affecting only database servers:" msgstr "å‰ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€åŒã˜æ©Ÿèƒ½ã‚’æŒã¤ãƒ›ã‚¹ãƒˆã‚’クラスター化ã™ã‚‹ãŸã‚ã«ã€ã‚°ãƒ«ãƒ¼ãƒ—を使用ã™ã‚‹ä¾‹ã‚’ã™ã§ã«æ示ã—ã¦ã„ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ‡ãƒ¼ã‚¿ãƒ™ãƒ¼ã‚¹ã‚µãƒ¼ãƒãƒ¼ã ã‘ã«å½±éŸ¿ã™ã‚‹ Playbook ã¾ãŸã¯ãƒãƒ¼ãƒ«å†…ã§ãƒ•ã‚¡ã‚¤ã‚¢ã‚¦ã‚©ãƒ¼ãƒ«ãƒ«ãƒ¼ãƒ«ã‚’定義ã§ãã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:802 +#: ../../rst/inventory_guide/intro_inventory.rst:808 msgid "Example: Group by location" msgstr "例: å ´æ‰€åˆ¥ã«ã‚°ãƒ«ãƒ¼ãƒ—化" -#: ../../rst/inventory_guide/intro_inventory.rst:804 +#: ../../rst/inventory_guide/intro_inventory.rst:810 msgid "Other tasks might be focused on where a certain host is located. Let's say that ``db01.test.example.com`` and ``app01.test.example.com`` are located in DC1 while ``db02.test.example.com`` is in DC2:" msgstr "ã¾ãŸã€ç‰¹å®šã®ãƒ›ã‚¹ãƒˆãŒã©ã“ã«ã‚ã‚‹ã‹ã«ç„¦ç‚¹ã‚’当ã¦ãŸã‚¿ã‚¹ã‚¯ã‚‚ã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€``db01.test.example.com`` 㨠``app01.test.example.com`` ㌠DC1 ã«ã‚ã‚Šã€``db02.test.example.com`` ㌠DC2 ã«ã‚ã‚‹ã¨ã—ã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:817 +#: ../../rst/inventory_guide/intro_inventory.rst:823 msgid "In practice, you might even end up mixing all these setups as you might need to, on one day, update all nodes in a specific data center while, on another day, update all the application servers no matter their location." msgstr "実際ã«ã¯ã€ãŸã¨ãˆã°ç‰¹å®šã®ãƒ‡ãƒ¼ã‚¿ã‚»ãƒ³ã‚¿ãƒ¼å†…ã®ã™ã¹ã¦ã®ãƒŽãƒ¼ãƒ‰ã‚’æ›´æ–°ã™ã‚‹æ—¥ã¨ã€ç½®ã‹ã‚Œã¦ã„ã‚‹å ´æ‰€ã«é–¢ä¿‚ãªãã™ã¹ã¦ã®ã‚¢ãƒ—リケーションサーãƒãƒ¼ã‚’æ›´æ–°ã™ã‚‹æ—¥ãŒå¿…è¦ã«ãªã‚‹ãŸã‚ã€ã“れらã™ã¹ã¦ã®è¨å®šã‚’組ã¿åˆã‚ã›ã¦ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/inventory_guide/intro_inventory.rst:824 +#: ../../rst/inventory_guide/intro_inventory.rst:830 msgid ":ref:`inventory_plugins`" msgstr ":ref:`inventory_plugins`" -#: ../../rst/inventory_guide/intro_inventory.rst:825 +#: ../../rst/inventory_guide/intro_inventory.rst:831 msgid "Pulling inventory from dynamic or static sources" msgstr "動的ソースã¾ãŸã¯é™çš„ソースã‹ã‚‰ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®ãƒ—ル" -#: ../../rst/inventory_guide/intro_inventory.rst:826 +#: ../../rst/inventory_guide/intro_inventory.rst:832 msgid ":ref:`intro_dynamic_inventory`" msgstr ":ref:`intro_dynamic_inventory`" -#: ../../rst/inventory_guide/intro_inventory.rst:827 +#: ../../rst/inventory_guide/intro_inventory.rst:833 msgid "Pulling inventory from dynamic sources, such as cloud providers" msgstr "クラウドプãƒãƒã‚¤ãƒ€ãƒ¼ãªã©ã®å‹•çš„ソースã‹ã‚‰ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã®ãƒ—ル" -#: ../../rst/inventory_guide/intro_inventory.rst:828 +#: ../../rst/inventory_guide/intro_inventory.rst:834 #: ../../rst/inventory_guide/intro_patterns.rst:246 msgid ":ref:`intro_adhoc`" msgstr ":ref:`intro_adhoc`" -#: ../../rst/inventory_guide/intro_inventory.rst:829 +#: ../../rst/inventory_guide/intro_inventory.rst:835 #: ../../rst/inventory_guide/intro_patterns.rst:247 msgid "Examples of basic commands" msgstr "基本コマンドã®ä¾‹" -#: ../../rst/inventory_guide/intro_inventory.rst:830 +#: ../../rst/inventory_guide/intro_inventory.rst:836 #: ../../rst/inventory_guide/intro_patterns.rst:248 msgid ":ref:`working_with_playbooks`" msgstr ":ref:`working_with_playbooks`" -#: ../../rst/inventory_guide/intro_inventory.rst:831 +#: ../../rst/inventory_guide/intro_inventory.rst:837 msgid "Learning Ansible's configuration, deployment, and orchestration language." msgstr "Ansible ã®è¨å®šã€ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã€ãŠã‚ˆã³ã‚ªãƒ¼ã‚±ã‚¹ãƒˆãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³è¨€èªžã«ã¤ã„ã¦" @@ -1397,4 +1415,10 @@ msgstr "Ansible コマンドãŠã‚ˆã³ Playbook ã§ãƒ‘ターンã«é–¢ã™ã‚‹çŸ¥è˜ msgid "Learning the Ansible configuration management language" msgstr "Ansible ã®è¨å®šç®¡ç†è¨€èªžã«ã¤ã„ã¦" +#~ msgid "In Ansible 2.10 and later, inventory scripts moved to their associated collections. Many are now in the `community.general scripts/inventory directory <https://github.com/ansible-collections/community.general/tree/main/scripts/inventory>`_. We recommend you use :ref:`inventory_plugins` instead." +#~ msgstr "Ansible 2.10 以é™ã§ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯é–¢é€£ã™ã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ç§»å‹•ã—ã¾ã—ãŸã€‚ç¾åœ¨ã€å¤šãã®ã‚¹ã‚¯ãƒªãƒ—ト㯠`community.general scripts/inventory directory <https://github.com/ansible-collections/community.general/tree/main/scripts/inventory>`_ ã«ã‚ã‚Šã¾ã™ã€‚代ã‚ã‚Šã« :ref:`inventory_plugins` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "To create parent/child relationships for groups: * in INI format, use the ``:children`` suffix * in YAML format, use the ``children:`` entry" +#~ msgstr "グループã®è¦ª/åã®é–¢ä¿‚を作æˆã™ã‚‹ã«ã¯ã€ * INI å½¢å¼ã®å ´åˆã«ã¯ ``:children`` ã®æŽ¥å°¾è¾žã‚’〠* YAML å½¢å¼ã®å ´åˆã¯ ``children:`` エントリーを使用ã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/network.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/network.po index c4eea114..24f72d10 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/network.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/network.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/network/dev_guide/developing_plugins_network.rst:7 msgid "Developing network plugins" @@ -54,7 +54,7 @@ msgstr "è¦æ±‚ã®ä½œæˆ" #: ../../rst/network/dev_guide/developing_plugins_network.rst:54 msgid "The ``httpapi`` connection plugin has a ``send()`` method, but an httpapi plugin needs a ``send_request(self, data, **message_kwargs)`` method as a higher-level wrapper to ``send()``. This method should prepare requests by adding fixed values like common headers or URL root paths. This method may do more complex work such as turning data into formatted payloads, or determining which path or method to request. It may then also unpack responses to be more easily consumed by the caller." -msgstr "``httpapi`` connection プラグインã«ã¯ ``send()`` メソッドãŒã‚ã‚Šã¾ã™ãŒã€httpapi プラグインã«ã¯ã€``send()`` ã¸ã®é«˜ãƒ¬ãƒ™ãƒ«ãƒ©ãƒƒãƒ‘ーã¨ã—㦠``send_request(self, data, **message_kwargs)`` メソッドãŒå¿…è¦ã§ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€å…±é€šãƒ˜ãƒƒãƒ€ãƒ¼ã‚„ URL ルートパスãªã©ã®å›ºå®šå€¤ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§è¦æ±‚を準備ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã•ã‚ŒãŸãƒšã‚¤ãƒãƒ¼ãƒ‰ã¸ã®ãƒ‡ãƒ¼ã‚¿ã®åˆ‡ã‚Šæ›¿ãˆã‚„ã€ãƒªã‚¯ã‚¨ã‚¹ãƒˆç”¨ã®ãƒ‘スやメソッドã®ç‰¹å®šãªã©ã€ã‚ˆã‚Šè¤‡é›‘ãªä½œæ¥ã‚’è¡Œã†ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ãã®å¾Œã€å‘¼ã³å‡ºã—å…ƒã«ã‚ˆã£ã¦ç°¡å˜ã«æ¶ˆè²»ã•ã‚Œã‚‹å¿œç”ãŒå±•é–‹ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™" +msgstr "``httpapi`` connection プラグインã«ã¯ ``send()`` メソッドãŒã‚ã‚Šã¾ã™ãŒã€httpapi プラグインã«ã¯ã€``send()`` ã¸ã®é«˜ãƒ¬ãƒ™ãƒ«ãƒ©ãƒƒãƒ‘ーã¨ã—㦠``send_request(self, data, **message_kwargs)`` メソッドãŒå¿…è¦ã§ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€å…±é€šãƒ˜ãƒƒãƒ€ãƒ¼ã‚„ URL ルートパスãªã©ã®å›ºå®šå€¤ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§è¦æ±‚を準備ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã•ã‚ŒãŸãƒšã‚¤ãƒãƒ¼ãƒ‰ã¸ã®ãƒ‡ãƒ¼ã‚¿ã®åˆ‡ã‚Šæ›¿ãˆã‚„ã€ãƒªã‚¯ã‚¨ã‚¹ãƒˆç”¨ã®ãƒ‘スやメソッドã®ç‰¹å®šãªã©ã€ã‚ˆã‚Šè¤‡é›‘ãªä½œæ¥ã‚’è¡Œã†ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ãã®å¾Œã€å‘¼ã³å‡ºã—å…ƒã«ã‚ˆã£ã¦ç°¡å˜ã«æ¶ˆè²»ã•ã‚Œã‚‹å¿œç”ãŒå±•é–‹ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/network/dev_guide/developing_plugins_network.rst:74 msgid "Authenticating" @@ -802,13 +802,13 @@ msgid "Your tests should detect resources (such as interfaces) at runtime rather msgstr "テストã¯ã€(インターフェースãªã©ã®) リソースをテストã«ãƒãƒ¼ãƒ‰ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã™ã‚‹ã®ã§ã¯ãªãã€ãƒ©ãƒ³ã‚¿ã‚¤ãƒ 時ã«ãƒªã‚½ãƒ¼ã‚¹ã‚’検出ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ†ã‚¹ãƒˆã¯ã•ã¾ã–ã¾ãªã‚·ã‚¹ãƒ†ãƒ ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" #: ../../rst/network/dev_guide/developing_resource_modules_network.rst:631 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:205 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:264 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:300 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:329 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:360 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:409 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:615 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:209 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:268 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:304 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:333 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:364 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:413 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:623 #: ../../rst/network/user_guide/network_working_with_command_output.rst:29 msgid "For example:" msgstr "例:" @@ -1149,7 +1149,7 @@ msgstr "管ç†ãƒ›ã‚¹ãƒˆã«é©ç”¨ã•ã‚Œã‚‹ã€Œã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã€ã®å®šç¾©ã€‚タス #: ../../rst/shared_snippets/basic_concepts.txt:43 msgid "Handlers" -msgstr "ãƒãƒ³ãƒ‰ãƒ©ãƒ¼" +msgstr "Handler (ãƒãƒ³ãƒ‰ãƒ©ãƒ¼)" #: ../../rst/shared_snippets/basic_concepts.txt:44 msgid "A special form of a Task, that only executes when notified by a previous task which resulted in a 'changed' status." @@ -1324,8 +1324,8 @@ msgid "This is an example using an extract from a YAML inventory, as the INI fo msgstr "INI å½¢å¼ã¯ã‚¤ãƒ³ãƒ©ã‚¤ãƒ³ã® vault ã«å¯¾å¿œã—ã¦ã„ãªã„ãŸã‚ã€ä»¥ä¸‹ã¯ YAML インベントリーã‹ã‚‰æŠ½å‡ºã‚’使用ã™ã‚‹ä¾‹ã§ã™ã€‚" #: ../../rst/network/getting_started/first_inventory.rst:396 -msgid "To use an inline vaulted variables with an INI inventory you need to store it in a 'vars' file in YAML format, it can reside in host_vars/ or group_vars/ to be automatically picked up or referenced from a play via ``vars_files`` or ``include_vars``." -msgstr "インライン㮠Vault 変数を INI インベントリーã§ä½¿ç”¨ã™ã‚‹ã«ã¯ã€ã“れを YAML å½¢å¼ã§ã€Œvarsã€ãƒ•ã‚¡ã‚¤ãƒ«ã«ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れ㯠host_vars/ ã¾ãŸã¯ group_vars/ ã«ç½®ã‹ã‚Œã€``vars_files`` ã¾ãŸã¯ ``include_vars`` 㧠Play ã‹ã‚‰è‡ªå‹•çš„ã«å–å¾—ã¾ãŸã¯å‚ç…§ã•ã‚Œã¾ã™ã€‚" +msgid "To use an inline vaulted variables with an INI inventory you need to store it in a 'vars' file in YAML format, it can reside in host_vars/ or group_vars/ to be automatically picked up or referenced from a play through ``vars_files`` or ``include_vars``." +msgstr "インライン㮠Vault 変数を INI インベントリーã§ä½¿ç”¨ã™ã‚‹ã«ã¯ã€ã“れを YAML å½¢å¼ã§ã€Œvarsã€ãƒ•ã‚¡ã‚¤ãƒ«ã«ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“れ㯠host_vars/ ã¾ãŸã¯ group_vars/ ã«ç½®ã‹ã‚Œã€``vars_files`` ã¾ãŸã¯ ``include_vars`` ã§ãƒ—レイã‹ã‚‰è‡ªå‹•çš„ã«å–å¾—ã¾ãŸã¯å‚ç…§ã•ã‚Œã¾ã™ã€‚" #: ../../rst/network/getting_started/first_inventory.rst:399 msgid "To run a playbook with this setup, drop the ``-k`` flag and add a flag for your ``vault-id``:" @@ -1485,8 +1485,8 @@ msgid "Now that you can retrieve the device config, try updating it with Ansible msgstr "デãƒã‚¤ã‚¹è¨å®šã‚’å–å¾—ã§ããŸã®ã§ã€Ansible ã§æ›´æ–°ã—ã¦ã¿ã¾ã—ょã†ã€‚最åˆã® Playbook ã®æ‹¡å¼µãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã‚ã‚‹ :download:`first_playbook_ext.yml <sample_files/first_playbook_ext.yml>` をダウンãƒãƒ¼ãƒ‰ã—ã¾ã™ã€‚" #: ../../rst/network/getting_started/first_playbook.rst:116 -msgid "The extended first playbook has four tasks in a single play. Run it with the same command you used above. The output shows you the change Ansible made to the config:" -msgstr "æ‹¡å¼µã•ã‚ŒãŸæœ€åˆã® Playbook ã«ã¯ã€1 ã¤ã®ãƒ—レイ㫠4 ã¤ã®ã‚¿ã‚¹ã‚¯ãŒã‚ã‚Šã¾ã™ã€‚上記ã®ã‚³ãƒžãƒ³ãƒ‰ã¨åŒã˜ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦å®Ÿè¡Œã™ã‚‹ã¨ã€å‡ºåŠ›ã«ã¯ã€Ansible ãŒè¨å®šã«åŠ ãˆãŸå¤‰æ›´ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" +msgid "The extended first playbook has five tasks in a single play. Run it with the same command you used above. The output shows you the change Ansible made to the config:" +msgstr "æ‹¡å¼µã•ã‚ŒãŸæœ€åˆã® Playbook ã«ã¯ã€1 ã¤ã®ãƒ—レイ㫠5 ã¤ã®ã‚¿ã‚¹ã‚¯ãŒã‚ã‚Šã¾ã™ã€‚上記ã®ã‚³ãƒžãƒ³ãƒ‰ã¨åŒã˜ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¦å®Ÿè¡Œã™ã‚‹ã¨ã€å‡ºåŠ›ã«ã¯ã€Ansible ãŒè¨å®šã«åŠ ãˆãŸå¤‰æ›´ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" #: ../../rst/network/getting_started/first_playbook.rst:158 msgid "Gathering facts from network devices" @@ -1533,8 +1533,8 @@ msgid "Leverage the same simple, powerful, and agentless automation tool for net msgstr "æ“作ã¨é–‹ç™ºã§ä½¿ç”¨ã™ã‚‹ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã‚¿ã‚¹ã‚¯ã®ä¸¡æ–¹ã«ã€åŒä¸€ã®ç°¡å˜ã§å¼·åŠ›ãªã‚¨ãƒ¼ã‚¸ã‚§ãƒ³ãƒˆãƒ¬ã‚¹ã®è‡ªå‹•åŒ–ツールを使用ã—ã¾ã™ã€‚" #: ../../rst/network/getting_started/index.rst:11 -msgid "Separate the data model (in a playbook or role) from the execution layer (via Ansible modules) to manage heterogeneous network devices" -msgstr "異機種環境ã«ã‚ã‚‹ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã‚’管ç†ã™ã‚‹ãŸã‚ã€(Ansible モジュールã«ã‚ˆã‚Š) 実行レイヤーã‹ã‚‰ãƒ‡ãƒ¼ã‚¿ãƒ¢ãƒ‡ãƒ« (Playbook ã¾ãŸã¯ãƒãƒ¼ãƒ«) を分離ã—ã¾ã™ã€‚" +msgid "Separate the data model (in a playbook or role) from the execution layer (through Ansible modules) to manage heterogeneous network devices" +msgstr "異機種環境ã«ã‚ã‚‹ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã‚’管ç†ã™ã‚‹ãŸã‚ã€(Ansible モジュールã«ã‚ˆã‚Š) 実行レイヤーã‹ã‚‰ (Playbook ã¾ãŸã¯ãƒãƒ¼ãƒ«ã®) データモデルを分離ã—ã¾ã™ã€‚" #: ../../rst/network/getting_started/index.rst:12 msgid "Benefit from community and vendor-generated sample playbooks and roles to help accelerate network automation projects" @@ -1852,11 +1852,11 @@ msgstr "Ansible イベントã«ãŠã‘るセッションã¯ã™ã¹ã¦éŒ²ç”»ã•ã‚Œã #: ../../rst/network/getting_started/network_resources.rst:25 msgid "`Recorded AnsibleFests <https://www.ansible.com/resources/videos/ansiblefest>`_" -msgstr "`AnsibleFests (録画) <https://www.ansible.com/resources/videos/ansiblefest>`_" +msgstr "`Recorded AnsibleFests <https://www.ansible.com/resources/videos/ansiblefest>`_" #: ../../rst/network/getting_started/network_resources.rst:26 msgid "`Recorded AnsibleAutomates <https://www.ansible.com/resources/webinars-training>`_" -msgstr "`AnsibleAutomates (録画) <https://www.ansible.com/resources/webinars-training>`_" +msgstr "`Recorded AnsibleAutomates <https://www.ansible.com/resources/webinars-training>`_" #: ../../rst/network/getting_started/network_resources.rst:27 msgid "`Upcoming Ansible Events <https://www.ansible.com/community/events>`_ page." @@ -2032,7 +2032,7 @@ msgstr "ãƒãƒ¼ãƒ«ã® Ansible Galaxy ページã«ã¯ã€ä½¿ç”¨å¯èƒ½ãªã™ã¹ã¦ã #: ../../rst/network/getting_started/network_roles.rst:266 msgid "`Ansible Galaxy documentation <https://galaxy.ansible.com/docs/>`_" -msgstr "`Ansible Galaxy ドã‚ュメント <https://galaxy.ansible.com/docs/>`_" +msgstr "`Ansible Galaxy documentation <https://galaxy.ansible.com/docs/>`_" #: ../../rst/network/getting_started/network_roles.rst:267 msgid "Ansible Galaxy user guide" @@ -2428,7 +2428,7 @@ msgid "``textfsm`` is a Python module which implements a template-based state ma msgstr "``textfsm`` ã¯ã€åŠãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã®ãƒ†ã‚ストを解æžã™ã‚‹ãŸã‚ã«ãƒ†ãƒ³ãƒ—レートベースã®çŠ¶æ…‹ãƒžã‚·ãƒ³ã‚’実装ã™ã‚‹ Python モジュールã§ã™ã€‚" #: ../../rst/network/user_guide/cli_parsing.rst:442 -msgid "The following sample``textfsm`` template is stored as ``templates/nxos_show_interface.textfsm``" +msgid "The following sample ``textfsm`` template is stored as ``templates/nxos_show_interface.textfsm``" msgstr "以下ã®ã‚µãƒ³ãƒ—ル ``textfsm`` テンプレートã¯ã€``templates/nxos_show_interface.textfsm`` ã®å½¢å¼ã§ä¿å˜ã•ã‚Œã¾ã™ã€‚" #: ../../rst/network/user_guide/cli_parsing.rst:486 @@ -3040,7 +3040,7 @@ msgid "SSH key issues" msgstr "SSH ã‚ーã®å•é¡Œ" #: ../../rst/network/user_guide/network_debug_troubleshooting.rst -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:443 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:447 msgid "Timeout issues" msgstr "タイムアウトã®å•é¡Œ" @@ -3053,7 +3053,7 @@ msgid "May actually be masking a authentication issue" msgstr "èªè¨¼ã®å•é¡Œã‚’実際ã«ãƒžã‚¹ã‚¯ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹" #: ../../rst/network/user_guide/network_debug_troubleshooting.rst -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:604 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:612 msgid "Playbook issues" msgstr "Playbook ã®å•é¡Œ" @@ -3074,13 +3074,13 @@ msgid "Enabling Networking logging and how to read the logfile" msgstr "ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒã‚®ãƒ³ã‚°ã®æœ‰åŠ¹åŒ–ã¨ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã®èªã¿å–り方法" #: ../../rst/network/user_guide/network_debug_troubleshooting.rst:39 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:98 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:158 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:201 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:258 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:296 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:323 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:430 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:100 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:160 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:205 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:262 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:300 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:327 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:434 msgid "**Platforms:** Any" msgstr "**プラットフォーム:** ä»»æ„" @@ -3137,501 +3137,509 @@ msgid "If the log reports the port as ``None`` this means that the default port msgstr "ãƒã‚°ã§ãƒãƒ¼ãƒˆãŒ ``None`` ã¨ã—ã¦å ±å‘Šã•ã‚Œã‚‹å ´åˆã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒãƒ¼ãƒˆãŒä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚今後㮠Ansible リリースã§ã¯ã€ãƒãƒ¼ãƒˆãŒå¸¸ã«ãƒã‚°ã«è¨˜éŒ²ã•ã‚Œã‚‹ã‚ˆã†ã«ã“ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒæ”¹å–„ã•ã‚Œã¾ã™ã€‚" #: ../../rst/network/user_guide/network_debug_troubleshooting.rst:90 -msgid "Because the log files are verbose, you can use grep to look for specific information. For example, once you have identified the ``pid`` from the ``creating new control socket for host`` line you can search for other connection log entries::" -msgstr "ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã¯å†—é•·ã§ã‚ã‚‹ãŸã‚ã€grepを使用ã—ã¦ç‰¹å®šã®æƒ…å ±ã‚’æ¤œç´¢ã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€``creating new control socket for host`` è¡Œã‹ã‚‰ ``pid`` を特定ã—ãŸã‚‰ã€ä»–ã®æŽ¥ç¶šãƒã‚°ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’検索ã§ãã¾ã™ã€‚" +msgid "Because the log files are verbose, you can use grep to look for specific information. For example, once you have identified the ``pid`` from the ``creating new control socket for host`` line you can search for other connection log entries:" +msgstr "ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã¯å†—é•·ã§ã‚ã‚‹ãŸã‚ã€grep を使用ã—ã¦ç‰¹å®šã®æƒ…å ±ã‚’æ¤œç´¢ã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€``creating new control socket for host`` è¡Œã‹ã‚‰ ``pid`` を特定ã—ãŸã‚‰ã€ä»–ã®æŽ¥ç¶šãƒã‚°ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’検索ã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:96 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:98 msgid "Enabling Networking device interaction logging" msgstr "ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã®å¯¾è©±ãƒã‚®ãƒ³ã‚°ã®æœ‰åŠ¹åŒ–" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:100 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:102 msgid "Ansible includes logging of device interaction in the log file to help diagnose and troubleshoot issues regarding Ansible Networking modules. The messages are logged in the file pointed to by the ``log_path`` configuration option in the Ansible configuration file or by setting the :envvar:`ANSIBLE_LOG_PATH`." msgstr "Ansible ã«ã¯ã€Ansible ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«é–¢ã™ã‚‹å•é¡Œã®è¨ºæ–ãŠã‚ˆã³ãƒˆãƒ©ãƒ–ルシューティングã«å½¹ç«‹ã¤ã€ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«å†…ã®ãƒ‡ãƒã‚¤ã‚¹ã®å¯¾è©±ã®ãƒã‚°ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯ã€Ansible è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã® ``log_path`` è¨å®šã‚ªãƒ—ションã§æŒ‡å®šã•ã‚Œã¦ã„るファイルã«è¨˜éŒ²ã•ã‚Œã‚‹ã‹ã€:envvar:`ANSIBLE_LOG_PATH` ã‚’è¨å®šã™ã‚‹ã¨è¨˜éŒ²ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:105 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:107 msgid "The device interaction messages consist of command executed on the target device and the returned response. Since this log data can contain sensitive information including passwords in plain text it is disabled by default. Additionally, in order to prevent accidental leakage of data, a warning will be shown on every task with this setting enabled, specifying which host has it enabled and where the data is being logged." msgstr "デãƒã‚¤ã‚¹ã‚¤ãƒ³ã‚¿ãƒ©ã‚¯ã‚·ãƒ§ãƒ³ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯ã€ã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒ‡ãƒã‚¤ã‚¹ä¸Šã§å®Ÿè¡Œã•ã‚ŒãŸã‚³ãƒžãƒ³ãƒ‰ã¨è¿”ã•ã‚ŒãŸå¿œç”ã§æ§‹æˆã•ã‚Œã¾ã™ã€‚ã“ã®ãƒã‚°ãƒ‡ãƒ¼ã‚¿ã«ã¯ã€ãƒ‘スワードãªã©ã®æ©Ÿå¯†æƒ…å ±ãŒãƒ—レーンテã‚ストã®å½¢å¼ã§å«ã¾ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ç„¡åŠ¹ã«ãªã£ã¦ã„ã¾ã™ã€‚ã¾ãŸã€èª¤ã£ã¦ãƒ‡ãƒ¼ã‚¿ãŒæ¼æ´©ã—ãªã„よã†ã«ã€ã“ã®è¨å®šãŒæœ‰åŠ¹ã«ãªã£ã¦ã„ã‚‹ã™ã¹ã¦ã®ã‚¿ã‚¹ã‚¯ã«è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã€æœ‰åŠ¹ã«ãªã£ã¦ã„るホストã¨ãƒ‡ãƒ¼ã‚¿ãŒè¨˜éŒ²ã•ã‚Œã‚‹å ´æ‰€ãŒæŒ‡å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:110 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:112 msgid "Be sure to fully understand the security implications of enabling this option. The device interaction logging can be enabled either globally by setting in configuration file or by setting environment or enabled on per task basis by passing a special variable to the task." msgstr "ã“ã®ã‚ªãƒ—ションを有効ã«ã—ãŸå ´åˆã®ã‚»ã‚ュリティーã¸ã®å½±éŸ¿ã‚’完全ã«ç†è§£ã—ã¦ãã ã•ã„。デãƒã‚¤ã‚¹å¯¾è©±ãƒã‚®ãƒ³ã‚°ã¯ã€è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚°ãƒãƒ¼ãƒãƒ«ã«è¨å®šã™ã‚‹ã‹ã€ç’°å¢ƒã‚’è¨å®šã—ã¦æœ‰åŠ¹ã«ã™ã‚‹ã‹ã€ã¾ãŸã¯ç‰¹æ®Šãªå¤‰æ•°ã‚’タスクã«æ¸¡ã™ã“ã¨ã§ã‚¿ã‚¹ã‚¯ã”ã¨ã«æœ‰åŠ¹ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:112 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:114 msgid "Before running ``ansible-playbook`` run the following commands to enable logging:" msgstr "``ansible-playbook`` を実行ã™ã‚‹å‰ã«ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¦ãƒã‚®ãƒ³ã‚°ã‚’有効ã«ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:120 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:122 msgid "Enable device interaction logging for a given task" msgstr "特定ã®ã‚¿ã‚¹ã‚¯ã®ãƒ‡ãƒã‚¤ã‚¹å¯¾è©±ãƒã‚°ã‚’有効ã«ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:132 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:760 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:827 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:134 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:768 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:835 msgid "To make this a global setting, add the following to your ``ansible.cfg`` file:" msgstr "ã“ã®è¨å®šã‚’ã‚°ãƒãƒ¼ãƒãƒ«ã«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®è¨å®šã‚’ ``ansible.cfg`` ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:139 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:141 msgid "or enable the environment variable `ANSIBLE_PERSISTENT_LOG_MESSAGES`:" msgstr "ã¾ãŸã¯ã€ç’°å¢ƒå¤‰æ•° `ANSIBLE_PERSISTENT_LOG_MESSAGES` を有効ã«ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:146 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:148 msgid "If the task is failing on connection initialization itself, you should enable this option globally. If an individual task is failing intermittently this option can be enabled for that task itself to find the root cause." msgstr "タスク自体ãŒæŽ¥ç¶šã®åˆæœŸåŒ–ã«å¤±æ•—ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã“ã®ã‚ªãƒ—ションをグãƒãƒ¼ãƒãƒ«ã«æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚個々ã®ã‚¿ã‚¹ã‚¯ãŒæ–続的ã«å¤±æ•—ã™ã‚‹å ´åˆã¯ã€ãã®ã‚¿ã‚¹ã‚¯è‡ªä½“ã«å¯¾ã—ã¦ã“ã®ã‚ªãƒ—ションを有効ã«ã—ã¦ã€æ ¹æœ¬åŽŸå› を見ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:149 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:151 msgid "After Ansible has finished running you can inspect the log file which has been created on the ansible-controller" msgstr "Ansible ã®å®Ÿè¡ŒãŒå®Œäº†ã—ãŸã‚‰ã€ansible-controller ã§ä½œæˆã•ã‚ŒãŸãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‚’確èªã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:151 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:153 msgid "Be sure to fully understand the security implications of enabling this option as it can log sensitive information in log file thus creating security vulnerability." msgstr "ã“ã®ã‚ªãƒ—ションを有効ã«ã™ã‚‹ã¨ã€ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã«æ©Ÿå¯†æƒ…å ±ãŒè¨˜éŒ²ã•ã‚Œã€ã‚»ã‚ュリティ上ã®è„†å¼±æ€§ãŒç”Ÿã˜ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã‚»ã‚ュリティー上ã®å½±éŸ¿ã‚’å分ã«ç†è§£ã—ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:156 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:158 msgid "Isolating an error" msgstr "エラーã®åˆ†é›¢" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:160 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:162 msgid "As with any effort to troubleshoot it's important to simplify the test case as much as possible." msgstr "トラブルシューティングã«ãŠã‘ã‚‹ã‚らゆる作æ¥ã¨åŒæ§˜ã«ã€ãƒ†ã‚¹ãƒˆã‚±ãƒ¼ã‚¹ã‚’ã§ãã‚‹ã ã‘簡略化ã™ã‚‹ã“ã¨ãŒé‡è¦ã§ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:162 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:164 msgid "For Ansible this can be done by ensuring you are only running against one remote device:" msgstr "Ansible ã®å ´åˆã¯ã€1 ã¤ã®ãƒªãƒ¢ãƒ¼ãƒˆãƒ‡ãƒã‚¤ã‚¹ã«å¯¾ã—ã¦ã®ã¿å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ã™ã‚‹ã“ã¨ã§ã“れを行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:164 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:166 msgid "Using ``ansible-playbook --limit switch1.example.net...``" msgstr "``ansible-playbook --limit switch1.example.net...`` ã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:165 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:167 msgid "Using an ad hoc ``ansible`` command" msgstr "``ansible`` アドホックコマンドã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:167 -msgid "`ad hoc` refers to running Ansible to perform some quick command using ``/usr/bin/ansible``, rather than the orchestration language, which is ``/usr/bin/ansible-playbook``. In this case we can ensure connectivity by attempting to execute a single command on the remote device::" -msgstr "`ad hoc` ã¯ã€ã‚ªãƒ¼ã‚±ã‚¹ãƒˆãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³è¨€èªž ``/usr/bin/ansible-playbook`` ã§ã¯ãªãã€``/usr/bin/ansible`` を使用ã—ã¦ç°¡å˜ãªã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ãŸã‚ã« Ansible を実行ã™ã‚‹ã“ã¨ã‚’指ã—ã¾ã™ã€‚ã“ã®å ´åˆã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ‡ãƒã‚¤ã‚¹ã§ 1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ã“ã¨ã§ã€æŽ¥ç¶šã‚’確èªã§ãã¾ã™ã€‚" +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:169 +msgid "`ad hoc` refers to running Ansible to perform some quick command using ``/usr/bin/ansible``, rather than the orchestration language, which is ``/usr/bin/ansible-playbook``. In this case we can ensure connectivity by attempting to execute a single command on the remote device:" +msgstr "`ad hoc` ã¯ã€ã‚ªãƒ¼ã‚±ã‚¹ãƒˆãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³è¨€èªž ``/usr/bin/ansible-playbook`` ã§ã¯ãªãã€``/usr/bin/ansible`` を使用ã—ã¦ç°¡å˜ãªã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ãŸã‚ã« Ansible を実行ã™ã‚‹ã“ã¨ã‚’指ã—ã¾ã™ã€‚ã“ã®å ´åˆã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ‡ãƒã‚¤ã‚¹ã§ 1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ã®å®Ÿè¡Œã‚’試ã¿ã‚‹ã“ã¨ã§ã€æŽ¥ç¶šã‚’確èªã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:171 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:175 msgid "In the above example, we:" msgstr "上記ã®ä¾‹ã§ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:173 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:177 msgid "connect to ``switch1.example.net`` specified in the inventory file ``inventory``" msgstr "インベントリーファイル ``inventory`` ã«æŒ‡å®šã•ã‚ŒãŸ ``switch1.example.net`` ã«æŽ¥ç¶šã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:174 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:178 msgid "use the module ``arista.eos.eos_command``" msgstr "``arista.eos.eos_command`` モジュールã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:175 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:179 msgid "run the command ``?``" msgstr "``?`` コマンドã®å®Ÿè¡Œ" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:176 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:180 msgid "connect using the username ``admin``" msgstr "ユーザーå ``admin`` を使用ã—ã¦æŽ¥ç¶š" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:177 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:181 msgid "inform the ``ansible`` command to prompt for the SSH password by specifying ``-k``" msgstr "``-k`` を指定ã—㦠SSH パスワードをè¦æ±‚ã™ã‚‹ã‚ˆã†ã«ã€``ansible`` コマンドã«é€šçŸ¥" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:179 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:183 msgid "If you have SSH keys configured correctly, you don't need to specify the ``-k`` parameter." msgstr "SSH ã‚ーãŒæ£ã—ãè¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``-k`` パラメーターを指定ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:181 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:185 msgid "If the connection still fails you can combine it with the enable_network_logging parameter. For example:" msgstr "ãã‚Œã§ã‚‚接続ãŒå¤±æ•—ã—ãŸå ´åˆã¯ã€ã“れを enable_network_logging パラメーターã¨çµ„ã¿åˆã‚ã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:192 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:196 msgid "Then review the log file and find the relevant error message in the rest of this document." msgstr "次ã«ã€ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‚’確èªã—ã€ã“ã®ãƒ‰ã‚ュメントã®æ®‹ã‚Šã®éƒ¨åˆ†ã§ã€é–¢é€£ã™ã‚‹ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’見ã¤ã‘ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:199 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:203 msgid "Troubleshooting socket path issues" msgstr "ソケットパスã®å•é¡Œã®ãƒˆãƒ©ãƒ–ルシューティング" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:203 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:207 msgid "The ``Socket path does not exist or cannot be found`` and ``Unable to connect to socket`` messages indicate that the socket used to communicate with the remote network device is unavailable or does not exist." msgstr "``Socket path does not exist or cannot be found`` メッセージãŠã‚ˆã³ ``Unable to connect to socket``メッセージã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã¨ã®é€šä¿¡ã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚½ã‚±ãƒƒãƒˆãŒåˆ©ç”¨ã§ããªã„ã‹ã€å˜åœ¨ã—ãªã„ã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:218 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:243 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:380 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:222 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:247 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:384 msgid "or" msgstr "ã¾ãŸã¯" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:231 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:285 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:311 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:337 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:371 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:423 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:454 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:480 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:506 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:517 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:543 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:627 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:799 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:235 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:289 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:315 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:341 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:375 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:427 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:458 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:484 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:510 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:523 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:551 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:635 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:807 msgid "Suggestions to resolve:" msgstr "解決ã™ã‚‹ãŸã‚ã®ãƒ’ント:" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:233 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:237 msgid "Verify that you have write access to the socket path described in the error message." msgstr "エラーメッセージã«è¨˜è¼‰ã•ã‚Œã¦ã„るソケットパスã¸ã®æ›¸ãè¾¼ã¿æ¨©é™ãŒã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:235 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:239 msgid "Follow the steps detailed in :ref:`enable network logging <enable_network_logging>`." msgstr "「:ref:`ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒã‚®ãƒ³ã‚°ã®æœ‰åŠ¹åŒ– <enable_network_logging>`ã€è¨˜è¼‰ã•ã‚Œã‚‹æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:237 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:241 msgid "If the identified error message from the log file is:" msgstr "ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ç‰¹å®šã•ã‚ŒãŸã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒä»¥ä¸‹ã®å ´åˆã¯ã€" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:249 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:253 msgid "Follow the steps detailed in :ref:`timeout issues <timeout_issues>`" msgstr "「:ref:`タイムアウトã®å•é¡Œ <timeout_issues>`ã€ã«è¨˜è¼‰ã®æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:255 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:259 msgid "Category \"Unable to open shell\"" msgstr "Category \"Unable to open shell\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:260 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:264 msgid "The ``unable to open shell`` message means that the ``ansible-connection`` daemon has not been able to successfully talk to the remote network device. This generally means that there is an authentication issue. It is a \"catch all\" message, meaning you need to enable :ref:`logging <a_note_about_logging>` to find the underlying issues." msgstr "``unable to open shell`` メッセージã¯ã€``ansible-connection`` デーモンãŒãƒªãƒ¢ãƒ¼ãƒˆãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã¨æ£å¸¸ã«é€šä¿¡ã§ããªã‹ã£ãŸã“ã¨ã‚’示ã—ã¾ã™ã€‚ã“ã‚Œã¯é€šå¸¸ã€èªè¨¼ã®å•é¡ŒãŒã‚ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€Œcatch all (å…¨ã¦å–å¾—ã™ã‚‹)ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã§ã™ã€‚ã¤ã¾ã‚Šã€:ref:`logging <a_note_about_logging>` を有効ã«ã—ã¦ã€æ ¹æœ¬çš„ãªå•é¡Œã‚’検出ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:272 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:276 msgid "or:" msgstr "ã¾ãŸã¯" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:287 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:291 msgid "Follow the steps detailed in enable_network_logging_." msgstr "enable_network_logging_ ã«è¨˜è¼‰ã®æ‰‹é †ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:289 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:293 msgid "Once you've identified the error message from the log file, the specific solution can be found in the rest of this document." msgstr "ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒç‰¹å®šã§ããŸã‚‰ã€ç‰¹å®šã®è§£æ±ºæ–¹æ³•ã¯ã€æœ¬ã‚¬ã‚¤ãƒ‰ã®ãã®ä»–ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:294 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:298 msgid "Error: \"[Errno -2] Name or service not known\"" msgstr "Error: \"[Errno -2] Name or service not known\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:298 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:302 msgid "Indicates that the remote host you are trying to connect to can not be reached" msgstr "接続ã—よã†ã¨ã—ã¦ã„るリモートホストã«åˆ°é”ã§ããªã„ã“ã¨ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:313 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:317 msgid "If you are using the ``provider:`` options ensure that its suboption ``host:`` is set correctly." msgstr "``provider:`` オプションを使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã‚µãƒ–オプション ``host:`` ãŒæ£ã—ãè¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:314 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:318 msgid "If you are not using ``provider:`` nor top-level arguments ensure your inventory file is correct." msgstr "``provider:`` ã¾ãŸã¯ãƒˆãƒƒãƒ—レベルã®å¼•æ•°ã‚’使用ã—ãªã„å ´åˆã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ãŒæ£ã—ã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:321 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:325 msgid "Error: \"Authentication failed\"" msgstr "Error: \"Authentication failed\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:325 -msgid "Occurs if the credentials (username, passwords, or ssh keys) passed to ``ansible-connection`` (via ``ansible`` or ``ansible-playbook``) can not be used to connect to the remote device." +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:329 +msgid "Occurs if the credentials (username, passwords, or ssh keys) passed to ``ansible-connection`` (through ``ansible`` or ``ansible-playbook``) can not be used to connect to the remote device." msgstr "(``ansible`` ã¾ãŸã¯ ``ansible-playbook`` を使用ã—ã¦) ``ansible-connection`` ã«æ¸¡ã•ã‚Œã‚‹èªè¨¼æƒ…å ± (ユーザーåã€ãƒ‘スワードã€ã¾ãŸã¯ ssh ã‚ー) を使用ã—ã¦ãƒªãƒ¢ãƒ¼ãƒˆãƒ‡ãƒã‚¤ã‚¹ã«æŽ¥ç¶šã§ããªã„å ´åˆã«ç™ºç”Ÿã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:339 -msgid "If you are specifying credentials via ``password:`` (either directly or via ``provider:``) or the environment variable `ANSIBLE_NET_PASSWORD` it is possible that ``paramiko`` (the Python SSH library that Ansible uses) is using ssh keys, and therefore the credentials you are specifying are being ignored. To find out if this is the case, disable \"look for keys\". This can be done like this:" +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:343 +msgid "If you are specifying credentials through ``password:`` (either directly or through ``provider:``) or the environment variable `ANSIBLE_NET_PASSWORD` it is possible that ``paramiko`` (the Python SSH library that Ansible uses) is using ssh keys, and therefore the credentials you are specifying are being ignored. To find out if this is the case, disable \"look for keys\". This can be done like this:" msgstr "(直接ã¾ãŸã¯ ``provider:`` を使用ã—ã¦) ``password:`` ã§èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å ´åˆã‚„ã€ç’°å¢ƒå¤‰æ•° `ANSIBLE_NET_PASSWORD` を指定ã™ã‚‹å ´åˆã¯ã€``paramiko`` (Ansible ãŒä½¿ç”¨ã™ã‚‹ Python SSH ライブラリー) ㌠ssh ã‚ーを使用ã—ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€æŒ‡å®šã™ã‚‹èªè¨¼æƒ…å ±ãŒç„¡åŠ¹ã«ãªã‚Šã¾ã™ã€‚ã“れを確èªã™ã‚‹ã«ã¯ã€ã€Œlook for keysã€ã‚’無効ã«ã—ã¾ã™ã€‚ã“ã‚Œã¯æ¬¡ã®ã‚ˆã†ã«è¡Œã„ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:345 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:462 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:489 -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:554 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:349 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:466 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:493 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:562 msgid "To make this a permanent change, add the following to your ``ansible.cfg`` file:" msgstr "ã“れを永続的ã«è¡Œã†ã«ã¯ã€ä»¥ä¸‹ã‚’ ``ansible.cfg`` ファイルã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:354 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:358 msgid "Error: \"connecting to host <hostname> returned an error\" or \"Bad address\"" msgstr "Error: \"connecting to host <hostname> returned an error\" or \"Bad address\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:356 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:360 msgid "This may occur if the SSH fingerprint hasn't been added to Paramiko's (the Python SSH library) know hosts file." msgstr "ã“ã‚Œã¯ã€SSH フィンガープリント㌠Paramiko ã®æ—¢çŸ¥ã®ãƒ›ã‚¹ãƒˆãƒ•ã‚¡ã‚¤ãƒ« (Python SSH ライブラリー) ã«è¿½åŠ ã•ã‚Œã¦ã„ãªã„å ´åˆã«ç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:358 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:362 msgid "When using persistent connections with Paramiko, the connection runs in a background process. If the host doesn't already have a valid SSH key, by default Ansible will prompt to add the host key. This will cause connections running in background processes to fail." msgstr "Paramiko ã§æ°¸ç¶šçš„ãªæŽ¥ç¶šã‚’使用ã™ã‚‹å ´åˆã€æŽ¥ç¶šã¯ãƒãƒƒã‚¯ã‚°ãƒ©ã‚¦ãƒ³ãƒ‰ãƒ—ãƒã‚»ã‚¹ã§å®Ÿè¡Œã—ã¾ã™ã€‚ホストãŒæœ‰åŠ¹ãª SSH ã‚ーをæŒã£ã¦ã„ãªã„å ´åˆã€Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ãƒ›ã‚¹ãƒˆã‚ãƒ¼ã‚’è¿½åŠ ã™ã‚‹ã‚ˆã†ãƒ—ãƒãƒ³ãƒ—トを出ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒãƒƒã‚¯ã‚°ãƒ©ã‚¦ãƒ³ãƒ‰ãƒ—ãƒã‚»ã‚¹ã§å®Ÿè¡Œä¸ã®æŽ¥ç¶šãŒå¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:373 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:377 msgid "Use ``ssh-keyscan`` to pre-populate the known_hosts. You need to ensure the keys are correct." msgstr "``ssh-keyscan`` を使用ã—㦠known_hosts を事å‰ã«è¨å®šã—ã¾ã™ã€‚ã‚ーãŒæ£ã—ã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:382 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:386 msgid "You can tell Ansible to automatically accept the keys" msgstr "éµã‚’自動的ã«å—ã‘入れるよã†ã« Ansible ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:384 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:388 msgid "Environment variable method:" msgstr "環境変数メソッド:" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:391 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:395 msgid "``ansible.cfg`` method:" msgstr "``ansible.cfg`` メソッド:" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:393 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:397 msgid "ansible.cfg" msgstr "ansible.cfg" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:407 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:411 msgid "Error: \"No authentication methods available\"" msgstr "Error: \"No authentication methods available\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:425 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:429 msgid "No password or SSH key supplied" msgstr "パスワードã¾ãŸã¯ SSH ã‚ーãŒæŒ‡å®šã•ã‚Œã¦ã„ãªã„" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:428 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:432 msgid "Clearing Out Persistent Connections" msgstr "永続的ãªæŽ¥ç¶šã‚’解除" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:432 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:436 msgid "In Ansible 2.3, persistent connection sockets are stored in ``~/.ansible/pc`` for all network devices. When an Ansible playbook runs, the persistent socket connection is displayed when verbose output is specified." msgstr "Ansible 2.3 ã§ã¯ã€ã™ã¹ã¦ã®ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã®æ°¸ç¶šçš„ãªæŽ¥ç¶šã‚½ã‚±ãƒƒãƒˆãŒ ``~/.ansible/pc`` ã«ä¿å˜ã•ã‚Œã¾ã™ã€‚Ansible Playbook ãŒå®Ÿè¡Œã™ã‚‹ã¨ã€è©³ç´°ãªå‡ºåŠ›ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã«æ°¸ç¶šçš„ãªã‚½ã‚±ãƒƒãƒˆæŽ¥ç¶šãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:434 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:438 msgid "``<switch> socket_path: /home/fred/.ansible/pc/f64ddfa760``" msgstr "``<switch> socket_path: /home/fred/.ansible/pc/f64ddfa760``" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:436 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:440 msgid "To clear out a persistent connection before it times out (the default timeout is 30 seconds of inactivity), simple delete the socket file." msgstr "タイムアウトã™ã‚‹å‰ã«æ°¸ç¶šçš„ãªæŽ¥ç¶š (デフォルトã®ã‚¿ã‚¤ãƒ アウト㌠30 秒ã®éžã‚¢ã‚¯ãƒ†ã‚£ãƒ–タイムアウト) を削除ã™ã‚‹ã«ã¯ã€ã‚½ã‚±ãƒƒãƒˆãƒ•ã‚¡ã‚¤ãƒ«ã‚’ç°¡å˜ãªå‰Šé™¤ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:446 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:450 msgid "Persistent connection idle timeout" msgstr "永続的ãªæŽ¥ç¶šã‚¢ã‚¤ãƒ‰ãƒ«ã‚¿ã‚¤ãƒ アウト" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:448 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:452 msgid "By default, ``ANSIBLE_PERSISTENT_CONNECT_TIMEOUT`` is set to 30 (seconds). You may see the following error if this value is too low:" msgstr "デフォルトã§ã¯ã€``ANSIBLE_PERSISTENT_CONNECT_TIMEOUT`` 㯠30 (秒) ã«è¨å®šã•ã‚Œã¾ã™ã€‚ã“ã®å€¤ãŒä½Žã™ãŽã‚‹ã¨ã€ä»¥ä¸‹ã®ã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:456 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:460 msgid "Increase value of persistent connection idle timeout:" msgstr "永続的ãªæŽ¥ç¶šã‚¢ã‚¤ãƒ‰ãƒ«ã‚¿ã‚¤ãƒ アウトã®å€¤ã‚’大ããã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:470 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:474 msgid "Command timeout" msgstr "コマンドタイムアウト" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:472 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:476 msgid "By default, ``ANSIBLE_PERSISTENT_COMMAND_TIMEOUT`` is set to 30 (seconds). Prior versions of Ansible had this value set to 10 seconds by default. You may see the following error if this value is too low:" msgstr "デフォルトã§ã¯ã€``ANSIBLE_PERSISTENT_COMMAND_TIMEOUT`` 㯠30 (秒) ã«è¨å®šã•ã‚Œã¾ã™ã€‚Ansible ã®ä»¥å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã“ã®å€¤ã‚’ 10 秒ã«è¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®å€¤ãŒä½Žã™ãŽã‚‹ã¨ã€ä»¥ä¸‹ã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:482 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:486 msgid "Option 1 (Global command timeout setting): Increase value of command timeout in configuration file or by setting environment variable." msgstr "オプション 1 (ã‚°ãƒãƒ¼ãƒãƒ«ã‚³ãƒžãƒ³ãƒ‰ã®ã‚¿ã‚¤ãƒ アウトè¨å®š): è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã€ã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¦ã‚³ãƒžãƒ³ãƒ‰ã‚¿ã‚¤ãƒ アウトã®å€¤ã‚’増やã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:496 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:500 msgid "Option 2 (Per task command timeout setting): Increase command timeout per task basis. All network modules support a timeout value that can be set on a per task basis. The timeout value controls the amount of time in seconds before the task will fail if the command has not returned." msgstr "オプション 2 (タスクã”ã¨ã®ã‚³ãƒžãƒ³ãƒ‰ã®ã‚¿ã‚¤ãƒ アウトè¨å®š): タスクã”ã¨ã«ã‚³ãƒžãƒ³ãƒ‰ã‚¿ã‚¤ãƒ アウトを増やã—ã¾ã™ã€‚ã™ã¹ã¦ã®ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ã‚¿ã‚¹ã‚¯ã”ã¨ã«è¨å®šã§ãるタイムアウト値をサãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚タイムアウト値ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãŒè¿”ã•ã‚Œãªã‹ã£ãŸå ´åˆã«ã‚¿ã‚¹ã‚¯ãŒå¤±æ•—ã™ã‚‹ã¾ã§ã®æ™‚間を秒å˜ä½ã§åˆ¶å¾¡ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:502 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:506 msgid "For local connection type:" msgstr "ãƒãƒ¼ã‚«ãƒ«æŽ¥ç¶šã‚¿ã‚¤ãƒ—ã®å ´åˆ:" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:527 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:512 +msgid "Some modules support a ``timeout`` option, which is different to the ``timeout`` keyword for tasks." +msgstr "一部ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€``timeout`` オプションをサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚ã“ã®ã‚ªãƒ—ションã¯ã€ã‚¿ã‚¹ã‚¯ã® ``timeout`` ã‚ーワードã¨ã¯ç•°ãªã‚Šã¾ã™ã€‚" + +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:525 +msgid "If the module does not support the ``timeout`` option directly, most networking connection plugins can enable similar functionality with the ``ansible_command_timeout`` variable." +msgstr "モジュール㌠``timeout`` オプションを直接使用ã™ã‚‹å ´åˆã«ã¯ã€ã»ã¨ã‚“ã©ã®ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯æŽ¥ç¶šãƒ—ラグインã§ã€``ansible_command_timeout`` 変数を使用ã—ã¦åŒæ§˜ã®æ©Ÿèƒ½ã‚’有効化ã§ãã¾ã™ã€‚" + +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:535 msgid "Some operations take longer than the default 30 seconds to complete. One good example is saving the current running config on IOS devices to startup config. In this case, changing the timeout value from the default 30 seconds to 60 seconds will prevent the task from failing before the command completes successfully." msgstr "一部ã®æ“作ã¯ã€å®Œäº†ã¾ã§ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® 30 秒より長ãã‹ã‹ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€IOS デãƒã‚¤ã‚¹ä¸Šã®ç¾åœ¨ã®å®Ÿè¡Œè¨å®šã‚’スタートアップè¨å®šã«ä¿å˜ã—ã¾ã™ã€‚ã“ã®å ´åˆã¯ã€ã‚¿ã‚¤ãƒ アウト値をデフォルト㮠30 秒ã‹ã‚‰ 60 秒ã«å¤‰æ›´ã™ã‚‹ã¨ã€ã‚³ãƒžãƒ³ãƒ‰ãŒæ£å¸¸ã«å®Œäº†ã™ã‚‹å‰ã«ã‚¿ã‚¹ã‚¯ãŒå¤±æ•—ã™ã‚‹ã®ã‚’防ãã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:534 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:542 msgid "Persistent connection retry timeout" msgstr "永続的ãªæŽ¥ç¶šã®å†è©¦è¡Œã‚¿ã‚¤ãƒ アウト" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:536 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:544 msgid "By default, ``ANSIBLE_PERSISTENT_CONNECT_RETRY_TIMEOUT`` is set to 15 (seconds). You may see the following error if this value is too low:" msgstr "デフォルトã§ã¯ã€``ANSIBLE_PERSISTENT_CONNECT_RETRY_TIMEOUT`` 㯠15 (秒) ã«è¨å®šã•ã‚Œã¾ã™ã€‚ã“ã®å€¤ãŒä½Žã™ãŽã‚‹ã¨ã€ä»¥ä¸‹ã®ã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:545 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:553 msgid "Increase the value of the persistent connection idle timeout. Note: This value should be greater than the SSH timeout value (the timeout value under the defaults section in the configuration file) and less than the value of the persistent connection idle timeout (connect_timeout)." msgstr "æŒç¶šçš„接続アイドルタイムアウトã®å€¤ã‚’増やã—ã¾ã™ã€‚注æ„: ã“ã®å€¤ã¯ã€SSH タイムアウト値 (è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸‹ã®ã‚¿ã‚¤ãƒ アウト値) より大ããã€æ°¸ç¶šçš„接続アイドルタイムアウト値 (connect_timeout) よりå°ã•ãã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:563 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:571 msgid "Timeout issue due to platform specific login menu with ``network_cli`` connection type" msgstr "``network_cli`` 接続タイプをæŒã¤ãƒ—ラットフォーム固有ã®ãƒã‚°ã‚¤ãƒ³ãƒ¡ãƒ‹ãƒ¥ãƒ¼ã«ã‚ˆã‚‹ã‚¿ã‚¤ãƒ アウトã®å•é¡Œ" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:565 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:573 msgid "In Ansible 2.9 and later, the network_cli connection plugin configuration options are added to handle the platform specific login menu. These options can be set as group/host or tasks variables." msgstr "Ansible 2.9 以é™ã§ã¯ã€ãƒ—ラットフォーム固有ã®ãƒã‚°ã‚¤ãƒ³ãƒ¡ãƒ‹ãƒ¥ãƒ¼ã‚’処ç†ã™ã‚‹ãŸã‚ã« network_cli connection プラグインè¨å®šã‚ªãƒ—ションãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚ã“れらã®ã‚ªãƒ—ションã¯ã€ã‚°ãƒ«ãƒ¼ãƒ—/ホストã¾ãŸã¯ã‚¿ã‚¹ã‚¯å¤‰æ•°ã¨ã—ã¦è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:569 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:577 msgid "Example: Handle single login menu prompts with host variables" msgstr "例: ホスト変数を使用ã—㟠1 ã¤ã®ãƒã‚°ã‚¤ãƒ³ãƒ¡ãƒ‹ãƒ¥ãƒ¼ãƒ—ãƒãƒ³ãƒ—トを処ç†ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:580 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:588 msgid "Example: Handle remote host multiple login menu prompts with host variables" msgstr "例: ホスト変数を使用ã—ãŸãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã®è¤‡æ•°ã®ãƒã‚°ã‚¤ãƒ³ãƒ¡ãƒ‹ãƒ¥ãƒ¼ãƒ—ãƒãƒ³ãƒ—トを処ç†ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:594 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:602 msgid "To handle multiple login menu prompts:" msgstr "複数ã®ãƒã‚°ã‚¤ãƒ³ãƒ¡ãƒ‹ãƒ¥ãƒ¼ãƒ—ãƒãƒ³ãƒ—トを処ç†ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:596 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:604 msgid "The values of ``ansible_terminal_initial_prompt`` and ``ansible_terminal_initial_answer`` should be a list." msgstr "``ansible_terminal_initial_prompt`` ãŠã‚ˆã³ ``ansible_terminal_initial_answer`` ã®å€¤ã¯ä¸€è¦§å½¢å¼ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:597 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:605 msgid "The prompt sequence should match the answer sequence." msgstr "プãƒãƒ³ãƒ—トシーケンスã¯ã€å¿œç”シーケンスã«ä¸€è‡´ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:598 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:606 msgid "The value of ``ansible_terminal_initial_prompt_checkall`` should be set to ``True``." msgstr "``ansible_terminal_initial_prompt_checkall`` ã®å€¤ã¯ ``True`` ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:600 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:608 msgid "If all the prompts in sequence are not received from remote host at the time connection initialization it will result in a timeout." msgstr "接続ã®åˆæœŸåŒ–時ã«ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã‹ã‚‰ã‚·ãƒ¼ã‚±ãƒ³ã‚¹å†…ã®ã™ã¹ã¦ã®ãƒ—ãƒãƒ³ãƒ—トをå—ã‘å–らãªã„ã¨ã€ã‚¿ã‚¤ãƒ アウトãŒç”Ÿã˜ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:606 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:614 msgid "This section details issues are caused by issues with the Playbook itself." msgstr "本セクションã§ã¯ã€Playbook 自体ã®å•é¡ŒãŒåŽŸå› ã§ç™ºç”Ÿã™ã‚‹å•é¡Œã‚’詳ã—ã説明ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:609 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:617 msgid "Error: \"Unable to enter configuration mode\"" msgstr "Error: \"Unable to enter configuration mode\"" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:611 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:619 msgid "**Platforms:** Arista EOS and Cisco IOS" msgstr "**プラットフォーム:** Arista EOS ãŠã‚ˆã³ Cisco IOS" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:613 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:621 msgid "This occurs when you attempt to run a task that requires privileged mode in a user mode shell." msgstr "ã“ã‚Œã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãƒ¢ãƒ¼ãƒ‰ã‚·ã‚§ãƒ«ã§ç‰¹æ¨©ãƒ¢ãƒ¼ãƒ‰ã‚’å¿…è¦ã¨ã™ã‚‹ã‚¿ã‚¹ã‚¯ã‚’実行ã—よã†ã¨ã™ã‚‹ã¨ç™ºç”Ÿã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:629 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:637 msgid "Use ``connection: ansible.netcommon.network_cli`` and ``become: yes``" msgstr "``connection: ansible.netcommon.network_cli`` ãŠã‚ˆã³ ``become: yes`` ã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:633 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:641 msgid "Proxy Issues" msgstr "プãƒã‚シーã®å•é¡Œ" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:638 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:646 msgid "delegate_to vs ProxyCommand" msgstr "delegate_to 対 ProxyCommand" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:640 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:648 msgid "In order to use a bastion or intermediate jump host to connect to network devices over ``cli`` transport, network modules support the use of ``ProxyCommand``." msgstr "bastion ã¾ãŸã¯ä¸é–“ジャンプホストを使用ã—㦠``cli`` トランスãƒãƒ¼ãƒˆã§ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã«æŽ¥ç¶šã™ã‚‹ãŸã‚ã«ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``ProxyCommand`` ã®ä½¿ç”¨ã«å¯¾å¿œã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:643 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:651 msgid "To use ``ProxyCommand``, configure the proxy settings in the Ansible inventory file to specify the proxy host." msgstr "``ProxyCommand`` を使用ã™ã‚‹ã«ã¯ã€Ansible インベントリーファイルã§ãƒ—ãƒã‚シーè¨å®šã‚’è¨å®šã—ã¦ã€ãƒ—ãƒã‚シーホストを指定ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:656 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:664 msgid "With the configuration above, simply build and run the playbook as normal with no additional changes necessary. The network module will now connect to the network device by first connecting to the host specified in ``ansible_ssh_common_args``, which is ``bastion01`` in the above example." msgstr "上記ã®è¨å®šã§ã¯ã€è¿½åŠ ã®å¤‰æ›´ã‚’å¿…è¦ã¨ã›ãšã«ã€é€šå¸¸ã©ãŠã‚Š Playbook をビルドã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€æœ€åˆã« ``ansible_ssh_common_args`` ã§æŒ‡å®šã—ãŸãƒ›ã‚¹ãƒˆ (上記ã®ä¾‹ã¯ ``bastion01``) ã«æŽ¥ç¶šã—ã¦ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã«æŽ¥ç¶šã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:661 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:669 msgid "You can also set the proxy target for all hosts by using environment variables." msgstr "環境変数を使用ã—ã¦ã€ã™ã¹ã¦ã®ãƒ›ã‚¹ãƒˆã®ãƒ—ãƒã‚シーターゲットをè¨å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:668 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:676 msgid "Using bastion/jump host with netconf connection" msgstr "netconf 接続ã§ã® bastion/ジャンプホストã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:671 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:679 msgid "Enabling jump host setting" msgstr "ジャンプホストè¨å®šã®æœ‰åŠ¹åŒ–" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:677 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:685 msgid "Bastion/jump host with netconf connection can be enabled by:" msgstr "netconf 接続をæŒã¤ bastion/ジャンプホストã¯ã€ä»¥ä¸‹ã§æœ‰åŠ¹ã«ã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:675 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:683 msgid "Setting Ansible variable ``ansible_netconf_ssh_config`` either to ``True`` or custom ssh config file path" msgstr "Ansible 変数 ``ansible_netconf_ssh_config`` ã‚’ ``True`` ã¾ãŸã¯ã‚«ã‚¹ã‚¿ãƒ ã® ssh è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ãƒ‘スã«è¨å®š" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:676 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:684 msgid "Setting environment variable ``ANSIBLE_NETCONF_SSH_CONFIG`` to ``True`` or custom ssh config file path" msgstr "環境変数 ``ANSIBLE_NETCONF_SSH_CONFIG`` ã‚’ ``True`` ã¾ãŸã¯ã‚«ã‚¹ã‚¿ãƒ ã® ssh è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ãƒ‘スã«è¨å®š" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:677 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:685 msgid "Setting ``ssh_config = 1`` or ``ssh_config = <ssh-file-path>`` under ``netconf_connection`` section" msgstr "``ssh_config = 1`` セクションã®ä¸‹ã« ``ssh_config = <ssh-file-path>`` ã¾ãŸã¯ ``netconf_connection`` ã®è¨å®š" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:679 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:687 msgid "If the configuration variable is set to 1 the proxycommand and other ssh variables are read from default ssh config file (~/.ssh/config)." msgstr "è¨å®šå¤‰æ•°ãŒ 1 ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã€proxycommand ãŠã‚ˆã³ãã®ä»–ã® ssh 変数ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® ssh è¨å®šãƒ•ã‚¡ã‚¤ãƒ« (~/.ssh/config) ã‹ã‚‰èªã¿è¾¼ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:682 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:690 msgid "If the configuration variable is set to file path the proxycommand and other ssh variables are read from the given custom ssh file path" msgstr "è¨å®šå¤‰æ•°ãŒãƒ•ã‚¡ã‚¤ãƒ«ãƒ‘スã«è¨å®šã•ã‚Œã¦ã„ã‚‹ã¨ã€proxycommand ãŠã‚ˆã³ãã®ä»–ã® ssh 変数ã¯æŒ‡å®šã®ã‚«ã‚¹ã‚¿ãƒ ssh ファイルパスã‹ã‚‰èªã¿è¾¼ã¾ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:686 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:694 msgid "Example ssh config file (~/.ssh/config)" msgstr "ssh è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã®ä¾‹ (~/.ssh/config)" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:713 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:721 msgid "Example Ansible inventory file" msgstr "Ansible インベントリーファイルã®ä¾‹" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:727 -msgid "Using ``ProxyCommand`` with passwords via variables" +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:735 +msgid "Using ``ProxyCommand`` with passwords through variables" msgstr "変数を介ã—ãŸãƒ‘スワードã§ã® ``ProxyCommand`` ã®ä½¿ç”¨" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:729 -msgid "By design, SSH doesn't support providing passwords via environment variables. This is done to prevent secrets from leaking out, for example in ``ps`` output." -msgstr "è¨è¨ˆä¸Šã€SSH ã¯ç’°å¢ƒå¤‰æ•°çµŒç”±ã§ãƒ‘スワードã®æ供をサãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。ã“ã‚Œã¯ã€``ps`` ã®å‡ºåŠ›ãªã©ã€ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆãŒãƒªãƒ¼ã‚¯ã—ãªã„よã†ã«ã—ã¾ã™ã€‚" +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:737 +msgid "By design, SSH doesn't support providing passwords through environment variables. This is done to prevent secrets from leaking out, for example in ``ps`` output." +msgstr "è¨è¨ˆä¸Šã€SSH ã¯ç’°å¢ƒå¤‰æ•°çµŒç”±ã§ã®ãƒ‘スワードã®æ供をサãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。ã“ã‚Œã¯ã€``ps`` ã®å‡ºåŠ›ãªã©ã«ã€ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆãŒãƒªãƒ¼ã‚¯ã™ã‚‹ã“ã¨ã‚’防ããŸã‚ã§ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:732 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:740 msgid "We recommend using SSH Keys, and if needed an ssh-agent, rather than passwords, where ever possible." msgstr "SSH éµã‚’使用ã™ã‚‹ã“ã¨ã‚’推奨ã—ã¾ã™ã€‚å¿…è¦ã«å¿œã˜ã¦ã€å¯èƒ½ãªå ´åˆã¯ã€ãƒ‘スワードã§ã¯ãªã ssh-agent を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:735 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:743 msgid "Miscellaneous Issues" msgstr "ãã®ä»–ã®å•é¡Œ" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:739 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:747 msgid "Intermittent failure while using ``ansible.netcommon.network_cli`` connection type" msgstr "``ansible.netcommon.network_cli`` 接続タイプã®ä½¿ç”¨ä¸ã«æ–続的ãªå¤±æ•—" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:741 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:749 msgid "If the command prompt received in response is not matched correctly within the ``ansible.netcommon.network_cli`` connection plugin the task might fail intermittently with truncated response or with the error message ``operation requires privilege escalation``. Starting in 2.7.1 a new buffer read timer is added to ensure prompts are matched properly and a complete response is send in output. The timer default value is 0.2 seconds and can be adjusted on a per task basis or can be set globally in seconds." msgstr "å¿œç”ã§å—ã‘å–ã£ãŸã‚³ãƒžãƒ³ãƒ‰ãƒ—ãƒãƒ³ãƒ—ト㌠``ansible.netcommon.network_cli`` connection プラグイン内ã§æ£ã—ã一致ã—ãªã„ã¨ã€ã‚¿ã‚¹ã‚¯ãŒæ–続的ã«å¤±æ•—ã—ã€å¿œç”ãŒåˆ‡ã‚Šæ¨ã¦ã‚‰ã‚Œã‚‹ã‹ã€ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ ``operation requires privilege escalation`` ãŒè¡¨ç¤ºã•ã‚Œã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚2.7.1 以é™ã€ãƒ—ãƒãƒ³ãƒ—トãŒæ£ã—ã一致ã—ã€å®Œå…¨ãªå¿œç”ãŒå‡ºåŠ›ã«é€ä¿¡ã•ã‚Œã‚‹ã‚ˆã†ã«ã€æ–°ã—ã„ãƒãƒƒãƒ•ã‚¡èªã¿å–りタイマーãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚タイマーã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ 0.2 秒ã§ã€ã‚¿ã‚¹ã‚¯ã”ã¨ã«èª¿æ•´ã™ã‚‹ã“ã¨ã‚‚ã€ç§’å˜ä½ã§ã‚°ãƒãƒ¼ãƒãƒ«ã«è¨å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:748 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:756 msgid "Example Per task timer setting" msgstr "タスクタイマーã”ã¨ã®è¨å®šä¾‹" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:767 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:775 msgid "This timer delay per command executed on remote host can be disabled by setting the value to zero." msgstr "リモートホストã§å®Ÿè¡Œã•ã‚Œã‚‹ã‚³ãƒžãƒ³ãƒ‰åˆ¥ã®ã“ã®ã‚¿ã‚¤ãƒžãƒ¼é…延ã¯ã€å€¤ã‚’ゼãƒã«è¨å®šã™ã‚‹ã¨ç„¡åŠ¹ã«ã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:771 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:779 msgid "Task failure due to mismatched error regex within command response using ``ansible.netcommon.network_cli`` connection type" msgstr "``ansible.netcommon.network_cli`` 接続タイプを使用ã—ãŸã‚³ãƒžãƒ³ãƒ‰å¿œç”内ã®ã‚¨ãƒ©ãƒ¼æ£è¦è¡¨ç¾ã®ä¸ä¸€è‡´ã«ã‚ˆã‚‹ã‚¿ã‚¹ã‚¯ã®å¤±æ•—" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:773 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:781 msgid "In Ansible 2.9 and later, the ``ansible.netcommon.network_cli`` connection plugin configuration options are added to handle the stdout and stderr regex to identify if the command execution response consist of a normal response or an error response. These options can be set group/host variables or as tasks variables." msgstr "Ansible 2.9 以é™ã§ã¯ã€``ansible.netcommon.network_cli`` connection プラグインè¨å®šã‚ªãƒ—ションãŒè¿½åŠ ã•ã‚Œã€æ¨™æº–出力ã¨æ¨™æº–エラーã®æ£è¦è¡¨ç¾ã‚’処ç†ã—ã¦ã€ã‚³ãƒžãƒ³ãƒ‰å®Ÿè¡Œå¿œç”ãŒé€šå¸¸ã®å¿œç”ã‹ã‚¨ãƒ©ãƒ¼å¿œç”ã‹ã‚’è˜åˆ¥ã—ã¾ã™ã€‚ã“れらã®ã‚ªãƒ—ションã¯ã€ã‚°ãƒ«ãƒ¼ãƒ—/ホスト変数ã¾ãŸã¯ã‚¿ã‚¹ã‚¯å¤‰æ•°ã¨ã—ã¦è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:778 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:786 msgid "Example: For mismatched error response" msgstr "例: ä¸ä¸€è‡´ã®ã‚¨ãƒ©ãƒ¼å¿œç”ã®å ´åˆ" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:788 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:796 msgid "Playbook run output:" msgstr "Playbook 実行ã®å‡ºåŠ›:" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:801 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:809 msgid "Modify the error regex for individual task." msgstr "個々ã®ã‚¿ã‚¹ã‚¯ã®ã‚¨ãƒ©ãƒ¼æ£è¦è¡¨ç¾ã‚’変更ã—ã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:814 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:822 msgid "The terminal plugin regex options ``ansible_terminal_stderr_re`` and ``ansible_terminal_stdout_re`` have ``pattern`` and ``flags`` as keys. The value of the ``flags`` key should be a value that is accepted by the ``re.compile`` python method." msgstr "端末プラグインã®æ£è¦è¡¨ç¾ã‚ªãƒ—ション ``ansible_terminal_stderr_re`` ãŠã‚ˆã³ ``ansible_terminal_stdout_re`` ã¯ã€``pattern`` 㨠``flags`` ã‚’ã‚ーã¨ã—ã¾ã™ã€‚``flags`` ã‚ーã®å€¤ã¯ã€``re.compile`` python メソッドã§è¨±å¯ã•ã‚Œã‚‹å€¤ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:820 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:828 msgid "Intermittent failure while using ``ansible.netcommon.network_cli`` connection type due to slower network or remote target host" msgstr "低速ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã¾ãŸã¯ãƒªãƒ¢ãƒ¼ãƒˆã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒ›ã‚¹ãƒˆã«ã‚ˆã‚‹ ``ansible.netcommon.network_cli`` 接続タイプã®ä½¿ç”¨æ™‚ã®æ–続的ãªå¤±æ•—" -#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:822 +#: ../../rst/network/user_guide/network_debug_troubleshooting.rst:830 msgid "In Ansible 2.9 and later, the ``ansible.netcommon.network_cli`` connection plugin configuration option is added to control the number of attempts to connect to a remote host. The default number of attempts is three. After every retry attempt the delay between retries is increased by power of 2 in seconds until either the maximum attempts are exhausted or either the ``persistent_command_timeout`` or ``persistent_connect_timeout`` timers are triggered." msgstr "Ansible 2.9 以é™ã§ã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã¸ã®æŽ¥ç¶šã®è©¦è¡Œå›žæ•°ã‚’制御ã™ã‚‹ãŸã‚ã«ã€``ansible.netcommon.network_cli`` connection プラグインè¨å®šã‚ªãƒ—ションãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚デフォルトã®è©¦è¡Œå›žæ•°ã¯ 3 回ã§ã™ã€‚å†è©¦è¡Œã®ãŸã³ã«ã€æœ€å¤§è©¦è¡Œå›žæ•°ãŒãªããªã‚‹ã‹ã€``persistent_command_timeout`` ã¾ãŸã¯ ``persistent_connect_timeout`` タイマーã®ã„ãšã‚Œã‹ãŒç™ºç”Ÿã™ã‚‹ã¾ã§ã€å†è©¦è¡Œé–“ã®é…延㯠2 ã®ç´¯ä¹— (秒) ãšã¤å¢—åŠ ã—ã¾ã™ã€‚" @@ -4096,31 +4104,8 @@ msgid "Indirect Access" msgstr "間接アクセス" #: ../../rst/network/user_guide/platform_ce.rst:29 -#: ../../rst/network/user_guide/platform_cnos.rst:27 -#: ../../rst/network/user_guide/platform_dellos10.rst:27 -#: ../../rst/network/user_guide/platform_dellos6.rst:27 -#: ../../rst/network/user_guide/platform_dellos9.rst:27 -#: ../../rst/network/user_guide/platform_enos.rst:27 -#: ../../rst/network/user_guide/platform_eos.rst:27 -#: ../../rst/network/user_guide/platform_eric_eccli.rst:27 -#: ../../rst/network/user_guide/platform_exos.rst:28 -#: ../../rst/network/user_guide/platform_frr.rst:27 -#: ../../rst/network/user_guide/platform_icx.rst:27 -#: ../../rst/network/user_guide/platform_ios.rst:27 -#: ../../rst/network/user_guide/platform_iosxr.rst:31 -#: ../../rst/network/user_guide/platform_ironware.rst:27 -#: ../../rst/network/user_guide/platform_junos.rst:30 -#: ../../rst/network/user_guide/platform_netconf_enabled.rst:29 -#: ../../rst/network/user_guide/platform_netvisor.rst:28 -#: ../../rst/network/user_guide/platform_nos.rst:28 -#: ../../rst/network/user_guide/platform_nxos.rst:27 -#: ../../rst/network/user_guide/platform_routeros.rst:28 -#: ../../rst/network/user_guide/platform_slxos.rst:28 -#: ../../rst/network/user_guide/platform_voss.rst:28 -#: ../../rst/network/user_guide/platform_vyos.rst:27 -#: ../../rst/network/user_guide/platform_weos4.rst:28 msgid "via a bastion (jump host)" -msgstr "bastion (jump ホスト) を使用" +msgstr "bastion (ジャンプホスト) を使用" #: ../../rst/network/user_guide/platform_ce.rst:31 #: ../../rst/network/user_guide/platform_cnos.rst:29 @@ -4319,28 +4304,6 @@ msgid "If you are accessing your host directly (not through a bastion/jump host) msgstr "(bastion/ジャンプホストを経由ã›ãš) ホストã«ç›´æŽ¥ã‚¢ã‚¯ã‚»ã‚¹ã—ã¦ã„ã‚‹å ´åˆã¯ã€``ansible_ssh_common_args`` è¨å®šã‚’削除ã§ãã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_ce.rst:61 -#: ../../rst/network/user_guide/platform_cnos.rst:62 -#: ../../rst/network/user_guide/platform_dellos10.rst:63 -#: ../../rst/network/user_guide/platform_dellos6.rst:62 -#: ../../rst/network/user_guide/platform_dellos9.rst:62 -#: ../../rst/network/user_guide/platform_enos.rst:64 -#: ../../rst/network/user_guide/platform_eos.rst:67 -#: ../../rst/network/user_guide/platform_eric_eccli.rst:57 -#: ../../rst/network/user_guide/platform_exos.rst:59 -#: ../../rst/network/user_guide/platform_frr.rst:56 -#: ../../rst/network/user_guide/platform_icx.rst:60 -#: ../../rst/network/user_guide/platform_ios.rst:62 -#: ../../rst/network/user_guide/platform_iosxr.rst:64 -#: ../../rst/network/user_guide/platform_ironware.rst:63 -#: ../../rst/network/user_guide/platform_junos.rst:65 -#: ../../rst/network/user_guide/platform_netvisor.rst:58 -#: ../../rst/network/user_guide/platform_nos.rst:58 -#: ../../rst/network/user_guide/platform_nxos.rst:64 -#: ../../rst/network/user_guide/platform_routeros.rst:62 -#: ../../rst/network/user_guide/platform_slxos.rst:59 -#: ../../rst/network/user_guide/platform_voss.rst:62 -#: ../../rst/network/user_guide/platform_vyos.rst:58 -#: ../../rst/network/user_guide/platform_weos4.rst:58 msgid "If you are accessing your host through a bastion/jump host, you cannot include your SSH password in the ``ProxyCommand`` directive. To prevent secrets from leaking out (for example in ``ps`` output), SSH does not support providing passwords via environment variables." msgstr "bastion/ジャンプホストを介ã—ã¦ãƒ›ã‚¹ãƒˆã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å ´åˆã¯ã€``ProxyCommand`` ディレクティブ㫠SSH パスワードをå«ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã›ã‚“。シークレットãŒæ¼æ´©ã™ã‚‹ã®ã‚’防ããŸã‚ã« (例: ``ps`` 出力)ã€SSH ã¯ç’°å¢ƒå¤‰æ•°ã«ã‚ˆã‚‹ãƒ‘スワードã®æ供をサãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" @@ -4475,6 +4438,28 @@ msgstr "CNOS プラットフォームã®ã‚ªãƒ—ション" msgid "CNOS is part of the `community.network <https://galaxy.ansible.com/community/network>`_ collection and supports Enable Mode (Privilege Escalation). This page offers details on how to use Enable Mode on CNOS in Ansible." msgstr "CNOS ã¯ã€`community.network <https://galaxy.ansible.com/community/network>`_ コレクションã®ä¸€éƒ¨ã§ã€Enable Mode (Privilege Escalation) をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚ã“ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€Ansible ã® CNOS 㧠Enable Mode を有効ã«ã™ã‚‹æ–¹æ³•ã‚’詳細ã«èª¬æ˜Žã—ã¾ã™ã€‚" +#: ../../rst/network/user_guide/platform_cnos.rst:27 +#: ../../rst/network/user_guide/platform_enos.rst:27 +#: ../../rst/network/user_guide/platform_eos.rst:27 +#: ../../rst/network/user_guide/platform_eric_eccli.rst:27 +#: ../../rst/network/user_guide/platform_exos.rst:28 +#: ../../rst/network/user_guide/platform_frr.rst:27 +#: ../../rst/network/user_guide/platform_icx.rst:27 +#: ../../rst/network/user_guide/platform_ios.rst:27 +#: ../../rst/network/user_guide/platform_iosxr.rst:31 +#: ../../rst/network/user_guide/platform_ironware.rst:27 +#: ../../rst/network/user_guide/platform_junos.rst:30 +#: ../../rst/network/user_guide/platform_netvisor.rst:28 +#: ../../rst/network/user_guide/platform_nos.rst:28 +#: ../../rst/network/user_guide/platform_nxos.rst:27 +#: ../../rst/network/user_guide/platform_routeros.rst:28 +#: ../../rst/network/user_guide/platform_slxos.rst:28 +#: ../../rst/network/user_guide/platform_voss.rst:28 +#: ../../rst/network/user_guide/platform_vyos.rst:27 +#: ../../rst/network/user_guide/platform_weos4.rst:28 +msgid "by a bastion (jump host)" +msgstr "bastion (ジャンプホスト) を使用" + #: ../../rst/network/user_guide/platform_cnos.rst:29 #: ../../rst/network/user_guide/platform_dellos10.rst:29 #: ../../rst/network/user_guide/platform_dellos6.rst:29 @@ -4542,6 +4527,31 @@ msgstr "``ansible_connection: local`` ã¯éžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚代ã‚ã‚Š msgid "Example CLI ``group_vars/cnos.yml``" msgstr "CLI ã®ä¾‹ ``group_vars/cnos.yml``" +#: ../../rst/network/user_guide/platform_cnos.rst:62 +#: ../../rst/network/user_guide/platform_dellos10.rst:63 +#: ../../rst/network/user_guide/platform_dellos6.rst:62 +#: ../../rst/network/user_guide/platform_dellos9.rst:62 +#: ../../rst/network/user_guide/platform_enos.rst:64 +#: ../../rst/network/user_guide/platform_eos.rst:67 +#: ../../rst/network/user_guide/platform_eric_eccli.rst:57 +#: ../../rst/network/user_guide/platform_exos.rst:59 +#: ../../rst/network/user_guide/platform_frr.rst:56 +#: ../../rst/network/user_guide/platform_icx.rst:60 +#: ../../rst/network/user_guide/platform_ios.rst:62 +#: ../../rst/network/user_guide/platform_iosxr.rst:64 +#: ../../rst/network/user_guide/platform_ironware.rst:63 +#: ../../rst/network/user_guide/platform_junos.rst:65 +#: ../../rst/network/user_guide/platform_netvisor.rst:58 +#: ../../rst/network/user_guide/platform_nos.rst:58 +#: ../../rst/network/user_guide/platform_nxos.rst:64 +#: ../../rst/network/user_guide/platform_routeros.rst:62 +#: ../../rst/network/user_guide/platform_slxos.rst:59 +#: ../../rst/network/user_guide/platform_voss.rst:62 +#: ../../rst/network/user_guide/platform_vyos.rst:58 +#: ../../rst/network/user_guide/platform_weos4.rst:58 +msgid "If you are accessing your host through a bastion/jump host, you cannot include your SSH password in the ``ProxyCommand`` directive. To prevent secrets from leaking out (for example in ``ps`` output), SSH does not support providing passwords through environment variables." +msgstr "bastion/ジャンプ ホストを介ã—ã¦ãƒ›ã‚¹ãƒˆã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å ´åˆã¯ã€``ProxyCommand`` ディレクティブ㫠SSH パスワードをå«ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã›ã‚“。シークレット㌠(``ps`` 出力ãªã©ã«) æ¼æ´©ã™ã‚‹ã®ã‚’防ããŸã‚ã«ã€SSH ã¯ç’°å¢ƒå¤‰æ•°ã«ã‚ˆã‚‹ãƒ‘スワードã®æ供をサãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" + #: ../../rst/network/user_guide/platform_dellos10.rst:5 msgid "Dell OS10 Platform Options" msgstr "Dell OS10 プラットフォームオプション" @@ -4550,6 +4560,13 @@ msgstr "Dell OS10 プラットフォームオプション" msgid "The `dellemc.os10 <https://galaxy.ansible.com/dellemc_networking/os10>`_ collection supports Enable Mode (Privilege Escalation). This page offers details on how to use Enable Mode on OS10 in Ansible." msgstr "`dellemc.os10 <https://galaxy.ansible.com/dellemc_networking/os10>`_ コレクション㯠Enable Mode (Privilege Escalation) をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚ã“ã®ãƒšãƒ¼ã‚¸ã§ã¯ã€Ansible ã® OS10 㧠Enable Mode を使用ã™ã‚‹æ–¹æ³•ã«é–¢ã™ã‚‹è©³ç´°ãŒè¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" +#: ../../rst/network/user_guide/platform_dellos10.rst:27 +#: ../../rst/network/user_guide/platform_dellos6.rst:27 +#: ../../rst/network/user_guide/platform_dellos9.rst:27 +#: ../../rst/network/user_guide/platform_netconf_enabled.rst:29 +msgid "through a bastion (jump host)" +msgstr "bastion (ジャンプホスト) を使用" + #: ../../rst/network/user_guide/platform_dellos10.rst:47 msgid "Example CLI ``group_vars/dellos10.yml``" msgstr "CLI ã®ä¾‹ ``group_vars/dellos10.yml``" @@ -4617,8 +4634,7 @@ msgstr "HTTPS 証明書ãŒå˜åœ¨ã™ã‚‹å ´åˆã¯ä½¿ç”¨ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_eos.rst:27 #: ../../rst/network/user_guide/platform_exos.rst:28 -#: ../../rst/network/user_guide/platform_nxos.rst:27 -msgid "via a web proxy" +msgid "through a web proxy" msgstr "Web プãƒã‚シー経由" #: ../../rst/network/user_guide/platform_eos.rst:29 @@ -5197,7 +5213,7 @@ msgid "enable NETCONF on the Junos OS device(s)" msgstr "Junos OS デãƒã‚¤ã‚¹ã® netconf を有効ã«ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_junos.rst:89 -msgid "To enable NETCONF on a new switch via Ansible, use the ``junipernetworks.junos.junos_netconf`` module through the CLI connection. Set up your platform-level variables just like in the CLI example above, then run a playbook task like this:" +msgid "To enable NETCONF on a new switch through Ansible, use the ``junipernetworks.junos.junos_netconf`` module through the CLI connection. Set up your platform-level variables just like in the CLI example above, then run a playbook task like this:" msgstr "Ansible を介ã—ã¦æ–°ã—ã„スイッãƒã§ NETCONF を有効ã«ã™ã‚‹ã«ã¯ã€CLI 接続を介ã—㦠``junipernetworks.junos.junos_netconf`` モジュールを使用ã—ã¾ã™ã€‚上記㮠CLI ã®ä¾‹ã®ã‚ˆã†ã«ãƒ—ラットフォームレベルã®å¤‰æ•°ã‚’è¨å®šã—ã€æ¬¡ã®ã‚ˆã†ã« Playbook タスクを実行ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_junos.rst:101 @@ -5254,8 +5270,8 @@ msgid "install the ``ncclient`` Python package on your control node(s) with ``pi msgstr "``pip install ncclient`` を使用ã—ã¦ã€``ncclient`` Python パッケージをコントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_netconf_enabled.rst:48 -msgid "To enable NETCONF on a new switch via Ansible, use the platform specific module via the CLI connection or set it manually. For example set up your platform-level variables just like in the CLI example above, then run a playbook task like this:" -msgstr "Ansible 経由ã§æ–°ã—ã„スイッãƒã® NETCONF を有効ã«ã™ã‚‹ã«ã¯ã€CLI 接続経由ã§ãƒ—ラットフォーム固有ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã‹ã€æ‰‹å‹•ã§è¨å®šã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ä¸Šè¨˜ã® CLI ã®ä¾‹ã®ã‚ˆã†ã«ãƒ—ラットフォームレベルã®å¤‰æ•°ã‚’è¨å®šã—ã€æ¬¡ã®ã‚ˆã†ãª Playbook タスクを実行ã—ã¾ã™ã€‚" +msgid "To enable NETCONF on a new switch through Ansible, use the platform specific module through the CLI connection or set it manually. For example set up your platform-level variables just like in the CLI example above, then run a playbook task like this:" +msgstr "Ansible を介ã—ã¦æ–°ã—ã„スイッãƒã§ NETCONF を有効ã«ã™ã‚‹ã«ã¯ã€CLI 接続経由ã§ãƒ—ラットフォーム固有ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã‹ã€æ‰‹å‹•ã§è¨å®šã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ä¸Šè¨˜ã® CLI ã®ä¾‹ã®ã‚ˆã†ã«ãƒ—ラットフォームレベルã®å¤‰æ•°ã‚’è¨å®šã—ã€æ¬¡ã®ã‚ˆã†ãª Playbook タスクを実行ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_netconf_enabled.rst:83 msgid "Example NETCONF task with configurable variables" @@ -5267,7 +5283,7 @@ msgstr "注æ„: netconf connection プラグインã®è¨å®šå¯èƒ½ãªå¤‰æ•°ã¯ã€ #: ../../rst/network/user_guide/platform_netconf_enabled.rst:97 msgid "Bastion/Jumphost configuration" -msgstr "Bastion/Jumphost ã®è¨å®š" +msgstr "Bastion/ジャンプホストã®è¨å®š" #: ../../rst/network/user_guide/platform_netconf_enabled.rst:98 msgid "To use a jump host to connect to a NETCONF enabled device you must set the ``ANSIBLE_NETCONF_SSH_CONFIG`` environment variable." @@ -5370,6 +5386,10 @@ msgstr "`Cisco NXOS <https://galaxy.ansible.com/cisco/nxos>`_ ã¯è¤‡æ•°ã®æŽ¥ç¶š msgid "NX-API" msgstr "NX-API" +#: ../../rst/network/user_guide/platform_nxos.rst:27 +msgid "by a web proxy" +msgstr "Web プãƒã‚シー経由" + #: ../../rst/network/user_guide/platform_nxos.rst:32 msgid "not supported by NX-API" msgstr "NX-API ã§ã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã›ã‚“" @@ -5387,7 +5407,7 @@ msgid "Enabling NX-API" msgstr "NX-API ã®æœ‰åŠ¹åŒ–" #: ../../rst/network/user_guide/platform_nxos.rst:85 -msgid "Before you can use NX-API to connect to a switch, you must enable NX-API. To enable NX-API on a new switch via Ansible, use the ``nxos_nxapi`` module via the CLI connection. Set up group_vars/nxos.yml just like in the CLI example above, then run a playbook task like this:" +msgid "Before you can use NX-API to connect to a switch, you must enable NX-API. To enable NX-API on a new switch through Ansible, use the ``nxos_nxapi`` module through the CLI connection. Set up group_vars/nxos.yml just like in the CLI example above, then run a playbook task like this:" msgstr "NX-API を使用ã—ã¦ã‚¹ã‚¤ãƒƒãƒã«æŽ¥ç¶šã™ã‚‹å‰ã«ã€NX-API を有効ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Ansible を介ã—ã¦æ–°ã—ã„スイッãƒã§ NX-API を有効ã«ã™ã‚‹ã«ã¯ã€CLI 接続を介ã—㦠``nxos_nxapi`` モジュールを使用ã—ã¾ã™ã€‚å‰è¿°ã® CLI ã®ä¾‹ã¨åŒæ§˜ã« group_vars/nxos.yml ã‚’è¨å®šã—ã€æ¬¡ã®ã‚ˆã†ã« Playbook タスクを実行ã—ã¾ã™ã€‚" #: ../../rst/network/user_guide/platform_nxos.rst:95 @@ -5794,4 +5814,7 @@ msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€Ethernet2/1 ãŠã‚ˆã³ Ethernet2/10 ã¯ã€å®šç¾©ã•ã‚Œã #~ msgid "8.4(1) and later" #~ msgstr "8.4(1) 以é™" +#~ msgid "If you are specifying credentials via ``password:`` (either directly or via ``provider:``) or the environment variable `ANSIBLE_NET_PASSWORD` it is possible that ``paramiko`` (the Python SSH library that Ansible uses) is using ssh keys, and therefore the credentials you are specifying are being ignored. To find out if this is the case, disable \"look for keys\". This can be done like this:" +#~ msgstr "(直接ã¾ãŸã¯ ``provider:`` を使用ã—ã¦) ``password:`` ã§èªè¨¼æƒ…å ±ã‚’æŒ‡å®šã™ã‚‹å ´åˆã‚„ã€ç’°å¢ƒå¤‰æ•° `ANSIBLE_NET_PASSWORD` を指定ã™ã‚‹å ´åˆã¯ã€``paramiko`` (Ansible ãŒä½¿ç”¨ã™ã‚‹ Python SSH ライブラリー) ㌠ssh ã‚ーを使用ã—ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€æŒ‡å®šã™ã‚‹èªè¨¼æƒ…å ±ãŒç„¡åŠ¹ã«ãªã‚Šã¾ã™ã€‚ã“れを確èªã™ã‚‹ã«ã¯ã€ã€Œlook for keysã€ã‚’無効ã«ã—ã¾ã™ã€‚ã“ã‚Œã¯æ¬¡ã®ã‚ˆã†ã«è¡Œã„ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/os_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/os_guide.po index 09ee4595..ffe530e6 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/os_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/os_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/os_guide/index.rst:5 msgid "Using Ansible on Windows and BSD" @@ -222,17 +222,17 @@ msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ #: ../../rst/os_guide/intro_bsd.rst:277 ../../rst/os_guide/windows_dsc.rst:507 #: ../../rst/os_guide/windows_faq.rst:256 -#: ../../rst/os_guide/windows_setup.rst:577 +#: ../../rst/os_guide/windows_setup.rst:498 #: ../../rst/os_guide/windows_usage.rst:518 -#: ../../rst/os_guide/windows_winrm.rst:1010 +#: ../../rst/os_guide/windows_winrm.rst:1012 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" #: ../../rst/os_guide/intro_bsd.rst:278 ../../rst/os_guide/windows_dsc.rst:508 #: ../../rst/os_guide/windows_faq.rst:257 -#: ../../rst/os_guide/windows_setup.rst:578 +#: ../../rst/os_guide/windows_setup.rst:499 #: ../../rst/os_guide/windows_usage.rst:519 -#: ../../rst/os_guide/windows_winrm.rst:1011 +#: ../../rst/os_guide/windows_winrm.rst:1013 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -370,8 +370,8 @@ msgid "A ``[PSCredential]`` object is used to store credentials in a secure way, msgstr "``[PSCredential]`` オブジェクトã¯èªè¨¼æƒ…å ±ã‚’å®‰å…¨ãªæ–¹æ³•ã§ä¿å˜ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ãŒã€Ansible ã«ã¯ã“れを JSON ã§ã‚·ãƒªã‚¢ãƒ«åŒ–ã™ã‚‹æ–¹æ³•ãŒã‚ã‚Šã¾ã›ã‚“。DSC PSCredential プãƒãƒ‘ティーをè¨å®šã™ã‚‹ã«ã¯ã€ãã®ãƒ‘ラメーターã®å®šç¾©ã«ã€ãƒ¦ãƒ¼ã‚¶åã¨ãƒ‘スワードをãã‚Œãžã‚Œ ``_username`` 㨠``_password`` をサフィックスã«ã—㟠2 ã¤ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’è¿½åŠ ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/os_guide/windows_dsc.rst:190 -msgid "On versions of Ansible older than 2.8, you should set ``no_log: yes`` on the task definition in Ansible to ensure any credentials used are not stored in any log file or console output." -msgstr "2.8 よりå¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã§ã¯ã€Ansible ã®ã‚¿ã‚¹ã‚¯å®šç¾©ã« ``no_log: yes`` ã‚’è¨å®šã—ã¦ã€ä½¿ç”¨ã™ã‚‹èªè¨¼æƒ…å ±ãŒãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã¾ãŸã¯ã‚³ãƒ³ã‚½ãƒ¼ãƒ«ã®å‡ºåŠ›ã«ä¿å˜ã•ã‚Œãªã„よã†ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "On versions of Ansible older than 2.8, you should set ``no_log: true`` on the task definition in Ansible to ensure any credentials used are not stored in any log file or console output." +msgstr "2.8 よりå¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã§ã¯ã€Ansible ã®ã‚¿ã‚¹ã‚¯å®šç¾©ã« ``no_log: true`` ã‚’è¨å®šã—ã¦ã€ä½¿ç”¨ã™ã‚‹èªè¨¼æƒ…å ±ãŒãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã¾ãŸã¯ã‚³ãƒ³ã‚½ãƒ¼ãƒ«ã®å‡ºåŠ›ã«ä¿å˜ã•ã‚Œãªã„よã†ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/os_guide/windows_dsc.rst:194 msgid "A ``[PSCredential]`` is defined with ``EmbeddedInstance(\"MSFT_Credential\")`` in a DSC resource MOF definition." @@ -519,61 +519,61 @@ msgstr "IIS Web サイトã®ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—" #: ../../rst/os_guide/windows_dsc.rst:499 #: ../../rst/os_guide/windows_usage.rst:510 -#: ../../rst/os_guide/windows_winrm.rst:1002 +#: ../../rst/os_guide/windows_winrm.rst:1004 msgid ":ref:`playbooks_intro`" msgstr ":ref:`playbooks_intro`" #: ../../rst/os_guide/windows_dsc.rst:500 #: ../../rst/os_guide/windows_faq.rst:251 -#: ../../rst/os_guide/windows_setup.rst:570 +#: ../../rst/os_guide/windows_setup.rst:491 #: ../../rst/os_guide/windows_usage.rst:511 -#: ../../rst/os_guide/windows_winrm.rst:1003 +#: ../../rst/os_guide/windows_winrm.rst:1005 msgid "An introduction to playbooks" msgstr "Playbook ã®æ¦‚è¦" #: ../../rst/os_guide/windows_dsc.rst:501 #: ../../rst/os_guide/windows_faq.rst:252 -#: ../../rst/os_guide/windows_setup.rst:571 +#: ../../rst/os_guide/windows_setup.rst:492 #: ../../rst/os_guide/windows_usage.rst:512 -#: ../../rst/os_guide/windows_winrm.rst:1004 +#: ../../rst/os_guide/windows_winrm.rst:1006 msgid ":ref:`playbooks_best_practices`" msgstr ":ref:`playbooks_best_practices`" #: ../../rst/os_guide/windows_dsc.rst:502 #: ../../rst/os_guide/windows_faq.rst:253 -#: ../../rst/os_guide/windows_setup.rst:572 +#: ../../rst/os_guide/windows_setup.rst:493 #: ../../rst/os_guide/windows_usage.rst:513 -#: ../../rst/os_guide/windows_winrm.rst:1005 +#: ../../rst/os_guide/windows_winrm.rst:1007 msgid "Tips and tricks for playbooks" msgstr "Playbook ã®ãƒ’ントã¨è£æŠ€" #: ../../rst/os_guide/windows_dsc.rst:503 -#: ../../rst/os_guide/windows_setup.rst:573 +#: ../../rst/os_guide/windows_setup.rst:494 #: ../../rst/os_guide/windows_usage.rst:514 -#: ../../rst/os_guide/windows_winrm.rst:1006 +#: ../../rst/os_guide/windows_winrm.rst:1008 msgid ":ref:`List of Windows Modules <windows_modules>`" msgstr ":ref:`List of Windows Modules <windows_modules>`" #: ../../rst/os_guide/windows_dsc.rst:504 -#: ../../rst/os_guide/windows_setup.rst:574 +#: ../../rst/os_guide/windows_setup.rst:495 #: ../../rst/os_guide/windows_usage.rst:515 -#: ../../rst/os_guide/windows_winrm.rst:1007 +#: ../../rst/os_guide/windows_winrm.rst:1009 msgid "Windows specific module list, all implemented in PowerShell" msgstr "Windows 固有ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒªã‚¹ãƒˆ (ã™ã¹ã¦ PowerShell ã«å®Ÿè£…)" #: ../../rst/os_guide/windows_dsc.rst:505 #: ../../rst/os_guide/windows_faq.rst:254 -#: ../../rst/os_guide/windows_setup.rst:575 +#: ../../rst/os_guide/windows_setup.rst:496 #: ../../rst/os_guide/windows_usage.rst:516 -#: ../../rst/os_guide/windows_winrm.rst:1008 +#: ../../rst/os_guide/windows_winrm.rst:1010 msgid "`User Mailing List <https://groups.google.com/group/ansible-project>`_" msgstr "`User Mailing List <https://groups.google.com/group/ansible-project>`_" #: ../../rst/os_guide/windows_dsc.rst:506 #: ../../rst/os_guide/windows_faq.rst:255 -#: ../../rst/os_guide/windows_setup.rst:576 +#: ../../rst/os_guide/windows_setup.rst:497 #: ../../rst/os_guide/windows_usage.rst:517 -#: ../../rst/os_guide/windows_winrm.rst:1009 +#: ../../rst/os_guide/windows_winrm.rst:1011 msgid "Have a question? Stop by the google group!" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" @@ -878,8 +878,8 @@ msgid "The value for ``ansible_shell_type`` should either be ``cmd`` or ``powers msgstr "``ansible_shell_type`` ã®å€¤ã¯ã€``cmd`` ã¾ãŸã¯ ``powershell`` ã®ã„ãšã‚Œã‹ã§ãªã‘ã‚Œã°ãªã‚Šã¾ã›ã‚“。SSH サービス㧠``DefaultShell`` ãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã¯ ``cmd`` を使用ã—ã¦ã€``DefaultShell`` ã¨ã—ã¦è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ ``powershell`` を使用ã—ã¦ãã ã•ã„。" #: ../../rst/os_guide/windows_faq.rst:219 -msgid "Why is connecting to a Windows host via SSH failing?" -msgstr "SSH 経由㧠Windows ホストã«æŽ¥ç¶šã§ããªã„ã®ã¯ãªãœã§ã™ã‹" +msgid "Why is connecting to a Windows host through SSH failing?" +msgstr "SSH を介ã—㟠Windows ホストã¸ã®æŽ¥ç¶šã«å¤±æ•—ã™ã‚‹ã®ã¯ãªãœã§ã™ã‹?" #: ../../rst/os_guide/windows_faq.rst:220 msgid "Unless you are using ``Win32-OpenSSH`` as described above, you must connect to Windows hosts using :ref:`windows_winrm`. If your Ansible output indicates that SSH was used, either you did not set the connection vars properly or the host is not inheriting them correctly." @@ -922,7 +922,7 @@ msgid "The Windows documentation index" msgstr "Windows ドã‚ュメントã®ç›®æ¬¡" #: ../../rst/os_guide/windows_faq.rst:250 -#: ../../rst/os_guide/windows_setup.rst:569 +#: ../../rst/os_guide/windows_setup.rst:490 msgid ":ref:`about_playbooks`" msgstr ":ref:`about_playbooks`" @@ -959,8 +959,8 @@ msgid "Fix high-CPU-on-boot for VMs/cloud instances" msgstr "仮想マシン/クラウドインスタンスã®ã€ã‚·ã‚¹ãƒ†ãƒ 起動時ã®é«˜ CPU ã‚’ä¿®æ£" #: ../../rst/os_guide/windows_performance.rst:50 -msgid "If you are creating golden images to spawn instances from, you can avoid a disruptive high CPU task near startup via `processing the ngen queue <https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator#native-image-service>`_ within your golden image creation, if you know the CPU types won't change between golden image build process and runtime." -msgstr "インスタンスを生æˆã™ã‚‹ãŸã‚ã«ã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸ã‚’作æˆã—ã¦ã„ã‚‹å ´åˆã¯ã€ã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸ã®ãƒ“ルドプãƒã‚»ã‚¹ã¨ãƒ©ãƒ³ã‚¿ã‚¤ãƒ ã®é–“㧠CPU タイプãŒå¤‰ã‚らãªã„ã“ã¨ãŒã‚ã‹ã£ã¦ã„ã‚Œã°ã€ã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸ã®ä½œæˆæ™‚ã« `ngen ã‚ューã®å‡¦ç† <https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator#native-image-service>`_ を使用ã™ã‚‹ã“ã¨ã§ã€èµ·å‹•æ™‚ã«é«˜ã„ CPU タスクãŒç™ºç”Ÿã™ã‚‹ã®ã‚’防ãã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "If you are creating golden images to spawn instances from, you can avoid a disruptive high CPU task near startup through `processing the ngen queue <https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator#native-image-service>`_ within your golden image creation, if you know the CPU types won't change between golden image build process and runtime." +msgstr "インスタンスを生æˆã™ã‚‹ãŸã‚ã«ã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸ã‚’作æˆã—ã¦ã„ã‚‹å ´åˆã¯ã€ã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸ã®ãƒ“ルドプãƒã‚»ã‚¹ã¨ãƒ©ãƒ³ã‚¿ã‚¤ãƒ ã®é–“㧠CPU タイプãŒå¤‰ã‚らãªã„ã“ã¨ãŒã‚ã‹ã£ã¦ã„ã‚Œã°ã€ä½œæˆã—ãŸã‚´ãƒ¼ãƒ«ãƒ‡ãƒ³ã‚¤ãƒ¡ãƒ¼ã‚¸å†…㧠`processing the ngen queue <https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator#native-image-service>`_ を介ã—ã¦ã€èµ·å‹•æ™‚ã«ç ´å£Šçš„㪠CPU 使用率ã®é«˜ã„タスクを回é¿ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/os_guide/windows_performance.rst:55 msgid "Place the following near the end of your playbook, bearing in mind the factors that can cause native images to be invalidated (`see MSDN <https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator#native-images-and-jit-compilation>`_)." @@ -975,449 +975,529 @@ msgid "This document discusses the setup that is required before Ansible can com msgstr "本書ã§ã¯ã€Ansible ㌠Microsoft Windows ホストã¨é€šä¿¡ã™ã‚‹å‰ã«å¿…è¦ãªã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—を説明ã—ã¾ã™ã€‚" #: ../../rst/os_guide/windows_setup.rst:12 -msgid "For Ansible to communicate to a Windows host and use Windows modules, the Windows host must meet these requirements:" -msgstr "Ansible ㌠Windows ホストã¨é€šä¿¡ã—ã€Windows モジュールを使用ã™ã‚‹ãŸã‚ã«ã¯ã€Windows ホストãŒä»¥ä¸‹ã®è¦ä»¶ã‚’満ãŸã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "For Ansible to communicate to a Windows host and use Windows modules, the Windows host must meet these base requirements for connectivity:" +msgstr "Ansible ㌠Windows ホストã¨é€šä¿¡ã—ã€Windows モジュールを使用ã™ã‚‹ãŸã‚ã«ã¯ã€Windows ホストãŒä»¥ä¸‹ã®æŽ¥ç¶šæ€§ã«é–¢ã™ã‚‹åŸºæœ¬è¦ä»¶ã‚’満ãŸã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/os_guide/windows_setup.rst:15 -msgid "Ansible can generally manage Windows versions under current and extended support from Microsoft. Ansible can manage desktop OSs including Windows 8.1, and 10, and server OSs including Windows Server 2012, 2012 R2, 2016, 2019, and 2022." -msgstr "Ansible ã¯ã€Microsoft ã®ç¾è¡ŒãŠã‚ˆã³æ‹¡å¼µã‚µãƒãƒ¼ãƒˆä¸‹ã«ã‚ã‚‹ Windows ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’一般的ã«ç®¡ç†ã§ãã¾ã™ã€‚Ansible ã¯ã€Windows 8.1ãŠã‚ˆã³ 10 ã‚’å«ã‚€ãƒ‡ã‚¹ã‚¯ãƒˆãƒƒãƒ— OSã€ãªã‚‰ã³ã« Windows Server 2012ã€2012 R2ã€2016ã€2019ã€ãŠã‚ˆã³ 2022 ã‚’å«ã‚€ã‚µãƒ¼ãƒãƒ¼ OS を管ç†ã§ãã¾ã™ã€‚" +msgid "With Ansible you can generally manage Windows versions under the current and extended support from Microsoft. You can also manage desktop OSs including Windows 8.1, and 10, and server OSs including Windows Server 2012, 2012 R2, 2016, 2019, and 2022." +msgstr "Ansible ã¯ã€Microsoft ã®ç¾è¡ŒãŠã‚ˆã³æ‹¡å¼µã‚µãƒãƒ¼ãƒˆä¸‹ã«ã‚ã‚‹ Windows ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’一般的ã«ç®¡ç†ã§ãã¾ã™ã€‚ã¾ãŸã€Windows 8.1ãŠã‚ˆã³ 10 ã‚’å«ã‚€ãƒ‡ã‚¹ã‚¯ãƒˆãƒƒãƒ— OSã€ãªã‚‰ã³ã« Windows Server 2012ã€2012 R2ã€2016ã€2019ã€ãŠã‚ˆã³ 2022 ã‚’å«ã‚€ã‚µãƒ¼ãƒãƒ¼ OS を管ç†ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:20 -msgid "Ansible requires PowerShell 3.0 or newer and at least .NET 4.0 to be installed on the Windows host." -msgstr "Ansible を利用ã™ã‚‹ã«ã¯ã€Windows ホスト㫠PowerShell 3.0 以é™ã¨å°‘ãªãã¨ã‚‚ .NET 4.0 ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:17 +msgid "You need to install PowerShell 3.0 or newer and at least .NET 4.0 on the Windows host." +msgstr "Windows ホスト㫠PowerShell 3.0 以é™ã¨å°‘ãªãã¨ã‚‚ .NET 4.0 ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:23 -msgid "A WinRM listener should be created and activated. More details for this can be found below." -msgstr "WinRM リスナーを作æˆã—ã€æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ä»¥ä¸‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:19 +msgid "You need to create and activate a WinRM listener. More details, see `WinRM Setup <https://docs.ansible.com/ansible/latest//user_guide/windows_setup.html#winrm-listener>`_." +msgstr "WinRM リスナーを作æˆã—ã¦ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€`WinRM Setup <https://docs.ansible.com/ansible/latest//user_guide/windows_setup.html#winrm-listener>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:26 -msgid "While these are the base requirements for Ansible connectivity, some Ansible modules have additional requirements, such as a newer OS or PowerShell version. Please consult the module's documentation page to determine whether a host meets those requirements." -msgstr "ã“れらã¯ã€Ansible 接続ã®åŸºæœ¬çš„ãªè¦ä»¶ã§ã™ãŒã€Ansible モジュールã®ä¸ã«ã¯ã€æ–°ã—ã„ OS ã‚„ PowerShell ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãªã©ã€è¿½åŠ ã®è¦ä»¶ãŒã‚ã‚‹ã‚‚ã®ã‚‚ã‚ã‚Šã¾ã™ã€‚ホストãŒã“れらã®è¦ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントページをå‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:21 +msgid "Some Ansible modules have additional requirements, such as a newer OS or PowerShell version. Consult the module documentation page to determine whether a host meets those requirements." +msgstr "Ansible モジュールã®ä¸ã«ã¯ã€æ–°ã—ã„ OS ã‚„ PowerShell ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãªã©ã€è¿½åŠ ã®è¦ä»¶ãŒã‚ã‚‹ã‚‚ã®ã‚‚ã‚ã‚Šã¾ã™ã€‚ホストãŒã“れらã®è¦ä»¶ã‚’満ãŸã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントページをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:32 +#: ../../rst/os_guide/windows_setup.rst:24 msgid "Upgrading PowerShell and .NET Framework" msgstr "PowerShell ãŠã‚ˆã³ .NET Framework ã®ã‚¢ãƒƒãƒ—グレード" -#: ../../rst/os_guide/windows_setup.rst:33 +#: ../../rst/os_guide/windows_setup.rst:25 msgid "Ansible requires PowerShell version 3.0 and .NET Framework 4.0 or newer to function on older operating systems like Server 2008 and Windows 7. The base image does not meet this requirement. You can use the `Upgrade-PowerShell.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Upgrade-PowerShell.ps1>`_ script to update these." msgstr "Ansible ㌠Server 2008 ã‚„ Windows 7 ãªã©ã®å¤ã„オペレーティングシステムã§æ©Ÿèƒ½ã™ã‚‹ãŸã‚ã«ã¯ã€PowerShell ã® ãƒãƒ¼ã‚¸ãƒ§ãƒ³3.0 㨠.NET Framework 4.0 以é™ãŒå¿…è¦ã§ã™ã€‚ベースイメージã¯ã€ã“ã®è¦ä»¶ã‚’満ãŸã—ã¦ã„ã¾ã›ã‚“。`Upgrade-PowerShell.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Upgrade-PowerShell.ps1>`_ スクリプトを使用ã—ã¦ã“れらを更新ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:36 +#: ../../rst/os_guide/windows_setup.rst:28 msgid "This is an example of how to run this script from PowerShell:" msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トを PowerShell ã‹ã‚‰å®Ÿè¡Œã™ã‚‹ä¾‹ã‚’以下ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:52 -msgid "Once completed, you will need to remove auto logon and set the execution policy back to the default (``Restricted `` for Windows clients, or ``RemoteSigned`` for Windows servers). You can do this with the following PowerShell commands:" -msgstr "完了ã—ãŸã‚‰ã€è‡ªå‹•ãƒã‚°ã‚ªãƒ³ã‚’解除ã—ã¦ã€å®Ÿè¡Œãƒãƒªã‚·ãƒ¼ã‚’デフォルト (Windows クライアントã®å ´åˆã¯ ``Restricted ``ã€Windows サーãƒãƒ¼ã®å ´åˆã¯ ``RemoteSigned``) ã«æˆ»ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã¯ä»¥ä¸‹ã® PowerShell コマンドãŒå¿…è¦ã§ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:43 +msgid "In the script, the ``file`` value can be the PowerShell version 3.0, 4.0, or 5.1." +msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã§ã¯ã€``file`` ã®å€¤ã¯ PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.0ã€4.0ã€ã¾ãŸã¯ 5.1 ã«æŒ‡å®šã§ãã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:45 +msgid "Once completed, you need to run the following PowerShell commands:" +msgstr "完了ã—ãŸã‚‰ã€ä»¥ä¸‹ã® PowerShell コマンドを実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:66 -msgid "The script works by checking to see what programs need to be installed (such as .NET Framework 4.5.2) and what PowerShell version is required. If a reboot is required and the ``username`` and ``password`` parameters are set, the script will automatically reboot and logon when it comes back up from the reboot. The script will continue until no more actions are required and the PowerShell version matches the target version. If the ``username`` and ``password`` parameters are not set, the script will prompt the user to manually reboot and logon when required. When the user is next logged in, the script will continue where it left off and the process continues until no more actions are required." -msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ãªãƒ—ãƒã‚°ãƒ©ãƒ (.NET Framework 4.5.2 ãªã©) ã‚„ã€å¿…è¦ãª PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã—ã¦å‹•ä½œã—ã¾ã™ã€‚å†èµ·å‹•ãŒå¿…è¦ã§ã€``username`` パラメーター㨠``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã‚¹ã‚¯ãƒªãƒ—トãŒè‡ªå‹•çš„ã«å†èµ·å‹•ã—ã€å†èµ·å‹•ã‹ã‚‰å¾©å¸°ã—ãŸã¨ãã«ãƒã‚°ã‚ªãƒ³ã—ã¾ã™ã€‚スクリプトã¯ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒä¸è¦ã«ãªã‚Šã€PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ä¸€è‡´ã™ã‚‹ã¾ã§ç¶šè¡Œã•ã‚Œã¾ã™ã€‚``username`` パラメーターãŠã‚ˆã³ ``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã€ã‚¹ã‚¯ãƒªãƒ—トã¯å¿…è¦ã«å¿œã˜ã¦ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«æ‰‹å‹•ã§å†èµ·å‹•ã¨ãƒã‚°ã‚ªãƒ³ã‚’促ã—ã¾ã™ã€‚ユーザーãŒæ¬¡ã«ãƒã‚°ã‚¤ãƒ³ã™ã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯å‰å›žã®ç¶šãを実行ã—ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒå¿…è¦ãªããªã‚‹ã¾ã§å‡¦ç†ã‚’続ã‘ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:47 +msgid "As an optional but good security practice, you can set the execution policy back to the default." +msgstr "ã“ã¡ã‚‰ã¯ä»»æ„ã§ã™ãŒã€å®Ÿè¡Œãƒãƒªã‚·ãƒ¼ã‚’デフォルトã«æˆ»ã™ã“ã¨ãŒã‚»ã‚ュリティープラクティスã¨ã—ã¦é©åˆ‡ã§ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:77 -msgid "If running on Server 2008, then SP2 must be installed. If running on Server 2008 R2 or Windows 7, then SP1 must be installed." -msgstr "Server 2008 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€SP2 ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Server 2008 R2 ã¾ãŸã¯ Windows 7 ã§å®Ÿè¡Œã—ã¦ã„ã‚‹å ´åˆã¯ SP1 をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:53 +msgid "Use the ``RemoteSigned`` value for Windows servers, or ``Restricted`` for Windows clients." +msgstr "Windows サーãƒãƒ¼ã«ã¯ ``RemoteSigned`` ã®å€¤ã‚’使用ã—ã€Windows クライアントã«ã¯ ``Restricted`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:80 -msgid "Windows Server 2008 can only install PowerShell 3.0; specifying a newer version will result in the script failing." +#: ../../rst/os_guide/windows_setup.rst:55 +msgid "Remove the auto logon." +msgstr "自動ãƒã‚°ã‚ªãƒ³ã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:64 +msgid "The script determines what programs you need to install (such as .NET Framework 4.5.2) and what PowerShell version needs to be present. If a reboot is needed and the ``username`` and ``password`` parameters are set, the script will automatically reboot the machine and then logon. If the ``username`` and ``password`` parameters are not set, the script will prompt the user to manually reboot and logon when required. When the user is next logged in, the script will continue where it left off and the process continues until no more actions are required." +msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ãªãƒ—ãƒã‚°ãƒ©ãƒ (.NET Framework 4.5.2 ãªã©) ã‚„ã€å¿…è¦ãª PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã—ã¦å‹•ä½œã—ã¾ã™ã€‚å†èµ·å‹•ãŒå¿…è¦ã§ã€``username`` パラメーター㨠``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã‚¹ã‚¯ãƒªãƒ—トãŒè‡ªå‹•çš„ã«å†èµ·å‹•ã—ã€å†èµ·å‹•ã‹ã‚‰å¾©å¸°ã—ãŸã¨ãã«ãƒã‚°ã‚ªãƒ³ã—ã¾ã™ã€‚``username`` パラメーターãŠã‚ˆã³ ``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã«ã¯ã€ã‚¹ã‚¯ãƒªãƒ—トã¯å¿…è¦ã«å¿œã˜ã¦ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«æ‰‹å‹•ã§å†èµ·å‹•ã¨ãƒã‚°ã‚ªãƒ³ã‚’促ã—ã¾ã™ã€‚ユーザーãŒæ¬¡ã«ãƒã‚°ã‚¤ãƒ³ã™ã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯å‰å›žã®ç¶šãを実行ã—ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒå¿…è¦ãªããªã‚‹ã¾ã§å‡¦ç†ã‚’続ã‘ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:67 +msgid "If you run the script on Server 2008, then you need to install SP2. For Server 2008 R2 or Windows 7 you need SP1." +msgstr "Server 2008 ã§ã‚¹ã‚¯ãƒªãƒ—トを実行ã™ã‚‹å ´åˆã¯ã€SP2 をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Server 2008 R2 ã¾ãŸã¯ Windows 7 ã®å ´åˆã¯ SP1 ãŒå¿…è¦ã§ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:69 +msgid "On Windows Server 2008 you can install only PowerShell 3.0. A newer version will result in the script failure." msgstr "Windows Server 2008 ã§ã¯ PowerShell 3.0 ã—ã‹ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ããªã„ãŸã‚ã€ãれより新ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’指定ã™ã‚‹ã¨ã‚¹ã‚¯ãƒªãƒ—トãŒå¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:83 -msgid "The ``username`` and ``password`` parameters are stored in plain text in the registry. Make sure the cleanup commands are run after the script finishes to ensure no credentials are still stored on the host." +#: ../../rst/os_guide/windows_setup.rst:71 +msgid "The ``username`` and ``password`` parameters are stored in plain text in the registry. Run the cleanup commands after the script finishes to ensure no credentials are stored on the host." msgstr "``username`` 㨠``password`` ã®ãƒ‘ラメーターã¯ã€ãƒ¬ã‚¸ã‚¹ãƒˆãƒªãƒ¼ã«å¹³æ–‡ã§ä¿å˜ã•ã‚Œã¾ã™ã€‚スクリプトã®çµ‚了後ã«ã‚¯ãƒªãƒ¼ãƒ³ã‚¢ãƒƒãƒ—コマンドを実行ã—ã¦ã€ãƒ›ã‚¹ãƒˆä¸Šã«èªè¨¼æƒ…å ±ãŒä¿å˜ã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:88 +#: ../../rst/os_guide/windows_setup.rst:75 msgid "WinRM Memory Hotfix" msgstr "WinRM Memory Hotfix" -#: ../../rst/os_guide/windows_setup.rst:89 -msgid "When running on PowerShell v3.0, there is a bug with the WinRM service that limits the amount of memory available to WinRM. Without this hotfix installed, Ansible will fail to execute certain commands on the Windows host. These hotfixes should be installed as part of the system bootstrapping or imaging process. The script `Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ can be used to install the hotfix on affected hosts." -msgstr "PowerShell v3.0 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€WinRM サービスã®ãƒã‚°ã«ã‚ˆã‚Šã€WinRM ã§ä½¿ç”¨ã§ãるメモリーé‡ãŒåˆ¶é™ã•ã‚Œã‚‹ã¨ã„ã†å•é¡ŒãŒã‚ã‚Šã¾ã—ãŸã€‚ã“ã® Hotfix をインストールã—ãªã„ã¨ã€Windows ホスト上㧠Ansible ã«ã‚ˆã‚‹ç‰¹å®šã®ã‚³ãƒžãƒ³ãƒ‰ã®å®Ÿè¡Œã«å¤±æ•—ã—ã¾ã™ã€‚ã“れら㮠Hotfix ã¯ã€ã‚·ã‚¹ãƒ†ãƒ ã®ãƒ–ートストラップã¾ãŸã¯ã‚¤ãƒ¡ãƒ¼ã‚¸ãƒ³ã‚°ãƒ—ãƒã‚»ã‚¹ã®ä¸€éƒ¨ã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚`Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ ã¨ã„ã†ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã¨ã€å½±éŸ¿ã‚’å—ã‘るホスト㫠hotfix をインストールã§ãã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:76 +msgid "On PowerShell v3.0, there is a bug that limits the amount of memory available to the WinRM service. Use the `Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ script to install a hotfix on affected hosts as part of the system bootstrapping or imaging process. Without this hotfix, Ansible fails to execute certain commands on the Windows host." +msgstr "PowerShell v3.0 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€WinRM サービスã®ãƒã‚°ã«ã‚ˆã‚Šã€WinRM ã§ä½¿ç”¨ã§ãるメモリーé‡ãŒåˆ¶é™ã•ã‚Œã‚‹ã¨ã„ã†å•é¡ŒãŒã‚ã‚Šã¾ã—ãŸã€‚`Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ ã¨ã„ã†ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã¨ã€ã‚·ã‚¹ãƒ†ãƒ ã®ãƒ–ートストラップã¾ãŸã¯ã‚¤ãƒ¡ãƒ¼ã‚¸ãƒ—ãƒã‚»ã‚¹ã®ä¸€éƒ¨ã¨ã—ã¦ã€å½±éŸ¿ã‚’å—ã‘るホスト㫠hotfix をインストールã§ãã¾ã™ã€‚ã“ã® hotfix ãŒãªã„å ´åˆã«ã¯ã€Ansible ã§ã¯ Windows ホスト上ã§ç‰¹å®šã®ã‚³ãƒžãƒ³ãƒ‰ã®å®Ÿè¡Œã«å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:95 -msgid "The following PowerShell command will install the hotfix:" -msgstr "以下㮠PowerShell コマンド㯠hotfix をインストールã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:78 +msgid "To install the hotfix:" +msgstr "ホットフィックスをインストールã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:106 -msgid "For more details, please refer to the `Hotfix document <https://support.microsoft.com/en-us/help/2842230/out-of-memory-error-on-a-computer-that-has-a-customized-maxmemorypersh>`_ from Microsoft." -msgstr "詳細ã¯ã€Microsoft 社㮠`Hotfix ドã‚ュメント <https://support.microsoft.com/en-us/help/2842230/out-of-memory-error-on-a-computer-that-has-a-customized-maxmemorypersh>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:89 +msgid "For more details, refer to the `\"Out of memory\" error on a computer that has a customized MaxMemoryPerShellMB quota set and has WMF 3.0 installed <https://support.microsoft.com/en-us/help/2842230/out-of-memory-error-on-a-computer-that-has-a-customized-maxmemorypersh>`_ article." +msgstr "詳細ã¯ã€`\"Out of memory\" error on a computer that has a customized MaxMemoryPerShellMB quota set and has WMF 3.0 installed <https://support.microsoft.com/en-us/help/2842230/out-of-memory-error-on-a-computer-that-has-a-customized-maxmemorypersh>`_ アーティクルをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:109 +#: ../../rst/os_guide/windows_setup.rst:92 msgid "WinRM Setup" msgstr "WinRM ã®è¨å®š" -#: ../../rst/os_guide/windows_setup.rst:110 -msgid "Once Powershell has been upgraded to at least version 3.0, the final step is to configure the WinRM service so that Ansible can connect to it. There are two main components of the WinRM service that governs how Ansible can interface with the Windows host: the ``listener`` and the ``service`` configuration settings." -msgstr "Powershell ã‚’ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.0 以é™ã«ã‚¢ãƒƒãƒ—グレードã—ãŸã‚‰ã€æœ€å¾Œã®ã‚¹ãƒ†ãƒƒãƒ—ã¨ã—ã¦ã€WinRM サービスをè¨å®šã—㦠Ansible ãŒæŽ¥ç¶šã§ãるよã†ã«ã—ã¾ã™ã€‚WinRM サービスã«ã¯ã€Ansible ㌠Windows ホストã¨ã©ã®ã‚ˆã†ã«é€£æºã™ã‚‹ã‹ã‚’決定ã™ã‚‹æ§‹æˆè¨å®š ``listener`` ãŠã‚ˆã³ ``service`` ã® 2 ã¤ã®ä¸»è¦ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:93 +msgid "You need to configure the WinRM service so that Ansible can connect to it. There are two main components of the WinRM service that governs how Ansible can interface with the Windows host: the ``listener`` and the ``service`` configuration settings." +msgstr "WinRM サービスをè¨å®šã—㦠Ansible ãŒæŽ¥ç¶šã§ãるよã†ã«ã—ã¾ã™ã€‚WinRM サービスã«ã¯ã€æ§‹æˆè¨å®š ``listener`` ãŠã‚ˆã³ ``service`` ã® 2 ã¤ã®ä¸»è¦ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆãŒã‚ã‚Šã€Ansible ㌠Windows ホストã¨ã©ã®ã‚ˆã†ã«é€£æºã™ã‚‹ã‹ã‚’決定ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:116 +#: ../../rst/os_guide/windows_setup.rst:96 msgid "WinRM Listener" msgstr "WinRM リスナー" -#: ../../rst/os_guide/windows_setup.rst:117 -msgid "The WinRM services listens for requests on one or more ports. Each of these ports must have a listener created and configured." +#: ../../rst/os_guide/windows_setup.rst:97 +msgid "The WinRM services listen for requests on one or more ports. Each of these ports must have a listener created and configured." msgstr "WinRM サービスã¯ã€1 ã¤ä»¥ä¸Šã®ãƒãƒ¼ãƒˆã§è¦æ±‚をリッスンã—ã¾ã™ã€‚ã“れらã®ãƒãƒ¼ãƒˆã”ã¨ã«ãƒªã‚¹ãƒŠãƒ¼ã‚’作æˆã—ã€è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:120 -msgid "To view the current listeners that are running on the WinRM service, run the following command:" -msgstr "WinRM サービスã§å®Ÿè¡Œã—ã¦ã„ã‚‹ç¾åœ¨ã®ãƒªã‚¹ãƒŠãƒ¼ã‚’表示ã™ã‚‹ã«ã¯ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:99 +msgid "To view the current listeners that are running on the WinRM service:" +msgstr "WinRM サービスã§å®Ÿè¡Œã—ã¦ã„ã‚‹ç¾åœ¨ã®ãƒªã‚¹ãƒŠãƒ¼ã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:127 -#: ../../rst/os_guide/windows_setup.rst:245 +#: ../../rst/os_guide/windows_setup.rst:105 +#: ../../rst/os_guide/windows_setup.rst:200 msgid "This will output something like:" msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ä»¥ä¸‹ã®ã‚ˆã†ãªã‚‚ã®ãŒå‡ºåŠ›ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:153 -msgid "In the example above there are two listeners activated; one is listening on port 5985 over HTTP and the other is listening on port 5986 over HTTPS. Some of the key options that are useful to understand are:" +#: ../../rst/os_guide/windows_setup.rst:131 +msgid "In the example above there are two listeners activated. One is listening on port 5985 over HTTP and the other is listening on port 5986 over HTTPS. Some of the key options that are useful to understand are:" msgstr "上ã®ä¾‹ã§ã¯ã€2 ã¤ã®ãƒªã‚¹ãƒŠãƒ¼ãŒæœ‰åŠ¹ã«ãªã£ã¦ã„ã¾ã™ã€‚1 ã¤ã¯ HTTP ã§ãƒãƒ¼ãƒˆ 5985 をリッスンã—ã¦ãŠã‚Šã€ã‚‚ㆠ1 ã¤ã¯ HTTPS ã§ãƒãƒ¼ãƒˆ 5986 をリッスンã—ã¦ã„ã¾ã™ã€‚ç†è§£ã—ã¦ãŠãã¨ä¾¿åˆ©ãªã‚ªãƒ—ションをã„ãã¤ã‹ç´¹ä»‹ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:157 -msgid "``Transport``: Whether the listener is run over HTTP or HTTPS, it is recommended to use a listener over HTTPS as the data is encrypted without any further changes required." +#: ../../rst/os_guide/windows_setup.rst:133 +msgid "``Transport``: Whether the listener is run over HTTP or HTTPS. We recommend you use a listener over HTTPS because the data is encrypted without any further changes required." msgstr "``Transport``: リスナー㌠HTTP ã¾ãŸã¯ HTTPS ã®ã©ã¡ã‚‰ã§å®Ÿè¡Œã—ã¦ã„ã‚‹å ´åˆã§ã‚‚ã€ãƒ‡ãƒ¼ã‚¿ã¯ã•ã‚‰ãªã‚‹å¤‰æ›´ãªã—ã«æš—å·åŒ–ã•ã‚Œã‚‹ãŸã‚ã€HTTPS 経由ã§ãƒªã‚¹ãƒŠãƒ¼ã‚’使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:161 -msgid "``Port``: The port the listener runs on, by default it is ``5985`` for HTTP and ``5986`` for HTTPS. This port can be changed to whatever is required and corresponds to the host var ``ansible_port``." +#: ../../rst/os_guide/windows_setup.rst:135 +msgid "``Port``: The port the listener runs on. By default it is ``5985`` for HTTP and ``5986`` for HTTPS. This port can be changed to whatever is required and corresponds to the host var ``ansible_port``." msgstr "``Port``: リスナーãŒå®Ÿè¡Œã™ã‚‹ãƒãƒ¼ãƒˆã€‚デフォルトã¯ã€HTTP ã®å ´åˆã¯ ``5985``ã€HTTPS ã®å ´åˆã¯ ``5986`` ã§ã™ã€‚ã“ã®ãƒãƒ¼ãƒˆã¯ã€å¿…è¦ãªã‚‚ã®ã«ãã‚Œãžã‚Œå¤‰æ›´ã§ãã€ãƒ›ã‚¹ãƒˆå¤‰æ•° ``ansible_port`` ã«å¯¾å¿œã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:165 -msgid "``URLPrefix``: The URL prefix to listen on, by default it is ``wsman``. If this is changed, the host var ``ansible_winrm_path`` must be set to the same value." -msgstr "``URLPrefix``: リッスンã™ã‚‹ URL プレフィックス。デフォルト㯠``wsman`` ã§ã™ã€‚ã“ã‚ŒãŒå¤‰æ›´ã•ã‚ŒãŸå ´åˆã€ãƒ›ã‚¹ãƒˆå¤‰æ•° ``ansible_winrm_path`` ã¯åŒã˜å€¤ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:137 +msgid "``URLPrefix``: The URL prefix to listen on. By default it is ``wsman``. If you change this option, you need to set the host var ``ansible_winrm_path`` to the same value." +msgstr "``URLPrefix``: リッスンã™ã‚‹ URL プレフィックス。デフォルト㯠``wsman`` ã§ã™ã€‚ã“ã®ã‚ªãƒ—ションãŒå¤‰æ›´ã•ã‚ŒãŸå ´åˆã€ãƒ›ã‚¹ãƒˆå¤‰æ•° ``ansible_winrm_path`` ã¯åŒã˜å€¤ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:169 -msgid "``CertificateThumbprint``: If running over an HTTPS listener, this is the thumbprint of the certificate in the Windows Certificate Store that is used in the connection. To get the details of the certificate itself, run this command with the relevant certificate thumbprint in PowerShell:" -msgstr "``CertificateThumbprint``: HTTPS リスナーを介ã—ã¦å®Ÿè¡Œã™ã‚‹å ´åˆã€ã“ã‚Œã¯æŽ¥ç¶šã«ä½¿ç”¨ã•ã‚Œã‚‹ Windows 証明書ストアã®è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントã§ã™ã€‚証明書自体ã®è©³ç´°ã‚’å–å¾—ã™ã‚‹ã«ã¯ã€PowerShell ã§è©²å½“ã™ã‚‹è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントを指定ã—ã¦æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:139 +msgid "``CertificateThumbprint``: If you use an HTTPS listener, this is the thumbprint of the certificate in the Windows Certificate Store that is used in the connection. To get the details of the certificate itself, run this command with the relevant certificate thumbprint in PowerShell:" +msgstr "``CertificateThumbprint``: HTTPS リスナーを使用ã™ã‚‹å ´åˆã€ã“ã‚Œã¯æŽ¥ç¶šã«ä½¿ç”¨ã•ã‚Œã‚‹ Windows 証明書ストアã®è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントã§ã™ã€‚証明書自体ã®è©³ç´°ã‚’å–å¾—ã™ã‚‹ã«ã¯ã€PowerShell ã§è©²å½“ã™ã‚‹è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントを指定ã—ã¦æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:180 +#: ../../rst/os_guide/windows_setup.rst:147 msgid "Setup WinRM Listener" msgstr "WinRM リスナーã®è¨å®š" -#: ../../rst/os_guide/windows_setup.rst:181 +#: ../../rst/os_guide/windows_setup.rst:148 msgid "There are three ways to set up a WinRM listener:" msgstr "WinRM リスナーをè¨å®šã™ã‚‹ã«ã¯ã€3 ã¤ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:183 -msgid "Using ``winrm quickconfig`` for HTTP or ``winrm quickconfig -transport:https`` for HTTPS. This is the easiest option to use when running outside of a domain environment and a simple listener is required. Unlike the other options, this process also has the added benefit of opening up the Firewall for the ports required and starts the WinRM service." +#: ../../rst/os_guide/windows_setup.rst:150 +msgid "Using ``winrm quickconfig`` for HTTP or ``winrm quickconfig -transport:https`` for HTTPS. This is the easiest option to use when running outside of a domain environment and a simple listener is required. Unlike the other options, this process also has the added benefit of opening up the firewall for the ports required and starts the WinRM service." msgstr "HTTP ã«ã¯ ``winrm quickconfig`` ã‚’ã€HTTPS ã«ã¯ ``winrm quickconfig -transport:https`` を使用ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‰ãƒ¡ã‚¤ãƒ³ç’°å¢ƒå¤–ã§å‹•ä½œã—ã€ã‚·ãƒ³ãƒ—ルãªãƒªã‚¹ãƒŠãƒ¼ãŒå¿…è¦ãªå ´åˆã«ã€æœ€ã‚‚ç°¡å˜ã«ä½¿ç”¨ã§ãるオプションã§ã™ã€‚ä»–ã®ã‚ªãƒ—ションã¨ã¯ç•°ãªã‚Šã€ã“ã®ãƒ—ãƒã‚»ã‚¹ã«ã¯ã€å¿…è¦ãªãƒãƒ¼ãƒˆã®ãŸã‚ã«ãƒ•ã‚¡ã‚¤ã‚¢ã‚¦ã‚©ãƒ¼ãƒ«ã‚’é–‹ãã€WinRM サービスを開始ã™ã‚‹ã¨ã„ã†åˆ©ç‚¹ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:189 -msgid "Using Group Policy Objects. This is the best way to create a listener when the host is a member of a domain because the configuration is done automatically without any user input. For more information on group policy objects, see the `Group Policy Objects documentation <https://msdn.microsoft.com/en-us/library/aa374162(v=vs.85).aspx>`_." -msgstr "グループãƒãƒªã‚·ãƒ¼ã‚ªãƒ–ジェクトã®ä½¿ç”¨ã€‚è¨å®šã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒå…¥åŠ›ã›ãšã«è‡ªå‹•çš„ã«è¡Œã‚れるãŸã‚ã€ã“ã®æ–¹æ³•ã¯ã€ãƒ›ã‚¹ãƒˆãŒãƒ‰ãƒ¡ã‚¤ãƒ³ã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã‚ã‚‹å ´åˆã«ãƒªã‚¹ãƒŠãƒ¼ã‚’作æˆã™ã‚‹ã®ã«æœ€é©ãªæ–¹æ³•ã§ã™ã€‚グループãƒãƒªã‚·ãƒ¼ã‚ªãƒ–ジェクトã®è©³ç´°ã¯ã€`Group Policy Objects ドã‚ュメント <https://msdn.microsoft.com/en-us/library/aa374162(v=vs.85).aspx>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:152 +msgid "Using Group Policy Objects (GPO). This is the best way to create a listener when the host is a member of a domain because the configuration is done automatically without any user input. For more information on group policy objects, see the `Group Policy Objects documentation <https://msdn.microsoft.com/en-us/library/aa374162(v=vs.85).aspx>`_." +msgstr "グループãƒãƒªã‚·ãƒ¼ã‚ªãƒ–ジェクト (GPO) ã®ä½¿ç”¨ã€‚è¨å®šã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒå…¥åŠ›ã›ãšã«è‡ªå‹•çš„ã«è¡Œã‚れるãŸã‚ã€ã“ã®æ–¹æ³•ã¯ã€ãƒ›ã‚¹ãƒˆãŒãƒ‰ãƒ¡ã‚¤ãƒ³ã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã‚ã‚‹å ´åˆã«ãƒªã‚¹ãƒŠãƒ¼ã‚’作æˆã™ã‚‹ã®ã«æœ€é©ãªæ–¹æ³•ã§ã™ã€‚グループãƒãƒªã‚·ãƒ¼ã‚ªãƒ–ジェクトã®è©³ç´°ã¯ã€`Group Policy Objects documentation <https://msdn.microsoft.com/en-us/library/aa374162(v=vs.85).aspx>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:194 -msgid "Using PowerShell to create the listener with a specific configuration. This can be done by running the following PowerShell commands:" +#: ../../rst/os_guide/windows_setup.rst:154 +msgid "Using PowerShell to create a listener with a specific configuration. This can be done by running the following PowerShell commands:" msgstr "PowerShell を使用ã—ã¦ã€ç‰¹å®šã®è¨å®šã§ãƒªã‚¹ãƒŠãƒ¼ã‚’作æˆã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ä»¥ä¸‹ã® PowerShell コマンドを実行ã™ã‚‹ã“ã¨ã§å¯èƒ½ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:209 -msgid "To see the other options with this PowerShell cmdlet, see `New-WSManInstance <https://docs.microsoft.com/en-us/powershell/module/microsoft.wsman.management/new-wsmaninstance?view=powershell-5.1>`_." -msgstr "ã“ã® PowerShell コマンドレッドを伴ã†ä»–ã®ã‚ªãƒ—ションを表示ã™ã‚‹ã«ã¯ã€ã€Œ`New-WSManInstance <https://docs.microsoft.com/en-us/powershell/module/microsoft.wsman.management/new-wsmaninstance?view=powershell-5.1>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:168 +msgid "To see the other options with this PowerShell command, refer to the `New-WSManInstance <https://docs.microsoft.com/en-us/powershell/module/microsoft.wsman.management/new-wsmaninstance?view=powershell-5.1>`_ documentation." +msgstr "ã“ã® PowerShell コマンドã®ä»–ã®ã‚ªãƒ—ションを確èªã™ã‚‹ã«ã¯ã€`New-WSManInstance <https://docs.microsoft.com/en-us/powershell/module/microsoft.wsman.management/new-wsmaninstance?view=powershell-5.1>`_ ドã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:212 -msgid "When creating an HTTPS listener, an existing certificate needs to be created and stored in the ``LocalMachine\\My`` certificate store. Without a certificate being present in this store, most commands will fail." -msgstr "HTTPS リスナーを作æˆã™ã‚‹éš›ã«ã¯ã€æ—¢å˜ã®è¨¼æ˜Žæ›¸ã‚’作æˆã—ã€``LocalMachine\\My`` ã®è¨¼æ˜Žæ›¸ã‚¹ãƒˆã‚¢ã«ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚¹ãƒˆã‚¢ã«è¨¼æ˜Žæ›¸ãŒå˜åœ¨ã—ãªã„ã¨ã€ã»ã¨ã‚“ã©ã®ã‚³ãƒžãƒ³ãƒ‰ãŒå¤±æ•—ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:171 +msgid "When creating an HTTPS listener, you must create and store a certificate in the ``LocalMachine\\My`` certificate store." +msgstr "HTTPS リスナーを作æˆã™ã‚‹ã¨ãã¯ã€``LocalMachine\\My`` 証明書ストアã«è¨¼æ˜Žæ›¸ã‚’作æˆã—ã¦ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:217 +#: ../../rst/os_guide/windows_setup.rst:174 msgid "Delete WinRM Listener" msgstr "WinRM リスナーã®å‰Šé™¤" -#: ../../rst/os_guide/windows_setup.rst:218 -msgid "To remove a WinRM listener:" +#: ../../rst/os_guide/windows_setup.rst:175 +msgid "To remove all WinRM listeners:" msgstr "WinRM リスナーを削除ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:228 -msgid "The ``Keys`` object is an array of strings, so it can contain different values. By default it contains a key for ``Transport=`` and ``Address=`` which correspond to the values from winrm enumerate winrm/config/Listeners." -msgstr "``Keys`` オブジェクトã¯æ–‡å—列ã®é…列ã§ã‚ã‚‹ãŸã‚ã€ç•°ãªã‚‹å€¤ã‚’å«ã‚€ã“ã¨ãŒã§ãã¾ã™ã€‚デフォルトã§ã¯ã€winrm enumerate winrm/config/Listeners ã®å€¤ã«å¯¾å¿œã™ã‚‹ ``Transport=`` ãŠã‚ˆã³ ``Address=`` ã®ã‚ーをå«ã‚“ã§ã„ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:181 +msgid "To remove only those listeners that run over HTTPS:" +msgstr "HTTPS ã§å®Ÿè¡Œã•ã‚Œã‚‹ãƒªã‚¹ãƒŠãƒ¼ã®ã¿ã‚’削除ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:187 +msgid "The ``Keys`` object is an array of strings, so it can contain different values. By default, it contains a key for ``Transport=`` and ``Address=`` which correspond to the values from the ``winrm enumerate winrm/config/Listeners`` command." +msgstr "``Keys`` オブジェクトã¯æ–‡å—列ã®é…列ã§ã‚ã‚‹ãŸã‚ã€ç•°ãªã‚‹å€¤ã‚’å«ã‚€ã“ã¨ãŒã§ãã¾ã™ã€‚デフォルトã§ã¯ã€ ``winrm enumerate winrm/config/Listeners`` コマンドã‹ã‚‰ã®ã®å€¤ã«å¯¾å¿œã™ã‚‹ ``Transport=`` ãŠã‚ˆã³ ``Address=`` ã®ã‚ーをå«ã‚“ã§ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:233 +#: ../../rst/os_guide/windows_setup.rst:190 msgid "WinRM Service Options" msgstr "WinRM サービスオプション" -#: ../../rst/os_guide/windows_setup.rst:234 -msgid "There are a number of options that can be set to control the behavior of the WinRM service component, including authentication options and memory settings." -msgstr "WinRM サービスコンãƒãƒ¼ãƒãƒ³ãƒˆã®å‹•ä½œã‚’制御ã™ã‚‹ã‚ˆã†ã«è¨å®šã§ãã€èªè¨¼ã‚ªãƒ—ションやメモリーè¨å®šãªã©ã€è¤‡æ•°ã®ã‚ªãƒ—ションをè¨å®šã§ãã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:191 +msgid "You can control the behavior of the WinRM service component, including authentication options and memory settings." +msgstr "èªè¨¼ã‚ªãƒ—ションやメモリーè¨å®šãªã©ã€WinRM サービスコンãƒãƒ¼ãƒãƒ³ãƒˆã®å‹•ä½œã‚’制御ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:237 +#: ../../rst/os_guide/windows_setup.rst:193 msgid "To get an output of the current service configuration options, run the following command:" msgstr "ç¾åœ¨ã®ã‚µãƒ¼ãƒ“スè¨å®šã‚ªãƒ—ションã®å‡ºåŠ›ã‚’å¾—ã‚‹ã«ã¯ã€æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:283 -msgid "While many of these options should rarely be changed, a few can easily impact the operations over WinRM and are useful to understand. Some of the important options are:" -msgstr "ã“れらã®ã‚ªãƒ—ションã®å¤šãã¯ã»ã¨ã‚“ã©å¤‰æ›´ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ã„ãã¤ã‹ã®ã‚ªãƒ—ション㯠WinRM ã®æ“作ã«ç°¡å˜ã«å½±éŸ¿ã‚’与ãˆã‚‹ãŸã‚ã€ç†è§£ã—ã¦ãŠãã¨ä¾¿åˆ©ã§ã™ã€‚é‡è¦ãªã‚ªãƒ—ションã®ä¸€éƒ¨ã‚’紹介ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:238 +msgid "You do not need to change the majority of these options. However, some of the important ones to know about are:" +msgstr "ã“れらã®ã‚ªãƒ—ションã®å¤§éƒ¨åˆ†ã‚’変更ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€çŸ¥ã£ã¦ãŠãã¹ãé‡è¦ãªã‚ªãƒ—ションã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:287 -msgid "``Service\\AllowUnencrypted``: This option defines whether WinRM will allow traffic that is run over HTTP without message encryption. Message level encryption is only possible when ``ansible_winrm_transport`` is ``ntlm``, ``kerberos`` or ``credssp``. By default this is ``false`` and should only be set to ``true`` when debugging WinRM messages." -msgstr "``Service\\AllowUnencrypted``: ã“ã®ã‚ªãƒ—ションã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’æš—å·åŒ–ã›ãšã« HTTP ã§å®Ÿè¡Œã™ã‚‹ãƒˆãƒ©ãƒ•ã‚£ãƒƒã‚¯ã‚’ WinRM ã§è¨±å¯ã™ã‚‹ã‹ã©ã†ã‹ã‚’定義ã—ã¾ã™ã€‚メッセージレベルã®æš—å·åŒ–ã¯ã€``ansible_winrm_transport`` ㌠``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` ã®å ´åˆã«ã®ã¿å¯èƒ½ã§ã™ã€‚デフォルトã§ã¯ã€ã“れ㯠``false`` ã§ã‚ã‚Šã€WinRM メッセージをデãƒãƒƒã‚°ã™ã‚‹å ´åˆã«é™ã‚Š ``true`` ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:240 +msgid "``Service\\AllowUnencrypted`` - specifies whether WinRM will allow HTTP traffic without message encryption. Message level encryption is only possible when the ``ansible_winrm_transport`` variable is ``ntlm``, ``kerberos`` or ``credssp``. By default, this is ``false`` and you should only set it to ``true`` when debugging WinRM messages." +msgstr "``Service\\AllowUnencrypted``: メッセージを暗å·åŒ–ã›ãšã« HTTP トラフィックを WinRM ã§è¨±å¯ã™ã‚‹ã‹ã©ã†ã‹ã‚’定義ã—ã¾ã™ã€‚メッセージレベルã®æš—å·åŒ–ã¯ã€``ansible_winrm_transport`` 変数㌠``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` ã®å ´åˆã«ã®ã¿å¯èƒ½ã§ã™ã€‚デフォルトã§ã¯ã€ã“れ㯠``false`` ã§ã‚ã‚Šã€WinRM メッセージをデãƒãƒƒã‚°ã™ã‚‹å ´åˆã«é™ã‚Š ``true`` ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:293 -msgid "``Service\\Auth\\*``: These flags define what authentication options are allowed with the WinRM service. By default, ``Negotiate (NTLM)`` and ``Kerberos`` are enabled." -msgstr "``Service\\Auth\\*``: ã“れらã®ãƒ•ãƒ©ã‚°ã¯ã€WinRM サービスã§è¨±å¯ã•ã‚Œã‚‹èªè¨¼ã‚ªãƒ—ションを定義ã—ã¾ã™ã€‚デフォルトã§ã¯ã€``Negotiate (NTLM)`` ãŠã‚ˆã³ ``Kerberos`` ãŒæœ‰åŠ¹ã«ãªã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:242 +msgid "``Service\\Auth\\*`` - defines what authentication options you can use with the WinRM service. By default, ``Negotiate (NTLM)`` and ``Kerberos`` are enabled." +msgstr "``Service\\Auth\\*``: WinRM サービスã§ä½¿ç”¨å¯èƒ½ãªèªè¨¼ã‚ªãƒ—ションを定義ã—ã¾ã™ã€‚デフォルトã§ã¯ã€``Negotiate (NTLM)`` ãŠã‚ˆã³ ``Kerberos`` ãŒæœ‰åŠ¹ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:297 -msgid "``Service\\Auth\\CbtHardeningLevel``: Specifies whether channel binding tokens are not verified (None), verified but not required (Relaxed), or verified and required (Strict). CBT is only used when connecting with NTLM or Kerberos over HTTPS." -msgstr "``Service\\Auth\\CbtHardeningLevel``: ãƒãƒ£ãƒ³ãƒãƒ«ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãƒˆãƒ¼ã‚¯ãƒ³ã‚’検証ã—ãªã„ (None)ã€æ¤œè¨¼æ¸ˆã¿ã ãŒå¿…è¦ãªã„ (Relaxed)ã€æ¤œè¨¼æ¸ˆã¿ã§å¿…è¦ (Strict) ã®ã„ãšã‚Œã‹ã‚’指定ã—ã¾ã™ã€‚CBT ã¯ã€HTTPS ã® NTLM ã¾ãŸã¯ Kerberos ã§ã®æŽ¥ç¶šæ™‚ã«ã®ã¿ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:244 +msgid "``Service\\Auth\\CbtHardeningLevel`` - specifies whether channel binding tokens are not verified (None), verified but not required (Relaxed), or verified and required (Strict). CBT is only used when connecting with NT LAN Manager (NTLM) or Kerberos over HTTPS." +msgstr "``Service\\Auth\\CbtHardeningLevel``: ãƒãƒ£ãƒ³ãƒãƒ«ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãƒˆãƒ¼ã‚¯ãƒ³ã‚’検証ã—ãªã„ (None)ã€æ¤œè¨¼æ¸ˆã¿ã ãŒå¿…è¦ãªã„ (Relaxed)ã€æ¤œè¨¼æ¸ˆã¿ã§å¿…è¦ (Strict) ã®ã„ãšã‚Œã‹ã‚’指定ã—ã¾ã™ã€‚CBT ã¯ã€HTTPS ã® NT LAN Manager (NTLM) ã¾ãŸã¯ Kerberos ã§ã®æŽ¥ç¶šæ™‚ã«ã®ã¿ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:302 -msgid "``Service\\CertificateThumbprint``: This is the thumbprint of the certificate used to encrypt the TLS channel used with CredSSP authentication. By default this is empty; a self-signed certificate is generated when the WinRM service starts and is used in the TLS process." -msgstr "``Service\\CertificateThumbprint``: ã“ã‚Œã¯ã€CredSSP èªè¨¼ã§ä½¿ç”¨ã•ã‚Œã‚‹ TLS ãƒãƒ£ãƒ³ãƒãƒ«ã®æš—å·åŒ–ã«ä½¿ç”¨ã•ã‚Œã‚‹è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントã§ã™ã€‚デフォルトã§ã¯ã€ã“ã‚Œã¯ç©ºã§ã™ã€‚自己署å証明書ã¯ã€WinRM サービスã®èµ·å‹•æ™‚ã«ç”Ÿæˆã•ã‚Œã€TLS プãƒã‚»ã‚¹ã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:246 +msgid "``Service\\CertificateThumbprint`` - thumbprint of the certificate for encrypting the TLS channel used with CredSSP authentication. By default, this is empty. A self-signed certificate is generated when the WinRM service starts and is used in the TLS process." +msgstr "``Service\\CertificateThumbprint``: CredSSP èªè¨¼ã§ä½¿ç”¨ã•ã‚Œã‚‹ TLS ãƒãƒ£ãƒ³ãƒãƒ«ã®æš—å·åŒ–ã«ä½¿ç”¨ã•ã‚Œã‚‹è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントã§ã™ã€‚デフォルトã§ã¯ã€ã“ã‚Œã¯ç©ºã§ã™ã€‚自己署å証明書ã¯ã€WinRM サービスã®èµ·å‹•æ™‚ã«ç”Ÿæˆã•ã‚Œã€TLS プãƒã‚»ã‚¹ã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:307 -msgid "``Winrs\\MaxShellRunTime``: This is the maximum time, in milliseconds, that a remote command is allowed to execute." +#: ../../rst/os_guide/windows_setup.rst:248 +msgid "``Winrs\\MaxShellRunTime`` - maximum time, in milliseconds, that a remote command is allowed to execute." msgstr "``Winrs\\MaxShellRunTime``: リモートコマンドã®å®Ÿè¡Œã‚’許å¯ã™ã‚‹æœ€å¤§æ™‚間をミリ秒å˜ä½ã§æŒ‡å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:310 -msgid "``Winrs\\MaxMemoryPerShellMB``: This is the maximum amount of memory allocated per shell, including the shell's child processes." -msgstr "``Winrs\\MaxMemoryPerShellMB``: シェルã®åプãƒã‚»ã‚¹ã‚’å«ã‚ã€ã‚·ã‚§ãƒ«ã”ã¨ã«å‰²ã‚Šå½“ã¦ã‚‰ã‚Œã‚‹ãƒ¡ãƒ¢ãƒªãƒ¼ã®æœ€å¤§é‡ã§ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:250 +msgid "``Winrs\\MaxMemoryPerShellMB`` - maximum amount of memory allocated per shell, including its child processes." +msgstr "``Winrs\\MaxMemoryPerShellMB``: シェルã®åプãƒã‚»ã‚¹ãªã©ã€ã‚·ã‚§ãƒ«ã”ã¨ã«å‰²ã‚Šå½“ã¦ã‚‰ã‚Œã‚‹ãƒ¡ãƒ¢ãƒªãƒ¼ã®æœ€å¤§é‡ã§ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:313 -msgid "To modify a setting under the ``Service`` key in PowerShell:" -msgstr "PowerShell ã® ``Service`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:252 +msgid "To modify a setting under the ``Service`` key in PowerShell, you need to provide a path to the option after ``winrm/config/Service``:" +msgstr "PowerShell ã® ``Service`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€``winrm/config/Service`` ã®å¾Œã« オプションã¸ã®ãƒ‘スを指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:323 -msgid "To modify a setting under the ``Winrs`` key in PowerShell:" -msgstr "PowerShell ã® ``Winrs`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:258 +msgid "For example, to change ``Service\\Auth\\CbtHardeningLevel``:" +msgstr "ãŸã¨ãˆã°ã€``Service\\Auth\\CbtHardeningLevel`` を変更ã™ã‚‹ã«ã¯ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:333 -msgid "If running in a domain environment, some of these options are set by GPO and cannot be changed on the host itself. When a key has been configured with GPO, it contains the text ``[Source=\"GPO\"]`` next to the value." -msgstr "ドメイン環境ã§å‹•ä½œã—ã¦ã„ã‚‹å ´åˆã€ã“れらã®ã‚ªãƒ—ションã®ä¸€éƒ¨ã¯ GPO ã«ã‚ˆã£ã¦è¨å®šã•ã‚Œã€ãƒ›ã‚¹ãƒˆè‡ªä½“ã§ã¯å¤‰æ›´ã§ãã¾ã›ã‚“。GPO ã§è¨å®šã•ã‚ŒãŸã‚ーã«ã¯ã€å€¤ã®æ¨ªã« ``[Source=\"GPO\"]`` ã¨ã„ã†ãƒ†ã‚ストãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:264 +msgid "To modify a setting under the ``Winrs`` key in PowerShell, you need to provide a path to the option after ``winrm/config/Winrs``:" +msgstr "PowerShell ã® ``Winrs`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€``winrm/config/Winrs`` ã®å¾Œã« オプションã¸ã®ãƒ‘スを指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:338 +#: ../../rst/os_guide/windows_setup.rst:270 +msgid "For example, to change ``Winrs\\MaxShellRunTime``:" +msgstr "ãŸã¨ãˆã°ã€``Winrs\\MaxShellRunTime`` を変更ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:276 +msgid "If you run the command in a domain environment, some of these options are set by GPO and cannot be changed on the host itself. When you configured a key with GPO, it contains the text ``[Source=\"GPO\"]`` next to the value." +msgstr "ドメイン環境ã§å‹•ä½œã—ã¦ã„ã‚‹å ´åˆã«ã¯ã€ã“れらã®ã‚ªãƒ—ションã®ä¸€éƒ¨ã¯ GPO ã«ã‚ˆã£ã¦è¨å®šã•ã‚Œã€ãƒ›ã‚¹ãƒˆè‡ªä½“ã§ã¯å¤‰æ›´ã§ãã¾ã›ã‚“。GPO ã§è¨å®šã•ã‚ŒãŸã‚ーã«ã¯ã€å€¤ã®æ¨ªã« ``[Source=\"GPO\"]`` ã¨ã„ã†ãƒ†ã‚ストãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:280 msgid "Common WinRM Issues" msgstr "一般的㪠WinRM ã®å•é¡Œ" -#: ../../rst/os_guide/windows_setup.rst:339 -msgid "Because WinRM has a wide range of configuration options, it can be difficult to setup and configure. Because of this complexity, issues that are shown by Ansible could in fact be issues with the host setup instead." -msgstr "WinRM ã«ã¯ã•ã¾ã–ã¾ãªè¨å®šã‚ªãƒ—ションãŒã‚ã‚‹ãŸã‚ã€ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—ã‚„è¨å®šãŒé›£ã—ã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ãã®ãŸã‚ã€Ansible ã§è¡¨ç¤ºã•ã‚Œã‚‹å•é¡ŒãŒã€å®Ÿéš›ã«ã¯ãƒ›ã‚¹ãƒˆã®è¨å®šã®å•é¡Œã§ã‚ã‚‹å¯èƒ½æ€§ã‚‚ã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:281 +msgid "WinRM has a wide range of configuration options, which makes its configuration complex. As a result, errors that Ansible displays could in fact be problems with the host setup instead." +msgstr "WinRM ã«ã¯ã•ã¾ã–ã¾ãªè¨å®šã‚ªãƒ—ションãŒã‚ã‚Šã€ãã®è¨å®šãŒè¤‡é›‘ã«ãªã‚‹ã®ã§ã€Ansible ãŒè¡¨ç¤ºã™ã‚‹ã‚¨ãƒ©ãƒ¼ã¯ã€å®Ÿéš›ã«ã¯ãƒ›ã‚¹ãƒˆã®è¨å®šã«å•é¡ŒãŒã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:343 -msgid "One easy way to determine whether a problem is a host issue is to run the following command from another Windows host to connect to the target Windows host:" +#: ../../rst/os_guide/windows_setup.rst:283 +msgid "To identify a host issue, run the following command from another Windows host to connect to the target Windows host." msgstr "å•é¡ŒãŒãƒ›ã‚¹ãƒˆã®å•é¡Œã§ã‚ã‚‹ã‹ã©ã†ã‹ã‚’判æ–ã™ã‚‹ç°¡å˜ãªæ–¹æ³•ã¨ã—ã¦ã€åˆ¥ã® Windows ホストã‹ã‚‰æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¦ã€å¯¾è±¡ã® Windows ホストã«æŽ¥ç¶šã™ã‚‹æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:363 -msgid "If this fails, the issue is probably related to the WinRM setup. If it works, the issue may not be related to the WinRM setup; please continue reading for more troubleshooting suggestions." -msgstr "失敗ã—ãŸå ´åˆã¯ã€WinRM ã®è¨å®šã«å•é¡ŒãŒã‚ã‚‹ã¨æ€ã‚ã‚Œã¾ã™ã€‚æˆåŠŸã—ãŸå ´åˆã¯ã€å•é¡ŒãŒ WinRM ã®è¨å®šã«é–¢é€£ã—ã¦ã„ãªã„å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã•ã‚‰ã«è©³ã—ã„トラブルシューティングã®æ–¹æ³•ã‚’ã”確èªãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:285 +msgid "To test HTTP:" +msgstr "HTTP をテストã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:366 +#: ../../rst/os_guide/windows_setup.rst:291 +msgid "To test HTTPS:" +msgstr "HTTPS をテストã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:297 +msgid "The command will fail if the certificate is not verifiable." +msgstr "証明書ãŒæ¤œè¨¼ã§ããªã„å ´åˆã€ã‚³ãƒžãƒ³ãƒ‰ã¯å¤±æ•—ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:299 +msgid "To test HTTPS ignoring certificate verification:" +msgstr "証明書ã®æ¤œè¨¼ã‚’無視ã™ã‚‹ HTTPS をテストã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:310 +msgid "If any of the above commands fail, the issue is probably related to the WinRM setup." +msgstr "上記ã®ã‚³ãƒžãƒ³ãƒ‰ã®ã„ãšã‚Œã‹ãŒå¤±æ•—ã—ãŸå ´åˆã«ã¯ã€å•é¡Œã¯ WinRM è¨å®šã«é–¢é€£ã—ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:313 msgid "HTTP 401/Credentials Rejected" msgstr "HTTP 401/èªè¨¼æƒ…å ±ã®æ‹’å¦" -#: ../../rst/os_guide/windows_setup.rst:367 -msgid "A HTTP 401 error indicates the authentication process failed during the initial connection. Some things to check for this are:" -msgstr "HTTP 401 エラーã¯ã€æœ€åˆã®æŽ¥ç¶šæ™‚ã«èªè¨¼ãƒ—ãƒã‚»ã‚¹ãŒå¤±æ•—ã—ãŸã“ã¨ã‚’示ã—ã¾ã™ã€‚ã“れを確èªã™ã‚‹ãŸã‚ã®ã„ãã¤ã‹ã®é …ç›®ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:314 +msgid "An HTTP 401 error indicates the authentication process failed during the initial connection. You can check the following to troubleshoot:" +msgstr "HTTP 401 エラーã¯ã€æœ€åˆã®æŽ¥ç¶šæ™‚ã«èªè¨¼ãƒ—ãƒã‚»ã‚¹ãŒå¤±æ•—ã—ãŸã“ã¨ã‚’示ã—ã¾ã™ã€‚以下ã®é …目を確èªã—ã¦ã€ãƒˆãƒ©ãƒ–ルシューティングã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:370 -msgid "Verify that the credentials are correct and set properly in your inventory with ``ansible_user`` and ``ansible_password``" -msgstr "``ansible_user`` ãŠã‚ˆã³ ``ansible_password`` を使用ã—ã¦ã€èªè¨¼æƒ…å ±ãŒæ£ã—ãã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«é©åˆ‡ã«è¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:317 +msgid "The credentials are correct and set properly in your inventory with the ``ansible_user`` and ``ansible_password`` variables." +msgstr "``ansible_user`` ãŠã‚ˆã³ ``ansible_password`` 変数を使用ã—ã¦ã€èªè¨¼æƒ…å ±ãŒæ£ã—ãã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«é©åˆ‡ã«è¨å®šã•ã‚Œã¦ã„る。" -#: ../../rst/os_guide/windows_setup.rst:373 -msgid "Ensure that the user is a member of the local Administrators group or has been explicitly granted access (a connection test with the ``winrs`` command can be used to rule this out)." -msgstr "ユーザーãŒãƒãƒ¼ã‚«ãƒ«ã® Administrators グループã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã‚ã‚‹ã‹ã€æ˜Žç¤ºçš„ã«ã‚¢ã‚¯ã‚»ã‚¹ã‚’許å¯ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„ (``winrs`` コマンドã«ã‚ˆã‚‹æŽ¥ç¶šãƒ†ã‚¹ãƒˆã§é™¤å¤–ã§ãã¾ã™)。" +#: ../../rst/os_guide/windows_setup.rst:319 +msgid "The user is a member of the local Administrators group, or has been explicitly granted access. You can perform a connection test with the ``winrs`` command to rule this out." +msgstr "ユーザーãŒãƒãƒ¼ã‚«ãƒ«ã® Administrators グループã®ãƒ¡ãƒ³ãƒãƒ¼ã§ã‚ã‚‹ã‹ã€æ˜Žç¤ºçš„ã«ã‚¢ã‚¯ã‚»ã‚¹ã‚’許å¯ã•ã‚Œã¦ã„る。ã“ã‚Œã¯ã€``winrs`` コマンドã«ã‚ˆã‚‹æŽ¥ç¶šãƒ†ã‚¹ãƒˆã§é™¤å¤–ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:377 -msgid "Make sure that the authentication option set by ``ansible_winrm_transport`` is enabled under ``Service\\Auth\\*``" -msgstr "``ansible_winrm_transport`` ã§è¨å®šã—ãŸèªè¨¼ã‚ªãƒ—ションãŒã€``Service\\Auth\\*`` ã§æœ‰åŠ¹ã«ãªã£ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:321 +msgid "The authentication option set by the ``ansible_winrm_transport`` variable is enabled under ``Service\\Auth\\*``." +msgstr "``ansible_winrm_transport`` ã§è¨å®šã—ãŸèªè¨¼ã‚ªãƒ—ションãŒã€``Service\\Auth\\*`` ã§æœ‰åŠ¹ã«ãªã£ã¦ã„る。" -#: ../../rst/os_guide/windows_setup.rst:380 -msgid "If running over HTTP and not HTTPS, use ``ntlm``, ``kerberos`` or ``credssp`` with ``ansible_winrm_message_encryption: auto`` to enable message encryption. If using another authentication option or if the installed pywinrm version cannot be upgraded, the ``Service\\AllowUnencrypted`` can be set to ``true`` but this is only recommended for troubleshooting" -msgstr "HTTPS ã§ã¯ãªã HTTP ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` 㨠``ansible_winrm_message_encryption: auto`` を使用ã—ã¦ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®æš—å·åŒ–を有効ã«ã—ã¦ãã ã•ã„。他ã®èªè¨¼ã‚ªãƒ—ションを使用ã—ã¦ã„ã‚‹å ´åˆã‚„ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ pywinrm ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’アップグレードã§ããªã„å ´åˆã¯ã€``Service\\AllowUnencrypted`` ã‚’``true`` ã«è¨å®šã§ãã¾ã™ãŒã€ã“ã‚Œã¯ãƒˆãƒ©ãƒ–ルシューティングã®ãŸã‚ã«ã®ã¿æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:323 +msgid "If running over HTTP and not HTTPS, use ``ntlm``, ``kerberos`` or ``credssp`` with the ``ansible_winrm_message_encryption: auto`` custom inventory variable to enable message encryption. If you use another authentication option, or if it is not possible to upgrade the installed ``pywinrm`` package, you can set ``Service\\AllowUnencrypted`` to ``true``. This is recommended only for troubleshooting." +msgstr "HTTPS ã§ã¯ãªã HTTP ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` を使用ã—ã¦ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®æš—å·åŒ–を有効ã«ã—ã¾ã™ã€‚別ã®èªè¨¼ã‚ªãƒ—ションを使用ã™ã‚‹å ´åˆã€ã¾ãŸã¯ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸ ``pywinrm`` パッケージをアップグレードã§ããªã„å ´åˆã«ã¯ã€``Service\\AllowUnencrypted`` ã‚’ ``true`` ã«è¨å®šã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒˆãƒ©ãƒ–ルシューティングã®ç›®çš„ã§ã®ã¿æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:386 -msgid "Ensure the downstream packages ``pywinrm``, ``requests-ntlm``, ``requests-kerberos``, and/or ``requests-credssp`` are up to date using ``pip``." -msgstr "ダウンストリームパッケージã§ã‚ã‚‹ ``pywinrm``ã€``requests-ntlm``ã€``requests-kerberos``ã€ã¾ãŸã¯ ``requests-credssp``ã€ã‚‚ã—ãã¯ãã®çµ„ã¿åˆã‚ã›ãŒ ``pip`` を使用ã—ã¦æœ€æ–°ã®çŠ¶æ…‹ã«ãªã£ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:325 +msgid "The downstream packages ``pywinrm``, ``requests-ntlm``, ``requests-kerberos``, and/or ``requests-credssp`` are up to date using ``pip``." +msgstr "ダウンストリームパッケージã§ã‚ã‚‹ ``pywinrm``ã€``requests-ntlm``ã€``requests-kerberos``ã€ã¾ãŸã¯ ``requests-credssp``ã€ã‚‚ã—ãã¯ãã®çµ„ã¿åˆã‚ã›ãŒ ``pip`` を使用ã—ã¦æœ€æ–°ã®çŠ¶æ…‹ã«ãªã£ã¦ã„る。" -#: ../../rst/os_guide/windows_setup.rst:389 -msgid "If using Kerberos authentication, ensure that ``Service\\Auth\\CbtHardeningLevel`` is not set to ``Strict``." +#: ../../rst/os_guide/windows_setup.rst:327 +msgid "For Kerberos authentication, ensure that ``Service\\Auth\\CbtHardeningLevel`` is not set to ``Strict``." msgstr "Kerberos èªè¨¼ã‚’使用ã™ã‚‹å ´åˆã¯ã€``Service\\Auth\\CbtHardeningLevel`` ㌠``Strict`` ã«è¨å®šã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:392 -msgid "When using Basic or Certificate authentication, make sure that the user is a local account and not a domain account. Domain accounts do not work with Basic and Certificate authentication." -msgstr "Basic èªè¨¼ã‚„ Certificate èªè¨¼ã‚’使用ã™ã‚‹éš›ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒãƒ‰ãƒ¡ã‚¤ãƒ³ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã§ã¯ãªãã€ãƒãƒ¼ã‚«ãƒ«ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ドメインアカウントã¯ã€Basic èªè¨¼ã‚„ Certificate èªè¨¼ã§ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" +#: ../../rst/os_guide/windows_setup.rst:329 +msgid "For Basic or Certificate authentication, make sure that the user is a local account. Domain accounts do not work with Basic and Certificate authentication." +msgstr "Basic èªè¨¼ã‚„ Certificate èªè¨¼ã‚’使用ã™ã‚‹å ´åˆã¯ã€ãƒãƒ¼ã‚«ãƒ«ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ドメインアカウントã¯ã€Basic èªè¨¼ã‚„ Certificate èªè¨¼ã§ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_setup.rst:397 +#: ../../rst/os_guide/windows_setup.rst:332 msgid "HTTP 500 Error" msgstr "HTTP 500 Error" -#: ../../rst/os_guide/windows_setup.rst:398 -msgid "These indicate an error has occurred with the WinRM service. Some things to check for include:" -msgstr "ã“れらã¯ã€WinRM サービスã§ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—ãŸã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚確èªã™ã¹ã点ã¯ä»¥ä¸‹ã®é€šã‚Šã§ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:333 +msgid "An HTTP 500 error indicates a problem with the WinRM service. You can check the following to troubleshoot:" +msgstr "HTTP 500 エラーã¯ã€WinRM サービスã«å•é¡ŒãŒã‚ã‚‹ã“ã¨ã‚’示ã—ã¾ã™ã€‚以下を確èªã—ã¦ãƒˆãƒ©ãƒ–ルシューティングを行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:401 -msgid "Verify that the number of current open shells has not exceeded either ``WinRsMaxShellsPerUser`` or any of the other Winrs quotas haven't been exceeded." -msgstr "ç¾åœ¨ã®ã‚ªãƒ¼ãƒ—ンシェルã®æ•°ãŒ ``WinRsMaxShellsPerUser`` ã®ã©ã¡ã‚‰ã‹ã‚’超ãˆã¦ã„ãªã„ã‹ã€ã¾ãŸã¯ä»–ã® Winrs ã®ã‚¯ã‚©ãƒ¼ã‚¿ã‚’超ãˆã¦ã„ãªã„ã‹ã‚’確èªã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:335 +msgid "The number of your currently open shells has not exceeded either ``WinRsMaxShellsPerUser``. Alternatively, you did not exceed any of the other Winrs quotas." +msgstr "ç¾åœ¨é–‹ã„ã¦ã„るシェルã®æ•°ãŒ ``WinRsMaxShellsPerUser`` を超ãˆã¦ã„ãªã„ã‹ã€ä»–ã® Winrs クォータを超ãˆã¦ã„ã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_setup.rst:406 +#: ../../rst/os_guide/windows_setup.rst:338 msgid "Timeout Errors" msgstr "タイムアウトエラー" -#: ../../rst/os_guide/windows_setup.rst:407 -msgid "These usually indicate an error with the network connection where Ansible is unable to reach the host. Some things to check for include:" -msgstr "ã“れらã¯é€šå¸¸ã€Ansible ãŒãƒ›ã‚¹ãƒˆã«åˆ°é”ã§ããªã„ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯æŽ¥ç¶šã®ã‚¨ãƒ©ãƒ¼ã‚’示ã—ã¦ã„ã¾ã™ã€‚ãƒã‚§ãƒƒã‚¯é …ç›®ã«ã¯ä»¥ä¸‹ãŒå«ã¾ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:339 +msgid "Sometimes Ansible is unable to reach the host. These instances usually indicate a problem with the network connection. You can check the following to troubleshoot:" +msgstr "Ansible ãŒãƒ›ã‚¹ãƒˆã«åˆ°é”ã§ããªã„ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“れらã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã¯é€šå¸¸ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯æŽ¥ç¶šã«å•é¡ŒãŒã‚ã‚‹ã“ã¨ã‚’示ã—ã¾ã™ã€‚以下を確èªã—ã¦ãƒˆãƒ©ãƒ–ルシューティングを行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:410 -msgid "Make sure the firewall is not set to block the configured WinRM listener ports" -msgstr "ファイアウォールãŒã€è¨å®šã•ã‚ŒãŸ WinRM リスナーãƒãƒ¼ãƒˆã‚’ブãƒãƒƒã‚¯ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ãªã„ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:341 +msgid "The firewall is not set to block the configured WinRM listener ports." +msgstr "ファイアウォールãŒã€è¨å®šã•ã‚ŒãŸ WinRM リスナーãƒãƒ¼ãƒˆã‚’ブãƒãƒƒã‚¯ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ãªã„。" -#: ../../rst/os_guide/windows_setup.rst:411 -msgid "Ensure that a WinRM listener is enabled on the port and path set by the host vars" -msgstr "WinRM リスナーãŒã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ã«ã‚ˆã£ã¦è¨å®šã•ã‚ŒãŸãƒãƒ¼ãƒˆãŠã‚ˆã³ãƒ‘スã§æœ‰åŠ¹ã«ãªã£ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:342 +msgid "A WinRM listener is enabled on the port and path set by the host vars." +msgstr "WinRM リスナーãŒã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ã«ã‚ˆã£ã¦è¨å®šã•ã‚ŒãŸãƒãƒ¼ãƒˆãŠã‚ˆã³ãƒ‘スã§æœ‰åŠ¹ã«ãªã£ã¦ã„る。" -#: ../../rst/os_guide/windows_setup.rst:412 -msgid "Ensure that the ``winrm`` service is running on the Windows host and configured for automatic start" -msgstr "Windows ホスト上㧠``winrm`` サービスãŒç¨¼å‹•ã—ã¦ãŠã‚Šã€è‡ªå‹•èµ·å‹•ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:343 +msgid "The ``winrm`` service is running on the Windows host and is configured for the automatic start." +msgstr "Windows ホスト上㧠``winrm`` サービスãŒç¨¼å‹•ã—ã¦ãŠã‚Šã€è‡ªå‹•èµ·å‹•ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„る。" -#: ../../rst/os_guide/windows_setup.rst:416 +#: ../../rst/os_guide/windows_setup.rst:346 msgid "Connection Refused Errors" msgstr "接続拒å¦ã‚¨ãƒ©ãƒ¼" -#: ../../rst/os_guide/windows_setup.rst:417 -msgid "These usually indicate an error when trying to communicate with the WinRM service on the host. Some things to check for:" -msgstr "ã“れらã¯é€šå¸¸ã€ãƒ›ã‚¹ãƒˆä¸Šã® WinRM サービスã¨é€šä¿¡ã—よã†ã¨ã™ã‚‹éš›ã«ã‚¨ãƒ©ãƒ¼ã‚’示ã—ã¾ã™ã€‚ã„ãã¤ã‹ã®ãƒã‚§ãƒƒã‚¯é …ç›®ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:347 +msgid "When you communicate with the WinRM service on the host you can encounter some problems. Check the following to help the troubleshooting:" +msgstr "ホスト㮠WinRM サービスã¨é€šä¿¡ã™ã‚‹ã¨ã€ã„ãã¤ã‹ã®å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚トラブルシューティングを行ã†ã«ã¯ã€ä»¥ä¸‹ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:420 -msgid "Ensure that the WinRM service is up and running on the host. Use ``(Get-Service -Name winrm).Status`` to get the status of the service." -msgstr "ホスト上㧠WinRM サービスãŒç¨¼åƒã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚``(Get-Service -Name winrm).Status`` を使用ã—ã¦ã€ã‚µãƒ¼ãƒ“スã®ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚’å–å¾—ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:349 +msgid "The WinRM service is up and running on the host. Use the ``(Get-Service -Name winrm).Status`` command to get the status of the service." +msgstr "ホスト上㧠WinRM サービスãŒç¨¼åƒã—ã¦ã„る。``(Get-Service -Name winrm).Status`` コマンドを使用ã—ã¦ã€ã‚µãƒ¼ãƒ“スã®ã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚’å–å¾—ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:422 -msgid "Check that the host firewall is allowing traffic over the WinRM port. By default this is ``5985`` for HTTP and ``5986`` for HTTPS." -msgstr "ホストå´ã®ãƒ•ã‚¡ã‚¤ã‚¢ã‚¦ã‚©ãƒ¼ãƒ«ãŒã€WinRM ãƒãƒ¼ãƒˆã¸ã®ãƒˆãƒ©ãƒ•ã‚£ãƒƒã‚¯ã‚’許å¯ã—ã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚デフォルトã§ã¯ã€HTTP ã§ã¯ ``5985``ã€HTTPS ã§ã¯ ``5986`` ã¨ãªã£ã¦ã„ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:350 +msgid "The host firewall is allowing traffic over the WinRM port. By default this is ``5985`` for HTTP and ``5986`` for HTTPS." +msgstr "ホストå´ã®ãƒ•ã‚¡ã‚¤ã‚¢ã‚¦ã‚©ãƒ¼ãƒ«ãŒã€WinRM ãƒãƒ¼ãƒˆã¸ã®ãƒˆãƒ©ãƒ•ã‚£ãƒƒã‚¯ã‚’許å¯ã—ã¦ã„る。デフォルトã§ã¯ã€HTTP ã§ã¯ ``5985``ã€HTTPS ã§ã¯ ``5986`` ã¨ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:425 -msgid "Sometimes an installer may restart the WinRM or HTTP service and cause this error. The best way to deal with this is to use ``win_psexec`` from another Windows host." -msgstr "インストーラー㌠WinRM ã‚„ HTTP サービスをå†èµ·å‹•ã—ã¦ã—ã¾ã„ã€ã“ã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«å¯¾å‡¦ã™ã‚‹æœ€è‰¯ã®æ–¹æ³•ã¯ã€åˆ¥ã® Windows ホストã‹ã‚‰ ``win_psexec`` を使用ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:352 +msgid "Sometimes an installer may restart the WinRM or HTTP service and cause this error. The best way to deal with this is to use the ``win_psexec`` module from another Windows host." +msgstr "インストーラー㌠WinRM ã‚„ HTTP サービスをå†èµ·å‹•ã—ã¦ã—ã¾ã„ã€ã“ã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«å¯¾å‡¦ã™ã‚‹æœ€è‰¯ã®æ–¹æ³•ã¯ã€åˆ¥ã® Windows ホストã‹ã‚‰ ``win_psexec`` モジュールを使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:430 +#: ../../rst/os_guide/windows_setup.rst:355 msgid "Failure to Load Builtin Modules" msgstr "組ã¿è¾¼ã¿ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®èªã¿è¾¼ã¿ã«å¤±æ•—" -#: ../../rst/os_guide/windows_setup.rst:431 -msgid "If powershell fails with an error message similar to ``The 'Out-String' command was found in the module 'Microsoft.PowerShell.Utility', but the module could not be loaded.`` then there could be a problem trying to access all the paths specified by the ``PSModulePath`` environment variable. A common cause of this issue is that the ``PSModulePath`` environment variable contains a UNC path to a file share and because of the double hop/credential delegation issue the Ansible process cannot access these folders. The way around this problems is to either:" -msgstr "``The 'Out-String' command was found in the module 'Microsoft.PowerShell.Utility', but the module could not be loaded.`` ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã§ powershell ãŒå¤±æ•—ã™ã‚‹å ´åˆã¯ã€``PSModulePath`` 環境変数ã§æŒ‡å®šã•ã‚ŒãŸã™ã¹ã¦ã®ãƒ‘スã«ã‚¢ã‚¯ã‚»ã‚¹ã—よã†ã¨ã™ã‚‹ã¨å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®å•é¡Œã®ä¸€èˆ¬çš„ãªåŽŸå› ã¯ã€``PSModulePath`` 環境変数ã«ãƒ•ã‚¡ã‚¤ãƒ«å…±æœ‰ã¸ã® UNC パスãŒå«ã¾ã‚Œã¦ãŠã‚Šã€ãƒ€ãƒ–ルホップ/èªè¨¼æƒ…å ±ã®å§”è²å•é¡Œã®ãŸã‚ã« Ansible プãƒã‚»ã‚¹ãŒã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããªã„ã“ã¨ã§ã™ã€‚ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:356 +msgid "Sometimes PowerShell fails with an error message similar to:" +msgstr "PowerShell ãŒä»¥ä¸‹ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã§å¤±æ•—ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:362 +msgid "In that case, there could be a problem when trying to access all the paths specified by the ``PSModulePath`` environment variable." +msgstr "ã“ã®å ´åˆã€``PSModulePath`` 環境変数ãŒæŒ‡å®šã—ãŸã™ã¹ã¦ã®ãƒ‘スã«ã‚¢ã‚¯ã‚»ã‚¹ã—よã†ã¨ã™ã‚‹ã¨å•é¡ŒãŒç”Ÿã˜ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:437 -msgid "Remove the UNC path from the ``PSModulePath`` environment variable, or" -msgstr "``PSModulePath`` 環境変数ã‹ã‚‰ UNC パスを削除ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:364 +msgid "A common cause of this issue is that ``PSModulePath`` contains a Universal Naming Convention (UNC) path to a file share. Additionally, the double hop/credential delegation issue causes that the Ansible process cannot access these folders. To work around this problem is to either:" +msgstr "ã“ã®å•é¡Œã®ä¸€èˆ¬çš„ãªåŽŸå› ã¯ã€``PSModulePath``ファイル共有ã¸ã®æ±Žç”¨å‘½åè¦å‰‡ (UNC) パスãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã•ã‚‰ã«ã€ãƒ€ãƒ–ルホップ/èªè¨¼æƒ…å ±ã®å§”ä»»ã®å•é¡Œã«ã‚ˆã‚Šã€Ansible プãƒã‚»ã‚¹ãŒã“れらã®ãƒ•ã‚©ãƒ«ãƒ€ãƒ¼ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããªããªã‚Šã¾ã™ã€‚ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ã€æ¬¡ã®ã„ãšã‚Œã‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:438 -msgid "Use an authentication option that supports credential delegation like ``credssp`` or ``kerberos`` with credential delegation enabled" -msgstr "èªè¨¼æƒ…å ±ã®å§”è²ã‚’有効ã«ã—㟠``credssp`` ã‚„ ``kerberos`` ã®ã‚ˆã†ãªã€èªè¨¼æƒ…å ±ã®å§”è²ã‚’サãƒãƒ¼ãƒˆã™ã‚‹èªè¨¼ã‚ªãƒ—ションを使用ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:366 +msgid "Remove the UNC path from ``PSModulePath``." +msgstr "``PSModulePath`` ã‹ã‚‰ UNC パスを削除ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:368 +msgid "or" +msgstr "ã¾ãŸã¯" -#: ../../rst/os_guide/windows_setup.rst:440 +#: ../../rst/os_guide/windows_setup.rst:370 +msgid "Use an authentication option that supports credential delegation like ``credssp`` or ``kerberos``. You need to have the credential delegation enabled." +msgstr "``credssp`` ã‚„ ``kerberos`` ã®ã‚ˆã†ãªã€èªè¨¼æƒ…å ±ã®å§”è²ã‚’サãƒãƒ¼ãƒˆã™ã‚‹èªè¨¼ã‚ªãƒ—ションを使用ã—ã¾ã™ã€‚èªè¨¼æƒ…å ±ã®å§”è²ã‚’有効ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:372 msgid "See `KB4076842 <https://support.microsoft.com/en-us/help/4076842>`_ for more information on this problem." msgstr "ã“ã®å•é¡Œã®è©³ç´°ã¯ã€ã€Œ`KB4076842 <https://support.microsoft.com/en-us/help/4076842>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:443 +#: ../../rst/os_guide/windows_setup.rst:375 msgid "Windows SSH Setup" msgstr "Windows SSH ã®è¨å®š" -#: ../../rst/os_guide/windows_setup.rst:444 +#: ../../rst/os_guide/windows_setup.rst:376 msgid "Ansible 2.8 has added an experimental SSH connection for Windows managed nodes." msgstr "Ansible 2.8 ã§ã¯ã€Windows 管ç†ãƒŽãƒ¼ãƒ‰ã®å®Ÿé¨“的㪠SSH 接続ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/os_guide/windows_setup.rst:447 -msgid "Use this feature at your own risk! Using SSH with Windows is experimental, the implementation may make backwards incompatible changes in feature releases. The server side components can be unreliable depending on the version that is installed." +#: ../../rst/os_guide/windows_setup.rst:379 +msgid "Use this feature at your own risk! Using SSH with Windows is experimental. This implementation may make backwards incompatible changes in future releases. The server-side components can be unreliable depending on your installed version." msgstr "ã“ã®æ©Ÿèƒ½ã¯ã”自身ã®è²¬ä»»ã§ãŠä½¿ã„ãã ã•ã„。Windows ã§ã® SSH ã®ä½¿ç”¨ã¯å®Ÿé¨“çš„ãªã‚‚ã®ã§ã‚ã‚Šã€å®Ÿè£…ã¯æ©Ÿèƒ½ãƒªãƒªãƒ¼ã‚¹ã«ãŠã„ã¦å¾Œæ–¹äº’æ›æ€§ã®ãªã„変更を行ã†å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€ã‚µãƒ¼ãƒãƒ¼å´ã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã‚ˆã£ã¦ã¯ä¿¡é ¼æ€§ã«æ¬ ã‘ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:453 +#: ../../rst/os_guide/windows_setup.rst:383 msgid "Installing OpenSSH using Windows Settings" msgstr "Windows è¨å®šã‚’使用ã—㟠OpenSSH ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/os_guide/windows_setup.rst:454 -msgid "OpenSSH can be used to connect Window 10 clients to Windows Server 2019. OpenSSH Client is available to install on Windows 10 build 1809 and later, while OpenSSH Server is available to install on Windows Server 2019 and later." +#: ../../rst/os_guide/windows_setup.rst:384 +msgid "You can use OpenSSH to connect Window 10 clients to Windows Server 2019. OpenSSH Client is available to install on Windows 10 build 1809 and later. OpenSSH Server is available to install on Windows Server 2019 and later." msgstr "OpenSSH ã¯ã€WinkW 10 クライアントを Windows Server 2019 ã«æŽ¥ç¶šã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚OpenSSH クライアント㯠Windows 10 ビルド 1809 以é™ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ãŒã€OpenSSH Server 㯠Windows Server 2019 以é™ã«åˆ©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:457 -msgid "Please refer `this guide <https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse>`_." -msgstr "`this guide <https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:386 +msgid "For more information, refer to `Get started with OpenSSH for Windows <https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse>`_." +msgstr "詳細ã¯ã€`Get started with OpenSSH for Windows <https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:460 +#: ../../rst/os_guide/windows_setup.rst:389 msgid "Installing Win32-OpenSSH" msgstr "Win32-OpenSSH ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/os_guide/windows_setup.rst:461 -msgid "The first step to using SSH with Windows is to install the `Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ service on the Windows host. Microsoft offers a way to install ``Win32-OpenSSH`` through a Windows capability but currently the version that is installed through this process is too old to work with Ansible. To install ``Win32-OpenSSH`` for use with Ansible, select one of these installation options:" -msgstr "Windows 㧠SSH を利用ã™ã‚‹ãŸã‚ã®æœ€åˆã®ã‚¹ãƒ†ãƒƒãƒ—ã¯ã€Windows ホスト㫠`Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ サービスをインストールã™ã‚‹ã“ã¨ã§ã™ã€‚Microsoft 社ã§ã¯ã€Windows ã®æ©Ÿèƒ½ã‚’利用ã—㦠``Win32-OpenSSH`` をインストールã™ã‚‹æ–¹æ³•ã‚’æä¾›ã—ã¦ã„ã¾ã™ãŒã€ç¾åœ¨ã€ã“ã®æ–¹æ³•ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€Ansible ã§å‹•ä½œã•ã›ã‚‹ã«ã¯å¤ã™ãŽã¾ã™ã€‚Ansible ã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã« ``Win32-OpenSSH`` をインストールã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚ªãƒ—ションã®ã„ãšã‚Œã‹ã‚’é¸æŠžã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:390 +msgid "To install the `Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ service for use with Ansible, select one of these installation options:" +msgstr "Ansible ã§ä½¿ç”¨ã™ã‚‹ `Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ サービスをインストールã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã„ãšã‚Œã‹ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚ªãƒ—ションをé¸æŠžã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:467 -msgid "Manually install the service, following the `install instructions <https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH>`_ from Microsoft." -msgstr "Microsoft 社ãŒæä¾›ã™ã‚‹ `ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ‰‹é † <https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH>`_ ã«å¾“ã£ã¦ã€ã‚µãƒ¼ãƒ“スを手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¦ãã ã•ã„。" +#: ../../rst/os_guide/windows_setup.rst:393 +msgid "Manually install ``Win32-OpenSSH``, following the `install instructions <https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH>`_ from Microsoft." +msgstr "Microsoft 社ãŒæä¾›ã™ã‚‹ `install instructions <https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH>`_ ã«å¾“ã£ã¦ã€``Win32-OpenSSH`` を手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_setup.rst:470 -msgid "Install the `openssh <https://chocolatey.org/packages/openssh>`_ package using Chocolatey:" -msgstr "Chocolatey を使用ã—㦠`openssh <https://chocolatey.org/packages/openssh>`_ パッケージをインストールã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:395 +msgid "Use Chocolatey:" +msgstr "Chocolatey を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:476 -msgid "Use ``win_chocolatey`` to install the service" -msgstr "``win_chocolatey`` を使用ã—ã¦ã‚µãƒ¼ãƒ“スをインストールã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:401 +msgid "Use the ``win_chocolatey`` Ansible module:" +msgstr "Ansibleモジュール ``win_chocolatey`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:486 -msgid "Use an existing Ansible Galaxy role like `jborean93.win_openssh <https://galaxy.ansible.com/jborean93/win_openssh>`_:" -msgstr "`jborean93.win_openssh <https://galaxy.ansible.com/jborean93/win_openssh>`_ ãªã©ã®æ—¢å˜ã® Ansible Galaxy ãƒãƒ¼ãƒ«ã‚’使用ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:411 +msgid "Install an Ansible Galaxy role for example `jborean93.win_openssh <https://galaxy.ansible.com/jborean93/win_openssh>`_:" +msgstr "`jborean93.win_openssh <https://galaxy.ansible.com/jborean93/win_openssh>`_ ãªã©ã® Ansible Galaxy ãƒãƒ¼ãƒ«ã‚’インストールã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:503 -msgid "``Win32-OpenSSH`` is still a beta product and is constantly being updated to include new features and bugfixes. If you are using SSH as a connection option for Windows, it is highly recommend you install the latest release from one of the 3 methods above." -msgstr "``Win32-OpenSSH`` ã¯æœªã ベータ版ã®è£½å“ã§ã‚ã‚Šã€æ–°æ©Ÿèƒ½ã‚„ãƒã‚°ä¿®æ£ã‚’å«ã‚ã¦å¸¸ã«æ›´æ–°ã•ã‚Œã¦ã„ã¾ã™ã€‚Windows 㧠SSH 接続をã”利用ã®æ–¹ã¯ã€ä¸Šè¨˜ 3 ã¤ã®æ–¹æ³•ã‹ã‚‰æœ€æ–°ç‰ˆã‚’インストールã™ã‚‹ã“ã¨ãŒå¼·ã推奨ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:417 +msgid "Use the role in your playbook:" +msgstr "playbook ã®ãƒãƒ¼ãƒ«ã‚’使用ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:428 +msgid "``Win32-OpenSSH`` is still a beta product and is constantly being updated to include new features and bugfixes. If you use SSH as a connection option for Windows, we highly recommend you install the latest version." +msgstr "``Win32-OpenSSH`` ã¯æœªã ベータ版ã®è£½å“ã§ã‚ã‚Šã€æ–°æ©Ÿèƒ½ã‚„ãƒã‚°ä¿®æ£ã‚’å«ã‚ã¦å¸¸ã«æ›´æ–°ã•ã‚Œã¦ã„ã¾ã™ã€‚Windows 㧠SSH 接続をã”利用ã®æ–¹ã¯ã€ä¸Šè¨˜ 3 ã¤ã®æ–¹æ³•ã‹ã‚‰æœ€æ–°ç‰ˆã‚’インストールã™ã‚‹ã“ã¨ã‚’å¼·ã推奨ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:509 +#: ../../rst/os_guide/windows_setup.rst:431 msgid "Configuring the Win32-OpenSSH shell" msgstr "Win32-OpenSSH シェルã®è¨å®š" -#: ../../rst/os_guide/windows_setup.rst:511 -msgid "By default ``Win32-OpenSSH`` will use ``cmd.exe`` as a shell. To configure a different shell, use an Ansible task to define the registry setting:" -msgstr "デフォルトã§ã¯ã€``Win32-OpenSSH`` 㯠``cmd.exe`` をシェルã¨ã—ã¦ä½¿ç”¨ã—ã¾ã™ã€‚別ã®ã‚·ã‚§ãƒ«ã‚’è¨å®šã™ã‚‹ã«ã¯ã€Ansible タスクを使用ã—ã¦ã€ãƒ¬ã‚¸ã‚¹ãƒˆãƒªãƒ¼è¨å®šã‚’定義ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:433 +msgid "By default ``Win32-OpenSSH`` uses ``cmd.exe`` as a shell." +msgstr "デフォルトã§ã¯ã€``Win32-OpenSSH`` ã¯ã‚·ã‚§ãƒ«ã¨ã—㦠``cmd.exe`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:532 +#: ../../rst/os_guide/windows_setup.rst:435 +msgid "To configure a different shell, use an Ansible playbook with a task to define the registry setting:" +msgstr "別ã®ã‚·ã‚§ãƒ«ã‚’è¨å®šã™ã‚‹ã«ã¯ã€Ansible Playbook を使用ã—ã¦ã€ãƒ¬ã‚¸ã‚¹ãƒˆãƒªãƒ¼è¨å®šã‚’定義ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:447 +msgid "To revert the settings back to the default shell:" +msgstr "è¨å®šã‚’デフォルトã®ã‚·ã‚§ãƒ«ã«æˆ»ã™ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:458 msgid "Win32-OpenSSH Authentication" msgstr "Win32-OpenSSH èªè¨¼" -#: ../../rst/os_guide/windows_setup.rst:533 -msgid "Win32-OpenSSH authentication with Windows is similar to SSH authentication on Unix/Linux hosts. You can use a plaintext password or SSH public key authentication, add public keys to an ``authorized_key`` file in the ``.ssh`` folder of the user's profile directory, and configure the service using the ``sshd_config`` file used by the SSH service as you would on a Unix/Linux host." -msgstr "Windows ã§ã® Win32-OpenSSH èªè¨¼ã¯ã€Unix/Linux ホストã§ã® SSH èªè¨¼ã«ä¼¼ã¦ã„ã¾ã™ã€‚平文ã®ãƒ‘スワードã¾ãŸã¯ SSH 公開éµèªè¨¼ã‚’使用ã—ã€å…¬é–‹éµã‚’ユーザーã®ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã® ``.ssh`` ディレクトリーã«ã‚ã‚‹ ``authorized_key`` ファイルã«è¿½åŠ ã—ã€Unix/Linux ホストã¨åŒæ§˜ã« SSH サービスã§ä½¿ç”¨ã•ã‚Œã‚‹ ``sshd_config`` ファイルを使用ã—ã¦ã‚µãƒ¼ãƒ“スをè¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:459 +msgid "Win32-OpenSSH authentication with Windows is similar to SSH authentication on Unix/Linux hosts. You can use a plaintext password or SSH public key authentication." +msgstr "Windows ã§ã® Win32-OpenSSH èªè¨¼ã¯ã€Unix/Linux ホスト㮠SSH èªè¨¼ã«ä¼¼ã¦ã„ã¾ã™ã€‚プレーンテã‚ストã®ãƒ‘スワードã¾ãŸã¯ SSH 公開éµèªè¨¼ã‚’使用ã§ãã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:461 +msgid "For the key-based authentication:" +msgstr "éµãƒ™ãƒ¼ã‚¹èªè¨¼ã®ä½¿ç”¨" + +#: ../../rst/os_guide/windows_setup.rst:463 +msgid "Add your public keys to an ``authorized_key`` file in the ``.ssh`` folder of the user's profile directory." +msgstr "ユーザーã®ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã® ``.ssh`` フォルダーã«ã‚ã‚‹ ``authorized_key`` ファイルã«å…¬é–‹éµã‚’è¿½åŠ ã—ã¾ã™ã€‚" + +#: ../../rst/os_guide/windows_setup.rst:465 +msgid "Configure the SSH service using the ``sshd_config`` file." +msgstr "``sshd_config`` ファイルを使用ã—㦠SSH サービスをè¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:540 -msgid "When using SSH key authentication with Ansible, the remote session won't have access to the user's credentials and will fail when attempting to access a network resource. This is also known as the double-hop or credential delegation issue. There are two ways to work around this issue:" -msgstr "Ansible 㧠SSH ã‚ーèªè¨¼ã‚’使用ã™ã‚‹å ´åˆã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆã‚»ãƒƒã‚·ãƒ§ãƒ³ãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã®èªè¨¼æƒ…å ±ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããšã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒªã‚½ãƒ¼ã‚¹ã«ã‚¢ã‚¯ã‚»ã‚¹ã—よã†ã¨ã™ã‚‹ã¨å¤±æ•—ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ€ãƒ–ルホップやèªè¨¼æƒ…å ±ã®å§”è²ã®å•é¡Œã¨ã—ã¦ã‚‚知られã¦ã„ã¾ã™ã€‚ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ 2 ã¤ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:467 +msgid "When using SSH key authentication with Ansible, the remote session will not have access to user credentials and will fail when attempting to access a network resource. This is also known as the double-hop or credential delegation issue. To work around this problem:" +msgstr "Ansible 㧠SSH ã‚ーèªè¨¼ã‚’使用ã™ã‚‹å ´åˆã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆã‚»ãƒƒã‚·ãƒ§ãƒ³ãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã®èªè¨¼æƒ…å ±ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããšã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒªã‚½ãƒ¼ã‚¹ã«ã‚¢ã‚¯ã‚»ã‚¹ã—よã†ã¨ã™ã‚‹ã¨å¤±æ•—ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ€ãƒ–ルホップやèªè¨¼æƒ…å ±ã®å§”è²ã®å•é¡Œã¨ã—ã¦ã‚‚知られã¦ã„ã¾ã™ã€‚ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:545 -msgid "Use plaintext password auth by setting ``ansible_password``" -msgstr "``ansible_password`` ã‚’è¨å®šã—ã¦å¹³æ–‡ãƒ†ã‚ストã®ãƒ‘スワードèªè¨¼ã‚’使用ã™ã‚‹" +#: ../../rst/os_guide/windows_setup.rst:469 +msgid "Use plaintext password authentication by setting the ``ansible_password`` variable." +msgstr "``ansible_password`` 変数をè¨å®šã—ã¦ã€ãƒ—レーンテã‚ストã®ãƒ‘スワードèªè¨¼ã‚’使用ã™ã‚‹ã€‚" -#: ../../rst/os_guide/windows_setup.rst:546 -msgid "Use ``become`` on the task with the credentials of the user that needs access to the remote resource" -msgstr "リモートリソースã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã‚’å¿…è¦ã¨ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®èªè¨¼æƒ…å ±ã‚’ä½¿ç”¨ã—ã¦ã€ã‚¿ã‚¹ã‚¯ã§ ``become`` を使用ã™ã‚‹" +#: ../../rst/os_guide/windows_setup.rst:470 +msgid "Use the ``become`` directive on the task with the credentials of the user that needs access to the remote resource." +msgstr "リモートリソースã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã‚’å¿…è¦ã¨ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®èªè¨¼æƒ…å ±ã‚’ä½¿ç”¨ã—ã¦ã€ã‚¿ã‚¹ã‚¯ã§ ``become`` ディレクティブを使用ã™ã‚‹ã€‚" -#: ../../rst/os_guide/windows_setup.rst:549 +#: ../../rst/os_guide/windows_setup.rst:473 msgid "Configuring Ansible for SSH on Windows" msgstr "Windows 㧠SSH 用㫠Ansible ã®è¨å®š" -#: ../../rst/os_guide/windows_setup.rst:550 +#: ../../rst/os_guide/windows_setup.rst:474 msgid "To configure Ansible to use SSH for Windows hosts, you must set two connection variables:" msgstr "Ansible ㌠Windows ホスト㫠SSH を使用ã™ã‚‹ã‚ˆã†ã«è¨å®šã™ã‚‹ã«ã¯ã€æŽ¥ç¶šå¤‰æ•°ã‚’ 2 ã¤è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:552 +#: ../../rst/os_guide/windows_setup.rst:476 msgid "set ``ansible_connection`` to ``ssh``" msgstr "``ansible_connection`` ã‚’ ``ssh`` ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:553 +#: ../../rst/os_guide/windows_setup.rst:477 msgid "set ``ansible_shell_type`` to ``cmd`` or ``powershell``" msgstr "``ansible_shell_type`` ã‚’ ``cmd`` ã¾ãŸã¯ ``powershell`` ã«è¨å®šã™ã‚‹" -#: ../../rst/os_guide/windows_setup.rst:555 -msgid "The ``ansible_shell_type`` variable should reflect the ``DefaultShell`` configured on the Windows host. Set to ``cmd`` for the default shell or set to ``powershell`` if the ``DefaultShell`` has been changed to PowerShell." -msgstr "``ansible_shell_type`` 変数ã«ã¯ã€Windows ホストã§è¨å®šã•ã‚Œã¦ã„ã‚‹``DefaultShell`` ã‚’åæ˜ ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚デフォルトシェルã®å ´åˆã¯ ``cmd`` ã«ã€``DefaultShell`` ㌠PowerShell ã«å¤‰æ›´ã—ã¦ã„ã‚‹å ´åˆã¯ ``powershell`` ã«è¨å®šã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:479 +msgid "The ``ansible_shell_type`` variable should reflect the ``DefaultShell`` configured on the Windows host. Set ``ansible_shell_type`` to ``cmd`` for the default shell. Alternatively, set ``ansible_shell_type`` to ``powershell`` if you changed ``DefaultShell`` to PowerShell." +msgstr "``ansible_shell_type`` 変数ã«ã¯ã€Windows ホストã§è¨å®šã•ã‚Œã¦ã„ã‚‹``DefaultShell`` ã‚’åæ˜ ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚デフォルトシェルã®å ´åˆã¯ ``ansible_shell_type`` 㯠``cmd`` ã«è¨å®šã—ã¾ã™ã€‚ã¾ãŸã¯ã€``DefaultShell`` ã‚’ PowerShell ã«å¤‰æ›´ã—ãŸå ´åˆã«ã¯ ``ansible_shell_type`` ã‚’ ``powershell`` ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:560 +#: ../../rst/os_guide/windows_setup.rst:482 msgid "Known issues with SSH on Windows" msgstr "Windows ã§ã® SSH ã«é–¢ã™ã‚‹æ—¢çŸ¥ã®å•é¡Œ" -#: ../../rst/os_guide/windows_setup.rst:561 -msgid "Using SSH with Windows is experimental, and we expect to uncover more issues. Here are the known ones:" -msgstr "Windows ã§ã® SSH ã®ä½¿ç”¨ã¯å®Ÿé¨“çš„ãªã‚‚ã®ã§ã‚ã‚Šã€ã‚ˆã‚Šå¤šãã®å•é¡ŒãŒæ˜Žã‚‰ã‹ã«ãªã‚‹ã“ã¨ã‚’期待ã—ã¦ã„ã¾ã™ã€‚ã“ã“ã§ã¯ã€æ—¢çŸ¥ã®ã‚‚ã®ã‚’紹介ã—ã¾ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:483 +msgid "Using SSH with Windows is experimental. Currently existing issues are:" +msgstr "Windows ã§ã® SSH ã®ä½¿ç”¨ã¯å®Ÿé¨“çš„ãªã‚‚ã®ã§ã™ã€‚ç¾åœ¨ã€æ—¢å˜ã®å•é¡Œã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/os_guide/windows_setup.rst:564 -msgid "Win32-OpenSSH versions older than ``v7.9.0.0p1-Beta`` do not work when ``powershell`` is the shell type" +#: ../../rst/os_guide/windows_setup.rst:485 +msgid "Win32-OpenSSH versions older than ``v7.9.0.0p1-Beta`` do not work when ``powershell`` is the shell type." msgstr "``powershell`` ãŒã‚·ã‚§ãƒ«ã‚¿ã‚¤ãƒ—ã®å ´åˆã¯ã€``v7.9.0.0p1-Beta`` よりもå¤ã„ Win32-OpenSSH ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_setup.rst:565 -msgid "While SCP should work, SFTP is the recommended SSH file transfer mechanism to use when copying or fetching a file" -msgstr "SCP も有効ã§ã™ãŒã€SFTP ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®ã‚³ãƒ”ーã¾ãŸã¯å–得時ã«ä½¿ç”¨ã™ã‚‹ã€æŽ¨å¥¨ã•ã‚Œã‚‹ SSH ファイル転é€ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã§ã™ã€‚" +#: ../../rst/os_guide/windows_setup.rst:486 +msgid "While Secure Copy Protocol (SCP) should work, SSH File Transfer Protocol (SFTP) is the recommended mechanism to use when copying or fetching a file." +msgstr "Secure Copy Protocol (SCP) も有効ã§ã™ãŒã€SSH File Transfer Protocol (SFTP) ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã®ã‚³ãƒ”ーã¾ãŸã¯å–得時ã«ä½¿ç”¨ã™ã‚‹ã€æŽ¨å¥¨ã®ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã§ã™ã€‚" #: ../../rst/os_guide/windows_usage.rst:4 msgid "Using Ansible and Windows" @@ -1842,17 +1922,17 @@ msgid "Certificate" msgstr "証明書" #: ../../rst/os_guide/windows_winrm.rst:59 -#: ../../rst/os_guide/windows_winrm.rst:300 +#: ../../rst/os_guide/windows_winrm.rst:302 msgid "Kerberos" msgstr "Kerberos" #: ../../rst/os_guide/windows_winrm.rst:61 -#: ../../rst/os_guide/windows_winrm.rst:270 +#: ../../rst/os_guide/windows_winrm.rst:272 msgid "NTLM" msgstr "NTLM" #: ../../rst/os_guide/windows_winrm.rst:63 -#: ../../rst/os_guide/windows_winrm.rst:515 +#: ../../rst/os_guide/windows_winrm.rst:517 msgid "CredSSP" msgstr "CredSSP" @@ -1885,559 +1965,635 @@ msgid "Encrypted private keys cannot be used as the urllib3 library that is used msgstr "WinRM å‘ã‘ã« Ansible ãŒä½¿ç”¨ã™ã‚‹ urllib3 ライブラリーãŒã“ã®æ©Ÿèƒ½ã‚’サãƒãƒ¼ãƒˆã—ã¦ã„ãªã„ãŸã‚ã€æš—å·åŒ–ã•ã‚ŒãŸç§˜å¯†éµã¯ä½¿ç”¨ã§ãã¾ã›ã‚“。" #: ../../rst/os_guide/windows_winrm.rst:120 +msgid "Certificate authentication does not work with a TLS 1.3 connection." +msgstr "証明書èªè¨¼ã¯ã€TLS 1.3 接続ã§ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" + +#: ../../rst/os_guide/windows_winrm.rst:122 msgid ".._winrm_certificate_generate:" msgstr ".._winrm_certificate_generate:" -#: ../../rst/os_guide/windows_winrm.rst:123 +#: ../../rst/os_guide/windows_winrm.rst:125 msgid "Generate a Certificate" msgstr "証明書ã®ç”Ÿæˆ" -#: ../../rst/os_guide/windows_winrm.rst:125 +#: ../../rst/os_guide/windows_winrm.rst:127 msgid "A certificate must be generated before it can be mapped to a local user. This can be done using one of the following methods:" msgstr "証明書をãƒãƒ¼ã‚«ãƒ«ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ãƒžãƒƒãƒ”ングã™ã‚‹å‰ã«ã€è¨¼æ˜Žæ›¸ã‚’生æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ä»¥ä¸‹ã®ã„ãšã‚Œã‹ã®æ–¹æ³•ã§è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:128 +#: ../../rst/os_guide/windows_winrm.rst:130 msgid "OpenSSL" msgstr "OpenSSL" -#: ../../rst/os_guide/windows_winrm.rst:129 +#: ../../rst/os_guide/windows_winrm.rst:131 msgid "PowerShell, using the ``New-SelfSignedCertificate`` cmdlet" msgstr "``New-SelfSignedCertificate`` コマンドレットを使用ã—㟠PowerShell" -#: ../../rst/os_guide/windows_winrm.rst:130 +#: ../../rst/os_guide/windows_winrm.rst:132 msgid "Active Directory Certificate Services" msgstr "Active Directory 証明書サービス" -#: ../../rst/os_guide/windows_winrm.rst:132 +#: ../../rst/os_guide/windows_winrm.rst:134 msgid "Active Directory Certificate Services is beyond of scope in this documentation but may be the best option to use when running in a domain environment. For more information, see the `Active Directory Certificate Services documentation <https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc732625(v=ws.11)>`_." msgstr "Active Directory Certificate Services ã¯ã€ã“ã®ãƒ‰ã‚ュメントã§ã¯å¯¾è±¡å¤–ã«ãªã‚Šã¾ã™ãŒã€ãƒ‰ãƒ¡ã‚¤ãƒ³ç’°å¢ƒã§å®Ÿè¡Œã™ã‚‹å ´åˆã«ã¯ã€æœ€é©ãªã‚ªãƒ—ションã«ãªã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。詳細ã¯ã€`Active Directory Certificate Services ã®ãƒ‰ã‚ュメント <https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc732625(v=ws.11)>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:136 +#: ../../rst/os_guide/windows_winrm.rst:138 msgid "Using the PowerShell cmdlet ``New-SelfSignedCertificate`` to generate a certificate for authentication only works when being generated from a Windows 10 or Windows Server 2012 R2 host or later. OpenSSL is still required to extract the private key from the PFX certificate to a PEM file for Ansible to use." msgstr "PowerShell コマンドレット (``New-SelfSignedCertificate``) を使用ã—ã¦èªè¨¼ç”¨ã®è¨¼æ˜Žæ›¸ã‚’生æˆã™ã‚‹å ´åˆã¯ã€Windows 10 ã¾ãŸã¯ Windows Server 2012 R2 ホスト以é™ã‹ã‚‰ç”Ÿæˆã•ã‚ŒãŸå ´åˆã«ã®ã¿æ©Ÿèƒ½ã—ã¾ã™ã€‚PFX 証明書ã‹ã‚‰ Ansible ãŒä½¿ç”¨ã™ã‚‹ PEM ファイルã«ç§˜å¯†éµã‚’抽出ã™ã‚‹ã«ã¯ã€OpenSSL ãŒå¼•ã続ãå¿…è¦ã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:142 +#: ../../rst/os_guide/windows_winrm.rst:144 msgid "To generate a certificate with ``OpenSSL``:" msgstr "``OpenSSL`` ã§è¨¼æ˜Žæ›¸ã‚’生æˆã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:162 +#: ../../rst/os_guide/windows_winrm.rst:164 msgid "To generate a certificate with ``New-SelfSignedCertificate``:" msgstr "``New-SelfSignedCertificate`` ã§è¨¼æ˜Žæ›¸ã‚’生æˆã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:190 +#: ../../rst/os_guide/windows_winrm.rst:192 msgid "To convert the PFX file to a private key that pywinrm can use, run the following command with OpenSSL ``openssl pkcs12 -in cert.pfx -nocerts -nodes -out cert_key.pem -passin pass: -passout pass:``" msgstr "PFX ファイルを pywinrm ãŒä½¿ç”¨ã§ãる秘密éµã«å¤‰æ›ã™ã‚‹ã«ã¯ã€OpenSSL 㧠``openssl pkcs12 -in cert.pfx -nocerts -nodes -out cert_key.pem -passin pass: -passout pass:`` コマンドを実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:197 +#: ../../rst/os_guide/windows_winrm.rst:199 msgid "Import a Certificate to the Certificate Store" msgstr "証明書ストアã¸ã®è¨¼æ˜Žæ›¸ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" -#: ../../rst/os_guide/windows_winrm.rst:199 +#: ../../rst/os_guide/windows_winrm.rst:201 msgid "Once a certificate has been generated, the issuing certificate needs to be imported into the ``Trusted Root Certificate Authorities`` of the ``LocalMachine`` store, and the client certificate public key must be present in the ``Trusted People`` folder of the ``LocalMachine`` store. For this example, both the issuing certificate and public key are the same." msgstr "証明書ãŒç”Ÿæˆã•ã‚ŒãŸã‚‰ã€ç™ºè¡Œã—ãŸè¨¼æ˜Žæ›¸ã‚’ ``LocalMachine`` ストア㮠``Trusted Root Certificate Authorities`` ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã—ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆè¨¼æ˜Žæ›¸ã®å…¬é–‹éµã‚’ ``LocalMachine`` ストア㮠``Trusted People`` ディレクトリーã«å˜åœ¨ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ä¾‹ã§ã¯ã€ç™ºè¡Œã—ãŸè¨¼æ˜Žæ›¸ã¨å…¬é–‹éµã®ä¸¡æ–¹ãŒåŒã˜ã‚‚ã®ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:205 +#: ../../rst/os_guide/windows_winrm.rst:207 msgid "Following example shows how to import the issuing certificate:" msgstr "以下ã®ä¾‹ã§ã¯ã€ç™ºè¡Œã—ãŸè¨¼æ˜Žæ›¸ã‚’インãƒãƒ¼ãƒˆã™ã‚‹æ–¹æ³•ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:219 +#: ../../rst/os_guide/windows_winrm.rst:221 msgid "If using ADCS to generate the certificate, then the issuing certificate will already be imported and this step can be skipped." msgstr "ADCS を使用ã—ã¦è¨¼æ˜Žæ›¸ã‚’生æˆã™ã‚‹å ´åˆã¯ã€ç™ºè¡Œã™ã‚‹è¨¼æ˜Žæ›¸ãŒã™ã§ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€ã“ã®æ‰‹é †ã¯çœç•¥ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:222 +#: ../../rst/os_guide/windows_winrm.rst:224 msgid "The code to import the client certificate public key is:" msgstr "クライアント証明書ã®å…¬é–‹éµã‚’インãƒãƒ¼ãƒˆã™ã‚‹ã‚³ãƒ¼ãƒ‰ã¯ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:239 +#: ../../rst/os_guide/windows_winrm.rst:241 msgid "Mapping a Certificate to an Account" msgstr "証明書ã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã¸ã®ãƒžãƒƒãƒ”ング" -#: ../../rst/os_guide/windows_winrm.rst:241 +#: ../../rst/os_guide/windows_winrm.rst:243 msgid "Once the certificate has been imported, map it to the local user account:" msgstr "証明書をインãƒãƒ¼ãƒˆã—ãŸã‚‰ã€ã“れをãƒãƒ¼ã‚«ãƒ«ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã«ãƒžãƒƒãƒ”ングã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:262 +#: ../../rst/os_guide/windows_winrm.rst:264 msgid "Once this is complete, the hostvar ``ansible_winrm_cert_pem`` should be set to the path of the public key and the ``ansible_winrm_cert_key_pem`` variable should be set to the path of the private key." msgstr "ã“ã‚ŒãŒå®Œäº†ã—ãŸã‚‰ã€ãƒ›ã‚¹ãƒˆå¤‰æ•° ``ansible_winrm_cert_pem`` ã«å…¬é–‹éµã®ãƒ‘スをè¨å®šã—ã€å¤‰æ•°``ansible_winrm_cert_key_pem`` ã«ç§˜å¯†éµã®ãƒ‘スをè¨å®šã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:272 +#: ../../rst/os_guide/windows_winrm.rst:274 msgid "NTLM is an older authentication mechanism used by Microsoft that can support both local and domain accounts. NTLM is enabled by default on the WinRM service, so no setup is required before using it." msgstr "NTLM ã¯ã€Microsoft ãŒä½¿ç”¨ã—ã¦ã„ã‚‹å¤ã„èªè¨¼ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã§ã€ãƒãƒ¼ã‚«ãƒ«ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã¨ãƒ‰ãƒ¡ã‚¤ãƒ³ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã®ä¸¡æ–¹ã‚’サãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚NTLM ã¯ã€WinRM サービスã§ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§æœ‰åŠ¹ã«ãªã£ã¦ã„ã‚‹ãŸã‚ã€ä½¿ç”¨ã™ã‚‹å‰ã«è¨å®šã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_winrm.rst:276 +#: ../../rst/os_guide/windows_winrm.rst:278 msgid "NTLM is the easiest authentication protocol to use and is more secure than ``Basic`` authentication. If running in a domain environment, ``Kerberos`` should be used instead of NTLM." msgstr "NTLM ã¯æœ€ã‚‚ç°¡å˜ã«ä½¿ç”¨ã§ãã‚‹èªè¨¼ãƒ—ãƒãƒˆã‚³ãƒ«ã§ã‚ã‚Šã€``Basic`` èªè¨¼ã‚ˆã‚Šã‚‚安全ã§ã™ã€‚ドメイン環境ã§ç¨¼åƒã—ã¦ã„ã‚‹å ´åˆã¯ã€NTLM ã®ä»£ã‚ã‚Šã« ``Kerberos`` を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:280 +#: ../../rst/os_guide/windows_winrm.rst:282 msgid "Kerberos has several advantages over using NTLM:" msgstr "Kerberos 㯠NTLM ã®ä½¿ç”¨ã¨æ¯”較ã—ã¦ã€ä»¥ä¸‹ã®ã‚ˆã†ãªåˆ©ç‚¹ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:282 +#: ../../rst/os_guide/windows_winrm.rst:284 msgid "NTLM is an older protocol and does not support newer encryption protocols." msgstr "NTLM ã¯å¤ã„プãƒãƒˆã‚³ãƒ«ã§ã‚ã‚Šã€æ–°ã—ã„æš—å·åŒ–プãƒãƒˆã‚³ãƒ«ã‚’サãƒãƒ¼ãƒˆã—ã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_winrm.rst:284 +#: ../../rst/os_guide/windows_winrm.rst:286 msgid "NTLM is slower to authenticate because it requires more round trips to the host in the authentication stage." msgstr "NTLM ã¯ã€èªè¨¼ã®æ®µéšŽã§ãƒ›ã‚¹ãƒˆã¸ã®ãƒ©ã‚¦ãƒ³ãƒ‰ãƒˆãƒªãƒƒãƒ—ãŒå¤šããªã‚‹ãŸã‚ã€èªè¨¼ã«æ™‚é–“ãŒã‹ã‹ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:286 +#: ../../rst/os_guide/windows_winrm.rst:288 msgid "Unlike Kerberos, NTLM does not allow credential delegation." msgstr "Kerberos ã¨ã¯ç•°ãªã‚Šã€NTLM ã¯èªè¨¼æƒ…å ±ã®å§”è²ã‚’許å¯ã—ã¦ã„ã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_winrm.rst:288 +#: ../../rst/os_guide/windows_winrm.rst:290 msgid "This example shows host variables configured to use NTLM authentication:" msgstr "以下ã®ä¾‹ã§ã¯ã€NTLM èªè¨¼ã‚’使用ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„るホスト変数を示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:302 +#: ../../rst/os_guide/windows_winrm.rst:304 msgid "Kerberos is the recommended authentication option to use when running in a domain environment. Kerberos supports features like credential delegation and message encryption over HTTP and is one of the more secure options that is available through WinRM." msgstr "Kerberos ã¯ã€ãƒ‰ãƒ¡ã‚¤ãƒ³ç’°å¢ƒã§å®Ÿè¡Œã™ã‚‹å ´åˆã«ä½¿ç”¨ã™ã‚‹æŽ¨å¥¨ã®èªè¨¼ã‚ªãƒ—ションã§ã™ã€‚Kerberos ã¯ã€èªè¨¼æƒ…å ±ã®å§”è²ã‚„ HTTP ã§ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ãªã©ã®æ©Ÿèƒ½ã‚’サãƒãƒ¼ãƒˆã—ã¦ãŠã‚Šã€WinRM ã§åˆ©ç”¨ã§ãるより安全ãªã‚ªãƒ—ション㮠1 ã¤ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:307 +#: ../../rst/os_guide/windows_winrm.rst:309 msgid "Kerberos requires some additional setup work on the Ansible host before it can be used properly." msgstr "Kerberos ã‚’æ£ã—ã使用ã™ã‚‹ã«ã¯ã€Ansible ホスト上ã§ã„ãã¤ã‹ã®è¿½åŠ è¨å®šä½œæ¥ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:310 +#: ../../rst/os_guide/windows_winrm.rst:312 msgid "The following example shows host vars configured for Kerberos authentication:" msgstr "以下ã®ä¾‹ã¯ã€Kerberos èªè¨¼ã«è¨å®šã•ã‚ŒãŸãƒ›ã‚¹ãƒˆå¤‰æ•°ã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:320 +#: ../../rst/os_guide/windows_winrm.rst:322 msgid "As of Ansible version 2.3, the Kerberos ticket will be created based on ``ansible_user`` and ``ansible_password``. If running on an older version of Ansible or when ``ansible_winrm_kinit_mode`` is ``manual``, a Kerberos ticket must already be obtained. See below for more details." msgstr "Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.3 以é™ã§ã¯ã€``ansible_user`` 㨠``ansible_password`` ã«åŸºã¥ã„㦠Kerberos ãƒã‚±ãƒƒãƒˆãŒä½œæˆã•ã‚Œã¾ã™ã€‚å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã§å®Ÿè¡Œã—ã¦ã„ã‚‹å ´åˆã‚„ã€``ansible_winrm_kinit_mode`` ㌠``manual`` ã®å ´åˆã¯ã€ã™ã§ã« Kerberos ãƒã‚±ãƒƒãƒˆã‚’å–å¾—ã—ã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ä»¥ä¸‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:325 +#: ../../rst/os_guide/windows_winrm.rst:327 msgid "There are some extra host variables that can be set:" msgstr "è¨å®šå¯èƒ½ãªè¿½åŠ ã®ãƒ›ã‚¹ãƒˆå¤‰æ•°ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:338 +#: ../../rst/os_guide/windows_winrm.rst:340 msgid "Installing the Kerberos Library" msgstr "Kerberos ライブラリーã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/os_guide/windows_winrm.rst:340 +#: ../../rst/os_guide/windows_winrm.rst:342 msgid "Some system dependencies that must be installed prior to using Kerberos. The script below lists the dependencies based on the distro:" msgstr "Kerberos を使用ã™ã‚‹å‰ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚るシステムä¾å˜é–¢ä¿‚ãŒã‚ã‚Šã¾ã™ã€‚以下ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã«åŸºã¥ãä¾å˜é–¢ä¿‚を一覧表示ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:369 +#: ../../rst/os_guide/windows_winrm.rst:371 msgid "Once the dependencies have been installed, the ``python-kerberos`` wrapper can be install using ``pip``:" msgstr "ä¾å˜é–¢ä¿‚ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸã‚‰ã€``pip`` を使用ã—㦠``python-kerberos`` ラッパーをインストールã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:378 +#: ../../rst/os_guide/windows_winrm.rst:380 msgid "While Ansible has supported Kerberos auth through ``pywinrm`` for some time, optional features or more secure options may only be available in newer versions of the ``pywinrm`` and/or ``pykerberos`` libraries. It is recommended you upgrade each version to the latest available to resolve any warnings or errors. This can be done through tools like ``pip`` or a system package manager like ``dnf``, ``yum``, ``apt`` but the package names and versions available may differ between tools." msgstr "Ansible ã¯ã“ã‚Œã¾ã§ã€``pywinrm`` を通ã˜ã¦ Kerberos èªè¨¼ã‚’サãƒãƒ¼ãƒˆã—ã¦ãã¾ã—ãŸãŒã€ã‚ªãƒ—ション機能やより安全ãªã‚ªãƒ—ションã¯ã€``pywinrm`` ライブラリーã¾ãŸã¯ ``pykerberos`` ライブラリーã®æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã®ã¿åˆ©ç”¨ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚è¦å‘Šã‚„エラーãŒç™ºç”Ÿã—ãŸå ´åˆã¯ã€å„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’最新ã®ã‚‚ã®ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ã“ã®ä½œæ¥ã¯ã€``pip`` ã®ã‚ˆã†ãªãƒ„ールやã€``dnf``ã€``yum``ã€``apt`` ã®ã‚ˆã†ãªã‚·ã‚¹ãƒ†ãƒ パッケージマãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã§è¡Œã†ã“ã¨ãŒã§ãã¾ã™ãŒã€ãƒ‘ッケージåや利用å¯èƒ½ãªãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ãƒ„ールã«ã‚ˆã£ã¦ç•°ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:390 +#: ../../rst/os_guide/windows_winrm.rst:392 msgid "Configuring Host Kerberos" msgstr "ホスト Kerberos ã®è¨å®š" -#: ../../rst/os_guide/windows_winrm.rst:392 +#: ../../rst/os_guide/windows_winrm.rst:394 msgid "Once the dependencies have been installed, Kerberos needs to be configured so that it can communicate with a domain. This configuration is done through the ``/etc/krb5.conf`` file, which is installed with the packages in the script above." msgstr "ä¾å˜é–¢ä¿‚ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸã‚‰ã€Kerberos ãŒãƒ‰ãƒ¡ã‚¤ãƒ³ã¨é€šä¿¡ã§ãるよã†ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®è¨å®šã¯ã€ä¸Šã®ã‚¹ã‚¯ãƒªãƒ—トã§ãƒ‘ッケージã¨ä¸€ç·’ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸ ``/etc/krb5.conf`` ファイルを通ã˜ã¦è¡Œã‚ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:396 +#: ../../rst/os_guide/windows_winrm.rst:398 msgid "To configure Kerberos, in the section that starts with:" msgstr "Kerberos ã‚’è¨å®šã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã§å§‹ã¾ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§è¡Œã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:402 +#: ../../rst/os_guide/windows_winrm.rst:404 msgid "Add the full domain name and the fully qualified domain names of the primary and secondary Active Directory domain controllers. It should look something like this:" msgstr "プライマリーãŠã‚ˆã³ã‚»ã‚«ãƒ³ãƒ€ãƒªãƒ¼ã® Active Directory ドメインコントãƒãƒ¼ãƒ©ãƒ¼ã®å®Œå…¨ãƒ‰ãƒ¡ã‚¤ãƒ³åãŠã‚ˆã³å®Œå…¨ä¿®é£¾ãƒ‰ãƒ¡ã‚¤ãƒ³åã‚’è¿½åŠ ã—ã¾ã™ã€‚以下ã®ã‚ˆã†ã«ãªã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:414 +#: ../../rst/os_guide/windows_winrm.rst:416 msgid "In the section that starts with:" msgstr "以下ã§å§‹ã¾ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã€" -#: ../../rst/os_guide/windows_winrm.rst:420 +#: ../../rst/os_guide/windows_winrm.rst:422 msgid "Add a line like the following for each domain that Ansible needs access for:" msgstr "Ansible ãŒã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å¿…è¦ã®ã‚ã‚‹å„ドメインã«ä»¥ä¸‹ã®ã‚ˆã†ãªè¡Œã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:427 +#: ../../rst/os_guide/windows_winrm.rst:429 msgid "You can configure other settings in this file such as the default domain. See `krb5.conf <https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html>`_ for more details." msgstr "ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ‰ãƒ¡ã‚¤ãƒ³ãªã©ã€ãã®ä»–ã®è¨å®šã‚’è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚詳細㯠`krb5.conf <https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:434 +#: ../../rst/os_guide/windows_winrm.rst:436 msgid "Automatic Kerberos Ticket Management" msgstr "Kerberos ãƒã‚±ãƒƒãƒˆã®è‡ªå‹•ç®¡ç†" -#: ../../rst/os_guide/windows_winrm.rst:436 +#: ../../rst/os_guide/windows_winrm.rst:438 msgid "Ansible version 2.3 and later defaults to automatically managing Kerberos tickets when both ``ansible_user`` and ``ansible_password`` are specified for a host. In this process, a new ticket is created in a temporary credential cache for each host. This is done before each task executes to minimize the chance of ticket expiration. The temporary credential caches are deleted after each task completes and will not interfere with the default credential cache." msgstr "Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.3 以é™ã§ã¯ã€ãƒ›ã‚¹ãƒˆã« ``ansible_user`` ãŠã‚ˆã³ ``ansible_password`` ã®ä¸¡æ–¹ãŒæŒ‡å®šã•ã‚ŒãŸå ´åˆã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ Kerberos ãƒã‚±ãƒƒãƒˆã‚’自動的ã«ç®¡ç†ã—ã¾ã™ã€‚ã“ã®ãƒ—ãƒã‚»ã‚¹ã§ã¯ã€å„ホストã®ä¸€æ™‚çš„ãªèªè¨¼æƒ…å ±ã‚ャッシュã«æ–°ã—ã„ãƒã‚±ãƒƒãƒˆãŒä½œæˆã•ã‚Œã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒã‚±ãƒƒãƒˆãŒå¤±åŠ¹ã™ã‚‹å¯èƒ½æ€§ã‚’最å°é™ã«ã™ã‚‹ãŸã‚ã«ã€å„タスクãŒå®Ÿè¡Œã•ã‚Œã‚‹å‰ã«è¡Œã‚ã‚Œã¾ã™ã€‚一時的ãªèªè¨¼æƒ…å ±ã‚ャッシュã¯ã€å„タスクãŒå®Œäº†ã™ã‚‹ã¨å‰Šé™¤ã•ã‚Œã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®èªè¨¼æƒ…å ±ã‚ャッシュã«å¹²æ¸‰ã™ã‚‹ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_winrm.rst:443 -msgid "To disable automatic ticket management, set ``ansible_winrm_kinit_mode=manual`` via the inventory." +#: ../../rst/os_guide/windows_winrm.rst:445 +msgid "To disable automatic ticket management, set ``ansible_winrm_kinit_mode=manual`` through the inventory." msgstr "ãƒã‚±ãƒƒãƒˆã®è‡ªå‹•ç®¡ç†ã‚’無効ã«ã™ã‚‹ã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‹ã‚‰ ``ansible_winrm_kinit_mode=manual`` ã‚’è¨å®šã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:446 +#: ../../rst/os_guide/windows_winrm.rst:448 msgid "Automatic ticket management requires a standard ``kinit`` binary on the control host system path. To specify a different location or binary name, set the ``ansible_winrm_kinit_cmd`` hostvar to the fully qualified path to a MIT krbv5 ``kinit``-compatible binary." msgstr "自動ãƒã‚±ãƒƒãƒˆç®¡ç†ã«ã¯ã€åˆ¶å¾¡ãƒ›ã‚¹ãƒˆã‚·ã‚¹ãƒ†ãƒ ã®ãƒ‘スã«æ¨™æº–ã® ``kinit`` ãƒã‚¤ãƒŠãƒªãƒ¼ãŒå¿…è¦ã§ã™ã€‚別ã®å ´æ‰€ã‚„ãƒã‚¤ãƒŠãƒªãƒ¼åを指定ã™ã‚‹ã«ã¯ã€ãƒ›ã‚¹ãƒˆå¤‰æ•° ``ansible_winrm_kinit_cmd`` ã« MIT krbv5 ``kinit`` 互æ›ãƒã‚¤ãƒŠãƒªãƒ¼ã¸ã®å®Œå…¨ä¿®é£¾ãƒ‘スをè¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:454 +#: ../../rst/os_guide/windows_winrm.rst:456 msgid "Manual Kerberos Ticket Management" msgstr "Kerberos ãƒã‚±ãƒƒãƒˆã®æ‰‹å‹•ç®¡ç†" -#: ../../rst/os_guide/windows_winrm.rst:456 +#: ../../rst/os_guide/windows_winrm.rst:458 msgid "To manually manage Kerberos tickets, the ``kinit`` binary is used. To obtain a new ticket the following command is used:" msgstr "Kerberos ãƒã‚±ãƒƒãƒˆã‚’手動ã§ç®¡ç†ã™ã‚‹ã«ã¯ã€``kinit`` ãƒã‚¤ãƒŠãƒªãƒ¼ã‚’使用ã—ã¾ã™ã€‚æ–°ã—ã„ãƒã‚±ãƒƒãƒˆã‚’å–å¾—ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:463 +#: ../../rst/os_guide/windows_winrm.rst:465 msgid "The domain must match the configured Kerberos realm exactly, and must be in upper case." msgstr "ドメインã¯è¨å®šã•ã‚ŒãŸ Kerberos レルムã«å®Œå…¨ã«ä¸€è‡´ã—ã€å¤§æ–‡å—ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:465 +#: ../../rst/os_guide/windows_winrm.rst:467 msgid "To see what tickets (if any) have been acquired, use the following command:" msgstr "å–å¾—ã—ãŸãƒã‚±ãƒƒãƒˆ (å˜åœ¨ã™ã‚‹å ´åˆ) を確èªã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:471 +#: ../../rst/os_guide/windows_winrm.rst:473 msgid "To destroy all the tickets that have been acquired, use the following command:" msgstr "å–å¾—ã—ãŸã™ã¹ã¦ã®ãƒã‚±ãƒƒãƒˆã‚’ç ´æ£„ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:480 +#: ../../rst/os_guide/windows_winrm.rst:482 msgid "Troubleshooting Kerberos" msgstr "Kerberos ã®ãƒˆãƒ©ãƒ–ルシューティング" -#: ../../rst/os_guide/windows_winrm.rst:482 +#: ../../rst/os_guide/windows_winrm.rst:484 msgid "Kerberos is reliant on a properly-configured environment to work. To troubleshoot Kerberos issues, ensure that:" msgstr "Kerberos ã¯ã€é©åˆ‡ã«æ§‹æˆã•ã‚ŒãŸç’°å¢ƒã§ãªã‘ã‚Œã°å‹•ä½œã—ã¾ã›ã‚“。Kerberos ã®å•é¡Œã‚’トラブルシューティングã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:485 +#: ../../rst/os_guide/windows_winrm.rst:487 msgid "The hostname set for the Windows host is the FQDN and not an IP address. * If you connect using an IP address you will get the error message `Server not found in Kerberos database`. * To determine if you are connecting using an IP address or an FQDN run your playbook (or call the ``win_ping`` module) using the `-vvv` flag." msgstr "Windows ホストã«è¨å®šã•ã‚ŒãŸãƒ›ã‚¹ãƒˆå㯠FQDN ã§ã‚ã‚Šã€IP アドレスã§ã¯ã‚ã‚Šã¾ã›ã‚“。* IP アドレスを使用ã—ã¦æŽ¥ç¶šã™ã‚‹å ´åˆã¯ã€ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ `Server not found in Kerberos database` ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚* IP アドレスã¾ãŸã¯ FQDN を使用ã—ã¦æŽ¥ç¶šã—ã¦ã„ã‚‹å ´åˆã¯ã€`-vvv` フラグを使用ã—㦠Playbook を実行ã™ã‚‹ã‹ã€``win_ping`` モジュールを呼ã³å‡ºã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:489 +#: ../../rst/os_guide/windows_winrm.rst:491 msgid "The forward and reverse DNS lookups are working properly in the domain. To test this, ping the windows host by name and then use the ip address returned with ``nslookup``. The same name should be returned when using ``nslookup`` on the IP address." msgstr "ã“ã®ãƒ‰ãƒ¡ã‚¤ãƒ³ã§ã¯ã€DNS ã®æ£å¼•ãã¨é€†å¼•ããŒæ£å¸¸ã«å‹•ä½œã—ã¦ã„ã¾ã™ã€‚ã“れをテストã™ã‚‹ã«ã¯ã€Windows ホストã«åå‰ã§ ping を打ã¡ã€``nslookup`` ã§è¿”ã•ã‚ŒãŸ IP アドレスを使用ã—ã¾ã™ã€‚IP アドレス㫠``nslookup`` を使用ã™ã‚‹ã¨ã€åŒã˜åå‰ãŒè¿”ã•ã‚Œã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:494 +#: ../../rst/os_guide/windows_winrm.rst:496 msgid "The Ansible host's clock is synchronized with the domain controller. Kerberos is time sensitive, and a little clock drift can cause the ticket generation process to fail." msgstr "Ansible ホストã®æ™‚計ã¯ãƒ‰ãƒ¡ã‚¤ãƒ³ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã¨åŒæœŸã—ã¾ã™ã€‚Kerberos ã¯æ™‚é–“ã«æ•æ„Ÿã§ã€ã‚ãšã‹ãªæ™‚計ã®ãšã‚Œã«ã‚ˆã‚Šã€ãƒã‚±ãƒƒãƒˆç”Ÿæˆãƒ—ãƒã‚»ã‚¹ãŒå¤±æ•—ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:498 +#: ../../rst/os_guide/windows_winrm.rst:500 msgid "Ensure that the fully qualified domain name for the domain is configured in the ``krb5.conf`` file. To check this, run:" msgstr "ドメインã®å®Œå…¨ä¿®é£¾ãƒ‰ãƒ¡ã‚¤ãƒ³åãŒã€``krb5.conf`` ファイルã«è¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。ã“れを確èªã™ã‚‹ã«ã¯ã€æ¬¡ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:506 +#: ../../rst/os_guide/windows_winrm.rst:508 msgid "If the domain name returned by ``klist`` is different from the one requested, an alias is being used. The ``krb5.conf`` file needs to be updated so that the fully qualified domain name is used and not an alias." msgstr "``klist`` ã§è¿”ã•ã‚ŒãŸãƒ‰ãƒ¡ã‚¤ãƒ³åãŒè¦æ±‚ã•ã‚ŒãŸã‚‚ã®ã¨ç•°ãªã‚‹å ´åˆã¯ã€ã‚¨ã‚¤ãƒªã‚¢ã‚¹ãŒä½¿ç”¨ã•ã‚Œã¦ã„ã¾ã™ã€‚``krb5.conf`` ファイルを更新ã—ã¦ã€ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã¯ãªã完全修飾ドメインåを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:510 +#: ../../rst/os_guide/windows_winrm.rst:512 msgid "If the default kerberos tooling has been replaced or modified (some IdM solutions may do this), this may cause issues when installing or upgrading the Python Kerberos library. As of the time of this writing, this library is called ``pykerberos`` and is known to work with both MIT and Heimdal Kerberos libraries. To resolve ``pykerberos`` installation issues, ensure the system dependencies for Kerberos have been met (see: `Installing the Kerberos Library`_), remove any custom Kerberos tooling paths from the PATH environment variable, and retry the installation of Python Kerberos library package." msgstr "デフォルト㮠kerberos ツールãŒç½®ãæ›ãˆã‚‰ã‚ŒãŸã‚Šå¤‰æ›´ã—ãŸã‚Šã—ãŸå ´åˆ (ã„ãã¤ã‹ã® IdM ソリューションã§ã¯ãã†ãªã£ã¦ã„ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“)ã€Python Kerberos ライブラリーをインストールã—ãŸã‚Šã‚¢ãƒƒãƒ—グレードã—ãŸã‚Šã™ã‚‹éš›ã«å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚本ガイドã®ä½œæˆæ™‚点ã§ã€ã“ã®ãƒ©ã‚¤ãƒ–ラリー㯠``pykerberos`` ã¨å‘¼ã°ã‚Œã€MIT 㨠Heimdal Kerberos ライブラリーã®ä¸¡æ–¹ã§å‹•ä½œã™ã‚‹ã“ã¨ãŒçŸ¥ã‚‰ã‚Œã¦ã„ã¾ã™ã€‚``pykerberos`` ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«å•é¡Œã‚’解決ã™ã‚‹ã«ã¯ã€Kerberos ã®ã‚·ã‚¹ãƒ†ãƒ ä¾å˜æ€§ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã— (å‚ç…§: `Installing the Kerberos Library`_)ã€PATH 環境変数ã‹ã‚‰ã‚«ã‚¹ã‚¿ãƒ ã® Kerberos ツールパスを削除ã—ã€Python Kerberos ライブラリーパッケージã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’å†è©¦è¡Œã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:517 +#: ../../rst/os_guide/windows_winrm.rst:519 msgid "CredSSP authentication is a newer authentication protocol that allows credential delegation. This is achieved by encrypting the username and password after authentication has succeeded and sending that to the server using the CredSSP protocol." msgstr "CredSSP èªè¨¼ã¯ã€èªè¨¼æƒ…å ±ã®å§”è²ã‚’å¯èƒ½ã«ã™ã‚‹æ–°ã—ã„èªè¨¼ãƒ—ãƒãƒˆã‚³ãƒ«ã«ãªã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€èªè¨¼ãŒæˆåŠŸã—ãŸå¾Œã®ãƒ¦ãƒ¼ã‚¶ãƒ¼åã¨ãƒ‘スワードを暗å·åŒ–ã—ã€ãれを CredSSP プãƒãƒˆã‚³ãƒ«ã‚’使用ã—ã¦ã‚µãƒ¼ãƒãƒ¼ã«é€ä¿¡ã™ã‚‹ã“ã¨ã§å®Ÿç¾ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:522 +#: ../../rst/os_guide/windows_winrm.rst:524 msgid "Because the username and password are sent to the server to be used for double hop authentication, ensure that the hosts that the Windows host communicates with are not compromised and are trusted." msgstr "ユーザーåã¨ãƒ‘スワードをサーãƒãƒ¼ã«é€ä¿¡ã—ã¦ãƒ€ãƒ–ルホップèªè¨¼ã«ä½¿ç”¨ã™ã‚‹ãŸã‚ã€Windows ホストãŒé€šä¿¡ã™ã‚‹ãƒ›ã‚¹ãƒˆãŒæ¼æ´©ã—ã¦ãŠã‚‰ãšã€ä¿¡é ¼ã§ãã‚‹ã“ã¨ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:526 +#: ../../rst/os_guide/windows_winrm.rst:528 msgid "CredSSP can be used for both local and domain accounts and also supports message encryption over HTTP." msgstr "CredSSP ã¯ã€ãƒãƒ¼ã‚«ãƒ«ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã¨ãƒ‰ãƒ¡ã‚¤ãƒ³ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã®ä¸¡æ–¹ã«ä½¿ç”¨ã§ãã€HTTPã§ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ã«ã‚‚対応ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:529 +#: ../../rst/os_guide/windows_winrm.rst:531 msgid "To use CredSSP authentication, the host vars are configured like so:" msgstr "CredSSP èªè¨¼ã‚’使用ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãƒ›ã‚¹ãƒˆå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:538 +#: ../../rst/os_guide/windows_winrm.rst:540 msgid "There are some extra host variables that can be set as shown below:" msgstr "以下ã®ã‚ˆã†ã«è¨å®šã§ãã‚‹è¿½åŠ ã®ãƒ›ã‚¹ãƒˆå¤‰æ•°ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:544 +#: ../../rst/os_guide/windows_winrm.rst:546 msgid "CredSSP authentication is not enabled by default on a Windows host, but can be enabled by running the following in PowerShell:" msgstr "CredSSP èªè¨¼ã¯ã€Windows ホストã§ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯æœ‰åŠ¹ã«ãªã£ã¦ã„ã¾ã›ã‚“ãŒã€PowerShell ã§ä»¥ä¸‹ã‚’実行ã™ã‚‹ã“ã¨ã§æœ‰åŠ¹ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:554 +#: ../../rst/os_guide/windows_winrm.rst:556 msgid "Installing CredSSP Library" msgstr "CredSSP ライブラリーã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -#: ../../rst/os_guide/windows_winrm.rst:556 +#: ../../rst/os_guide/windows_winrm.rst:558 msgid "The ``requests-credssp`` wrapper can be installed using ``pip``:" msgstr "``requests-credssp`` ラッパーã¯ã€``pip`` を使用ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:565 +#: ../../rst/os_guide/windows_winrm.rst:567 msgid "CredSSP and TLS 1.2" msgstr "CredSSP ãŠã‚ˆã³ TLS 1.2" -#: ../../rst/os_guide/windows_winrm.rst:567 +#: ../../rst/os_guide/windows_winrm.rst:569 msgid "By default the ``requests-credssp`` library is configured to authenticate over the TLS 1.2 protocol. TLS 1.2 is installed and enabled by default for Windows Server 2012 and Windows 8 and more recent releases." msgstr "デフォルトã§ã¯ã€``requests-credssp`` ライブラリーã¯ã€TLS 1.2 プãƒãƒˆã‚³ãƒ«ã§èªè¨¼ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚TLS 1.2 ã¯ã€Windows Server 2012 ãŠã‚ˆã³ Windows 8 ã¨ã€ãれ以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã€æœ‰åŠ¹ã«ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:571 +#: ../../rst/os_guide/windows_winrm.rst:573 msgid "There are two ways that older hosts can be used with CredSSP:" msgstr "å¤ã„ホストを CredSSP ã§ä½¿ç”¨ã§ãる方法㯠2 ã¤ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:573 +#: ../../rst/os_guide/windows_winrm.rst:575 msgid "Install and enable a hotfix to enable TLS 1.2 support (recommended for Server 2008 R2 and Windows 7)." msgstr "TLS 1.2 ã®ã‚µãƒãƒ¼ãƒˆã‚’有効ã«ã™ã‚‹ Hotfix をインストールã—ã¦æœ‰åŠ¹ã«ã—ã¦ãã ã•ã„ (Server 2008 R2 ãŠã‚ˆã³ Windows 7 ã§æŽ¨å¥¨)。" -#: ../../rst/os_guide/windows_winrm.rst:576 +#: ../../rst/os_guide/windows_winrm.rst:578 msgid "Set ``ansible_winrm_credssp_disable_tlsv1_2=True`` in the inventory to run over TLS 1.0. This is the only option when connecting to Windows Server 2008, which has no way of supporting TLS 1.2" msgstr "インベントリー㫠``ansible_winrm_credssp_disable_tlsv1_2=True`` ã‚’è¨å®šã—ã¦ã€TLS 1.0 ã§å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«è¨å®šã—ã¾ã™ã€‚ã“ã‚Œã¯ã€TLS 1.2 ã«å¯¾å¿œã—ã¦ã„ãªã„ Windows Server 2008 ã«æŽ¥ç¶šã™ã‚‹éš›ã®å”¯ä¸€ã®é¸æŠžè‚¢ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:580 +#: ../../rst/os_guide/windows_winrm.rst:582 msgid "See :ref:`winrm_tls12` for more information on how to enable TLS 1.2 on the Windows host." msgstr "Windows ホスト㧠TLS 1.2 を有効ã«ã™ã‚‹æ–¹æ³•ã¯ã€ã€Œ:ref:`winrm_tls12`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:586 +#: ../../rst/os_guide/windows_winrm.rst:588 msgid "Set CredSSP Certificate" msgstr "CredSSP 証明書ã®è¨å®š" -#: ../../rst/os_guide/windows_winrm.rst:588 +#: ../../rst/os_guide/windows_winrm.rst:590 msgid "CredSSP works by encrypting the credentials through the TLS protocol and uses a self-signed certificate by default. The ``CertificateThumbprint`` option under the WinRM service configuration can be used to specify the thumbprint of another certificate." msgstr "CredSSP ã¯ã€TLS プãƒãƒˆã‚³ãƒ«ã§èªè¨¼æƒ…å ±ã‚’æš—å·åŒ–ã—ã¦å‹•ä½œã—ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯è‡ªå·±ç½²å証明書を使用ã—ã¾ã™ã€‚WinRM サービス構æˆã® ``CertificateThumbprint`` オプションを使用ã—ã¦ã€åˆ¥ã®è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントを指定ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:591 +#: ../../rst/os_guide/windows_winrm.rst:593 msgid "This certificate configuration is independent of the WinRM listener certificate. With CredSSP, message transport still occurs over the WinRM listener, but the TLS-encrypted messages inside the channel use the service-level certificate." msgstr "ã“ã®è¨¼æ˜Žæ›¸æ§‹æˆã¯ã€WinRM リスナーã®è¨¼æ˜Žæ›¸ã¨ã¯ç‹¬ç«‹ã—ã¦ã„ã¾ã™ã€‚CredSSP ã§ã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒˆãƒ©ãƒ³ã‚¹ãƒãƒ¼ãƒˆã¯å¼•ã続ã WinRM リスナーを介ã—ã¦è¡Œã‚ã‚Œã¾ã™ãŒã€ãƒãƒ£ãƒ³ãƒãƒ«å†…ã® TLS æš—å·åŒ–メッセージã«ã¯ã‚µãƒ¼ãƒ“スレベル証明書ãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:595 +#: ../../rst/os_guide/windows_winrm.rst:597 msgid "To explicitly set the certificate to use for CredSSP:" msgstr "CredSSP ã«ä½¿ç”¨ã™ã‚‹è¨¼æ˜Žæ›¸ã‚’明示的ã«è¨å®šã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:609 +#: ../../rst/os_guide/windows_winrm.rst:611 msgid "Non-Administrator Accounts" msgstr "管ç†è€…以外ã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆ" -#: ../../rst/os_guide/windows_winrm.rst:611 +#: ../../rst/os_guide/windows_winrm.rst:613 msgid "WinRM is configured by default to only allow connections from accounts in the local ``Administrators`` group. This can be changed by running:" msgstr "WinRM ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€ãƒãƒ¼ã‚«ãƒ«ã® ``Administrators`` グループã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‹ã‚‰ã®æŽ¥ç¶šã®ã¿ã‚’許å¯ã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã‚Œã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¦å¤‰æ›´ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:618 +#: ../../rst/os_guide/windows_winrm.rst:620 msgid "This will display an ACL editor, where new users or groups may be added. To run commands over WinRM, users and groups must have at least the ``Read`` and ``Execute`` permissions enabled." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ACL エディターãŒè¡¨ç¤ºã•ã‚Œã€æ–°ã—ã„ユーザーã¾ãŸã¯ã‚°ãƒ«ãƒ¼ãƒ—ã‚’è¿½åŠ ã§ãã¾ã™ã€‚WinRM ã§ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ã«ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŠã‚ˆã³ã‚°ãƒ«ãƒ¼ãƒ—ã«å°‘ãªãã¨ã‚‚ ``Read`` ãŠã‚ˆã³ ``Execute`` パーミッションãŒæœ‰åŠ¹ã«ãªã£ã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:622 +#: ../../rst/os_guide/windows_winrm.rst:624 msgid "While non-administrative accounts can be used with WinRM, most typical server administration tasks require some level of administrative access, so the utility is usually limited." msgstr "WinRM ã§ã¯ã€ç®¡ç†è€…以外ã®ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‚’使用ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€ä¸€èˆ¬çš„ãªã‚µãƒ¼ãƒãƒ¼ç®¡ç†ä½œæ¥ã§ã¯ã€ã‚る程度ã®ç®¡ç†è€…権é™ãŒå¿…è¦ã¨ãªã‚‹ãŸã‚ã€å®Ÿç”¨æ€§ã¯é™ã‚‰ã‚Œã¦ã—ã¾ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:628 +#: ../../rst/os_guide/windows_winrm.rst:630 msgid "WinRM Encryption" msgstr "WinRM æš—å·åŒ–" -#: ../../rst/os_guide/windows_winrm.rst:630 +#: ../../rst/os_guide/windows_winrm.rst:632 msgid "By default WinRM will fail to work when running over an unencrypted channel. The WinRM protocol considers the channel to be encrypted if using TLS over HTTP (HTTPS) or using message level encryption. Using WinRM with TLS is the recommended option as it works with all authentication options, but requires a certificate to be created and used on the WinRM listener." msgstr "デフォルトã§ã¯ã€WinRM ã¯ã€æš—å·åŒ–ã•ã‚Œã¦ã„ãªã„ãƒãƒ£ãƒ³ãƒãƒ«ä¸Šã§å®Ÿè¡Œã™ã‚‹ã¨ã€å‹•ä½œã«å¤±æ•—ã—ã¾ã™ã€‚WinRM プãƒãƒˆã‚³ãƒ«ã¯ã€TLS over HTTP (HTTPS) を使用ã—ã¦ã„ã‚‹å ´åˆã‚„ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒ¬ãƒ™ãƒ«ã®æš—å·åŒ–を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒãƒ£ãƒ³ãƒãƒ«ãŒæš—å·åŒ–ã•ã‚Œã¦ã„ã‚‹ã¨ã¿ãªã—ã¾ã™ã€‚WinRM ã‚’ TLS ã§ä½¿ç”¨ã™ã‚‹ã“ã¨ã¯ã€ã™ã¹ã¦ã®èªè¨¼ã‚ªãƒ—ションã§å‹•ä½œã™ã‚‹ãŸã‚ã€æŽ¨å¥¨ã•ã‚Œã‚‹ã‚ªãƒ—ションã§ã™ãŒã€WinRM リスナーã§è¨¼æ˜Žæ›¸ã‚’作æˆã—ã¦ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:636 +#: ../../rst/os_guide/windows_winrm.rst:638 msgid "If in a domain environment, ADCS can create a certificate for the host that is issued by the domain itself." msgstr "ドメイン環境ã®å ´åˆã€ADCS ã¯ãƒ‰ãƒ¡ã‚¤ãƒ³è‡ªä½“ãŒç™ºè¡Œã™ã‚‹ãƒ›ã‚¹ãƒˆã®è¨¼æ˜Žæ›¸ã‚’作æˆã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:639 +#: ../../rst/os_guide/windows_winrm.rst:641 msgid "If using HTTPS is not an option, then HTTP can be used when the authentication option is ``NTLM``, ``Kerberos`` or ``CredSSP``. These protocols will encrypt the WinRM payload with their own encryption method before sending it to the server. The message-level encryption is not used when running over HTTPS because the encryption uses the more secure TLS protocol instead. If both transport and message encryption is required, set ``ansible_winrm_message_encryption=always`` in the host vars." msgstr "HTTPS を使用ã™ã‚‹ã“ã¨ãŒã§ããªã„å ´åˆã¯ã€èªè¨¼ã‚ªãƒ—ション㌠``NTLM``ã€``Kerberos``ã€ã¾ãŸã¯ ``CredSSP`` ã§ã‚ã‚Œã°ã€HTTP を使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“れらã®ãƒ—ãƒãƒˆã‚³ãƒ«ã¯ã€WinRM ペイãƒãƒ¼ãƒ‰ã‚’独自ã®æš—å·åŒ–æ–¹å¼ã§æš—å·åŒ–ã—ã¦ã‹ã‚‰ã‚µãƒ¼ãƒãƒ¼ã«é€ä¿¡ã—ã¾ã™ã€‚æš—å·åŒ–ã¯ã€ã‚ˆã‚Šå®‰å…¨ãª TLS プãƒãƒˆã‚³ãƒ«ã‚’代ã‚ã‚Šã«ä½¿ç”¨ã™ã‚‹ãŸã‚ã€HTTPS ã§å®Ÿè¡Œã™ã‚‹å ´åˆã«ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒ¬ãƒ™ãƒ«ã®æš—å·åŒ–ã¯ä½¿ç”¨ã•ã‚Œã¾ã›ã‚“。トランスãƒãƒ¼ãƒˆã¨ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®ä¸¡æ–¹ã®æš—å·åŒ–ãŒå¿…è¦ãªå ´åˆã¯ã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ã« ``ansible_winrm_message_encryption=always`` ã‚’è¨å®šã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:647 +#: ../../rst/os_guide/windows_winrm.rst:649 msgid "Message encryption over HTTP requires pywinrm>=0.3.0." msgstr "HTTPã§ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ã«ã¯ 0.3.0 以上㮠pywinrm ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:649 +#: ../../rst/os_guide/windows_winrm.rst:651 msgid "A last resort is to disable the encryption requirement on the Windows host. This should only be used for development and debugging purposes, as anything sent from Ansible can be viewed, manipulated and also the remote session can completely be taken over by anyone on the same network. To disable the encryption requirement:" msgstr "最後ã®æ‰‹æ®µã¨ã—ã¦ã€Windows ホストã®æš—å·åŒ–è¦ä»¶ã‚’無効ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€Ansible ã‹ã‚‰é€ä¿¡ã•ã‚ŒãŸã‚‚ã®ã¯ã™ã¹ã¦é–²è¦§ã€æ“作ã§ãã€ã¾ãŸåŒã˜ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ä¸Šã®èª°ã‚‚ãŒãƒªãƒ¢ãƒ¼ãƒˆã‚»ãƒƒã‚·ãƒ§ãƒ³ã‚’完全ã«ä¹—ã£å–ã‚‹ã“ã¨ãŒã§ãã‚‹ãŸã‚ã€é–‹ç™ºã‚„デãƒãƒƒã‚°ã®ç›®çš„ã§ã®ã¿ä½¿ç”¨ã—ã¦ãã ã•ã„。暗å·åŒ–を無効ã«ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®æ‰‹é †ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:659 +#: ../../rst/os_guide/windows_winrm.rst:661 msgid "Do not disable the encryption check unless it is absolutely required. Doing so could allow sensitive information like credentials and files to be intercepted by others on the network." msgstr "ã©ã†ã—ã¦ã‚‚å¿…è¦ãªå ´åˆã‚’除ãã€æš—å·åŒ–ãƒã‚§ãƒƒã‚¯ã‚’無効ã«ã—ãªã„ã§ãã ã•ã„。暗å·åŒ–ãƒã‚§ãƒƒã‚¯ã‚’無効ã«ã™ã‚‹ã¨ã€èªè¨¼æƒ…å ±ã‚„ãƒ•ã‚¡ã‚¤ãƒ«ãªã©ã®æ©Ÿå¯†æƒ…å ±ãŒãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ä¸Šã®ä»–ã®äººã«å‚å—ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:666 +#: ../../rst/os_guide/windows_winrm.rst:668 msgid "Inventory Options" msgstr "インベントリーオプション" -#: ../../rst/os_guide/windows_winrm.rst:668 +#: ../../rst/os_guide/windows_winrm.rst:670 msgid "Ansible's Windows support relies on a few standard variables to indicate the username, password, and connection type of the remote hosts. These variables are most easily set up in the inventory, but can be set on the ``host_vars``/ ``group_vars`` level." msgstr "Ansible ã® Windows サãƒãƒ¼ãƒˆã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ›ã‚¹ãƒˆã®ãƒ¦ãƒ¼ã‚¶ãƒ¼åã€ãƒ‘スワードã€æŽ¥ç¶šã‚¿ã‚¤ãƒ—を示ã™ã„ãã¤ã‹ã®æ¨™æº–変数ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚ã“れらã®å¤‰æ•°ã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§æœ€ã‚‚ç°¡å˜ã«è¨å®šã§ãã¾ã™ãŒã€``host_vars``/``group_vars`` レベルã§è¨å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:673 +#: ../../rst/os_guide/windows_winrm.rst:675 msgid "When setting up the inventory, the following variables are required:" msgstr "インベントリーをè¨å®šã™ã‚‹éš›ã«ã€ä»¥ä¸‹ã®å¤‰æ•°ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:688 +#: ../../rst/os_guide/windows_winrm.rst:690 msgid "Using the variables above, Ansible will connect to the Windows host with Basic authentication through HTTPS. If ``ansible_user`` has a UPN value like ``username@MY.DOMAIN.COM`` then the authentication option will automatically attempt to use Kerberos unless ``ansible_winrm_transport`` has been set to something other than ``kerberos``." msgstr "上記ã®å¤‰æ•°ã‚’使用ã™ã‚‹ã¨ã€Ansible 㯠HTTPS を通ã˜ã¦ Basic èªè¨¼ã§ Windows ホストã«æŽ¥ç¶šã—ã¾ã™ã€‚``ansible_user`` ã« ``username@MY.DOMAIN.COM`` ã®ã‚ˆã†ãª UPN 値ãŒã‚ã‚‹å ´åˆã¯ã€``ansible_winrm_transport`` ㌠``kerberos`` 以外ã«è¨å®šã•ã‚Œã¦ã„ãªã„é™ã‚Šã€èªè¨¼ã‚ªãƒ—ションã¯è‡ªå‹•çš„ã« Kerberos ã®ä½¿ç”¨ã‚’試ã¿ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:694 +#: ../../rst/os_guide/windows_winrm.rst:696 msgid "The following custom inventory variables are also supported for additional configuration of WinRM connections:" msgstr "以下ã®ã‚«ã‚¹ã‚¿ãƒ インベントリー変数もã€WinRM 接続ã®è¿½åŠ è¨å®šã®ãŸã‚ã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:697 +#: ../../rst/os_guide/windows_winrm.rst:699 msgid "``ansible_port``: The port WinRM will run over, HTTPS is ``5986`` which is the default while HTTP is ``5985``" msgstr "``ansible_port``: WinRM ãŒå®Ÿè¡Œã™ã‚‹ãƒãƒ¼ãƒˆã§ã™ã€‚HTTPS ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``5986`` ã§ã€HTTP ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``5985`` ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:700 +#: ../../rst/os_guide/windows_winrm.rst:702 msgid "``ansible_winrm_scheme``: Specify the connection scheme (``http`` or ``https``) to use for the WinRM connection. Ansible uses ``https`` by default unless ``ansible_port`` is ``5985``" msgstr "``ansible_winrm_scheme``: WinRM 接続ã«ä½¿ç”¨ã™ã‚‹æŽ¥ç¶šã‚¹ã‚ーム(``http`` ã¾ãŸã¯ ``https``) を指定ã—ã¾ã™ã€‚Ansible ã¯ã€``ansible_port`` ㌠``5985`` ã«æŒ‡å®šã•ã‚Œã¦ã„ãªã„é™ã‚Šã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``https`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:704 +#: ../../rst/os_guide/windows_winrm.rst:706 msgid "``ansible_winrm_path``: Specify an alternate path to the WinRM endpoint, Ansible uses ``/wsman`` by default" msgstr "``ansible_winrm_path``: WinRMエンドãƒã‚¤ãƒ³ãƒˆã¸ã®åˆ¥ã®ãƒ‘スを指定ã—ã¾ã™ã€‚Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``/wsman`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:707 +#: ../../rst/os_guide/windows_winrm.rst:709 msgid "``ansible_winrm_realm``: Specify the realm to use for Kerberos authentication. If ``ansible_user`` contains ``@``, Ansible will use the part of the username after ``@`` by default" msgstr "``ansible_winrm_realm``: Kerberos èªè¨¼ã«ä½¿ç”¨ã™ã‚‹ãƒ¬ãƒ«ãƒ を指定ã—ã¾ã™ã€‚``ansible_user`` ã« ``@`` ãŒå«ã¾ã‚Œã‚‹å ´åˆã€Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``@`` ã®å¾Œã«ãƒ¦ãƒ¼ã‚¶ãƒ¼åã®ä¸€éƒ¨ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:711 +#: ../../rst/os_guide/windows_winrm.rst:713 msgid "``ansible_winrm_transport``: Specify one or more authentication transport options as a comma-separated list. By default, Ansible will use ``kerberos, basic`` if the ``kerberos`` module is installed and a realm is defined, otherwise it will be ``plaintext``" msgstr "``ansible_winrm_transport``: 1 ã¤ä»¥ä¸Šã®èªè¨¼ãƒˆãƒ©ãƒ³ã‚¹ãƒãƒ¼ãƒˆã‚ªãƒ—ションをコンマ区切りã®ãƒªã‚¹ãƒˆã§æŒ‡å®šã—ã¾ã™ã€‚デフォルトã§ã¯ã€``kerberos`` モジュールãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã¦ãƒ¬ãƒ«ãƒ ãŒå®šç¾©ã•ã‚Œã¦ã„ã‚‹å ´åˆã€Ansible 㯠``kerberos, basic`` を使用ã—ã€ãれ以外ã®å ´åˆã¯ ``plaintext`` ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:716 +#: ../../rst/os_guide/windows_winrm.rst:718 msgid "``ansible_winrm_server_cert_validation``: Specify the server certificate validation mode (``ignore`` or ``validate``). Ansible defaults to ``validate`` on Python 2.7.9 and higher, which will result in certificate validation errors against the Windows self-signed certificates. Unless verifiable certificates have been configured on the WinRM listeners, this should be set to ``ignore``" msgstr "``ansible_winrm_server_cert_validation``: サーãƒãƒ¼è¨¼æ˜Žæ›¸ã®æ¤œè¨¼ãƒ¢ãƒ¼ãƒ‰ (``ignore`` ã¾ãŸã¯``validate``) を指定ã—ã¾ã™ã€‚Ansible ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€Python 2.7.9 以é™ã§ã¯ ``validate`` ã§ã€ã“れ㯠Windows ã®è‡ªå·±ç½²å証明書ã«å¯¾ã—ã¦è¨¼æ˜Žæ›¸ã®æ¤œè¨¼ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—ã¾ã™ã€‚WinRM リスナーã§æ¤œè¨¼å¯èƒ½ãªè¨¼æ˜Žæ›¸ãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€ã“ã®è¨å®šã‚’ ``ignore`` ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:723 +#: ../../rst/os_guide/windows_winrm.rst:725 msgid "``ansible_winrm_operation_timeout_sec``: Increase the default timeout for WinRM operations, Ansible uses ``20`` by default" msgstr "``ansible_winrm_operation_timeout_sec``: WinRM æ“作ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚¿ã‚¤ãƒ アウトを増やã™ã¨ã€Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``20`` を使用ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:726 +#: ../../rst/os_guide/windows_winrm.rst:728 msgid "``ansible_winrm_read_timeout_sec``: Increase the WinRM read timeout, Ansible uses ``30`` by default. Useful if there are intermittent network issues and read timeout errors keep occurring" msgstr "``ansible_winrm_read_timeout_sec``: WinRM ã®èªã¿å–りタイムアウトを増やã—ã¾ã™ã€‚Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``30`` を使用ã—ã¾ã™ã€‚ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã®å•é¡ŒãŒæ–続的ã«ç™ºç”Ÿã—ã€èªã¿å–りタイムアウトã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—続ã‘ã‚‹å ´åˆã«æœ‰åŠ¹ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:730 +#: ../../rst/os_guide/windows_winrm.rst:732 msgid "``ansible_winrm_message_encryption``: Specify the message encryption operation (``auto``, ``always``, ``never``) to use, Ansible uses ``auto`` by default. ``auto`` means message encryption is only used when ``ansible_winrm_scheme`` is ``http`` and ``ansible_winrm_transport`` supports message encryption. ``always`` means message encryption will always be used and ``never`` means message encryption will never be used" msgstr "``ansible_winrm_message_encryption``: 使用ã™ã‚‹ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–æ“作 (``auto``ã€``always``ã€``never``) を指定ã—ã¾ã™ã€‚Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``auto`` を使用ã—ã¾ã™ã€‚``auto`` ã¯ã€``ansible_winrm_scheme`` ㌠``http`` ã§ã€``ansible_winrm_transport`` ãŒãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–をサãƒãƒ¼ãƒˆã—ã¦ã„ã‚‹å ´åˆã«é™ã‚Šã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ãŒä½¿ç”¨ã•ã‚Œã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚``always`` ã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ãŒå¸¸ã«ä½¿ç”¨ã•ã‚Œã‚‹ã“ã¨ã‚’æ„味ã—ã€``never`` ã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸æš—å·åŒ–ãŒæ±ºã—ã¦ä½¿ç”¨ã•ã‚Œãªã„ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:737 +#: ../../rst/os_guide/windows_winrm.rst:739 msgid "``ansible_winrm_ca_trust_path``: Used to specify a different cacert container than the one used in the ``certifi`` module. See the HTTPS Certificate Validation section for more details." msgstr "``ansible_winrm_ca_trust_path``: ``certifi`` モジュールã§ä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹ã‚‚ã®ã¨ã¯ç•°ãªã‚‹ cacert コンテナーを指定ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã—ã¾ã™ã€‚詳細ã¯ã€ã€ŒHTTPS 証明書ã®æ¤œè¨¼ã€ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:741 +#: ../../rst/os_guide/windows_winrm.rst:743 msgid "``ansible_winrm_send_cbt``: When using ``ntlm`` or ``kerberos`` over HTTPS, the authentication library will try to send channel binding tokens to mitigate against man in the middle attacks. This flag controls whether these bindings will be sent or not (default: ``yes``)." msgstr "``ansible_winrm_send_cbt``: ``ntlm`` ã¾ãŸã¯ ``kerberos`` ã‚’ HTTPS ã§ä½¿ç”¨ã™ã‚‹å ´åˆã€èªè¨¼ãƒ©ã‚¤ãƒ–ラリーã¯ã€ä¸é–“者攻撃を緩和ã™ã‚‹ãŸã‚ã«ãƒãƒ£ãƒ³ãƒãƒ«ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãƒˆãƒ¼ã‚¯ãƒ³ã®é€ä¿¡ã‚’試ã¿ã¾ã™ã€‚ã“ã®ãƒ•ãƒ©ã‚°ã¯ã€ã“れらã®ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã‚’é€ä¿¡ã™ã‚‹ã‹ã©ã†ã‹ã‚’制御ã—ã¾ã™ (デフォルト: ``yes``)。" -#: ../../rst/os_guide/windows_winrm.rst:746 +#: ../../rst/os_guide/windows_winrm.rst:748 msgid "``ansible_winrm_*``: Any additional keyword arguments supported by ``winrm.Protocol`` may be provided in place of ``*``" msgstr "``ansible_winrm_*``: ``winrm.Protocol`` ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ä»»æ„ã®è¿½åŠ ã‚ーワード引数ã¯ã€ä»£ã‚ã‚Šã« ``*`` ã§æŒ‡å®šã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:749 +#: ../../rst/os_guide/windows_winrm.rst:751 msgid "In addition, there are also specific variables that need to be set for each authentication option. See the section on authentication above for more information." msgstr "ã•ã‚‰ã«ã€å„èªè¨¼ã‚ªãƒ—ションã§è¨å®šã™ã‚‹å¿…è¦ãŒã‚る特定ã®å¤‰æ•°ã‚‚ã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€ä¸Šè¨˜ã®èªè¨¼ã«é–¢ã™ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:752 +#: ../../rst/os_guide/windows_winrm.rst:754 msgid "Ansible 2.0 has deprecated the \"ssh\" from ``ansible_ssh_user``, ``ansible_ssh_pass``, ``ansible_ssh_host``, and ``ansible_ssh_port`` to become ``ansible_user``, ``ansible_password``, ``ansible_host``, and ``ansible_port``. If using a version of Ansible prior to 2.0, the older style (``ansible_ssh_*``) should be used instead. The shorter variables are ignored, without warning, in older versions of Ansible." msgstr "Ansible 2.0 ã§ã¯ã€``ansible_ssh_user``ã€``ansible_ssh_pass``ã€``ansible_ssh_host``ã€ãŠã‚ˆã³ ``ansible_ssh_port`` ã®ã€Œsshã€ãŒéžæŽ¨å¥¨ã¨ãªã‚Šã€``ansible_user``ã€``ansible_password``ã€``ansible_host``ã€ãŠã‚ˆã³ ``ansible_port`` ã¨ãªã‚Šã¾ã—ãŸã€‚Ansible 2.0 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ä»£ã‚ã‚Šã«å¤ã„スタイル (``ansible_ssh_*``) を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚çŸã„æ–¹ã®å¤‰æ•°ã¯ã€å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã§ã¯è¦å‘Šãªã—ã«ç„¡è¦–ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:759 +#: ../../rst/os_guide/windows_winrm.rst:761 msgid "``ansible_winrm_message_encryption`` is different from transport encryption done over TLS. The WinRM payload is still encrypted with TLS when run over HTTPS, even if ``ansible_winrm_message_encryption=never``." msgstr "``ansible_winrm_message_encryption`` ã¯ã€TLS 上ã§è¡Œã‚れるトランスãƒãƒ¼ãƒˆæš—å·åŒ–ã¨ã¯ç•°ãªã‚Šã¾ã™ã€‚WinRM ペイãƒãƒ¼ãƒ‰ã¯ã€``ansible_winrm_message_encryption=never`` ã§ã‚ã£ã¦ã‚‚ã€HTTPS ã§å®Ÿè¡Œã•ã‚ŒãŸå ´åˆã§ã‚‚ TLS ã§æš—å·åŒ–ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:766 +#: ../../rst/os_guide/windows_winrm.rst:768 msgid "IPv6 Addresses" msgstr "IPv6 アドレス" -#: ../../rst/os_guide/windows_winrm.rst:768 +#: ../../rst/os_guide/windows_winrm.rst:770 msgid "IPv6 addresses can be used instead of IPv4 addresses or hostnames. This option is normally set in an inventory. Ansible will attempt to parse the address using the `ipaddress <https://docs.python.org/3/library/ipaddress.html>`_ package and pass to pywinrm correctly." msgstr "IPv4 アドレスやホストåã®ä»£ã‚ã‚Šã«ã€IPv6 アドレスを使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã®ã‚ªãƒ—ションã¯é€šå¸¸ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§è¨å®šã—ã¾ã™ã€‚Ansible ã¯ã€`ipaddress <https://docs.python.org/3/library/ipaddress.html>`_ パッケージを使用ã—ã¦ã‚¢ãƒ‰ãƒ¬ã‚¹ã®è§£æžã‚’試ã¿ã€pywinrm ã«æ£ã—ã渡ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:773 +#: ../../rst/os_guide/windows_winrm.rst:775 msgid "When defining a host using an IPv6 address, just add the IPv6 address as you would an IPv4 address or hostname:" msgstr "IPv6 アドレスを使用ã—ã¦ãƒ›ã‚¹ãƒˆã‚’定義ã™ã‚‹å ´åˆã¯ã€IPv4 アドレスやホストåã¨åŒã˜ã‚ˆã†ã« IPv6 ã‚¢ãƒ‰ãƒ¬ã‚¹ã‚’è¿½åŠ ã™ã‚‹ã ã‘ã§ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:787 +#: ../../rst/os_guide/windows_winrm.rst:789 msgid "The ipaddress library is only included by default in Python 3.x. To use IPv6 addresses in Python 2.7, make sure to run ``pip install ipaddress`` which installs a backported package." msgstr "ipaddress ライブラリー㯠Python 3.x ã«ã®ã¿ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚Python 2.7 㧠IPv6 アドレスを使用ã™ã‚‹ã«ã¯ã€ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã•ã‚ŒãŸãƒ‘ッケージをインストールã™ã‚‹ ``pip install ipaddress`` ã‚’å¿…ãšå®Ÿè¡Œã—ã¦ãã ã•ã„。" -#: ../../rst/os_guide/windows_winrm.rst:794 +#: ../../rst/os_guide/windows_winrm.rst:796 msgid "HTTPS Certificate Validation" msgstr "HTTPS 証明書ã®æ¤œè¨¼" -#: ../../rst/os_guide/windows_winrm.rst:796 +#: ../../rst/os_guide/windows_winrm.rst:798 msgid "As part of the TLS protocol, the certificate is validated to ensure the host matches the subject and the client trusts the issuer of the server certificate. When using a self-signed certificate or setting ``ansible_winrm_server_cert_validation: ignore`` these security mechanisms are bypassed. While self signed certificates will always need the ``ignore`` flag, certificates that have been issued from a certificate authority can still be validated." msgstr "TLS プãƒãƒˆã‚³ãƒ«ã®ä¸€ç’°ã¨ã—ã¦ã€è¨¼æ˜Žæ›¸ãŒæ¤œè¨¼ã•ã‚Œã€ãƒ›ã‚¹ãƒˆãŒã‚µãƒ–ジェクトã¨ä¸€è‡´ã—ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãŒã‚µãƒ¼ãƒãƒ¼è¨¼æ˜Žæ›¸ã®ç™ºè¡Œè€…ã‚’ä¿¡é ¼ã—ã¦ã„ã‚‹ã“ã¨ãŒç¢ºèªã•ã‚Œã¾ã™ã€‚自己署å証明書を使用ã—ãŸã‚Šã€``ansible_winrm_server_cert_validation: ignore`` ã‚’è¨å®šã—ãŸã‚Šã™ã‚‹ã¨ã€ã“れらã®ã‚»ã‚ュリティーメカニズムãŒå›žé¿ã•ã‚Œã¾ã™ã€‚自己署å証明書ã«ã¯å¸¸ã« ``ignore`` フラグãŒå¿…è¦ã§ã™ãŒã€èªè¨¼å±€ã‹ã‚‰ç™ºè¡Œã•ã‚ŒãŸè¨¼æ˜Žæ›¸ã¯æ¤œè¨¼ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:804 +#: ../../rst/os_guide/windows_winrm.rst:806 msgid "One of the more common ways of setting up a HTTPS listener in a domain environment is to use Active Directory Certificate Service (AD CS). AD CS is used to generate signed certificates from a Certificate Signing Request (CSR). If the WinRM HTTPS listener is using a certificate that has been signed by another authority, like AD CS, then Ansible can be set up to trust that issuer as part of the TLS handshake." msgstr "ドメイン環境㧠HTTPS リスナーをセットアップã™ã‚‹ä¸€èˆ¬çš„ãªæ–¹æ³•ã® 1 ã¤ã«ã€Active Directory Certificate Service (AD CS) を使用ã™ã‚‹æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚AD CS ã¯ã€CSR (Certificate Signing Request) ã‹ã‚‰ç½²å付ã証明書を生æˆã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚WinRM HTTPS リスナー㌠AD CS ã®ã‚ˆã†ãªåˆ¥ã®æ©Ÿé–¢ã«ã‚ˆã£ã¦ç½²åã•ã‚ŒãŸè¨¼æ˜Žæ›¸ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã€Ansible 㯠TLS ãƒãƒ³ãƒ‰ã‚·ã‚§ã‚¤ã‚¯ã®ä¸€éƒ¨ã¨ã—ã¦ãã®ç™ºè¡Œè€…ã‚’ä¿¡é ¼ã™ã‚‹ã‚ˆã†ã«è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:811 +#: ../../rst/os_guide/windows_winrm.rst:813 msgid "To get Ansible to trust a Certificate Authority (CA) like AD CS, the issuer certificate of the CA can be exported as a PEM encoded certificate. This certificate can then be copied locally to the Ansible controller and used as a source of certificate validation, otherwise known as a CA chain." msgstr "AD CS ã®ã‚ˆã†ãªèªè¨¼å±€ (CA) ã‚’ Ansible ã«ä¿¡é ¼ã•ã›ã‚‹ã«ã¯ã€CA ã®ç™ºè¡Œè€…証明書を PEM エンコード証明書ã¨ã—ã¦ã‚¨ã‚¯ã‚¹ãƒãƒ¼ãƒˆã—ã¾ã™ã€‚ã“ã®è¨¼æ˜Žæ›¸ã¯ã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã®ãƒãƒ¼ã‚«ãƒ«ã«ã‚³ãƒ”ーã—ã¦ã€è¨¼æ˜Žæ›¸æ¤œè¨¼ã®ã‚½ãƒ¼ã‚¹ã¨ã—ã¦ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ (CA ãƒã‚§ãƒ¼ãƒ³ã¨ã‚‚呼ã°ã‚Œã¾ã™)。" -#: ../../rst/os_guide/windows_winrm.rst:816 +#: ../../rst/os_guide/windows_winrm.rst:818 msgid "The CA chain can contain a single or multiple issuer certificates and each entry is contained on a new line. To then use the custom CA chain as part of the validation process, set ``ansible_winrm_ca_trust_path`` to the path of the file. If this variable is not set, the default CA chain is used instead which is located in the install path of the Python package `certifi <https://github.com/certifi/python-certifi>`_." msgstr "CA ãƒã‚§ãƒ¼ãƒ³ã«ã¯ã€å˜ä¸€ã¾ãŸã¯è¤‡æ•°ã®ç™ºè¡Œè€…証明書をå«ã‚ã‚‹ã“ã¨ãŒã§ãã€å„エントリーã¯æ–°ã—ã„è¡Œã«å«ã¾ã‚Œã¾ã™ã€‚èªè¨¼ãƒ—ãƒã‚»ã‚¹ã®ä¸€éƒ¨ã¨ã—ã¦ã‚«ã‚¹ã‚¿ãƒ CA ãƒã‚§ãƒ¼ãƒ³ã‚’使用ã™ã‚‹ã«ã¯ã€``ansible_winrm_ca_trust_path`` ã«ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ‘スをè¨å®šã—ã¾ã™ã€‚ã“ã®å¤‰æ•°ãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€Python パッケージ `certifi <https://github.com/certifi/python-certifi>`_ ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãƒ‘スã«ã‚るデフォルト㮠CAムェーンãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:823 +#: ../../rst/os_guide/windows_winrm.rst:825 msgid "Each HTTP call is done by the Python requests library which does not use the systems built-in certificate store as a trust authority. Certificate validation will fail if the server's certificate issuer is only added to the system's truststore." msgstr "HTTP 呼ã³å‡ºã—ã¯ãã‚Œãžã‚Œã€ã‚·ã‚¹ãƒ†ãƒ ã«çµ„ã¿è¾¼ã¾ã‚ŒãŸè¨¼æ˜Žæ›¸ã‚¹ãƒˆã‚¢ã‚’ä¿¡é ¼æ©Ÿé–¢ã¨ã—ã¦ä½¿ç”¨ã—ãªã„ Python リクエストライブラリーã«ã‚ˆã£ã¦è¡Œã‚ã‚Œã¾ã™ã€‚サーãƒãƒ¼ã®è¨¼æ˜Žæ›¸ç™ºè¡Œè€…ãŒã‚·ã‚¹ãƒ†ãƒ ã®ãƒˆãƒ©ã‚¹ãƒˆã‚¹ãƒˆã‚¢ã«è¿½åŠ ã•ã‚Œã¦ã„ãªã„å ´åˆã€è¨¼æ˜Žæ›¸ã®æ¤œè¨¼ã¯å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:831 +#: ../../rst/os_guide/windows_winrm.rst:833 msgid "TLS 1.2 Support" msgstr "TLS 1.2 ã®ã‚µãƒãƒ¼ãƒˆ" -#: ../../rst/os_guide/windows_winrm.rst:833 +#: ../../rst/os_guide/windows_winrm.rst:835 msgid "As WinRM runs over the HTTP protocol, using HTTPS means that the TLS protocol is used to encrypt the WinRM messages. TLS will automatically attempt to negotiate the best protocol and cipher suite that is available to both the client and the server. If a match cannot be found then Ansible will error out with a message similar to:" msgstr "WinRM 㯠HTTP プãƒãƒˆã‚³ãƒ«ä¸Šã§å‹•ä½œã™ã‚‹ãŸã‚ã€HTTPS を使用ã™ã‚‹ã¨ã„ã†ã“ã¨ã¯ã€WinRM メッセージã®æš—å·åŒ–ã« TLS プãƒãƒˆã‚³ãƒ«ãŒä½¿ç”¨ã•ã‚Œã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚TLS ã¯ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã¨ã‚µãƒ¼ãƒãƒ¼ã®ä¸¡æ–¹ã§åˆ©ç”¨å¯èƒ½ãªã€æœ€é©ãªãƒ—ãƒãƒˆã‚³ãƒ«ã¨æš—å·ã‚¹ã‚¤ãƒ¼ãƒˆã‚’自動的ã«å–り決ã‚よã†ã¨ã—ã¾ã™ã€‚一致ã™ã‚‹ã‚‚ã®ãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã€Ansible ã¯æ¬¡ã®ã‚ˆã†ãªãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã§ã‚¨ãƒ©ãƒ¼ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:843 +#: ../../rst/os_guide/windows_winrm.rst:845 msgid "Commonly this is when the Windows host has not been configured to support TLS v1.2 but it could also mean the Ansible controller has an older OpenSSL version installed." msgstr "ã“ã‚Œã¯ã€Windows ホスト㌠TLS v1.2 をサãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«è¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã§ã™ãŒã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã«å¤ã„ OpenSSL ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚‚æ„味ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:847 +#: ../../rst/os_guide/windows_winrm.rst:849 msgid "Windows 8 and Windows Server 2012 come with TLS v1.2 installed and enabled by default but older hosts, like Server 2008 R2 and Windows 7, have to be enabled manually." msgstr "Windows 8 ãŠã‚ˆã³ Windows Server 2012 ã«ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ TLS v1.2 ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã€æœ‰åŠ¹ã«ãªã£ã¦ã„ã¾ã™ãŒã€Server 2008 R2 ã‚„ Windows 7 ãªã©ã®å¤ã„ホストã¯æ‰‹å‹•ã§æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:851 +#: ../../rst/os_guide/windows_winrm.rst:853 msgid "There is a bug with the TLS 1.2 patch for Server 2008 which will stop Ansible from connecting to the Windows host. This means that Server 2008 cannot be configured to use TLS 1.2. Server 2008 R2 and Windows 7 are not affected by this issue and can use TLS 1.2." msgstr "Server 2008 ã® TLS 1.2 パッãƒã«ã¯ãƒã‚°ãŒã‚ã‚Šã€Ansible ã® Windows ホストã¸ã®æŽ¥ç¶šãŒåœæ¢ã—ã¦ã—ã¾ã„ã¾ã™ã€‚ã“ã‚Œã¯ã€Server 2008 ㌠TLS 1.2 を使用ã™ã‚‹ã‚ˆã†ã«è¨å®šã§ããªã„ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚Server 2008 R2 ã¨Windows 7 ã¯ã“ã®å•é¡Œã®å½±éŸ¿ã‚’å—ã‘ãšã€TLS 1.2 を使用ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:856 +#: ../../rst/os_guide/windows_winrm.rst:858 msgid "To verify what protocol the Windows host supports, you can run the following command on the Ansible controller:" msgstr "Windows ホストãŒå¯¾å¿œã—ã¦ã„るプãƒãƒˆã‚³ãƒ«ã‚’確èªã™ã‚‹ã«ã¯ã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã§ä»¥ä¸‹ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:863 +#: ../../rst/os_guide/windows_winrm.rst:865 msgid "The output will contain information about the TLS session and the ``Protocol`` line will display the version that was negotiated:" msgstr "出力ã«ã¯ TLS セッションã«é–¢ã™ã‚‹æƒ…å ±ãŒå«ã¾ã‚Œã€``Protocol`` è¡Œã«ã¯ãƒã‚´ã‚·ã‚¨ãƒ¼ãƒˆã•ã‚ŒãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:901 +#: ../../rst/os_guide/windows_winrm.rst:903 msgid "If the host is returning ``TLSv1`` then it should be configured so that TLS v1.2 is enable. You can do this by running the following PowerShell script:" msgstr "ホスト㌠``TLSv1`` ã‚’è¿”ã™å ´åˆã¯ã€TLS v1.2 ãŒæœ‰åŠ¹ã«ãªã‚‹ã‚ˆã†ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€æ¬¡ã® PowerShell スクリプトを実行ã™ã‚‹ã“ã¨ã§è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:926 +#: ../../rst/os_guide/windows_winrm.rst:928 msgid "The below Ansible tasks can also be used to enable TLS v1.2:" msgstr "以下㮠Ansible タスクを使用ã—㦠TLS v1.2 を有効ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:956 +#: ../../rst/os_guide/windows_winrm.rst:958 msgid "There are other ways to configure the TLS protocols as well as the cipher suites that are offered by the Windows host. One tool that can give you a GUI to manage these settings is `IIS Crypto <https://www.nartac.com/Products/IISCrypto/>`_ from Nartac Software." msgstr "TLS プãƒãƒˆã‚³ãƒ«ã‚„ã€Windows ホストãŒæä¾›ã™ã‚‹æš—å·ã‚¹ã‚¤ãƒ¼ãƒˆã‚’è¨å®šã™ã‚‹æ–¹æ³•ã¯ä»–ã«ã‚‚ã‚ã‚Šã¾ã™ã€‚ã“れらã®è¨å®šã‚’管ç†ã™ã‚‹ãŸã‚ã® GUI ã‚’æä¾›ã™ã‚‹ãƒ„ールã¨ã—ã¦ã€Nartac Software 社㮠`IIS Crypto <https://www.nartac.com/Products/IISCrypto/>`_ ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:964 +#: ../../rst/os_guide/windows_winrm.rst:966 msgid "WinRM limitations" msgstr "WinRM ã®åˆ¶é™" -#: ../../rst/os_guide/windows_winrm.rst:965 +#: ../../rst/os_guide/windows_winrm.rst:967 msgid "Due to the design of the WinRM protocol , there are a few limitations when using WinRM that can cause issues when creating playbooks for Ansible. These include:" msgstr "WinRM プãƒãƒˆã‚³ãƒ«ã®è¨è¨ˆä¸Šã€WinRM を使用ã™ã‚‹éš›ã«ã¯ã„ãã¤ã‹ã®åˆ¶é™ãŒã‚ã‚Šã€Ansible ã® Playbook を作æˆã™ã‚‹éš›ã«å•é¡Œã¨ãªã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã¯æ¬¡ã®ã‚ˆã†ãªã‚‚ã®ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:969 +#: ../../rst/os_guide/windows_winrm.rst:971 msgid "Credentials are not delegated for most authentication types, which causes authentication errors when accessing network resources or installing certain programs." msgstr "ã»ã¨ã‚“ã©ã®èªè¨¼ã‚¿ã‚¤ãƒ—ã§èªè¨¼æƒ…å ±ãŒå§”è²ã•ã‚Œã¦ã„ãªã„ãŸã‚ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒªã‚½ãƒ¼ã‚¹ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã‚„特定ã®ãƒ—ãƒã‚°ãƒ©ãƒ ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ™‚ã«èªè¨¼ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã—ãŸã€‚" -#: ../../rst/os_guide/windows_winrm.rst:973 +#: ../../rst/os_guide/windows_winrm.rst:975 msgid "Many calls to the Windows Update API are blocked when running over WinRM." msgstr "WinRM 経由ã§å®Ÿè¡Œã™ã‚‹ã¨ã€Windows Update API ã¸ã®å¤šãã®å‘¼ã³å‡ºã—ãŒãƒ–ãƒãƒƒã‚¯ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:975 +#: ../../rst/os_guide/windows_winrm.rst:977 msgid "Some programs fail to install with WinRM due to no credential delegation or because they access forbidden Windows API like WUA over WinRM." msgstr "èªè¨¼æƒ…å ±ã®å§”è²ã‚„ã€WUA over WinRM ãªã©ã®ç¦æ¢ã•ã‚Œã¦ã„ã‚‹ Windows API ã¸ã®ã‚¢ã‚¯ã‚»ã‚¹ã«ã‚ˆã‚Šã€ä¸€éƒ¨ã®ãƒ—ãƒã‚°ãƒ©ãƒ 㯠WinRM ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ããªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:978 +#: ../../rst/os_guide/windows_winrm.rst:980 msgid "Commands under WinRM are done under a non-interactive session, which can prevent certain commands or executables from running." msgstr "WinRM ã®ã‚³ãƒžãƒ³ãƒ‰ã¯éžå¯¾è©±åž‹ã‚»ãƒƒã‚·ãƒ§ãƒ³ã§å®Ÿè¡Œã•ã‚Œã‚‹ãŸã‚ã€ç‰¹å®šã®ã‚³ãƒžãƒ³ãƒ‰ã‚„実行ファイルãŒå®Ÿè¡Œã§ããªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:981 +#: ../../rst/os_guide/windows_winrm.rst:983 msgid "You cannot run a process that interacts with ``DPAPI``, which is used by some installers (like Microsoft SQL Server)." msgstr "一部ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ©ãƒ¼ (Microsoft SQL Server ãªã©) ãŒä½¿ç”¨ã™ã‚‹ ``DPAPI`` ã¨å¯¾è©±ã™ã‚‹ãƒ—ãƒã‚»ã‚¹ã‚’実行ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。" -#: ../../rst/os_guide/windows_winrm.rst:984 +#: ../../rst/os_guide/windows_winrm.rst:986 msgid "Some of these limitations can be mitigated by doing one of the following:" msgstr "ã“ã®åˆ¶é™ã®ä¸€éƒ¨ã¯ã€ä»¥ä¸‹ã®ã„ãšã‚Œã‹ã‚’実行ã—ã¦è»½æ¸›ã§ãã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:986 +#: ../../rst/os_guide/windows_winrm.rst:988 msgid "Set ``ansible_winrm_transport`` to ``credssp`` or ``kerberos`` (with ``ansible_winrm_kerberos_delegation=true``) to bypass the double hop issue and access network resources" msgstr "ダブルホップå•é¡Œã‚’回é¿ã—ã¦ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒªã‚½ãƒ¼ã‚¹ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ãŸã‚ã«ã€``ansible_winrm_transport`` ã‚’ ``credssp`` ã¾ãŸã¯ ``kerberos`` (``ansible_winrm_kerberos_delegation=true`` を使用) ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:990 +#: ../../rst/os_guide/windows_winrm.rst:992 msgid "Use ``become`` to bypass all WinRM restrictions and run a command as it would locally. Unlike using an authentication transport like ``credssp``, this will also remove the non-interactive restriction and API restrictions like WUA and DPAPI" msgstr "``become`` を使用ã™ã‚‹ã¨ã€ã™ã¹ã¦ã® WinRM 制é™ã‚’回é¿ã—ã¦ã€ãƒãƒ¼ã‚«ãƒ«ã¨åŒæ§˜ã«ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã§ãã¾ã™ã€‚``credssp`` ã®ã‚ˆã†ãªèªè¨¼ãƒˆãƒ©ãƒ³ã‚¹ãƒãƒ¼ãƒˆã‚’使用ã™ã‚‹å ´åˆã¨ã¯ç•°ãªã‚Šã€éžå¯¾è©±åž‹ã®åˆ¶é™ã‚„ã€WUA ã‚„ DPAPI ãªã©ã® API ã®åˆ¶é™ã‚‚解除ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/os_guide/windows_winrm.rst:995 +#: ../../rst/os_guide/windows_winrm.rst:997 msgid "Use a scheduled task to run a command which can be created with the ``win_scheduled_task`` module. Like ``become``, this bypasses all WinRM restrictions but can only run a command and not modules." msgstr "``win_scheduled_task`` モジュールã§ä½œæˆã•ã‚Œã‚‹ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ãŸã‚ã«ã€ã‚¹ã‚±ã‚¸ãƒ¥ãƒ¼ãƒ«ã•ã‚ŒãŸã‚¿ã‚¹ã‚¯ã‚’使用ã—ã¾ã™ã€‚``become`` ã¨åŒæ§˜ã«ã€WinRM ã®åˆ¶é™ã‚’ã™ã¹ã¦å›žé¿ã—ã¾ã™ãŒã€å®Ÿè¡Œã§ãã‚‹ã®ã¯ã‚³ãƒžãƒ³ãƒ‰ã®ã¿ã§ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å®Ÿè¡Œã§ãã¾ã›ã‚“。" +#~ msgid "A WinRM listener should be created and activated. More details for this can be found below." +#~ msgstr "WinRM リスナーを作æˆã—ã€æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ä»¥ä¸‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#~ msgid "Once completed, you will need to remove auto logon and set the execution policy back to the default (``Restricted `` for Windows clients, or ``RemoteSigned`` for Windows servers). You can do this with the following PowerShell commands:" +#~ msgstr "完了ã—ãŸã‚‰ã€è‡ªå‹•ãƒã‚°ã‚ªãƒ³ã‚’解除ã—ã¦ã€å®Ÿè¡Œãƒãƒªã‚·ãƒ¼ã‚’デフォルト (Windows クライアントã®å ´åˆã¯ ``Restricted ``ã€Windows サーãƒãƒ¼ã®å ´åˆã¯ ``RemoteSigned``) ã«æˆ»ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã¯ä»¥ä¸‹ã® PowerShell コマンドãŒå¿…è¦ã§ã™ã€‚" + +#~ msgid "The script works by checking to see what programs need to be installed (such as .NET Framework 4.5.2) and what PowerShell version is required. If a reboot is required and the ``username`` and ``password`` parameters are set, the script will automatically reboot and logon when it comes back up from the reboot. The script will continue until no more actions are required and the PowerShell version matches the target version. If the ``username`` and ``password`` parameters are not set, the script will prompt the user to manually reboot and logon when required. When the user is next logged in, the script will continue where it left off and the process continues until no more actions are required." +#~ msgstr "ã“ã®ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒå¿…è¦ãªãƒ—ãƒã‚°ãƒ©ãƒ (.NET Framework 4.5.2 ãªã©) ã‚„ã€å¿…è¦ãª PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã—ã¦å‹•ä½œã—ã¾ã™ã€‚å†èµ·å‹•ãŒå¿…è¦ã§ã€``username`` パラメーター㨠``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã‚¹ã‚¯ãƒªãƒ—トãŒè‡ªå‹•çš„ã«å†èµ·å‹•ã—ã€å†èµ·å‹•ã‹ã‚‰å¾©å¸°ã—ãŸã¨ãã«ãƒã‚°ã‚ªãƒ³ã—ã¾ã™ã€‚スクリプトã¯ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒä¸è¦ã«ãªã‚Šã€PowerShell ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ä¸€è‡´ã™ã‚‹ã¾ã§ç¶šè¡Œã•ã‚Œã¾ã™ã€‚``username`` パラメーターãŠã‚ˆã³ ``password`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã€ã‚¹ã‚¯ãƒªãƒ—トã¯å¿…è¦ã«å¿œã˜ã¦ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«æ‰‹å‹•ã§å†èµ·å‹•ã¨ãƒã‚°ã‚ªãƒ³ã‚’促ã—ã¾ã™ã€‚ユーザーãŒæ¬¡ã«ãƒã‚°ã‚¤ãƒ³ã™ã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯å‰å›žã®ç¶šãを実行ã—ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒå¿…è¦ãªããªã‚‹ã¾ã§å‡¦ç†ã‚’続ã‘ã¾ã™ã€‚" + +#~ msgid "If running on Server 2008, then SP2 must be installed. If running on Server 2008 R2 or Windows 7, then SP1 must be installed." +#~ msgstr "Server 2008 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€SP2 ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Server 2008 R2 ã¾ãŸã¯ Windows 7 ã§å®Ÿè¡Œã—ã¦ã„ã‚‹å ´åˆã¯ SP1 をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "When running on PowerShell v3.0, there is a bug with the WinRM service that limits the amount of memory available to WinRM. Without this hotfix installed, Ansible will fail to execute certain commands on the Windows host. These hotfixes should be installed as part of the system bootstrapping or imaging process. The script `Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ can be used to install the hotfix on affected hosts." +#~ msgstr "PowerShell v3.0 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€WinRM サービスã®ãƒã‚°ã«ã‚ˆã‚Šã€WinRM ã§ä½¿ç”¨ã§ãるメモリーé‡ãŒåˆ¶é™ã•ã‚Œã‚‹ã¨ã„ã†å•é¡ŒãŒã‚ã‚Šã¾ã—ãŸã€‚ã“ã® Hotfix をインストールã—ãªã„ã¨ã€Windows ホスト上㧠Ansible ã«ã‚ˆã‚‹ç‰¹å®šã®ã‚³ãƒžãƒ³ãƒ‰ã®å®Ÿè¡Œã«å¤±æ•—ã—ã¾ã™ã€‚ã“れら㮠Hotfix ã¯ã€ã‚·ã‚¹ãƒ†ãƒ ã®ãƒ–ートストラップã¾ãŸã¯ã‚¤ãƒ¡ãƒ¼ã‚¸ãƒ³ã‚°ãƒ—ãƒã‚»ã‚¹ã®ä¸€éƒ¨ã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚`Install-WMF3Hotfix.ps1 <https://github.com/jborean93/ansible-windows/blob/master/scripts/Install-WMF3Hotfix.ps1>`_ ã¨ã„ã†ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã¨ã€å½±éŸ¿ã‚’å—ã‘るホスト㫠hotfix をインストールã§ãã¾ã™ã€‚" + +#~ msgid "The following PowerShell command will install the hotfix:" +#~ msgstr "以下㮠PowerShell コマンド㯠hotfix をインストールã—ã¾ã™ã€‚" + +#~ msgid "``CertificateThumbprint``: If running over an HTTPS listener, this is the thumbprint of the certificate in the Windows Certificate Store that is used in the connection. To get the details of the certificate itself, run this command with the relevant certificate thumbprint in PowerShell:" +#~ msgstr "``CertificateThumbprint``: HTTPS リスナーを介ã—ã¦å®Ÿè¡Œã™ã‚‹å ´åˆã€ã“ã‚Œã¯æŽ¥ç¶šã«ä½¿ç”¨ã•ã‚Œã‚‹ Windows 証明書ストアã®è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントã§ã™ã€‚証明書自体ã®è©³ç´°ã‚’å–å¾—ã™ã‚‹ã«ã¯ã€PowerShell ã§è©²å½“ã™ã‚‹è¨¼æ˜Žæ›¸ã®ã‚µãƒ プリントを指定ã—ã¦æ¬¡ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚" + +#~ msgid "When creating an HTTPS listener, an existing certificate needs to be created and stored in the ``LocalMachine\\My`` certificate store. Without a certificate being present in this store, most commands will fail." +#~ msgstr "HTTPS リスナーを作æˆã™ã‚‹éš›ã«ã¯ã€æ—¢å˜ã®è¨¼æ˜Žæ›¸ã‚’作æˆã—ã€``LocalMachine\\My`` ã®è¨¼æ˜Žæ›¸ã‚¹ãƒˆã‚¢ã«ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚¹ãƒˆã‚¢ã«è¨¼æ˜Žæ›¸ãŒå˜åœ¨ã—ãªã„ã¨ã€ã»ã¨ã‚“ã©ã®ã‚³ãƒžãƒ³ãƒ‰ãŒå¤±æ•—ã—ã¾ã™ã€‚" + +#~ msgid "While many of these options should rarely be changed, a few can easily impact the operations over WinRM and are useful to understand. Some of the important options are:" +#~ msgstr "ã“れらã®ã‚ªãƒ—ションã®å¤šãã¯ã»ã¨ã‚“ã©å¤‰æ›´ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ã„ãã¤ã‹ã®ã‚ªãƒ—ション㯠WinRM ã®æ“作ã«ç°¡å˜ã«å½±éŸ¿ã‚’与ãˆã‚‹ãŸã‚ã€ç†è§£ã—ã¦ãŠãã¨ä¾¿åˆ©ã§ã™ã€‚é‡è¦ãªã‚ªãƒ—ションã®ä¸€éƒ¨ã‚’紹介ã—ã¾ã™ã€‚" + +#~ msgid "``Service\\AllowUnencrypted``: This option defines whether WinRM will allow traffic that is run over HTTP without message encryption. Message level encryption is only possible when ``ansible_winrm_transport`` is ``ntlm``, ``kerberos`` or ``credssp``. By default this is ``false`` and should only be set to ``true`` when debugging WinRM messages." +#~ msgstr "``Service\\AllowUnencrypted``: ã“ã®ã‚ªãƒ—ションã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’æš—å·åŒ–ã›ãšã« HTTP ã§å®Ÿè¡Œã™ã‚‹ãƒˆãƒ©ãƒ•ã‚£ãƒƒã‚¯ã‚’ WinRM ã§è¨±å¯ã™ã‚‹ã‹ã©ã†ã‹ã‚’定義ã—ã¾ã™ã€‚メッセージレベルã®æš—å·åŒ–ã¯ã€``ansible_winrm_transport`` ㌠``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` ã®å ´åˆã«ã®ã¿å¯èƒ½ã§ã™ã€‚デフォルトã§ã¯ã€ã“れ㯠``false`` ã§ã‚ã‚Šã€WinRM メッセージをデãƒãƒƒã‚°ã™ã‚‹å ´åˆã«é™ã‚Š ``true`` ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "To modify a setting under the ``Service`` key in PowerShell:" +#~ msgstr "PowerShell ã® ``Service`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#~ msgid "To modify a setting under the ``Winrs`` key in PowerShell:" +#~ msgstr "PowerShell ã® ``Winrs`` ã‚ーã§è¨å®šã‚’変更ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" + +#~ msgid "If this fails, the issue is probably related to the WinRM setup. If it works, the issue may not be related to the WinRM setup; please continue reading for more troubleshooting suggestions." +#~ msgstr "失敗ã—ãŸå ´åˆã¯ã€WinRM ã®è¨å®šã«å•é¡ŒãŒã‚ã‚‹ã¨æ€ã‚ã‚Œã¾ã™ã€‚æˆåŠŸã—ãŸå ´åˆã¯ã€å•é¡ŒãŒ WinRM ã®è¨å®šã«é–¢é€£ã—ã¦ã„ãªã„å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã•ã‚‰ã«è©³ã—ã„トラブルシューティングã®æ–¹æ³•ã‚’ã”確èªãã ã•ã„。" + +#~ msgid "If running over HTTP and not HTTPS, use ``ntlm``, ``kerberos`` or ``credssp`` with ``ansible_winrm_message_encryption: auto`` to enable message encryption. If using another authentication option or if the installed pywinrm version cannot be upgraded, the ``Service\\AllowUnencrypted`` can be set to ``true`` but this is only recommended for troubleshooting" +#~ msgstr "HTTPS ã§ã¯ãªã HTTP ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€``ntlm``ã€``kerberos``ã€ã¾ãŸã¯ ``credssp`` 㨠``ansible_winrm_message_encryption: auto`` を使用ã—ã¦ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã®æš—å·åŒ–を有効ã«ã—ã¦ãã ã•ã„。他ã®èªè¨¼ã‚ªãƒ—ションを使用ã—ã¦ã„ã‚‹å ´åˆã‚„ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ pywinrm ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’アップグレードã§ããªã„å ´åˆã¯ã€``Service\\AllowUnencrypted`` ã‚’``true`` ã«è¨å®šã§ãã¾ã™ãŒã€ã“ã‚Œã¯ãƒˆãƒ©ãƒ–ルシューティングã®ãŸã‚ã«ã®ã¿æŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" + +#~ msgid "These indicate an error has occurred with the WinRM service. Some things to check for include:" +#~ msgstr "ã“れらã¯ã€WinRM サービスã§ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—ãŸã“ã¨ã‚’示ã—ã¦ã„ã¾ã™ã€‚確èªã™ã¹ã点ã¯ä»¥ä¸‹ã®é€šã‚Šã§ã™ã€‚" + +#~ msgid "These usually indicate an error with the network connection where Ansible is unable to reach the host. Some things to check for include:" +#~ msgstr "ã“れらã¯é€šå¸¸ã€Ansible ãŒãƒ›ã‚¹ãƒˆã«åˆ°é”ã§ããªã„ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯æŽ¥ç¶šã®ã‚¨ãƒ©ãƒ¼ã‚’示ã—ã¦ã„ã¾ã™ã€‚ãƒã‚§ãƒƒã‚¯é …ç›®ã«ã¯ä»¥ä¸‹ãŒå«ã¾ã‚Œã¾ã™ã€‚" + +#~ msgid "These usually indicate an error when trying to communicate with the WinRM service on the host. Some things to check for:" +#~ msgstr "ã“れらã¯é€šå¸¸ã€ãƒ›ã‚¹ãƒˆä¸Šã® WinRM サービスã¨é€šä¿¡ã—よã†ã¨ã™ã‚‹éš›ã«ã‚¨ãƒ©ãƒ¼ã‚’示ã—ã¾ã™ã€‚ã„ãã¤ã‹ã®ãƒã‚§ãƒƒã‚¯é …ç›®ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "If powershell fails with an error message similar to ``The 'Out-String' command was found in the module 'Microsoft.PowerShell.Utility', but the module could not be loaded.`` then there could be a problem trying to access all the paths specified by the ``PSModulePath`` environment variable. A common cause of this issue is that the ``PSModulePath`` environment variable contains a UNC path to a file share and because of the double hop/credential delegation issue the Ansible process cannot access these folders. The way around this problems is to either:" +#~ msgstr "``The 'Out-String' command was found in the module 'Microsoft.PowerShell.Utility', but the module could not be loaded.`` ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã§ powershell ãŒå¤±æ•—ã™ã‚‹å ´åˆã¯ã€``PSModulePath`` 環境変数ã§æŒ‡å®šã•ã‚ŒãŸã™ã¹ã¦ã®ãƒ‘スã«ã‚¢ã‚¯ã‚»ã‚¹ã—よã†ã¨ã™ã‚‹ã¨å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®å•é¡Œã®ä¸€èˆ¬çš„ãªåŽŸå› ã¯ã€``PSModulePath`` 環境変数ã«ãƒ•ã‚¡ã‚¤ãƒ«å…±æœ‰ã¸ã® UNC パスãŒå«ã¾ã‚Œã¦ãŠã‚Šã€ãƒ€ãƒ–ルホップ/èªè¨¼æƒ…å ±ã®å§”è²å•é¡Œã®ãŸã‚ã« Ansible プãƒã‚»ã‚¹ãŒã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ããªã„ã“ã¨ã§ã™ã€‚ã“ã®å•é¡Œã‚’回é¿ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "Remove the UNC path from the ``PSModulePath`` environment variable, or" +#~ msgstr "``PSModulePath`` 環境変数ã‹ã‚‰ UNC パスを削除ã—ã¾ã™ã€‚" + +#~ msgid "The first step to using SSH with Windows is to install the `Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ service on the Windows host. Microsoft offers a way to install ``Win32-OpenSSH`` through a Windows capability but currently the version that is installed through this process is too old to work with Ansible. To install ``Win32-OpenSSH`` for use with Ansible, select one of these installation options:" +#~ msgstr "Windows 㧠SSH を利用ã™ã‚‹ãŸã‚ã®æœ€åˆã®ã‚¹ãƒ†ãƒƒãƒ—ã¯ã€Windows ホスト㫠`Win32-OpenSSH <https://github.com/PowerShell/Win32-OpenSSH>`_ サービスをインストールã™ã‚‹ã“ã¨ã§ã™ã€‚Microsoft 社ã§ã¯ã€Windows ã®æ©Ÿèƒ½ã‚’利用ã—㦠``Win32-OpenSSH`` をインストールã™ã‚‹æ–¹æ³•ã‚’æä¾›ã—ã¦ã„ã¾ã™ãŒã€ç¾åœ¨ã€ã“ã®æ–¹æ³•ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€Ansible ã§å‹•ä½œã•ã›ã‚‹ã«ã¯å¤ã™ãŽã¾ã™ã€‚Ansible ã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã« ``Win32-OpenSSH`` をインストールã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚ªãƒ—ションã®ã„ãšã‚Œã‹ã‚’é¸æŠžã—ã¾ã™ã€‚" + +#~ msgid "Install the `openssh <https://chocolatey.org/packages/openssh>`_ package using Chocolatey:" +#~ msgstr "Chocolatey を使用ã—㦠`openssh <https://chocolatey.org/packages/openssh>`_ パッケージをインストールã—ã¾ã™ã€‚" + +#~ msgid "Use ``win_chocolatey`` to install the service" +#~ msgstr "``win_chocolatey`` を使用ã—ã¦ã‚µãƒ¼ãƒ“スをインストールã—ã¾ã™ã€‚" + +#~ msgid "Win32-OpenSSH authentication with Windows is similar to SSH authentication on Unix/Linux hosts. You can use a plaintext password or SSH public key authentication, add public keys to an ``authorized_key`` file in the ``.ssh`` folder of the user's profile directory, and configure the service using the ``sshd_config`` file used by the SSH service as you would on a Unix/Linux host." +#~ msgstr "Windows ã§ã® Win32-OpenSSH èªè¨¼ã¯ã€Unix/Linux ホストã§ã® SSH èªè¨¼ã«ä¼¼ã¦ã„ã¾ã™ã€‚平文ã®ãƒ‘スワードã¾ãŸã¯ SSH 公開éµèªè¨¼ã‚’使用ã—ã€å…¬é–‹éµã‚’ユーザーã®ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã® ``.ssh`` ディレクトリーã«ã‚ã‚‹ ``authorized_key`` ファイルã«è¿½åŠ ã—ã€Unix/Linux ホストã¨åŒæ§˜ã« SSH サービスã§ä½¿ç”¨ã•ã‚Œã‚‹ ``sshd_config`` ファイルを使用ã—ã¦ã‚µãƒ¼ãƒ“スをè¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#~ msgid "The ``ansible_shell_type`` variable should reflect the ``DefaultShell`` configured on the Windows host. Set to ``cmd`` for the default shell or set to ``powershell`` if the ``DefaultShell`` has been changed to PowerShell." +#~ msgstr "``ansible_shell_type`` 変数ã«ã¯ã€Windows ホストã§è¨å®šã•ã‚Œã¦ã„ã‚‹``DefaultShell`` ã‚’åæ˜ ã•ã›ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚デフォルトシェルã®å ´åˆã¯ ``cmd`` ã«ã€``DefaultShell`` ㌠PowerShell ã«å¤‰æ›´ã—ã¦ã„ã‚‹å ´åˆã¯ ``powershell`` ã«è¨å®šã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/playbook_guide.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/playbook_guide.po index d77abb0a..b28e5523 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/playbook_guide.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/playbook_guide.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/playbook_guide/complex_data_manipulation.rst:4 msgid "Manipulating data" @@ -221,11 +221,11 @@ msgid "An example on how to use facts to find a host's data that meets condition msgstr "ファクトを使用ã—ã¦ã€æ¡ä»¶ X を満ãŸã™ãƒ›ã‚¹ãƒˆã®ãƒ‡ãƒ¼ã‚¿ã‚’検索ã™ã‚‹ä¾‹:" #: ../../rst/playbook_guide/complex_data_manipulation.rst:298 -msgid "An example to show a host uptime in days/hours/minutes/seconds (assumes facts where gathered)." +msgid "An example to show a host uptime in days/hours/minutes/seconds (assumes facts were gathered)." msgstr "ホストã®ã‚¢ãƒƒãƒ—タイムを日数/時間/分/秒ã§è¡¨ç¤ºã™ã‚‹ä¾‹ï¼ˆåŽé›†ã•ã‚Œã‚‹ãƒ•ã‚¡ã‚¯ãƒˆã‚’想定）" #: ../../rst/playbook_guide/complex_data_manipulation.rst:309 -#: ../../rst/playbook_guide/playbooks_variables.rst:519 +#: ../../rst/playbook_guide/playbooks_variables.rst:521 msgid ":ref:`playbooks_filters`" msgstr ":ref:`playbooks_filters`" @@ -473,7 +473,7 @@ msgstr "ã“ã“ã§èª¬æ˜Žã—㟠lamp_haproxy ã®ä¾‹ã§ã™ã€‚" #: ../../rst/playbook_guide/playbooks_conditionals.rst:540 #: ../../rst/playbook_guide/playbooks_lookups.rst:28 #: ../../rst/playbook_guide/playbooks_reuse.rst:211 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:594 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:596 #: ../../rst/playbook_guide/playbooks_roles.rst:15 msgid ":ref:`working_with_playbooks`" msgstr ":ref:`working_with_playbooks`" @@ -486,7 +486,7 @@ msgstr ":ref:`working_with_playbooks`" #: ../../rst/playbook_guide/playbooks_delegation.rst:166 #: ../../rst/playbook_guide/playbooks_environment.rst:149 #: ../../rst/playbook_guide/playbooks_error_handling.rst:269 -#: ../../rst/playbook_guide/playbooks_filters.rst:2185 +#: ../../rst/playbook_guide/playbooks_filters.rst:2189 #: ../../rst/playbook_guide/playbooks_lookups.rst:29 #: ../../rst/playbook_guide/playbooks_loops.rst:487 #: ../../rst/playbook_guide/playbooks_prompts.rst:116 @@ -495,19 +495,19 @@ msgstr ":ref:`working_with_playbooks`" #: ../../rst/playbook_guide/playbooks_tags.rst:426 #: ../../rst/playbook_guide/playbooks_templating.rst:26 #: ../../rst/playbook_guide/playbooks_tests.rst:528 -#: ../../rst/playbook_guide/playbooks_variables.rst:516 +#: ../../rst/playbook_guide/playbooks_variables.rst:518 msgid "An introduction to playbooks" msgstr "Playbook ã®æ¦‚è¦" #: ../../rst/playbook_guide/guide_rolling_upgrade.rst:319 #: ../../rst/playbook_guide/playbooks_blocks.rst:188 #: ../../rst/playbook_guide/playbooks_conditionals.rst:542 -#: ../../rst/playbook_guide/playbooks_filters.rst:2192 +#: ../../rst/playbook_guide/playbooks_filters.rst:2196 #: ../../rst/playbook_guide/playbooks_loops.rst:488 #: ../../rst/playbook_guide/playbooks_strategies.rst:249 #: ../../rst/playbook_guide/playbooks_tags.rst:427 #: ../../rst/playbook_guide/playbooks_tests.rst:535 -#: ../../rst/playbook_guide/playbooks_variables.rst:523 +#: ../../rst/playbook_guide/playbooks_variables.rst:525 msgid ":ref:`playbooks_reuse_roles`" msgstr ":ref:`playbooks_reuse_roles`" @@ -519,12 +519,12 @@ msgstr "Playbook ã®ãƒãƒ¼ãƒ«ã®æ¦‚è¦" #: ../../rst/playbook_guide/playbooks_advanced_syntax.rst:115 #: ../../rst/playbook_guide/playbooks_conditionals.rst:546 #: ../../rst/playbook_guide/playbooks_error_handling.rst:274 -#: ../../rst/playbook_guide/playbooks_filters.rst:2188 +#: ../../rst/playbook_guide/playbooks_filters.rst:2192 #: ../../rst/playbook_guide/playbooks_lookups.rst:32 #: ../../rst/playbook_guide/playbooks_loops.rst:494 #: ../../rst/playbook_guide/playbooks_prompts.rst:119 #: ../../rst/playbook_guide/playbooks_reuse.rst:213 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:598 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:600 #: ../../rst/playbook_guide/playbooks_tests.rst:531 msgid ":ref:`playbooks_variables`" msgstr ":ref:`playbooks_variables`" @@ -597,59 +597,59 @@ msgstr "è¨å®šãƒ‘ス" msgid "By default these should be relative to the config file, some are specifically relative to the current working directory or the playbook and should have this noted in their description. Things like ssh keys are left to use the current working directory because it mirrors how the underlying tools would use it." msgstr "デフォルトã§ã¯ã€ã“れらã¯è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ã®ç›¸å¯¾çš„ãªã‚‚ã®ã§ã™ãŒã€ä¸ã«ã¯ç‰¹ã«ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚„ Playbook ã‹ã‚‰ã®ç›¸å¯¾çš„ãªã‚‚ã®ã‚‚ã‚ã‚‹ãŸã‚ã€èª¬æ˜Žã«ãã®æ—¨ã‚’記載ã—ã¦ãã ã•ã„。ssh ã‚ーã®ã‚ˆã†ãªã‚‚ã®ã¯ã€åŸºæœ¬çš„ãªãƒ„ールãŒä½¿ç”¨ã™ã‚‹æ–¹æ³•ã‚’åæ˜ ã™ã‚‹ãŸã‚ã€ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’使用ã™ã‚‹ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbook_pathing.rst:19 +#: ../../rst/playbook_guide/playbook_pathing.rst:20 msgid "Task paths" msgstr "タスクパス" -#: ../../rst/playbook_guide/playbook_pathing.rst:21 +#: ../../rst/playbook_guide/playbook_pathing.rst:22 msgid "Relative paths used in a task typically refer to remote files and directories on the managed nodes. However, paths passed to lookup plugins and some paths used in action plugins such as the \"src\" path for the :ref:`template <ansible_collections.ansible.builtin.template_module>` and :ref:`copy <ansible_collections.ansible.builtin.copy_module>` modules refer to local files and directories on the control node." msgstr "タスクã§ä½¿ç”¨ã•ã‚Œã‚‹ç›¸å¯¾ãƒ‘スã¯é€šå¸¸ã€ç®¡ç†ãƒŽãƒ¼ãƒ‰ã®ãƒªãƒ¢ãƒ¼ãƒˆãƒ•ã‚¡ã‚¤ãƒ«ãŠã‚ˆã³ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’å‚ç…§ã—ã¾ã™ã€‚ãŸã ã—ã€lookup プラグインã«æ¸¡ã•ã‚Œã‚‹ãƒ‘スやã€:ref:`template <ansible_collections.ansible.builtin.template_module>` モジュールãŠã‚ˆã³ :ref:`copy <ansible_collections.ansible.builtin.copy_module>` モジュールã®ã€Œsrcã€ãƒ‘スç‰ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãƒ—ラグインã§ä½¿ç”¨ã•ã‚Œã‚‹ä¸€éƒ¨ã®ãƒ‘スã¯ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã®ãƒãƒ¼ã‚«ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ãŠã‚ˆã³ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’å‚ç…§ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbook_pathing.rst:24 +#: ../../rst/playbook_guide/playbook_pathing.rst:25 msgid "Resolving local relative paths" msgstr "ãƒãƒ¼ã‚«ãƒ«ç›¸å¯¾ãƒ‘スã®è§£æ±º" -#: ../../rst/playbook_guide/playbook_pathing.rst:26 +#: ../../rst/playbook_guide/playbook_pathing.rst:27 msgid "When you specify a relative path for a local file, Ansible will try to find that file first in the current task's role, then in other roles that included or depend on the current role, then relative to the file in which the task is defined, and finally relative to the current play. It will take the first matching file that it finds. This way, if multiple files with the same filename exist, Ansible will find the file that is closest to the current task and that is most likely to be file you wanted." msgstr "ãƒãƒ¼ã‚«ãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã®ç›¸å¯¾ãƒ‘スを指定ã™ã‚‹å ´åˆã€Ansible ã¯ç¾åœ¨ã®ã‚¿ã‚¹ã‚¯ã®ãƒãƒ¼ãƒ«ã§ã¾ãšãã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’見ã¤ã‘よã†ã¨ã—ã¾ã™ã€‚次ã«ã€ç¾åœ¨ã®ãƒãƒ¼ãƒ«ã«å«ã¾ã‚Œã‚‹ã€ã¾ãŸã¯ä¾å˜ã™ã‚‹ä»–ã®ãƒãƒ¼ãƒ«ã§ã€æ¬¡ã«ã‚¿ã‚¹ã‚¯ãŒå®šç¾©ã•ã‚Œã¦ã„るファイルã«ç›¸å¯¾çš„ã«ã€æœ€å¾Œã«ç¾åœ¨ã®ãƒ—レイã«ç›¸å¯¾çš„ã«è¦‹ã¤ã‘よã†ã¨ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€æœ€åˆã«è¦‹ã¤ã‹ã£ãŸãƒžãƒƒãƒã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã—ãŸãŒã£ã¦ã€åŒã˜ãƒ•ã‚¡ã‚¤ãƒ«åã‚’æŒã¤è¤‡æ•°ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒå˜åœ¨ã™ã‚‹å ´åˆã€Ansible ã¯ç¾åœ¨ã®ã‚¿ã‚¹ã‚¯ã«ã‚‚ã£ã¨ã‚‚è¿‘ãã€å¸Œæœ›ã®ãƒ•ã‚¡ã‚¤ãƒ«ã§ã‚ã‚‹å¯èƒ½æ€§ãŒé«˜ã„ファイルを検索ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbook_pathing.rst:28 +#: ../../rst/playbook_guide/playbook_pathing.rst:29 msgid "Specifically, Ansible tries to find the file" msgstr "具体的ã«ã¯ã€Ansible ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’検索ã—よã†ã¨ã—ã¾ã™" -#: ../../rst/playbook_guide/playbook_pathing.rst:30 +#: ../../rst/playbook_guide/playbook_pathing.rst:31 msgid "In the current role." msgstr "ç¾åœ¨ã®ãƒãƒ¼ãƒ«ã§" -#: ../../rst/playbook_guide/playbook_pathing.rst:32 +#: ../../rst/playbook_guide/playbook_pathing.rst:33 msgid "In its appropriate subdirectory—\"files\", \"vars\", \"templates\" or \"tasks\", depending on the kind of file Ansible is searching for." msgstr "Ansible ãŒæ¤œç´¢ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã®ç¨®é¡žã«å¿œã˜ã¦ã€é©åˆ‡ãªã‚µãƒ–ディレクトリー(「filesã€ã€ã€Œvarsã€ã€ã€Œtemplatesã€ã€ã¾ãŸã¯ã€Œtasksã€)ã§" -#: ../../rst/playbook_guide/playbook_pathing.rst:33 +#: ../../rst/playbook_guide/playbook_pathing.rst:34 msgid "Directly in its directory." msgstr "ãã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«ç›´æŽ¥" -#: ../../rst/playbook_guide/playbook_pathing.rst:35 +#: ../../rst/playbook_guide/playbook_pathing.rst:36 msgid "Like 1, in the parent role that called into this current role with `include_role`, `import_role`, or with a role dependency. If the parent role has its own parent role, Ansible will repeat this step with that role." msgstr "1 ã¨åŒæ§˜ã«ã€`include_role`ã€`import_role` ã¾ãŸã¯ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã§ã“ã®ç¾åœ¨ã®ãƒãƒ¼ãƒ«ã«å‘¼ã³å‡ºã•ã‚Œã‚‹è¦ªãƒãƒ¼ãƒ«ã§ã€‚親ãƒãƒ¼ãƒ«ã«ç‹¬è‡ªã®è¦ªãƒãƒ¼ãƒ«ãŒã‚ã‚‹å ´åˆã¯ã€Ansible ã¯ãã®ãƒãƒ¼ãƒ«ã§ã“ã®æ‰‹é †ã‚’ç¹°ã‚Šè¿”ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbook_pathing.rst:36 +#: ../../rst/playbook_guide/playbook_pathing.rst:37 msgid "Like 1, in the current task file's directory." msgstr "1 ã¨åŒæ§˜ã«ã€ç¾åœ¨ã®ã‚¿ã‚¹ã‚¯ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§" -#: ../../rst/playbook_guide/playbook_pathing.rst:37 +#: ../../rst/playbook_guide/playbook_pathing.rst:38 msgid "Like 1, in the current play file's directory." msgstr "1 ã¨åŒæ§˜ã«ã€ç¾åœ¨ã® play ファイルã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã§" -#: ../../rst/playbook_guide/playbook_pathing.rst:39 +#: ../../rst/playbook_guide/playbook_pathing.rst:40 msgid "Ansible does not search the current working directory. (The directory you're in when you execute Ansible.) Also, Ansible will only search within a role if you actually included it with an `include_role` or `import_role` task or a dependency. If you instead use `include`, `include_task` or `import_task` to include just the tasks from a specific file but not the full role, Ansible will not search that role in steps 1 and 2." msgstr "Ansible ã¯ã€ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼(Ansibleを実行ã™ã‚‹æ™‚ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼)を検索ã—ã¾ã›ã‚“。ã¾ãŸã€`include_role` ã¾ãŸã¯ `import_role` タスクã¾ãŸã¯ä¾å˜é–¢ä¿‚ã§å®Ÿéš›ã«å«ã‚ãŸå ´åˆã€Ansible ã¯ãƒãƒ¼ãƒ«å†…ã®ã¿æ¤œç´¢ã—ã¾ã™ã€‚代ã‚ã‚Šã«ã€`include`ã€`include_task`ã€ã¾ãŸã¯ `import_task` を使用ã—ã¦ã€å®Œå…¨ãªãƒãƒ¼ãƒ«ã§ã¯ãªã特定ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ã®ã‚¿ã‚¹ã‚¯ã ã‘ã‚’å«ã‚ã‚‹å ´åˆã€Ansible ã¯ã‚¹ãƒ†ãƒƒãƒ—1ãŠã‚ˆã³2ã§ãã®ãƒãƒ¼ãƒ«ã‚’検索ã—ã¾ã›ã‚“。" -#: ../../rst/playbook_guide/playbook_pathing.rst:41 +#: ../../rst/playbook_guide/playbook_pathing.rst:42 msgid "When you execute Ansible, the variable `ansible_search_path` will contain the paths searched, in the order they were searched in but without listing their subdirectories. If you run Ansible in verbosity level 5 by passing the `-vvvvv` argument, Ansible will report each directory as it searches, except when it searches for a tasks file." msgstr "Ansible を実行ã™ã‚‹ã¨ã€å¤‰æ•° `ansible_search_path` ã«ã¯ã€æ¤œç´¢ã•ã‚ŒãŸãƒ‘スãŒæ¤œç´¢ã•ã‚ŒãŸé †ã«å«ã¾ã‚Œã¾ã™ãŒã€ãã®ã‚µãƒ–ディレクトリーã¯ä¸€è¦§è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“。`-vvvvv` 引数を渡ã—ã¦è©³ç´°ãƒ¬ãƒ™ãƒ«5ã§Ansible を実行ã™ã‚‹ã¨ã€ã‚¿ã‚¹ã‚¯ãƒ•ã‚¡ã‚¤ãƒ«ã‚’検索ã—ãŸå ´åˆã‚’除ãã€Ansible ã¯æ¤œç´¢ã—ãŸé †ã«å„ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’å ±å‘Šã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbook_pathing.rst:44 +#: ../../rst/playbook_guide/playbook_pathing.rst:45 msgid "The current working directory might vary depending on the connection plugin and if the action is local or remote. For the remote it is normally the directory on which the login shell puts the user. For local it is either the directory you executed ansible from or in some cases the playbook directory." msgstr "ç¾åœ¨ã®ä½œæ¥ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã¯ã€æŽ¥ç¶šãƒ—ラグインã¨ã€ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãŒãƒãƒ¼ã‚«ãƒ«ã‹ãƒªãƒ¢ãƒ¼ãƒˆã‹ã«ã‚ˆã£ã¦ç•°ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚リモートã®å ´åˆã€é€šå¸¸ã€ãƒã‚°ã‚¤ãƒ³ã‚·ã‚§ãƒ«ãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’é…ç½®ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ãªã‚Šã¾ã™ã€‚ãƒãƒ¼ã‚«ãƒ«ã®å ´åˆã¯ã€ansibleを実行ã—ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã‹ã€å ´åˆã«ã‚ˆã£ã¦ã¯Playbokディレクトリã«ãªã‚Šã¾ã™ã€‚" @@ -737,7 +737,7 @@ msgstr "``version`` ã®å€¤ã‚’ ``&my_version`` ã¨ã„ã†ã‚¢ãƒ³ã‚«ãƒ¼ã§å›ºå®šã—ã #: ../../rst/playbook_guide/playbooks_advanced_syntax.rst:116 #: ../../rst/playbook_guide/playbooks_conditionals.rst:547 #: ../../rst/playbook_guide/playbooks_error_handling.rst:275 -#: ../../rst/playbook_guide/playbooks_filters.rst:2189 +#: ../../rst/playbook_guide/playbooks_filters.rst:2193 #: ../../rst/playbook_guide/playbooks_lookups.rst:33 #: ../../rst/playbook_guide/playbooks_loops.rst:495 #: ../../rst/playbook_guide/playbooks_prompts.rst:120 @@ -755,7 +755,7 @@ msgstr "Ansible ã§ã®è¤‡é›‘ãªãƒ‡ãƒ¼ã‚¿æ“作ã®å®Ÿè¡Œ" #: ../../rst/playbook_guide/playbooks_advanced_syntax.rst:119 msgid "`User Mailing List <https://groups.google.com/group/ansible-project>`_" -msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansible-project>`_" +msgstr "`User Mailing List <https://groups.google.com/group/ansible-project>`_" #: ../../rst/playbook_guide/playbooks_advanced_syntax.rst:120 #: ../../rst/playbook_guide/playbooks_async.rst:187 @@ -765,7 +765,7 @@ msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansi #: ../../rst/playbook_guide/playbooks_delegation.rst:172 #: ../../rst/playbook_guide/playbooks_environment.rst:151 #: ../../rst/playbook_guide/playbooks_error_handling.rst:277 -#: ../../rst/playbook_guide/playbooks_filters.rst:2197 +#: ../../rst/playbook_guide/playbooks_filters.rst:2201 #: ../../rst/playbook_guide/playbooks_lookups.rst:37 #: ../../rst/playbook_guide/playbooks_loops.rst:497 #: ../../rst/playbook_guide/playbooks_prompts.rst:122 @@ -773,7 +773,7 @@ msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansi #: ../../rst/playbook_guide/playbooks_tags.rst:430 #: ../../rst/playbook_guide/playbooks_templating.rst:32 #: ../../rst/playbook_guide/playbooks_tests.rst:540 -#: ../../rst/playbook_guide/playbooks_variables.rst:530 +#: ../../rst/playbook_guide/playbooks_variables.rst:532 msgid "Have a question? Stop by the google group!" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" @@ -785,7 +785,7 @@ msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_delegation.rst:173 #: ../../rst/playbook_guide/playbooks_environment.rst:152 #: ../../rst/playbook_guide/playbooks_error_handling.rst:278 -#: ../../rst/playbook_guide/playbooks_filters.rst:2198 +#: ../../rst/playbook_guide/playbooks_filters.rst:2202 #: ../../rst/playbook_guide/playbooks_lookups.rst:38 #: ../../rst/playbook_guide/playbooks_loops.rst:498 #: ../../rst/playbook_guide/playbooks_privilege_escalation.rst:775 @@ -794,7 +794,7 @@ msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_tags.rst:431 #: ../../rst/playbook_guide/playbooks_templating.rst:33 #: ../../rst/playbook_guide/playbooks_tests.rst:541 -#: ../../rst/playbook_guide/playbooks_variables.rst:531 +#: ../../rst/playbook_guide/playbooks_variables.rst:533 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" @@ -806,7 +806,7 @@ msgstr ":ref:`communication_irc`" #: ../../rst/playbook_guide/playbooks_delegation.rst:174 #: ../../rst/playbook_guide/playbooks_environment.rst:153 #: ../../rst/playbook_guide/playbooks_error_handling.rst:279 -#: ../../rst/playbook_guide/playbooks_filters.rst:2199 +#: ../../rst/playbook_guide/playbooks_filters.rst:2203 #: ../../rst/playbook_guide/playbooks_lookups.rst:39 #: ../../rst/playbook_guide/playbooks_loops.rst:499 #: ../../rst/playbook_guide/playbooks_privilege_escalation.rst:776 @@ -815,7 +815,7 @@ msgstr ":ref:`communication_irc`" #: ../../rst/playbook_guide/playbooks_tags.rst:432 #: ../../rst/playbook_guide/playbooks_templating.rst:34 #: ../../rst/playbook_guide/playbooks_tests.rst:542 -#: ../../rst/playbook_guide/playbooks_variables.rst:532 +#: ../../rst/playbook_guide/playbooks_variables.rst:534 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -953,7 +953,7 @@ msgstr ":ref:`playbooks_intro`" #: ../../rst/playbook_guide/playbooks_delegation.rst:171 #: ../../rst/playbook_guide/playbooks_environment.rst:150 #: ../../rst/playbook_guide/playbooks_error_handling.rst:276 -#: ../../rst/playbook_guide/playbooks_filters.rst:2196 +#: ../../rst/playbook_guide/playbooks_filters.rst:2200 #: ../../rst/playbook_guide/playbooks_lookups.rst:36 #: ../../rst/playbook_guide/playbooks_loops.rst:496 #: ../../rst/playbook_guide/playbooks_prompts.rst:121 @@ -961,7 +961,7 @@ msgstr ":ref:`playbooks_intro`" #: ../../rst/playbook_guide/playbooks_tags.rst:429 #: ../../rst/playbook_guide/playbooks_templating.rst:31 #: ../../rst/playbook_guide/playbooks_tests.rst:539 -#: ../../rst/playbook_guide/playbooks_variables.rst:529 +#: ../../rst/playbook_guide/playbooks_variables.rst:531 msgid "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" msgstr "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" @@ -986,8 +986,8 @@ msgid "Block example with named tasks inside the block" msgstr "内部ã«åå‰ä»˜ãタスクをå«ã‚€ãƒ–ãƒãƒƒã‚¯ã®ä¾‹" #: ../../rst/playbook_guide/playbooks_blocks.rst:46 -msgid "In the example above, the 'when' condition will be evaluated before Ansible runs each of the three tasks in the block. All three tasks also inherit the privilege escalation directives, running as the root user. Finally, ``ignore_errors: yes`` ensures that Ansible continues to execute the playbook even if some of the tasks fail." -msgstr "上ã®ä¾‹ã§ã¯ã€Ansible ãŒãƒ–ãƒãƒƒã‚¯å†…ã® 3 ã¤ã®ã‚¿ã‚¹ã‚¯ã‚’ãã‚Œãžã‚Œå®Ÿè¡Œã™ã‚‹å‰ã«ã€ã€Œwhenã€æ¡ä»¶ãŒè©•ä¾¡ã•ã‚Œã¾ã™ã€‚ã¾ãŸã€3 ã¤ã®ã‚¿ã‚¹ã‚¯ã¯ã™ã¹ã¦ã€ç‰¹æ¨©æ˜‡æ ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を継承ã—ã€root ユーザーã¨ã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚最後ã«ã€``ignore_errors: yes`` ã¯ã€ä¸€éƒ¨ã®ã‚¿ã‚¹ã‚¯ãŒå¤±æ•—ã—ã¦ã‚‚ã€Ansible ㌠Playbook ã®å®Ÿè¡Œã‚’継続ã™ã‚‹ã“ã¨ã‚’ä¿è¨¼ã—ã¾ã™ã€‚" +msgid "In the example above, the 'when' condition will be evaluated before Ansible runs each of the three tasks in the block. All three tasks also inherit the privilege escalation directives, running as the root user. Finally, ``ignore_errors: true`` ensures that Ansible continues to execute the playbook even if some of the tasks fail." +msgstr "上ã®ä¾‹ã§ã¯ã€Ansible ãŒãƒ–ãƒãƒƒã‚¯å†…ã® 3 ã¤ã®ã‚¿ã‚¹ã‚¯ã‚’ãã‚Œãžã‚Œå®Ÿè¡Œã™ã‚‹å‰ã«ã€ã€Œwhenã€æ¡ä»¶ãŒè©•ä¾¡ã•ã‚Œã¾ã™ã€‚ã¾ãŸã€3 ã¤ã®ã‚¿ã‚¹ã‚¯ã¯ã™ã¹ã¦ã€ç‰¹æ¨©æ˜‡æ ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–を継承ã—ã€root ユーザーã¨ã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚最後ã«ã€``ignore_errors: true`` ã¯ã€ä¸€éƒ¨ã®ã‚¿ã‚¹ã‚¯ãŒå¤±æ•—ã—ã¦ã‚‚ã€Ansible ㌠Playbook ã®å®Ÿè¡Œã‚’継続ã™ã‚‹ã“ã¨ã‚’ä¿è¨¼ã—ã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_blocks.rst:48 msgid "Names for blocks have been available since Ansible 2.3. We recommend using names in all tasks, within blocks or elsewhere, for better visibility into the tasks being executed when you run the playbook." @@ -1067,12 +1067,12 @@ msgstr "``ansible-core`` 2.14 以é™ã§ã¯ã€ä¸¡æ–¹ã®å¤‰æ•°ãŒå†…部ブãƒãƒƒã‚ #: ../../rst/playbook_guide/playbooks_blocks.rst:189 #: ../../rst/playbook_guide/playbooks_conditionals.rst:543 -#: ../../rst/playbook_guide/playbooks_filters.rst:2193 +#: ../../rst/playbook_guide/playbooks_filters.rst:2197 #: ../../rst/playbook_guide/playbooks_loops.rst:489 #: ../../rst/playbook_guide/playbooks_strategies.rst:250 #: ../../rst/playbook_guide/playbooks_tags.rst:428 #: ../../rst/playbook_guide/playbooks_tests.rst:536 -#: ../../rst/playbook_guide/playbooks_variables.rst:524 +#: ../../rst/playbook_guide/playbooks_variables.rst:526 msgid "Playbook organization by roles" msgstr "ãƒãƒ¼ãƒ«åˆ¥ã® Playbook ã®çµ„ç¹”" @@ -1322,7 +1322,7 @@ msgstr "``x`` ãŒæœ€åˆã«å®šç¾©ã•ã‚Œã¦ã„ã‚‹å ´åˆã€ä¸¡æ–¹ã®ã‚¿ã‚¹ã‚¯ãŒæ„ #: ../../rst/playbook_guide/playbooks_conditionals.rst:321 msgid "If this is not the behavior you want, use an ``include_*`` statement to apply a condition only to that statement itself." -msgstr "ã“ã®ã‚ˆã†ãªå‹•ä½œã‚’望ã¾ãªã„å ´åˆã¯ã€ 文を使用ã—ã¦ã€ãã®æ–‡è‡ªä½“ã«ã®ã¿æ¡ä»¶ã‚’é©ç”¨ã—ã¾ã™ã€‚" +msgstr "ã“ã®ã‚ˆã†ãªå‹•ä½œã‚’望ã¾ãªã„å ´åˆã¯ã€``include_*`` 文を使用ã—ã¦ã€ãã®æ–‡è‡ªä½“ã«ã®ã¿æ¡ä»¶ã‚’é©ç”¨ã—ã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_conditionals.rst:332 msgid "Now if ``x`` is initially undefined, the debug task will not be skipped because the conditional is evaluated at the time of the include and does not apply to the individual tasks." @@ -1447,25 +1447,25 @@ msgstr "ansible_facts['os_family']" #: ../../rst/playbook_guide/playbooks_conditionals.rst:544 #: ../../rst/playbook_guide/playbooks_error_handling.rst:270 -#: ../../rst/playbook_guide/playbooks_filters.rst:2194 +#: ../../rst/playbook_guide/playbooks_filters.rst:2198 #: ../../rst/playbook_guide/playbooks_intro.rst:148 #: ../../rst/playbook_guide/playbooks_loops.rst:490 #: ../../rst/playbook_guide/playbooks_reuse.rst:219 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:596 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:598 #: ../../rst/playbook_guide/playbooks_tests.rst:537 -#: ../../rst/playbook_guide/playbooks_variables.rst:525 +#: ../../rst/playbook_guide/playbooks_variables.rst:527 msgid ":ref:`tips_and_tricks`" msgstr ":ref:`tips_and_tricks`" #: ../../rst/playbook_guide/playbooks_conditionals.rst:545 #: ../../rst/playbook_guide/playbooks_error_handling.rst:271 -#: ../../rst/playbook_guide/playbooks_filters.rst:2195 +#: ../../rst/playbook_guide/playbooks_filters.rst:2199 #: ../../rst/playbook_guide/playbooks_loops.rst:491 #: ../../rst/playbook_guide/playbooks_reuse.rst:220 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:597 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:599 #: ../../rst/playbook_guide/playbooks_templating.rst:28 #: ../../rst/playbook_guide/playbooks_tests.rst:538 -#: ../../rst/playbook_guide/playbooks_variables.rst:526 +#: ../../rst/playbook_guide/playbooks_variables.rst:528 msgid "Tips and tricks for playbooks" msgstr "Playbook ã®ãƒ’ントã¨è£æŠ€" @@ -2148,24 +2148,24 @@ msgid "You can also use blocks to define responses to task errors. This approach msgstr "ブãƒãƒƒã‚¯ã‚’使用ã—ã¦ã‚¿ã‚¹ã‚¯ã‚¨ãƒ©ãƒ¼ã¸ã®å¿œç”を定義ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã®æ–¹æ³•ã¯ã€å¤šãã®ãƒ—ãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªžã§ã®ä¾‹å¤–処ç†ã«ä¼¼ã¦ã„ã¾ã™ã€‚詳細ã¨ä¾‹ã¯ã€ã€Œ:ref:`block_error_handling`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_error_handling.rst:272 -#: ../../rst/playbook_guide/playbooks_filters.rst:2186 +#: ../../rst/playbook_guide/playbooks_filters.rst:2190 #: ../../rst/playbook_guide/playbooks_lookups.rst:30 #: ../../rst/playbook_guide/playbooks_loops.rst:492 #: ../../rst/playbook_guide/playbooks_prompts.rst:117 #: ../../rst/playbook_guide/playbooks_reuse.rst:215 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:600 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:602 #: ../../rst/playbook_guide/playbooks_tests.rst:529 -#: ../../rst/playbook_guide/playbooks_variables.rst:517 +#: ../../rst/playbook_guide/playbooks_variables.rst:519 msgid ":ref:`playbooks_conditionals`" msgstr ":ref:`playbooks_conditionals`" #: ../../rst/playbook_guide/playbooks_error_handling.rst:273 -#: ../../rst/playbook_guide/playbooks_filters.rst:2187 +#: ../../rst/playbook_guide/playbooks_filters.rst:2191 #: ../../rst/playbook_guide/playbooks_lookups.rst:31 #: ../../rst/playbook_guide/playbooks_loops.rst:493 #: ../../rst/playbook_guide/playbooks_prompts.rst:118 #: ../../rst/playbook_guide/playbooks_tests.rst:530 -#: ../../rst/playbook_guide/playbooks_variables.rst:518 +#: ../../rst/playbook_guide/playbooks_variables.rst:520 msgid "Conditional statements in playbooks" msgstr "Playbook ã®æ¡ä»¶åˆ†å²æ–‡" @@ -3267,82 +3267,86 @@ msgstr "ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.6 以é™ã§ã¯ã€ä½¿ç”¨ã™ã‚‹ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã msgid "The ``string`` filter is only required for Python 2 and ensures that text to encode is a unicode string. Without that filter before b64encode the wrong value will be encoded." msgstr "``string`` フィルター㯠Python 2 ã§ã®ã¿å¿…è¦ã§ã™ã€‚エンコードã™ã‚‹ãƒ†ã‚ストãŒãƒ¦ãƒ‹ã‚³ãƒ¼ãƒ‰æ–‡å—列ã§ã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚b64encode よりå‰ã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’使用ã—ãªã„ã¨ã€èª¤ã£ãŸå€¤ãŒã‚¨ãƒ³ã‚³ãƒ¼ãƒ‰ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2067 +#: ../../rst/playbook_guide/playbooks_filters.rst:2064 +msgid "The return value of b64decode is a string. If you decrypt a binary blob using b64decode and then try to use it (for example by using :ref:`copy <copy_module>` to write it to a file) you will mostly likely find that your binary has been corrupted. If you need to take a base64 encoded binary and write it to disk, it is best to use the system ``base64`` command with the :ref:`shell module <shell_module>`, piping in the encoded data using the ``stdin`` parameter. For example: ``shell: cmd=\"base64 --decode > myfile.bin\" stdin=\"{{ encoded }}\"``" +msgstr "b64decode ã®æˆ»ã‚Šå€¤ã¯æ–‡å—列ã§ã™ã€‚b64decode を使用ã—ã¦ãƒã‚¤ãƒŠãƒªãƒ¼ BLOB を復å·åŒ–ã—ã¦ä½¿ç”¨ã—よã†ã¨ã™ã‚‹ã¨ (:ref:`copy <copy_module>` を使用ã—ã¦ãƒ•ã‚¡ã‚¤ãƒ«ã«æ›¸ã込むãªã©)ã€ã»ã¨ã‚“ã©ã®å ´åˆã€ãƒã‚¤ãƒŠãƒªãƒ¼ãŒç ´æã—ã¦ã„ã‚‹ã“ã¨ãŒã‚ã‹ã‚Šã¾ã™ã€‚base64 ã§ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‰ã•ã‚ŒãŸãƒã‚¤ãƒŠãƒªãƒ¼ã‚’å–å¾—ã—ã¦ãƒ‡ã‚£ã‚¹ã‚¯ã«æ›¸ã込む必è¦ãŒã‚ã‚‹å ´åˆã¯ã€:ref:`shell module <shell_module>` ã§ã‚·ã‚¹ãƒ†ãƒ ã® ``base64`` コマンドを使用ã—ã€``stdin`` を使用ã—ã¦ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‰ã•ã‚ŒãŸãƒ‡ãƒ¼ã‚¿ã§ã®ãƒ‘イプ指定を行ã†ã®ãŒæœ€é©ã§ã™ (例: ``shell: cmd=\"base64 --decode > myfile.bin\" stdin=\"{{ encoded }}\"``)。" + +#: ../../rst/playbook_guide/playbooks_filters.rst:2069 msgid "Managing UUIDs" msgstr "UUID ã®ç®¡ç†" -#: ../../rst/playbook_guide/playbooks_filters.rst:2069 +#: ../../rst/playbook_guide/playbooks_filters.rst:2071 msgid "To create a namespaced UUIDv5:" msgstr "namespace を使用ã—㟠UUIDv5 を作æˆã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2077 +#: ../../rst/playbook_guide/playbooks_filters.rst:2079 msgid "To create a namespaced UUIDv5 using the default Ansible namespace '361E6D51-FAEC-444A-9079-341386DA8E2E':" msgstr "デフォルト㮠Ansible åå‰ç©ºé–“「361E6D51-FAEC-444A-9079-341386DA8E2E2Eã€ã‚’使用ã—ã¦åå‰ç©ºé–“を指定ã—㟠UUIDv5 を作æˆã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2085 +#: ../../rst/playbook_guide/playbooks_filters.rst:2087 msgid "To make use of one attribute from each item in a list of complex variables, use the :func:`Jinja2 map filter <jinja2:jinja-filters.map>`:" msgstr "複雑ãªå¤‰æ•°ã®ãƒªã‚¹ãƒˆã§ã€å„é …ç›®ã‹ã‚‰ 1 ã¤ã®å±žæ€§ã‚’使用ã™ã‚‹ã«ã¯ã€:func:`Jinja2 map filter <jinja2:jinja-filters.map>` を使用ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2093 +#: ../../rst/playbook_guide/playbooks_filters.rst:2095 msgid "Handling dates and times" msgstr "日付ã¨æ™‚刻ã®å‡¦ç†" -#: ../../rst/playbook_guide/playbooks_filters.rst:2095 +#: ../../rst/playbook_guide/playbooks_filters.rst:2097 msgid "To get a date object from a string use the `to_datetime` filter:" msgstr "æ–‡å—列ã‹ã‚‰æ—¥ä»˜ã‚ªãƒ–ジェクトをå–å¾—ã™ã‚‹ã«ã¯ã€`to_datetime` フィルターを使用ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2109 -msgid "For a full list of format codes for working with python date format strings, see https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior." -msgstr "Python 日付形å¼ã®æ–‡å—列を使用ã™ã‚‹å½¢å¼ã‚³ãƒ¼ãƒ‰ã®å…¨ä¸€è¦§ã¯ã€https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/playbook_guide/playbooks_filters.rst:2111 +msgid "For a full list of format codes for working with python date format strings, see the `python datetime documentation <https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior>`_." +msgstr "Python 日付形å¼ã®æ–‡å—列を使用ã™ã‚‹å½¢å¼ã‚³ãƒ¼ãƒ‰ã®å…¨ä¸€è¦§ã¯ã€`python datetime documentation <https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_filters.rst:2113 +#: ../../rst/playbook_guide/playbooks_filters.rst:2115 msgid "To format a date using a string (like with the shell date command), use the \"strftime\" filter:" msgstr "æ–‡å—列 (shell date コマンドã®å ´åˆã®ã‚ˆã†ã«) を使用ã—ã¦æ—¥ä»˜ã‚’フォーマットã™ã‚‹ã«ã¯ã€ã€Œstrftimeã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2135 -msgid "strftime takes an optional utc argument, defaulting to False, meaning times are in the local timezone::" +#: ../../rst/playbook_guide/playbooks_filters.rst:2137 +msgid "strftime takes an optional utc argument, defaulting to False, meaning times are in the local timezone:" msgstr "strftime ã¯ã‚ªãƒ—ション㮠utc 引数をå–ã‚Šã¾ã™ã€‚デフォルト㯠False ã§ã€ãƒãƒ¼ã‚«ãƒ«ã‚¿ã‚¤ãƒ ゾーンã®æ™‚間を使用ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2140 +#: ../../rst/playbook_guide/playbooks_filters.rst:2144 msgid "To get all string possibilities, check https://docs.python.org/3/library/time.html#time.strftime" msgstr "ã™ã¹ã¦ã®æ–‡å—列ã®å¯èƒ½æ€§ã‚’å–å¾—ã™ã‚‹ã«ã¯ã€https://docs.python.org/3/library/time.html#time.strftime を確èªã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2143 +#: ../../rst/playbook_guide/playbooks_filters.rst:2147 msgid "Getting Kubernetes resource names" msgstr "Kubernetes リソースåã®å–å¾—" -#: ../../rst/playbook_guide/playbooks_filters.rst:2147 +#: ../../rst/playbook_guide/playbooks_filters.rst:2151 msgid "These filters have migrated to the `kubernetes.core <https://galaxy.ansible.com/kubernetes/core>`_ collection. Follow the installation instructions to install that collection." msgstr "ã“れらã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã¯ `kubernetes.core <https://galaxy.ansible.com/kubernetes/core>`_ コレクションã«ç§»è¡Œã—ã¾ã—ãŸã€‚ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ‰‹é †ã«å¾“ã£ã¦ãã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’インストールã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2149 +#: ../../rst/playbook_guide/playbooks_filters.rst:2153 msgid "Use the \"k8s_config_resource_name\" filter to obtain the name of a Kubernetes ConfigMap or Secret, including its hash:" msgstr "「k8s_config_resource_nameã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’使用ã—ã¦ã€Kubernetes ConfigMap ã¾ãŸã¯ Secret ã®åå‰ã‚’ã€ãã®ãƒãƒƒã‚·ãƒ¥ã‚’å«ã‚ã¦å–å¾—ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2156 +#: ../../rst/playbook_guide/playbooks_filters.rst:2160 msgid "This can then be used to reference hashes in Pod specifications:" msgstr "ã“ã‚Œã¯ã€Pod 仕様ã®ãƒãƒƒã‚·ãƒ¥ã‚’å‚ç…§ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_filters.rst:2184 +#: ../../rst/playbook_guide/playbooks_filters.rst:2188 #: ../../rst/playbook_guide/playbooks_loops.rst:486 #: ../../rst/playbook_guide/playbooks_strategies.rst:245 -#: ../../rst/playbook_guide/playbooks_variables.rst:515 +#: ../../rst/playbook_guide/playbooks_variables.rst:517 msgid ":ref:`about_playbooks`" msgstr ":ref:`about_playbooks`" -#: ../../rst/playbook_guide/playbooks_filters.rst:2190 +#: ../../rst/playbook_guide/playbooks_filters.rst:2194 #: ../../rst/playbook_guide/playbooks_lookups.rst:34 #: ../../rst/playbook_guide/playbooks_reuse.rst:217 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:602 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:604 #: ../../rst/playbook_guide/playbooks_tests.rst:533 -#: ../../rst/playbook_guide/playbooks_variables.rst:521 +#: ../../rst/playbook_guide/playbooks_variables.rst:523 msgid ":ref:`playbooks_loops`" msgstr ":ref:`playbooks_loops`" -#: ../../rst/playbook_guide/playbooks_filters.rst:2191 +#: ../../rst/playbook_guide/playbooks_filters.rst:2195 #: ../../rst/playbook_guide/playbooks_lookups.rst:35 #: ../../rst/playbook_guide/playbooks_tests.rst:534 -#: ../../rst/playbook_guide/playbooks_variables.rst:522 +#: ../../rst/playbook_guide/playbooks_variables.rst:524 msgid "Looping in playbooks" msgstr "Playbook ã§ã®ãƒ«ãƒ¼ãƒ—" @@ -3604,8 +3608,8 @@ msgid "Run ``ansible-pull --help`` for details." msgstr "詳細ã¯ã€ã€Œ``ansible-pull --help``ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_intro.rst:119 -msgid "There's also a `clever playbook <https://github.com/ansible/ansible-examples/blob/master/language_features/ansible_pull.yml>`_ available to configure ``ansible-pull`` via a crontab from push mode." -msgstr "ã¾ãŸã€ãƒ—ッシュモードã‹ã‚‰ã® crontab 㧠``ansible-pull`` ã‚’è¨å®šã™ã‚‹éš›ã«åˆ©ç”¨å¯èƒ½ãª `優れ㟠Playbook <https://github.com/ansible/ansible-examples/blob/master/language_features/ansible_pull.yml>`_ ã‚‚ã‚ã‚Šã¾ã™ã€‚" +msgid "There's also a `clever playbook <https://github.com/ansible/ansible-examples/blob/master/language_features/ansible_pull.yml>`_ available to configure ``ansible-pull`` through a crontab from push mode." +msgstr "ã¾ãŸã€ãƒ—ッシュモードã‹ã‚‰ã® crontab 㧠``ansible-pull`` ã‚’è¨å®šã™ã‚‹éš›ã«åˆ©ç”¨å¯èƒ½ãª `clever playbook <https://github.com/ansible/ansible-examples/blob/master/language_features/ansible_pull.yml>`_ ã‚‚ã‚ã‚Šã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_intro.rst:122 msgid "Verifying playbooks" @@ -3636,12 +3640,12 @@ msgid "Learn how to test Ansible Playbooks syntax" msgstr "Ansible Playbook 構文ã®ãƒ†ã‚¹ãƒˆæ–¹æ³•ã«ã¤ã„ã¦" #: ../../rst/playbook_guide/playbooks_intro.rst:146 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:592 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:594 msgid ":ref:`yaml_syntax`" msgstr ":ref:`yaml_syntax`" #: ../../rst/playbook_guide/playbooks_intro.rst:147 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:593 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:595 msgid "Learn about YAML syntax" msgstr "YAML 構文ã«ã¤ã„ã¦" @@ -3650,17 +3654,17 @@ msgid "Tips for managing playbooks in the real world" msgstr "実際㮠Playbook ã®ç®¡ç†ã«é–¢ã™ã‚‹ã•ã¾ã–ã¾ãªãƒ’ント" #: ../../rst/playbook_guide/playbooks_intro.rst:150 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:606 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:608 msgid ":ref:`list_of_collections`" msgstr ":ref:`list_of_collections`" #: ../../rst/playbook_guide/playbooks_intro.rst:151 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:607 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:609 msgid "Browse existing collections, modules, and plugins" msgstr "æ—¢å˜ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãŠã‚ˆã³ãƒ—ラグインã®é–²è¦§" #: ../../rst/playbook_guide/playbooks_intro.rst:152 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:608 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:610 msgid ":ref:`developing_modules`" msgstr ":ref:`developing_modules`" @@ -3686,14 +3690,14 @@ msgstr "完全ãªã‚¨ãƒ³ãƒ‰ãƒ„ーエンド Playbook ã®ä¾‹" #: ../../rst/playbook_guide/playbooks_intro.rst:158 #: ../../rst/playbook_guide/playbooks_reuse.rst:225 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:612 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:614 msgid "`Mailing List <https://groups.google.com/group/ansible-project>`_" msgstr "`Mailing List <https://groups.google.com/group/ansible-project>`_" #: ../../rst/playbook_guide/playbooks_intro.rst:159 #: ../../rst/playbook_guide/playbooks_privilege_escalation.rst:774 #: ../../rst/playbook_guide/playbooks_reuse.rst:226 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:613 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:615 msgid "Questions? Help? Ideas? Stop by the list on Google Groups" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ案ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google グループã®ä¸€è¦§ã‚’ã”覧ãã ã•ã„。" @@ -4083,7 +4087,7 @@ msgid "As of Ansible 2.8 you can get the name of the value provided to ``loop_co msgstr "Ansible 2.8 ã§ã¯ã€``ansible_loop_var`` 変数を使用ã—㦠``loop_control.loop_var`` ã«æä¾›ã•ã‚ŒãŸå€¤ã®åå‰ã‚’å–å¾—ã§ãã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_loops.rst:471 -msgid "For role authors, writing roles that allow loops, instead of dictating the required ``loop_var`` value, you can gather the value via the following" +msgid "For role authors, writing roles that allow loops, instead of dictating the required ``loop_var`` value, you can gather the value through the following" msgstr "ãƒãƒ¼ãƒ«ã®ä½œæˆè€…ã¯ã€å¿…è¦ãª ``loop_var`` 値を指定ã™ã‚‹ä»£ã‚ã‚Šã«ã€ãƒ«ãƒ¼ãƒ—を許å¯ã™ã‚‹ãƒãƒ¼ãƒ«ã‚’作æˆã™ã‚‹ã“ã¨ã§ã€æ¬¡ã®æ–¹æ³•ã§å€¤ã‚’åŽé›†ã§ãã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_loops.rst:480 @@ -4158,27 +4162,31 @@ msgstr "with_sequence" msgid "``with_sequence`` is replaced by ``loop`` and the ``range`` function, and potentially the ``format`` filter." msgstr "``with_sequence`` ã¯ã€``loop`` 関数㨠``range`` ã®é–¢æ•°ã€ãã—ã¦æ½œåœ¨çš„ã«ã¯ ``format`` フィルターã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:153 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:151 +msgid "The range of the loop is exclusive of the end point." +msgstr "ループã®ç¯„囲ã¯ã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã‚’除ãã¾ã™ã€‚" + +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:154 msgid "with_subelements" msgstr "with_subelements" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:155 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:156 msgid "``with_subelements`` is replaced by ``loop`` and the ``subelements`` filter." msgstr "``with_subelements`` ã¯ã€``loop`` フィルターãŠã‚ˆã³ ``subelements`` フィルターã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:172 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:173 msgid "with_nested/with_cartesian" msgstr "with_nested/with_cartesian" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:174 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:175 msgid "``with_nested`` and ``with_cartesian`` are replaced by loop and the ``product`` filter." msgstr "``with_nested`` ã¨``with_cartesian`` ã¯ã€ãƒ«ãƒ¼ãƒ—㨠``product`` ã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:191 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:192 msgid "with_random_choice" msgstr "with_random_choice" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:193 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:194 msgid "``with_random_choice`` is replaced by just use of the ``random`` filter, without need of ``loop``." msgstr "``with_random_choice`` ã¯ã€``random`` フィルターを使用ã™ã‚‹ã ã‘ã§ã€``loop`` ã‚’å¿…è¦ã¨ã›ãšã«ç½®ãæ›ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" @@ -5109,8 +5117,8 @@ msgid "Dictionary views" msgstr "ディクショナリービュー" #: ../../rst/playbook_guide/playbooks_python_version.rst:18 -msgid "In Python2, the :meth:`dict.keys`, :meth:`dict.values`, and :meth:`dict.items` methods return a list. Jinja2 returns that to Ansible via a string representation that Ansible can turn back into a list." -msgstr "Python2 ã§ã¯ã€:meth:`dict.keys`ã€:meth:`dict.values`ã€ãŠã‚ˆã³ :meth:`dict.items` メソッドã¯ãƒªã‚¹ãƒˆã‚’è¿”ã—ã¾ã™ã€‚Jinja2 ã¯ã€Ansible ãŒãƒªã‚¹ãƒˆã«æˆ»ã£ã¦ããŸæ–‡å—列表ç¾ã§ Ansible ã«è¿”ã—ã¾ã™ã€‚" +msgid "In Python2, the :meth:`dict.keys`, :meth:`dict.values`, and :meth:`dict.items` methods return a list. Jinja2 returns that to Ansible using a string representation that Ansible can turn back into a list." +msgstr "Python2 ã§ã¯ã€:meth:`dict.keys`ã€:meth:`dict.values`ã€ãŠã‚ˆã³ :meth:`dict.items` メソッドã¯ãƒªã‚¹ãƒˆã‚’è¿”ã—ã¾ã™ã€‚Jinja2 ã¯ã“れをã€Ansible ãŒãƒªã‚¹ãƒˆã«æˆ»ã™ã“ã¨ãŒã§ãã‚‹æ–‡å—列表ç¾ã§ Ansible ã«è¿”ã—ã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_python_version.rst:22 msgid "In Python3, those methods return a :ref:`dictionary view <python3:dict-views>` object. The string representation that Jinja2 returns for dictionary views cannot be parsed back into a list by Ansible. It is, however, easy to make this portable by using the :func:`list <jinja2:jinja-filters.list>` filter whenever using :meth:`dict.keys`, :meth:`dict.values`, or :meth:`dict.items`." @@ -5161,7 +5169,7 @@ msgid "A playbook contains at least one play, and may contain variables, tasks, msgstr "Playbook ã«ã¯ã€å°‘ãªãã¨ã‚‚ 1 ã¤ã®ãƒ—レイãŒå«ã¾ã‚Œã¦ãŠã‚Šã€å¤‰æ•°ã€ã‚¿ã‚¹ã‚¯ã€ãã®ä»–ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’å«ã‚€ã“ã¨ãŒã§ãã¾ã™ã€‚厳密ã«ç„¦ç‚¹ã‚’絞ã£ãŸ Playbook ã¯å†åˆ©ç”¨ã§ãã¾ã™ãŒã€å‹•çš„ã«ã§ã¯ãªãé™çš„ã«ã—ã‹å†åˆ©ç”¨ã§ãã¾ã›ã‚“。" #: ../../rst/playbook_guide/playbooks_reuse.rst:20 -msgid "A role contains a set of related tasks, variables, defaults, handlers, and even modules or other plugins in a defined file-tree. Unlike variables files, task files, or playbooks, roles can be easily uploaded and shared via Ansible Galaxy. See :ref:`playbooks_reuse_roles` for details about creating and using roles." +msgid "A role contains a set of related tasks, variables, defaults, handlers, and even modules or other plugins in a defined file-tree. Unlike variables files, task files, or playbooks, roles can be easily uploaded and shared through Ansible Galaxy. See :ref:`playbooks_reuse_roles` for details about creating and using roles." msgstr "ãƒãƒ¼ãƒ«ã«ã¯ã€é–¢é€£ã™ã‚‹ã‚¿ã‚¹ã‚¯ã€å¤‰æ•°ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã€ãƒãƒ³ãƒ‰ãƒ©ãƒ¼ã€ã•ã‚‰ã«ã¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„ä»–ã®ãƒ—ラグインã®ã‚»ãƒƒãƒˆãŒã€å®šç¾©ã•ã‚ŒãŸãƒ•ã‚¡ã‚¤ãƒ«ãƒ„リーã«æ ¼ç´ã•ã‚Œã¦ã„ã¾ã™ã€‚変数ファイルã€ã‚¿ã‚¹ã‚¯ãƒ•ã‚¡ã‚¤ãƒ«ã€Playbook ã¨ã¯ç•°ãªã‚Šã€ãƒãƒ¼ãƒ«ã¯ Ansible Galaxy ã§ç°¡å˜ã«ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ã—ã¦å…±æœ‰ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãƒãƒ¼ãƒ«ã®ä½œæˆã¨ä½¿ç”¨ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€ã€Œ:ref:`playbooks_reuse_roles`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_reuse.rst:25 @@ -5473,7 +5481,7 @@ msgid "Documentation of the ``include*`` and ``import*`` modules discussed here. msgstr "ã“ã“ã§èª¬æ˜Žã™ã‚‹ ``include*`` モジュールãŠã‚ˆã³ ``import*`` モジュールã«é–¢ã™ã‚‹ãƒ‰ã‚ュメント" #: ../../rst/playbook_guide/playbooks_reuse.rst:212 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:595 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:597 #: ../../rst/playbook_guide/playbooks_roles.rst:16 msgid "Review the basic Playbook language features" msgstr "基本的㪠Playbook 言語機能ã®ç¢ºèª" @@ -5483,17 +5491,17 @@ msgid "All about variables in playbooks" msgstr "Playbook ã®å¤‰æ•°ã®è©³ç´°ã®ã™ã¹ã¦" #: ../../rst/playbook_guide/playbooks_reuse.rst:216 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:601 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:603 msgid "Conditionals in playbooks" msgstr "Playbook ã®æ¡ä»¶" #: ../../rst/playbook_guide/playbooks_reuse.rst:218 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:603 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:605 msgid "Loops in playbooks" msgstr "Playbook ã®ãƒ«ãƒ¼ãƒ—" #: ../../rst/playbook_guide/playbooks_reuse.rst:221 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:590 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:592 #: ../../rst/playbook_guide/playbooks_roles.rst:13 msgid ":ref:`ansible_galaxy`" msgstr ":ref:`ansible_galaxy`" @@ -5504,12 +5512,12 @@ msgid "How to share roles on galaxy, role management" msgstr "Galaxy (ãƒãƒ¼ãƒ«ç®¡ç†) ã«ãŠã‘ã‚‹ãƒãƒ¼ãƒ«ã®å…±æœ‰æ–¹æ³•" #: ../../rst/playbook_guide/playbooks_reuse.rst:223 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:610 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:612 msgid "`GitHub Ansible examples <https://github.com/ansible/ansible-examples>`_" -msgstr "`GitHub Ansible ã®ä¾‹ <https://github.com/ansible/ansible-examples>`_" +msgstr "`GitHub Ansible examples <https://github.com/ansible/ansible-examples>`_" #: ../../rst/playbook_guide/playbooks_reuse.rst:224 -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:611 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:613 msgid "Complete playbook files from the GitHub project source" msgstr "Github プãƒã‚¸ã‚§ã‚¯ãƒˆã‚½ãƒ¼ã‚¹ã®å®Œå…¨ãª Playbook ファイル" @@ -5847,7 +5855,7 @@ msgstr "ã“ã®ã‚ªãƒ—ションã®æ©Ÿèƒ½ã®è©³ç´°ãªèª¬æ˜Žã€‚ã“ã‚Œã¯ã€å®Œå…¨ãª #: ../../rst/playbook_guide/playbooks_reuse_roles.rst msgid "type" -msgstr "type" +msgstr "タイプ" #: ../../rst/playbook_guide/playbooks_reuse_roles.rst:313 msgid "The data type of the option. See :ref:`Argument spec <argument_spec>` for allowed values for ``type``. Default is ``str``." @@ -5886,18 +5894,18 @@ msgid "The default field must not be listed as part of the description, unless i msgstr "è¿½åŠ ã®æƒ…å ±ã‚„æ¡ä»¶ãŒå¿…è¦ãªå ´åˆã‚’除ãã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã¯ã€èª¬æ˜Žã®ä¸€éƒ¨ã¨ã—ã¦è¨˜è¼‰ã—ãªã„ã§ãã ã•ã„。" #: ../../rst/playbook_guide/playbooks_reuse_roles.rst:327 -msgid "If the option is a boolean value, you can use any of the boolean values recognized by Ansible: (such as true/false or yes/no). Choose the one that reads better in the context of the option." -msgstr "オプションãŒãƒ–ール値ã®å ´åˆã¯ã€Ansible ãŒèªè˜ã™ã‚‹ä»»æ„ã®ãƒ–ール値 (true/falseã€yes/no ãªã©) を使用ã§ãã¾ã™ã€‚オプションã®ã‚³ãƒ³ãƒ†ã‚ストã§èªã¿å–ã‚ŠãŒé©åˆ‡ã§ã‚ã‚Œã°ã“れをé¸æŠžã—ã¾ã™ã€‚" +msgid "If the option is a boolean value, you should use `true/false` if you want to be compatible with `ansible-lint`." +msgstr "オプションãŒãƒ–ール値ã§ã‚ã‚‹å ´åˆã€`ansible-lint` ã¨äº’æ›æ€§ã‚’æŒãŸã›ãŸã„å ´åˆã¯ã€`true/false` を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/playbook_guide/playbooks_reuse_roles.rst msgid "choices" msgstr "choices" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:332 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:331 msgid "List of option values." msgstr "オプション値ã®ãƒªã‚¹ãƒˆã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:333 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:332 msgid "Should be absent if empty." msgstr "空欄ã®å ´åˆã¯æŒ‡å®šãªã—ã«ãªã‚Šã¾ã™ã€‚" @@ -5905,187 +5913,191 @@ msgstr "空欄ã®å ´åˆã¯æŒ‡å®šãªã—ã«ãªã‚Šã¾ã™ã€‚" msgid "elements" msgstr "elements" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:337 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:336 msgid "Specifies the data type for list elements when type is ``list``." msgstr "タイプ㌠``list`` ã®å ´åˆã«ã€ãƒªã‚¹ãƒˆè¦ç´ ã®ãƒ‡ãƒ¼ã‚¿åž‹ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:341 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:340 msgid "If this option takes a dict or list of dicts, you can define the structure here." msgstr "ã“ã®ã‚ªãƒ—ションãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¾ãŸã¯ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒªã‚¹ãƒˆã‚’å–ã‚‹å ´åˆã¯ã€ã“ã“ã§æ§‹é€ を定義ã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:344 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:343 msgid "Sample specification" msgstr "サンプル仕様" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:379 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:378 msgid "Running a role multiple times in one play" msgstr "1 ã¤ã®ãƒ—レイã§ãƒãƒ¼ãƒ«ã‚’複数回実行ã™ã‚‹" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:381 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:380 msgid "Ansible only executes each role once in a play, even if you define it multiple times, unless the parameters defined on the role are different for each definition. For example, Ansible only runs the role ``foo`` once in a play like this:" msgstr "Ansible ã¯ã€ãƒãƒ¼ãƒ«ã«å®šç¾©ã•ã‚Œã¦ã„るパラメーターãŒå®šç¾©ã”ã¨ã«ç•°ãªã‚‹å ´åˆã‚’除ãã€å„ãƒãƒ¼ãƒ«ã‚’複数回定義ã—ã¦ã‚‚プレイã§ã¯ 1 回ã—ã‹å®Ÿè¡Œã—ã¾ã›ã‚“。ãŸã¨ãˆã°ã€Ansible ã¯æ¬¡ã®ã‚ˆã†ãªãƒ—レイ㧠``foo`` ã¨ã„ã†ãƒãƒ¼ãƒ«ã‚’ 1 回ã ã‘実行ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:392 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:391 msgid "You have two options to force Ansible to run a role more than once." msgstr "Ansible ãŒè¤‡æ•°ã®ãƒãƒ¼ãƒ«ã‚’強制的ã«å®Ÿè¡Œã™ã‚‹ã‚ªãƒ—ション㯠2 ã¤ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:395 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:394 msgid "Passing different parameters" msgstr "ç•°ãªã‚‹ãƒ‘ラメーターを渡ã™" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:397 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:396 msgid "If you pass different parameters in each role definition, Ansible runs the role more than once. Providing different variable values is not the same as passing different role parameters. You must use the ``roles`` keyword for this behavior, since ``import_role`` and ``include_role`` do not accept role parameters." msgstr "å„ãƒãƒ¼ãƒ«å®šç¾©ã§ç•°ãªã‚‹ãƒ‘ラメーターを渡ã™ã¨ã€Ansible ã¯ãã®ãƒãƒ¼ãƒ«ã‚’複数回実行ã—ã¾ã™ã€‚ç•°ãªã‚‹å¤‰æ•°å€¤ã‚’æä¾›ã™ã‚‹ã“ã¨ã¯ã€ç•°ãªã‚‹ãƒãƒ¼ãƒ«ãƒ‘ラメーターを渡ã™ã“ã¨ã¨ã¯ç•°ãªã‚Šã¾ã™ã€‚``import_role`` ãŠã‚ˆã³ ``include_role`` ã¯ãƒãƒ¼ãƒ«ãƒ‘ラメーターをå—ã‘入れãªã„ãŸã‚ã€ã“ã®å‹•ä½œã«ã¯ ``roles`` ã‚ーワードを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:399 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:398 msgid "This play runs the ``foo`` role twice:" msgstr "ã“ã®ãƒ—レイã§ã¯ã€``foo`` ãƒãƒ¼ãƒ«ãŒ 2 回実行ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:409 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:408 msgid "This syntax also runs the ``foo`` role twice;" msgstr "ã“ã®æ§‹æ–‡ã¯ã€``foo`` ãƒãƒ¼ãƒ«ã‚’ 2 回実行ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:421 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:420 msgid "In these examples, Ansible runs ``foo`` twice because each role definition has different parameters." msgstr "ã“れらã®ä¾‹ã§ã¯ã€å„ãƒãƒ¼ãƒ«å®šç¾©ã®ãƒ‘ラメーターãŒç•°ãªã‚‹ãŸã‚ã€Ansible 㯠``foo`` ã‚’ 2 回実行ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:424 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:423 msgid "Using ``allow_duplicates: true``" msgstr "``allow_duplicates: true`` ã®ä½¿ç”¨" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:426 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:425 msgid "Add ``allow_duplicates: true`` to the ``meta/main.yml`` file for the role:" msgstr "ãƒãƒ¼ãƒ«ã® ``meta/main.yml`` ファイル㫠``allow_duplicates: true`` ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:441 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:440 msgid "In this example, Ansible runs ``foo`` twice because we have explicitly enabled it to do so." msgstr "ã“ã®ä¾‹ã§ã¯ã€Ansible ㌠``foo`` ã‚’2回実行ã—ã¦ã„ã¾ã™ãŒã€ã“ã‚Œã¯æ˜Žç¤ºçš„ã«å®Ÿè¡Œã§ãるよã†ã«ã—ãŸãŸã‚ã§ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:446 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:445 msgid "Using role dependencies" msgstr "ãƒãƒ¼ãƒ«ä¾å˜é–¢ä¿‚ã®ä½¿ç”¨" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:448 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:447 msgid "Role dependencies let you automatically pull in other roles when using a role." msgstr "ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã«ã‚ˆã‚Šã€ãƒãƒ¼ãƒ«ã‚’使用ã™ã‚‹éš›ã«ä»–ã®ãƒãƒ¼ãƒ«ã‚’自動的ã«ãƒ—ルã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:450 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:449 msgid "Role dependencies are prerequisites, not true dependencies. The roles do not have a parent/child relationship. Ansible loads all listed roles, runs the roles listed under ``dependencies`` first, then runs the role that lists them. The play object is the parent of all roles, including roles called by a ``dependencies`` list." msgstr "ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã¯å‰ææ¡ä»¶ã§ã‚ã‚Šã€çœŸã®ä¾å˜é–¢ä¿‚ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã¾ãŸã€ãƒãƒ¼ãƒ«ã¯è¦ªå関係をæŒã¡ã¾ã›ã‚“。Ansible ã¯ãƒªã‚¹ãƒˆã‚¢ãƒƒãƒ—ã•ã‚ŒãŸã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã‚’èªã¿è¾¼ã¿ã€``dependencies`` ã«ãƒªã‚¹ãƒˆã‚¢ãƒƒãƒ—ã•ã‚ŒãŸãƒãƒ¼ãƒ«ã‚’最åˆã«å®Ÿè¡Œã—ã€æ¬¡ã«ãれらをリストアップã—ãŸãƒãƒ¼ãƒ«ã‚’実行ã—ã¾ã™ã€‚play オブジェクトã¯ã€``dependencies`` ã®ãƒªã‚¹ãƒˆã§å‘¼ã³å‡ºã•ã‚Œã‚‹ãƒãƒ¼ãƒ«ã‚’å«ã‚ã€ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã®è¦ªã§ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:452 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:451 msgid "Role dependencies are stored in the ``meta/main.yml`` file within the role directory. This file should contain a list of roles and parameters to insert before the specified role. For example:" msgstr "ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã¯ã€ãƒãƒ¼ãƒ«ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼å†…ã® ``meta/main.yml`` ファイルã«ä¿å˜ã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã¯ã€æŒ‡å®šã•ã‚ŒãŸãƒãƒ¼ãƒ«ã®å‰ã«æŒ¿å…¥ã™ã‚‹ãƒãƒ¼ãƒ«ã¨ãƒ‘ラメーターã®ä¸€è¦§ã‚’å«ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:470 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:469 msgid "Ansible always executes roles listed in ``dependencies`` before the role that lists them. Ansible executes this pattern recursively when you use the ``roles`` keyword. For example, if you list role ``foo`` under ``roles:``, role ``foo`` lists role ``bar`` under ``dependencies`` in its meta/main.yml file, and role ``bar`` lists role ``baz`` under ``dependencies`` in its meta/main.yml, Ansible executes ``baz``, then ``bar``, then ``foo``." msgstr "Ansible ã¯ã€``dependencies`` ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã‚’ã€ãれを記載ã—ã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã®å‰ã«å¸¸ã«å®Ÿè¡Œã—ã¾ã™ã€‚``roles`` ã‚ーワードを使用ã™ã‚‹ã¨ã€Ansible ã¯ã“ã®ãƒ‘ターンをå†å¸°çš„ã«å®Ÿè¡Œã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ãƒãƒ¼ãƒ« ``foo`` ã‚’ ``roles:`` ã®ä¸‹ã«ãƒªã‚¹ãƒˆã—ã€ãƒãƒ¼ãƒ« ``foo`` ㌠meta/main.yml ファイル㮠``dependencies`` ã®ä¸‹ã«ãƒãƒ¼ãƒ« ``bar`` をリストã—ã€ãƒãƒ¼ãƒ« ``bar`` ㌠meta/main.yml ã® ``dependencies`` ã®ä¸‹ã«ãƒãƒ¼ãƒ« ``baz`` をリストã—ã¦ã„ã‚‹å ´åˆã€Ansible㯠``baz``ã€``bar``ã€``foo`` ã®é †ã«å®Ÿè¡Œã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:473 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:472 msgid "Running role dependencies multiple times in one play" msgstr "1 ã¤ã®ãƒ—レイã§ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚を複数回実行ã™ã‚‹" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:475 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:474 msgid "Ansible treats duplicate role dependencies like duplicate roles listed under ``roles:``: Ansible only executes role dependencies once, even if defined multiple times, unless the parameters, tags, or when clause defined on the role are different for each definition. If two roles in a play both list a third role as a dependency, Ansible only runs that role dependency once, unless you pass different parameters, tags, when clause, or use ``allow_duplicates: true`` in the role you want to run multiple times. See :ref:`Galaxy role dependencies <galaxy_dependencies>` for more details." msgstr "Ansible ã¯ã€``roles:`` ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã‚‹é‡è¤‡ã—ãŸãƒãƒ¼ãƒ«ã®ã‚ˆã†ã«ã€é‡è¤‡ã—ãŸãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚を扱ã„ã¾ã™ã€‚Ansible ã¯ã€ãƒãƒ¼ãƒ«ã«å®šç¾©ã•ã‚ŒãŸãƒ‘ラメーターã€ã‚¿ã‚°ã€ã¾ãŸã¯ when å¥ãŒå®šç¾©ã”ã¨ã«ç•°ãªã‚‹å ´åˆã‚’除ãã€è¤‡æ•°å›žå®šç¾©ã•ã‚Œã¦ã„ã¦ã‚‚ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã‚’ 1 回ã®ã¿å®Ÿè¡Œã—ã¾ã™ã€‚プレイ内㮠2 ã¤ã®ãƒãƒ¼ãƒ«ãŒä¸¡æ–¹ã¨ã‚‚ä¾å˜é–¢ä¿‚ã¨ã—㦠3 番目ã®ãƒãƒ¼ãƒ«ã‚’リストã—ã¦ã„ã‚‹å ´åˆã€Ansible ã¯ã€è¤‡æ•°å›žå®Ÿè¡Œã™ã‚‹ãƒãƒ¼ãƒ«ã§ç•°ãªã‚‹ãƒ‘ラメーターã€ã‚¿ã‚°ã€when å¥ã‚’渡ã™ã‹ã€``allow_duplicates: true`` を使用ã—ãªã„é™ã‚Šã€ãã®ãƒãƒ¼ãƒ«ã®ä¾å˜é–¢ä¿‚ã‚’ 1 回ã®ã¿å®Ÿè¡Œã—ã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`Galaxy role dependencies <galaxy_dependencies>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:479 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:478 msgid "Role deduplication does not consult the invocation signature of parent roles. Additionally, when using ``vars:`` instead of role params, there is a side effect of changing variable scoping. Using ``vars:`` results in those variables being scoped at the play level. In the below example, using ``vars:`` would cause ``n`` to be defined as ``4`` through the entire play, including roles called before it." msgstr "ãƒãƒ¼ãƒ«ã®é‡è¤‡æŽ’除ã¯ã€è¦ªãƒãƒ¼ãƒ«ã®å‘¼ã³å‡ºã—ç½²åã‚’å‚ç…§ã—ã¾ã›ã‚“。ã•ã‚‰ã«ã€ãƒãƒ¼ãƒ«ãƒ‘ラメーターã®ä»£ã‚ã‚Šã« ``vars:`` を使用ã™ã‚‹å ´åˆã¯ã€å¤‰æ•°ã®ã‚¹ã‚³ãƒ¼ãƒ—を変更ã™ã‚‹ã¨ã„ã†å‰¯ä½œç”¨ãŒã‚ã‚Šã¾ã™ã€‚``vars:`` を使用ã™ã‚‹ã¨ã€ãれらã®å¤‰æ•°ãŒãƒ—レイレベルã§å¯¾è±¡ã¨ãªã‚Šã¾ã™ã€‚以下ã®ä¾‹ã§ã¯ã€``vars:`` を使用ã™ã‚‹ã¨ã€ãれ以å‰ã«å‘¼ã³å‡ºã•ã‚ŒãŸãƒãƒ¼ãƒ«ã‚’å«ã‚ã€ãƒ—レー全体を通ã—㦠``n`` ㌠``4`` ã¨ã—ã¦å®šç¾©ã•ã‚Œã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:481 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:480 msgid "In addition to the above, users should be aware that role de-duplication occurs before variable evaluation. This means that :term:`Lazy Evaluation` may make seemingly different role invocations equivalently the same, preventing the role from running more than once." msgstr "上記ã«åŠ ãˆã¦ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯å¤‰æ•°è©•ä¾¡ã®å‰ã«ãƒãƒ¼ãƒ«ã®é‡è¤‡æŽ’除ãŒè¡Œã‚れるã“ã¨ã«æ³¨æ„ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã¤ã¾ã‚Šã€:term:`Lazy Evaluation` ã¯ã€ä¸€è¦‹ç•°ãªã‚‹ãƒãƒ¼ãƒ«ã®å‘¼ã³å‡ºã—ã‚’ç‰ä¾¡ã«ã—ã¦ã€ãƒãƒ¼ãƒ«ãŒè¤‡æ•°å›žå®Ÿè¡Œã•ã‚Œã‚‹ã®ã‚’防ãã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:484 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:483 msgid "For example, a role named ``car`` depends on a role named ``wheel`` as follows:" msgstr "ãŸã¨ãˆã°ã€``car`` ã¨ã„ã†åå‰ã®ãƒãƒ¼ãƒ«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã« ``wheel`` ã¨ã„ã†åå‰ã®ãƒãƒ¼ãƒ«ã«ä¾å˜ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:499 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:498 msgid "And the ``wheel`` role depends on two roles: ``tire`` and ``brake``. The ``meta/main.yml`` for wheel would then contain the following:" msgstr "ãã—ã¦ã€``wheel`` ã®ãƒãƒ¼ãƒ«ã¯ã€``tire`` 㨠``brake`` ã® 2 ã¤ã®ãƒãƒ¼ãƒ«ã«ä¾å˜ã—ã¾ã™ã€‚ã“ã®ãŸã‚ã€wheel 用㮠``meta/main.yml`` ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:508 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:507 msgid "And the ``meta/main.yml`` for ``tire`` and ``brake`` would contain the following:" msgstr "ãã—ã¦ã€ã€Œ``tire``ã€ãŠã‚ˆã³ã€Œ``brake``ã€ã®ã€Œ``meta/main.yml``ã€ã«ã¯ã€æ¬¡ã®ã‚ˆã†ãªå†…容ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:515 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:514 msgid "The resulting order of execution would be as follows:" msgstr "ãã®çµæžœä½œæˆã•ã‚Œã‚‹å®Ÿè¡Œé †åºã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:528 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:527 msgid "To use ``allow_duplicates: true`` with role dependencies, you must specify it for the role listed under ``dependencies``, not for the role that lists it. In the example above, ``allow_duplicates: true`` appears in the ``meta/main.yml`` of the ``tire`` and ``brake`` roles. The ``wheel`` role does not require ``allow_duplicates: true``, because each instance defined by ``car`` uses different parameter values." msgstr "``allow_duplicates: true`` ã‚’ãƒãƒ¼ãƒ«ä¾å˜ã§ä½¿ç”¨ã™ã‚‹ã«ã¯ã€ãれをリストã—ã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã§ã¯ãªãã€``dependencies`` ã®ä¸‹ã«ãƒªã‚¹ãƒˆã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ãƒ«ã«å¯¾ã—ã¦æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚上記ã®ä¾‹ã§ã¯ã€``allow_duplicates: true`` ã¯ã€``tire`` ãƒãƒ¼ãƒ«ãŠã‚ˆã³ ``brake`` ãƒãƒ¼ãƒ«ã® ``meta/main.yml`` ã«è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚``wheel`` ãƒãƒ¼ãƒ«ã¯ã€``car`` ã§å®šç¾©ã•ã‚ŒãŸå„インスタンスãŒç•°ãªã‚‹ãƒ‘ラメーター値を使用ã™ã‚‹ãŸã‚ã€``allow_duplicates: true`` ã‚’å¿…è¦ã¨ã—ã¾ã›ã‚“。" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:531 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:530 msgid "See :ref:`playbooks_variables` for details on how Ansible chooses among variable values defined in different places (variable inheritance and scope). Also deduplication happens ONLY at the play level, so multiple plays in the same playbook may rerun the roles." msgstr "Ansible ãŒã€ã•ã¾ã–ã¾ãªå ´æ‰€ï¼ˆå¤‰æ•°ç¶™æ‰¿ãŠã‚ˆã³ç¯„囲）ã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã®å€¤ã‹ã‚‰é¸æŠžã™ã‚‹æ–¹æ³•ã¯ã€ã€Œ:ref:`playbooks_variables`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ã¾ãŸã€é‡è¤‡æŽ’除ã¯ãƒ—レイレベルã§ã®ã¿è¡Œã‚れるãŸã‚ã€åŒã˜ Playbook ã®è¤‡æ•°ã®ãƒ—レイãŒãƒãƒ¼ãƒ«ã‚’å†å®Ÿè¡Œã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:537 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:536 msgid "Embedding modules and plugins in roles" msgstr "ãƒãƒ¼ãƒ«ã§ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŠã‚ˆã³ãƒ—ラグインã®åŸ‹ã‚è¾¼ã¿" #: ../../rst/playbook_guide/playbooks_reuse_roles.rst:539 +msgid "This applies only to standalone roles. Roles in collections do not support plugin embedding; they must use the collection's ``plugins`` structure to distribute plugins." +msgstr "ã“ã‚Œã¯ã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã®ãƒãƒ¼ãƒ«ã«ã®ã¿é©ç”¨ã•ã‚Œã¾ã™ã€‚コレクション内ã®ãƒãƒ¼ãƒ«ã¯ãƒ—ラグインã®åŸ‹ã‚è¾¼ã¿ã‚’サãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã›ã‚“。プラグインをé…布ã™ã‚‹ã«ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® ``plugins`` æ§‹é€ ã‚’ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:541 msgid "If you write a custom module (see :ref:`developing_modules`) or a plugin (see :ref:`developing_plugins`), you might wish to distribute it as part of a role. For example, if you write a module that helps configure your company's internal software, and you want other people in your organization to use this module, but you do not want to tell everyone how to configure their Ansible library path, you can include the module in your internal_config role." msgstr "カスタムモジュール (「:ref:`developing_modules`ã€ã‚’å‚ç…§) やプラグイン (「:ref:`developing_plugins`ã€ã‚’å‚ç…§) を作æˆã—ãŸå ´åˆã¯ã€ãƒãƒ¼ãƒ«ã®ä¸€éƒ¨ã¨ã—ã¦é…布ã—ãŸã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€ç¤¾å†…ã®ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’è¨å®šã™ã‚‹ãŸã‚ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’作æˆã—ã€çµ„織内ã®ä»–ã®äººã«ã‚‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦ã»ã—ã„ã«ã‚‚é–¢ã‚らãšã€Ansible ã®ãƒ©ã‚¤ãƒ–ラリーパスをè¨å®šã™ã‚‹æ–¹æ³•ã‚’全員ã«é–‹ç¤ºã—ãŸããªã„å ´åˆã¯ã€internal_config ãƒãƒ¼ãƒ«ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å«ã‚ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:541 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:543 msgid "To add a module or a plugin to a role: Alongside the 'tasks' and 'handlers' structure of a role, add a directory named 'library' and then include the module directly inside the 'library' directory." msgstr "モジュールやプラグインをãƒãƒ¼ãƒ«ã«è¿½åŠ ã™ã‚‹ã«ã¯ã€ãƒãƒ¼ãƒ«ã®ã€Œtasksã€ãŠã‚ˆã³ã€Œhandlersã€æ§‹é€ ã®æ¨ªã«ã€ã€Œlibraryã€ã¨ã„ã†åå‰ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã‚’è¿½åŠ ã—ã€ãã®ã€Œlibraryã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼å†…ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’直接インクルードã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:544 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:546 msgid "Assuming you had this:" msgstr "以下ãŒã‚ã‚‹ã¨ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:554 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:556 msgid "The module will be usable in the role itself, as well as any roles that are called *after* this role, as follows:" msgstr "モジュールã¯ã€æ¬¡ã®ã‚ˆã†ã«ã€ãƒãƒ¼ãƒ«è‡ªä½“ã€ãŠã‚ˆã³ã“ã®ãƒãƒ¼ãƒ«ã® *後ã«* 呼ã³å‡ºã•ã‚Œã‚‹ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã§ä½¿ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:565 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:567 msgid "If necessary, you can also embed a module in a role to modify a module in Ansible's core distribution. For example, you can use the development version of a particular module before it is released in production releases by copying the module and embedding the copy in a role. Use this approach with caution, as API signatures may change in core components, and this workaround is not guaranteed to work." msgstr "å¿…è¦ã«å¿œã˜ã¦ã€ãƒãƒ¼ãƒ«ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’埋ã‚è¾¼ã¿ã€Ansible ã®ã‚³ã‚¢ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’変更ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’コピーã—ã€ãã®ã‚³ãƒ”ーをãƒãƒ¼ãƒ«ã«åŸ‹ã‚込むã“ã¨ã§ã€ç‰¹å®šã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®é–‹ç™ºãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’実稼åƒãƒªãƒªãƒ¼ã‚¹ã®å‰ã«ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚コアコンãƒãƒ¼ãƒãƒ³ãƒˆã§ã¯ API ã‚·ã‚°ãƒãƒãƒ£ãƒ¼ãŒå¤‰æ›´ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã€ã“ã®å›žé¿ç–ã¯å‹•ä½œãŒä¿è¨¼ã•ã‚Œã¦ã„ãªã„ãŸã‚ã€ã“ã®æ–¹æ³•ã¯æ…Žé‡ã«ä½¿ç”¨ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:567 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:569 msgid "The same mechanism can be used to embed and distribute plugins in a role, using the same schema. For example, for a filter plugin:" msgstr "åŒã˜ã‚¹ã‚ーマを使用ã—ã¦ã€ãƒãƒ¼ãƒ«ã«ãƒ—ラグインを埋ã‚込んã ã‚Šé…布ã—ãŸã‚Šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ãƒ—ラグインã®å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:577 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:579 msgid "These filters can then be used in a Jinja template in any role called after 'my_custom_filter'." msgstr "ã“れらã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã¯ã€Jinja ã®ãƒ†ãƒ³ãƒ—レートã§ã€ã€Œmy_custom_filterã€ã®å¾Œã«å‘¼ã°ã‚Œã‚‹ä»»æ„ã®ãƒãƒ¼ãƒ«ã§ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:580 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:582 msgid "Sharing roles: Ansible Galaxy" msgstr "ãƒãƒ¼ãƒ«ã®å…±æœ‰: Ansible Galaxy" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:582 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:584 msgid "`Ansible Galaxy <https://galaxy.ansible.com>`_ is a free site for finding, downloading, rating, and reviewing all kinds of community-developed Ansible roles and can be a great way to get a jumpstart on your automation projects." msgstr "`Ansible Galaxy <https://galaxy.ansible.com>`_ ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ã§é–‹ç™ºã•ã‚ŒãŸã‚らゆる種類㮠Ansible ãƒãƒ¼ãƒ«ã‚’検索ã€ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã€è©•ä¾¡ã€ãŠã‚ˆã³ãƒ¬ãƒ“ューã™ã‚‹ç„¡æ–™ã‚µã‚¤ãƒˆã§ã€ã“ã“ã§è‡ªå‹•åŒ–プãƒã‚¸ã‚§ã‚¯ãƒˆã‚’ã™ãã«é–‹å§‹ã™ã‚‹ãŸã‚ã®å„ªã‚ŒãŸæ–¹æ³•ã§ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:584 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:586 msgid "The client ``ansible-galaxy`` is included in Ansible. The Galaxy client allows you to download roles from Ansible Galaxy and provides an excellent default framework for creating your own roles." msgstr "クライアント ``ansible-galaxy`` ã¯ã€Ansible ã«å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚Galaxy クライアントを使用ã™ã‚‹ã¨ã€Ansible Galaxy ã‹ã‚‰ãƒãƒ¼ãƒ«ã‚’ダウンãƒãƒ¼ãƒ‰ã§ãã€ç‹¬è‡ªã®ãƒãƒ¼ãƒ«ã‚’作æˆã™ã‚‹å„ªã‚ŒãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ•ãƒ¬ãƒ¼ãƒ ワークもæä¾›ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:586 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:588 msgid "Read the `Ansible Galaxy documentation <https://galaxy.ansible.com/docs/>`_ page for more information. A page that refers back to this one frequently is the Galaxy Roles document which explains the required metadata your role needs for use in Galaxy <https://galaxy.ansible.com/docs/contributing/creating_role.html>." msgstr "詳細ã¯ã€`Ansible Galaxy documentation <https://galaxy.ansible.com/docs/>`_ ページをå‚ç…§ã—ã¦ãã ã•ã„。ã“ã‚Œã‚’é »ç¹ã«å‚ç…§ã™ã‚‹ãƒšãƒ¼ã‚¸ã¯ã€Galaxy Role ã®ãƒ‰ã‚ュメントã§ã€Galaxy <https://galaxy.ansible.com/docs/contributing/creating_role.html> ã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«ãƒãƒ¼ãƒ«ãŒå¿…è¦ã¨ã™ã‚‹ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã«ã¤ã„ã¦èª¬æ˜Žã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:591 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:593 msgid "How to create new roles, share roles on Galaxy, role management" msgstr "æ–°è¦ãƒãƒ¼ãƒ«ã®ä½œæˆã€Galaxy ã§ã®ãƒãƒ¼ãƒ«ã®å…±æœ‰ã€ãŠã‚ˆã³ãƒãƒ¼ãƒ«ã®ç®¡ç†ã®æ–¹æ³•" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:599 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:601 msgid "Variables in playbooks" msgstr "Playbook ã®å¤‰æ•°" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:604 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:606 msgid ":ref:`tags`" msgstr ":ref:`tags`" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:605 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:607 msgid "Using tags to select or skip roles/tasks in long playbooks" msgstr "タグを使用ã—ãŸé•·ã„ Playbook ã§ãƒãƒ¼ãƒ«/タスクã®é¸æŠžã¾ãŸã¯ã‚¹ã‚ップ" -#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:609 +#: ../../rst/playbook_guide/playbooks_reuse_roles.rst:611 msgid "Extending Ansible by writing your own modules" msgstr "独自ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’作æˆã—㦠Ansible ã‚’æ‹¡å¼µ" @@ -6657,7 +6669,7 @@ msgstr "utc" msgid "Specify ``True`` to get the current time in UTC. Defaults to ``False``." msgstr "UTC ã§ç¾åœ¨ã®æ™‚é–“ã‚’å–å¾—ã™ã‚‹ã«ã¯ã€``True`` を指定ã—ã¾ã™ã€‚デフォルト㯠``False`` ã§ã™ã€‚" -#: ../../<generated>:1 +#: ../../rst/playbook_guide/playbooks_templating_now.rst:17 msgid "fmt" msgstr "fmt" @@ -7041,7 +7053,7 @@ msgstr "Ansible ã§ã¯ã€ãƒ–ール変数 ``true/false``ã€``1/0``ã€``yes/no``〠#: ../../rst/playbook_guide/playbooks_variables.rst:110 msgid "Valid values" -msgstr "有効ãªå€¤" +msgstr "有効ãªå€¤ã¯ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" #: ../../rst/playbook_guide/playbooks_variables.rst:112 msgid "``True`` , ``'true'`` , ``'t'`` , ``'yes'`` , ``'y'`` , ``'on'`` , ``'1'`` , ``1`` , ``1.0``" @@ -7235,255 +7247,255 @@ msgstr "JSON æ–‡å—列ã®å½¢å¼" msgid "When passing variables with ``--extra-vars``, you must escape quotes and other special characters appropriately for both your markup (for example, JSON), and for your shell:" msgstr "``--extra-vars`` ã§å¤‰æ•°ã‚’渡ã™å ´åˆã«ã¯ã€ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ— (JSON ãªã©) ã¨ã‚·ã‚§ãƒ«ã®ä¸¡æ–¹ã§ã€å¼•ç”¨ç¬¦ã‚„ãã®ä»–ã®ç‰¹æ®Šæ–‡å—ã‚’é©åˆ‡ã«ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:334 -msgid "If you have a lot of special characters, use a JSON or YAML file containing the variable definitions." -msgstr "特殊文å—ãŒå¤šæ•°ã‚ã‚‹å ´åˆã¯ã€å¤‰æ•°å®šç¾©ã‚’å«ã‚€ JSON ファイルã¾ãŸã¯ YAML ファイルを使用ã—ã¾ã™ã€‚" - -#: ../../rst/playbook_guide/playbooks_variables.rst:337 +#: ../../rst/playbook_guide/playbooks_variables.rst:336 msgid "vars from a JSON or YAML file" msgstr "JSON ファイルã¾ãŸã¯ YAML ファイルã®å¤‰æ•°" -#: ../../rst/playbook_guide/playbooks_variables.rst:347 +#: ../../rst/playbook_guide/playbooks_variables.rst:338 +msgid "If you have a lot of special characters, use a JSON or YAML file containing the variable definitions. Prepend both JSON and YAML filenames with `@`." +msgstr "特殊文å—ãŒå¤šæ•°ã‚ã‚‹å ´åˆã¯ã€å¤‰æ•°å®šç¾©ã‚’å«ã‚€ JSON ファイルã¾ãŸã¯ YAML ファイルを使用ã—ã¾ã™ã€‚JSON ãŠã‚ˆã³ YAML ファイルåã« `@` ã®æŽ¥é 辞を付ã‘ã¾ã™ã€‚" + +#: ../../rst/playbook_guide/playbooks_variables.rst:349 msgid "Variable precedence: Where should I put a variable?" msgstr "変数ã®å„ªå…ˆé †ä½: 変数をã©ã“ã«ç½®ãã¹ãã‹" -#: ../../rst/playbook_guide/playbooks_variables.rst:349 +#: ../../rst/playbook_guide/playbooks_variables.rst:351 msgid "You can set multiple variables with the same name in many different places. When you do this, Ansible loads every possible variable it finds, then chooses the variable to apply based on variable precedence. In other words, the different variables will override each other in a certain order." msgstr "åŒã˜åå‰ã®è¤‡æ•°ã®å¤‰æ•°ã‚’ã•ã¾ã–ã¾ãªå ´æ‰€ã«è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“れを行ã†ã¨ã€Ansible ã¯æ¤œå‡ºå¯èƒ½ãªã™ã¹ã¦ã®å¤‰æ•°ã‚’èªã¿è¾¼ã¿ã€æ¬¡ã«å¤‰æ•°ã®å„ªå…ˆé †ä½ã«åŸºã¥ã„ã¦é©ç”¨ã™ã‚‹å¤‰æ•°ã‚’é¸æŠžã—ã¾ã™ã€‚ã¤ã¾ã‚Šã€ç•°ãªã‚‹å¤‰æ•°ãŒä¸€å®šã®é †åºã§äº’ã„ã«ä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:351 +#: ../../rst/playbook_guide/playbooks_variables.rst:353 msgid "Teams and projects that agree on guidelines for defining variables (where to define certain types of variables) usually avoid variable precedence concerns. We suggest that you define each variable in one place: figure out where to define a variable, and keep it simple. For examples, see :ref:`variable_examples`." msgstr "変数ã®å®šç¾©ã«é–¢ã™ã‚‹ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ (特定ã®ã‚¿ã‚¤ãƒ—ã®å¤‰æ•°ã‚’ã©ã“ã§å®šç¾©ã™ã‚‹ã‹) ã«åˆæ„ã—ãŸãƒãƒ¼ãƒ やプãƒã‚¸ã‚§ã‚¯ãƒˆã¯ã€é€šå¸¸ã€å¤‰æ•°ã®å„ªå…ˆé †ä½ã«é–¢ã™ã‚‹æ‡¸å¿µã‚’回é¿ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚å„変数ã¯ã€ä¸€ç®‡æ‰€ã§å®šç¾©ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ã©ã“ã§å¤‰æ•°ã‚’定義ã™ã‚‹ã‹ã‚’把æ¡ã—ã€ç°¡æ½”ã•ã‚’ä¿ã£ã¦ãã ã•ã„。例ã«ã¤ã„ã¦ã¯ã€ã€Œ:ref:`variable_examples`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_variables.rst:353 +#: ../../rst/playbook_guide/playbooks_variables.rst:355 msgid "Some behavioral parameters that you can set in variables you can also set in Ansible configuration, as command-line options, and using playbook keywords. For example, you can define the user Ansible uses to connect to remote devices as a variable with ``ansible_user``, in a configuration file with ``DEFAULT_REMOTE_USER``, as a command-line option with ``-u``, and with the playbook keyword ``remote_user``. If you define the same parameter in a variable and by another method, the variable overrides the other setting. This approach allows host-specific settings to override more general settings. For examples and more details on the precedence of these various settings, see :ref:`general_precedence_rules`." msgstr "変数ã§è¨å®šã§ãる動作パラメーターã®ä¸ã«ã¯ã€Ansible ã®æ§‹æˆã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã€ãŠã‚ˆã³ Playbook ã‚ーワードã§è¨å®šã§ãã‚‹ã‚‚ã®ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€Ansible ãŒãƒªãƒ¢ãƒ¼ãƒˆãƒ‡ãƒã‚¤ã‚¹ã¸ã®æŽ¥ç¶šã«ä½¿ç”¨ã™ã‚‹ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€å¤‰æ•°ã§ã¯ ``ansible_user``ã€æ§‹æˆãƒ•ã‚¡ã‚¤ãƒ«ã§ã¯ ``DEFAULT_REMOTE_USER``ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã§ã¯ ``-u`` ã€Playbook ã‚ーワードã§ã¯ ``remote_user`` ã§å®šç¾©ã§ãã¾ã™ã€‚変数ã¨åˆ¥ã®æ–¹æ³•ã§åŒã˜ãƒ‘ラメーターを定義ã—ãŸå ´åˆã¯ã€å¤‰æ•°ãŒåˆ¥ã®è¨å®šã‚’上書ãã—ã¾ã™ã€‚ã“ã®æ–¹æ³•ã§ã¯ã€ãƒ›ã‚¹ãƒˆå›ºæœ‰ã®è¨å®šãŒã‚ˆã‚Šä¸€èˆ¬çš„ãªè¨å®šã‚’上書ãã—ã¾ã™ã€‚ã“れらã®ã•ã¾ã–ã¾ãªè¨å®šã®å„ªå…ˆé †ä½ã®ä¾‹ã‚„詳細ã¯ã€ã€Œ:ref:`general_precedence_rules`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_variables.rst:356 +#: ../../rst/playbook_guide/playbooks_variables.rst:358 msgid "Understanding variable precedence" msgstr "変数ã®å„ªå…ˆé †ä½ã«ã¤ã„ã¦" -#: ../../rst/playbook_guide/playbooks_variables.rst:358 +#: ../../rst/playbook_guide/playbooks_variables.rst:360 msgid "Ansible does apply variable precedence, and you might have a use for it. Here is the order of precedence from least to greatest (the last listed variables override all other variables):" msgstr "Ansible ã§ã¯å¤‰æ•°ã®å„ªå…ˆé †ä½ã‚’é©ç”¨ã—ã¦ãŠã‚Šã€ãれを利用ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ã“ã“ã§ã¯ã€å„ªå…ˆé †ä½ã®ä½Žã„ã‚‚ã®ã‹ã‚‰é«˜ã„ã‚‚ã®ã¾ã§ã‚’紹介ã—ã¾ã™ (最後ã«æŒ™ã’ãŸå¤‰æ•°ãŒä»–ã®ã™ã¹ã¦ã®å¤‰æ•°ã‚’上書ãã—ã¾ã™)。" -#: ../../rst/playbook_guide/playbooks_variables.rst:360 +#: ../../rst/playbook_guide/playbooks_variables.rst:362 msgid "command line values (for example, ``-u my_user``, these are not variables)" msgstr "コマンドラインã®å€¤ (例: ``-u my_user`` (ã“れらã¯å¤‰æ•°ã§ã¯ã‚ã‚Šã¾ã›ã‚“))" -#: ../../rst/playbook_guide/playbooks_variables.rst:361 +#: ../../rst/playbook_guide/playbooks_variables.rst:363 msgid "role defaults (defined in role/defaults/main.yml) [1]_" msgstr "ãƒãƒ¼ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ(role/defaults/main.yml ã§å®šç¾©) [1]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:362 +#: ../../rst/playbook_guide/playbooks_variables.rst:364 msgid "inventory file or script group vars [2]_" msgstr "インベントリーファイルã¾ãŸã¯ã‚¹ã‚¯ãƒªãƒ—トã®ã‚°ãƒ«ãƒ¼ãƒ—変数 [2]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:363 +#: ../../rst/playbook_guide/playbooks_variables.rst:365 msgid "inventory group_vars/all [3]_" msgstr "インベントリー group_vars/all [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:364 +#: ../../rst/playbook_guide/playbooks_variables.rst:366 msgid "playbook group_vars/all [3]_" msgstr "playbook group_vars/all [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:365 +#: ../../rst/playbook_guide/playbooks_variables.rst:367 msgid "inventory group_vars/* [3]_" msgstr "インベントリー group_vars/* [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:366 +#: ../../rst/playbook_guide/playbooks_variables.rst:368 msgid "playbook group_vars/* [3]_" msgstr "playbook group_vars/* [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:367 +#: ../../rst/playbook_guide/playbooks_variables.rst:369 msgid "inventory file or script host vars [2]_" msgstr "インベントリーファイルã¾ãŸã¯ã‚¹ã‚¯ãƒªãƒ—トホスト変数 [2]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:368 +#: ../../rst/playbook_guide/playbooks_variables.rst:370 msgid "inventory host_vars/* [3]_" msgstr "インベントリー host_vars/* [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:369 +#: ../../rst/playbook_guide/playbooks_variables.rst:371 msgid "playbook host_vars/* [3]_" msgstr "playbook host_vars/* [3]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:370 +#: ../../rst/playbook_guide/playbooks_variables.rst:372 msgid "host facts / cached set_facts [4]_" msgstr "ホストファクト / ã‚ャッシュ済㿠set_facts [4]_" -#: ../../rst/playbook_guide/playbooks_variables.rst:371 +#: ../../rst/playbook_guide/playbooks_variables.rst:373 msgid "play vars" msgstr "プレイ変数" -#: ../../rst/playbook_guide/playbooks_variables.rst:372 +#: ../../rst/playbook_guide/playbooks_variables.rst:374 msgid "play vars_prompt" msgstr "play vars_prompt" -#: ../../rst/playbook_guide/playbooks_variables.rst:373 +#: ../../rst/playbook_guide/playbooks_variables.rst:375 msgid "play vars_files" msgstr "play vars_files" -#: ../../rst/playbook_guide/playbooks_variables.rst:374 +#: ../../rst/playbook_guide/playbooks_variables.rst:376 msgid "role vars (defined in role/vars/main.yml)" msgstr "role 変数 (role/vars/main.yml ã§å®šç¾©)" -#: ../../rst/playbook_guide/playbooks_variables.rst:375 +#: ../../rst/playbook_guide/playbooks_variables.rst:377 msgid "block vars (only for tasks in block)" msgstr "ブãƒãƒƒã‚¯å¤‰æ•° (ブãƒãƒƒã‚¯ã®ã‚¿ã‚¹ã‚¯ã«ã®ã¿é©ç”¨)" -#: ../../rst/playbook_guide/playbooks_variables.rst:376 +#: ../../rst/playbook_guide/playbooks_variables.rst:378 msgid "task vars (only for the task)" msgstr "タスク変数 (タスク専用)" -#: ../../rst/playbook_guide/playbooks_variables.rst:377 +#: ../../rst/playbook_guide/playbooks_variables.rst:379 msgid "include_vars" msgstr "include_vars" -#: ../../rst/playbook_guide/playbooks_variables.rst:378 +#: ../../rst/playbook_guide/playbooks_variables.rst:380 msgid "set_facts / registered vars" msgstr "set_facts / 登録変数" -#: ../../rst/playbook_guide/playbooks_variables.rst:379 +#: ../../rst/playbook_guide/playbooks_variables.rst:381 msgid "role (and include_role) params" msgstr "role (ãŠã‚ˆã³ include_role) パラメーター" -#: ../../rst/playbook_guide/playbooks_variables.rst:380 +#: ../../rst/playbook_guide/playbooks_variables.rst:382 msgid "include params" msgstr "include パラメーター" -#: ../../rst/playbook_guide/playbooks_variables.rst:381 +#: ../../rst/playbook_guide/playbooks_variables.rst:383 msgid "extra vars (for example, ``-e \"user=my_user\"``)(always win precedence)" msgstr "è¿½åŠ ã®å¤‰æ•° (例: ``-e \"user=my_user\"``)(常ã«å„ªå…ˆã•ã‚Œã¾ã™)" -#: ../../rst/playbook_guide/playbooks_variables.rst:383 +#: ../../rst/playbook_guide/playbooks_variables.rst:385 msgid "In general, Ansible gives precedence to variables that were defined more recently, more actively, and with more explicit scope. Variables in the defaults folder inside a role are easily overridden. Anything in the vars directory of the role overrides previous versions of that variable in the namespace. Host and/or inventory variables override role defaults, but explicit includes such as the vars directory or an ``include_vars`` task override inventory variables." msgstr "一般的ã«ã€Ansible ã¯ã€ã‚ˆã‚Šæ–°ã—ãã€ã‚ˆã‚Šç©æ¥µçš„ã«ã€ã‚ˆã‚Šæ˜Žç¢ºãªã‚¹ã‚³ãƒ¼ãƒ—ã§å®šç¾©ã•ã‚ŒãŸå¤‰æ•°ã‚’優先ã—ã¾ã™ã€‚ãƒãƒ¼ãƒ«å†…ã® defaults フォルダーã«ã‚る変数ã¯ç°¡å˜ã«ä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚ãƒãƒ¼ãƒ«ã® vars ディレクトリーã«ã‚ã‚‹ã‚‚ã®ã¯ã€åå‰ç©ºé–“内ã®ãã®å¤‰æ•°ã®ä»¥å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’上書ãã—ã¾ã™ã€‚ホストãŠã‚ˆã³/ã¾ãŸã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã¯ãƒãƒ¼ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’上書ãã—ã¾ã™ãŒã€vars ディレクトリーや ``include_vars`` タスクãªã©ã®æ˜Žç¤ºçš„ãªã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ãƒ‰ã¯ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã‚’上書ãã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:385 +#: ../../rst/playbook_guide/playbooks_variables.rst:387 msgid "Ansible merges different variables set in inventory so that more specific settings override more generic settings. For example, ``ansible_ssh_user`` specified as a group_var is overridden by ``ansible_user`` specified as a host_var. For details about the precedence of variables set in inventory, see :ref:`how_we_merge`." msgstr "Ansible ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«è¨å®šã—ãŸç•°ãªã‚‹å¤‰æ•°ã‚’マージã—ã¦ã€ã‚ˆã‚Šç‰¹å®šã®è¨å®šãŒã‚ˆã‚Šä¸€èˆ¬çš„ãªè¨å®šã‚’上書ãã™ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€group_var ã¨ã—ã¦æŒ‡å®šã—㟠``ansible_ssh_user`` ã¯ã€host_var ã¨ã—ã¦æŒ‡å®šã—㟠``ansible_user`` ã«ã‚ˆã‚Šä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚インベントリーã§è¨å®šã•ã‚ŒãŸå¤‰æ•°ã®å„ªå…ˆé †ä½ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€ã€Œ:ref:`how_we_merge`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_variables.rst:388 +#: ../../rst/playbook_guide/playbooks_variables.rst:390 msgid "Footnotes" msgstr "注記" -#: ../../rst/playbook_guide/playbooks_variables.rst:389 +#: ../../rst/playbook_guide/playbooks_variables.rst:391 msgid "Tasks in each role see their own role's defaults. Tasks defined outside of a role see the last role's defaults." msgstr "å„ãƒãƒ¼ãƒ«ã®ã‚¿ã‚¹ã‚¯ã«ã¯ã€ãã‚Œãžã‚Œã®ãƒãƒ¼ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ãƒãƒ¼ãƒ«ã®å¤–ã§å®šç¾©ã•ã‚ŒãŸã‚¿ã‚¹ã‚¯ã«ã¯ã€æœ€å¾Œã®ãƒãƒ¼ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:390 +#: ../../rst/playbook_guide/playbooks_variables.rst:392 msgid "Variables defined in inventory file or provided by dynamic inventory." msgstr "インベントリーファイルã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã€ã¾ãŸã¯å‹•çš„インベントリーã§æŒ‡å®šã•ã‚Œã‚‹å¤‰æ•°ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:391 +#: ../../rst/playbook_guide/playbooks_variables.rst:393 msgid "Includes vars added by 'vars plugins' as well as host_vars and group_vars which are added by the default vars plugin shipped with Ansible." msgstr "「vars プラグインã€ã¨ã€Ansible ã«åŒæ¢±ã•ã‚Œã‚‹ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® vars プラグインã«ã‚ˆã‚Šè¿½åŠ ã•ã‚Œã‚‹ host_vars ãŠã‚ˆã³ group_vars ãŒå«ã¾ã‚Œã‚‹ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ãƒ‰å¤‰æ•°ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:392 +#: ../../rst/playbook_guide/playbooks_variables.rst:394 msgid "When created with set_facts's cacheable option, variables have the high precedence in the play, but are the same as a host facts precedence when they come from the cache." msgstr "set_facts ã®ã‚ャッシュå¯èƒ½ãªã‚ªãƒ—ションを使用ã—ã¦ä½œæˆã™ã‚‹ã¨ã€å¤‰æ•°ãŒãƒ—レイã«å„ªå…ˆã•ã‚Œã¾ã™ãŒã€ã‚ャッシュã‹ã‚‰ã®ãƒ›ã‚¹ãƒˆã®ãƒ•ã‚¡ã‚¯ãƒˆã¨åŒæ§˜ã«å„ªå…ˆã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:395 +#: ../../rst/playbook_guide/playbooks_variables.rst:397 msgid "Within any section, redefining a var overrides the previous instance. If multiple groups have the same variable, the last one loaded wins. If you define a variable twice in a play's ``vars:`` section, the second one wins." msgstr "ã©ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã‚‚ã€å¤‰æ•°ã‚’å†å®šç¾©ã™ã‚‹ã¨å‰ã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ãŒä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚複数ã®ã‚°ãƒ«ãƒ¼ãƒ—ãŒåŒã˜å¤‰æ•°ã‚’æŒã£ã¦ã„ã‚‹å ´åˆã¯ã€æœ€å¾Œã«èªã¿è¾¼ã¾ã‚ŒãŸã‚‚ã®ãŒå„ªå…ˆã•ã‚Œã¾ã™ã€‚プレイä¸ã® ``vars:`` ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§å¤‰æ•°ã‚’ 2 回定義ã—ãŸå ´åˆã¯ã€2 回目ã®å¤‰æ•°ãŒå„ªå…ˆã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:398 +#: ../../rst/playbook_guide/playbooks_variables.rst:400 msgid "The previous describes the default config ``hash_behaviour=replace``, switch to ``merge`` to only partially overwrite." msgstr "以å‰ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®è¨å®š ``hash_behaviour=replace`` を説明ã—ã€``merge`` ã«åˆ‡ã‚Šæ›¿ãˆã¦ã‚’部分的ã«ä¸Šæ›¸ãã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:403 +#: ../../rst/playbook_guide/playbooks_variables.rst:405 msgid "Scoping variables" msgstr "変数ã®ã‚¹ã‚³ãƒ¼ãƒ—è¨å®š" -#: ../../rst/playbook_guide/playbooks_variables.rst:405 +#: ../../rst/playbook_guide/playbooks_variables.rst:407 msgid "You can decide where to set a variable based on the scope you want that value to have. Ansible has three main scopes:" msgstr "変数をã©ã“ã«è¨å®šã™ã‚‹ã‹ã¯ã€ãã®å€¤ãŒæŒã¤ã¹ãスコープã«åŸºã¥ã„ã¦æ±ºã‚ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚Ansible ã«ã¯å¤§ãã分ã‘㦠3 ã¤ã®ã‚¹ã‚³ãƒ¼ãƒ—ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:407 +#: ../../rst/playbook_guide/playbooks_variables.rst:409 msgid "Global: this is set by config, environment variables and the command line" msgstr "ã‚°ãƒãƒ¼ãƒãƒ«: ã“ã‚Œã¯ã€è¨å®šã€ç’°å¢ƒå¤‰æ•°ã€ãŠã‚ˆã³ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§è¨å®šã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:408 +#: ../../rst/playbook_guide/playbooks_variables.rst:410 msgid "Play: each play and contained structures, vars entries (vars; vars_files; vars_prompt), role defaults and vars." msgstr "プレイ: å„プレイãŠã‚ˆã³å«ã¾ã‚Œã‚‹æ§‹é€ ã€å¤‰æ•°ã‚¨ãƒ³ãƒˆãƒªãƒ¼ (varsã€vars_filesã€vars_prompt)ã€ãƒãƒ¼ãƒ«ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã€ãŠã‚ˆã³å¤‰æ•°" -#: ../../rst/playbook_guide/playbooks_variables.rst:409 +#: ../../rst/playbook_guide/playbooks_variables.rst:411 msgid "Host: variables directly associated to a host, like inventory, include_vars, facts or registered task outputs" msgstr "ホスト: インベントリーã€include_varsã€ãƒ•ã‚¡ã‚¯ãƒˆã€ã¾ãŸã¯ç™»éŒ²ã•ã‚ŒãŸã‚¿ã‚¹ã‚¯ã®å‡ºåŠ›ãªã©ã®ãƒ›ã‚¹ãƒˆã«ç›´æŽ¥é–¢é€£ä»˜ã‘られる変数" -#: ../../rst/playbook_guide/playbooks_variables.rst:411 +#: ../../rst/playbook_guide/playbooks_variables.rst:413 msgid "Inside a template, you automatically have access to all variables that are in scope for a host, plus any registered variables, facts, and magic variables." msgstr "テンプレート内ã§ã¯ã€ãƒ›ã‚¹ãƒˆã®ã‚¹ã‚³ãƒ¼ãƒ—内ã«ã‚ã‚‹ã™ã¹ã¦ã®å¤‰æ•°ã¨ã€ç™»éŒ²æ¸ˆã¿ã®å¤‰æ•°ã€ãƒ•ã‚¡ã‚¯ãƒˆã€ãŠã‚ˆã³ãƒžã‚¸ãƒƒã‚¯å¤‰æ•°ã«è‡ªå‹•çš„ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:416 +#: ../../rst/playbook_guide/playbooks_variables.rst:418 msgid "Tips on where to set variables" msgstr "変数をè¨å®šã™ã‚‹å ´æ‰€ã«é–¢ã™ã‚‹ãƒ’ント" -#: ../../rst/playbook_guide/playbooks_variables.rst:418 +#: ../../rst/playbook_guide/playbooks_variables.rst:420 msgid "You should choose where to define a variable based on the kind of control you might want over values." msgstr "変数を定義ã™ã‚‹å ´æ‰€ã¯ã€å€¤ã‚’ã©ã®ã‚ˆã†ã«åˆ¶å¾¡ã™ã‚‹ã‹ã«ã‚ˆã£ã¦é¸æŠžã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:420 +#: ../../rst/playbook_guide/playbooks_variables.rst:422 msgid "Set variables in inventory that deal with geography or behavior. Since groups are frequently the entity that maps roles onto hosts, you can often set variables on the group instead of defining them on a role. Remember: child groups override parent groups, and host variables override group variables. See :ref:`define_variables_in_inventory` for details on setting host and group variables." msgstr "地ç†ã‚„動作を扱ã†ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«å¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚グループã¯ã€ãƒ›ã‚¹ãƒˆã«ãƒãƒ¼ãƒ«ã‚’マッピングã™ã‚‹ã‚¨ãƒ³ãƒ†ã‚£ãƒ†ã‚£ãƒ¼ã§ã‚ã‚‹ã“ã¨ãŒå¤šã„ãŸã‚ã€ãƒãƒ¼ãƒ«ã«å¤‰æ•°ã‚’定義ã™ã‚‹ä»£ã‚ã‚Šã«ã€ã‚°ãƒ«ãƒ¼ãƒ—ã«å¤‰æ•°ã‚’è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚åグループãŒè¦ªã‚°ãƒ«ãƒ¼ãƒ—を上書ãã—ã€ãƒ›ã‚¹ãƒˆå¤‰æ•°ãŒã‚°ãƒ«ãƒ¼ãƒ—変数を上書ãã™ã‚‹ã“ã¨ã‚’忘れãªã„ã§ãã ã•ã„。ホスト変数ã¨ã‚°ãƒ«ãƒ¼ãƒ—変数ã®è¨å®šã®è©³ç´°ã¯ã€ã€Œ:ref:`define_variables_in_inventory`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_variables.rst:422 +#: ../../rst/playbook_guide/playbooks_variables.rst:424 msgid "Set common defaults in a ``group_vars/all`` file. See :ref:`splitting_out_vars` for details on how to organize host and group variables in your inventory. Group variables are generally placed alongside your inventory file, but they can also be returned by dynamic inventory (see :ref:`intro_dynamic_inventory`) or defined in AWX or on :ref:`ansible_platform` from the UI or API:" msgstr "``group_vars/all`` ファイルã§å…±é€šã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’è¨å®šã—ã¾ã™ã€‚インベントリーã§ãƒ›ã‚¹ãƒˆå¤‰æ•°ã¨ã‚°ãƒ«ãƒ¼ãƒ—変数を整ç†ã™ã‚‹æ–¹æ³•ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€ã€Œ:ref:`splitting_out_vars`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。グループ変数ã¯é€šå¸¸ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã¨ä¸€ç·’ã«ç½®ã‹ã‚Œã¾ã™ãŒã€å‹•çš„インベントリー (:ref:`intro_dynamic_inventory` ã‚’å‚ç…§) ã§è¿”ã•ã‚ŒãŸã‚Šã€AWXã€ã¾ãŸã¯ UI ã‚„ API ã‹ã‚‰ :ref:`ansible_platform` ã§å®šç¾©ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:431 +#: ../../rst/playbook_guide/playbooks_variables.rst:433 msgid "Set location-specific variables in ``group_vars/my_location`` files. All groups are children of the ``all`` group, so variables set here override those set in ``group_vars/all``:" msgstr "``group_vars/my_location`` ファイルã«ãƒã‚±ãƒ¼ã‚·ãƒ§ãƒ³å›ºæœ‰ã®å¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚ã™ã¹ã¦ã®ã‚°ãƒ«ãƒ¼ãƒ—㯠``all`` グループã®åã§ã‚ã‚‹ãŸã‚ã€ã“ã“ã«è¨å®šã•ã‚Œã‚‹å¤‰æ•°ã¯ ``group_vars/all`` ã§è¨å®šã—ãŸå¤‰æ•°ã‚’上書ãã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:439 +#: ../../rst/playbook_guide/playbooks_variables.rst:441 msgid "If one host used a different NTP server, you could set that in a host_vars file, which would override the group variable:" msgstr "1 ã¤ã®ãƒ›ã‚¹ãƒˆãŒåˆ¥ã® NTP サーãƒãƒ¼ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€host_vars ファイルã«ãã®ãƒ›ã‚¹ãƒˆã‚’è¨å®šã§ãã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ã‚°ãƒ«ãƒ¼ãƒ—変数ãŒä¸Šæ›¸ãã•ã‚Œã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:447 +#: ../../rst/playbook_guide/playbooks_variables.rst:449 msgid "Set defaults in roles to avoid undefined-variable errors. If you share your roles, other users can rely on the reasonable defaults you added in the ``roles/x/defaults/main.yml`` file, or they can easily override those values in inventory or at the command line. See :ref:`playbooks_reuse_roles` for more info. For example:" msgstr "未定義ãªå¤‰æ•°ã‚¨ãƒ©ãƒ¼ã‚’防ããŸã‚ã«ã€ãƒãƒ¼ãƒ«ã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’è¨å®šã—ã¾ã™ã€‚ãƒãƒ¼ãƒ«ã‚’共有ã—ã¦ã„ã‚‹å ´åˆã€ä»–ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ã€``roles/x/defaults/main.yml`` ファイルã§è¿½åŠ ã—ãŸå¦¥å½“ãªãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ä¿¡é ¼ã™ã‚‹ã‹ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚„コマンドラインã§ç°¡å˜ã«ãã®å€¤ã‚’上書ãã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`playbooks_reuse_roles`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:456 +#: ../../rst/playbook_guide/playbooks_variables.rst:458 msgid "Set variables in roles to ensure a value is used in that role, and is not overridden by inventory variables. If you are not sharing your role with others, you can define app-specific behaviors like ports this way, in ``roles/x/vars/main.yml``. If you are sharing roles with others, putting variables here makes them harder to override, although they still can by passing a parameter to the role or setting a variable with ``-e``:" msgstr "ãƒãƒ¼ãƒ«ã«å¤‰æ•°ã‚’è¨å®šã™ã‚‹ã“ã¨ã§ã€å€¤ãŒãã®ãƒãƒ¼ãƒ«ã§ä½¿ç”¨ã•ã‚Œã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã§ä¸Šæ›¸ãã•ã‚Œãªã„よã†ã«ã—ã¾ã™ã€‚ãƒãƒ¼ãƒ«ã‚’ä»–ã®äººã¨å…±æœ‰ã—ã¦ã„ãªã„å ´åˆã¯ã€ãƒãƒ¼ãƒˆãªã©ã®ã‚¢ãƒ—リ固有ã®å‹•ä½œã‚’ã€ã“ã®ã‚ˆã†ã« ``roles/x/vars/main.yml`` ã§å®šç¾©ã§ãã¾ã™ã€‚ä»–ã®äººã¨ãƒãƒ¼ãƒ«ã‚’共有ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã“ã“ã«å¤‰æ•°ã‚’ç½®ãã“ã¨ã§ä¸Šæ›¸ãã•ã‚Œã«ãããªã‚Šã¾ã™ã€‚ãŸã ã—ã€ãƒãƒ¼ãƒ«ã«ãƒ‘ラメーターを渡ã—ãŸã‚Šã€``-e`` ã§å¤‰æ•°ã‚’è¨å®šã—ãŸã‚Šã™ã‚Œã°ã€ä¸Šæ›¸ãã•ã‚Œã‚‹å¯èƒ½æ€§ã¯ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:465 +#: ../../rst/playbook_guide/playbooks_variables.rst:467 msgid "Pass variables as parameters when you call roles for maximum clarity, flexibility, and visibility. This approach overrides any defaults that exist for a role. For example:" msgstr "明確ã•ã€æŸ”軟性ã€ãŠã‚ˆã³å¯è¦–性を最大化ã™ã‚‹ãŸã‚ã«ãƒãƒ¼ãƒ«ã‚’呼ã³å‡ºã™å ´åˆã¯ã€ãƒ‘ラメーターã¨ã—ã¦å¤‰æ•°ã‚’渡ã—ã¾ã™ã€‚ã“ã®æ–¹æ³•ã§ã¯ã€ãƒãƒ¼ãƒ«ã«å˜åœ¨ã™ã‚‹ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’上書ãã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:474 +#: ../../rst/playbook_guide/playbooks_variables.rst:476 msgid "When you read this playbook it is clear that you have chosen to set a variable or override a default. You can also pass multiple values, which allows you to run the same role multiple times. See :ref:`run_role_twice` for more details. For example:" msgstr "ã“ã® Playbook ã‚’èªã‚€ã¨ã€å¤‰æ•°ã®è¨å®šã‚„デフォルトã®ä¸Šæ›¸ãã‚’é¸æŠžã—ãŸã“ã¨ãŒã‚ã‹ã‚Šã¾ã™ã€‚ã¾ãŸã€è¤‡æ•°ã®å€¤ã‚’渡ã™ã“ã¨ãŒã§ãã‚‹ãŸã‚ã€åŒã˜ãƒãƒ¼ãƒ«ã‚’複数回実行ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚詳細ã¯ã€Œ:ref:`run_role_twice`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:492 +#: ../../rst/playbook_guide/playbooks_variables.rst:494 msgid "Variables set in one role are available to later roles. You can set variables in a ``roles/common_settings/vars/main.yml`` file and use them in other roles and elsewhere in your playbook:" msgstr "1 ã¤ã®ãƒãƒ¼ãƒ«ã«è¨å®šã•ã‚ŒãŸå¤‰æ•°ã¯ã€å¾Œã®ãƒãƒ¼ãƒ«ã§ä½¿ç”¨ã§ãã¾ã™ã€‚変数ã¯ã€``roles/common_settings/vars/main.yml`` ファイルã«è¨å®šã—ã¦ã€ä»–ã®ãƒãƒ¼ãƒ«ã‚„ Playbook ã®ä»–ã®å ´æ‰€ã§ä½¿ç”¨ã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:503 +#: ../../rst/playbook_guide/playbooks_variables.rst:505 msgid "There are some protections in place to avoid the need to namespace variables. In this example, variables defined in 'common_settings' are available to 'something' and 'something_else' tasks, but tasks in 'something' have foo set at 12, even if 'common_settings' sets foo to 20." msgstr "変数ã®åå‰ç©ºé–“化ã®å¿…è¦æ€§ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€ã„ãã¤ã‹ã®ä¿è·æ©Ÿèƒ½ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ä¾‹ã§ã¯ã€ã€Œcommon_settingsã€ã§å®šç¾©ã•ã‚ŒãŸå¤‰æ•°ã¯ã€Œsomethingã€ã¨ã€Œsomething_elseã€ã®ã‚¿ã‚¹ã‚¯ã§ä½¿ç”¨ã§ãã¾ã™ãŒã€ã€Œcommon_settingsã€ã§ foo ㌠20 ã«è¨å®šã•ã‚Œã¦ã„ã¦ã‚‚ã€ã€Œsomethingã€ã®ã‚¿ã‚¹ã‚¯ã§ã¯ foo ㌠12 ã«è¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:506 +#: ../../rst/playbook_guide/playbooks_variables.rst:508 msgid "Instead of worrying about variable precedence, we encourage you to think about how easily or how often you want to override a variable when deciding where to set it. If you are not sure what other variables are defined, and you need a particular value, use ``--extra-vars`` (``-e``) to override all other variables." msgstr "変数ã®å„ªå…ˆé †ä½ã‚’æ°—ã«ã™ã‚‹ã®ã§ã¯ãªãã€å¤‰æ•°ã‚’ã©ã“ã«è¨å®šã™ã‚‹ã‹ã‚’決ã‚ã‚‹éš›ã«ã¯ã€ã©ã‚Œã ã‘ç°¡å˜ã«ã€ã‚ã‚‹ã„ã¯ã©ã‚Œã ã‘é »ç¹ã«å¤‰æ•°ã‚’上書ãã—ãŸã„ã‹ã‚’考ãˆã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ä»–ã®å¤‰æ•°ãŒã©ã®ã‚ˆã†ã«å®šç¾©ã•ã‚Œã¦ã„ã‚‹ã‹ã‚ã‹ã‚‰ãšã€ç‰¹å®šã®å€¤ãŒå¿…è¦ãªå ´åˆã¯ã€``--extra-vars`` (``-e``) を使用ã—ã¦ã€ä»–ã®ã™ã¹ã¦ã®å¤‰æ•°ã‚’上書ãã—ã¾ã™ã€‚" -#: ../../rst/playbook_guide/playbooks_variables.rst:509 +#: ../../rst/playbook_guide/playbooks_variables.rst:511 msgid "Using advanced variable syntax" msgstr "高度ãªå¤‰æ•°æ§‹æ–‡ã®ä½¿ç”¨" -#: ../../rst/playbook_guide/playbooks_variables.rst:511 +#: ../../rst/playbook_guide/playbooks_variables.rst:513 msgid "For information about advanced YAML syntax used to declare variables and have more control over the data placed in YAML files used by Ansible, see :ref:`playbooks_advanced_syntax`." msgstr "変数を宣言ã™ã‚‹ã®ã«ä½¿ç”¨ã•ã‚Œã‚‹é«˜åº¦ãª YAML 構文ã€ãŠã‚ˆã³ Ansible ã«ã‚ˆã‚Šä½¿ç”¨ã•ã‚Œã‚‹ YAML ファイルã«ã‚るデータã«å¯¾ã™ã‚‹åˆ¶å¾¡ã®è©³ç´°ã¯ã€ã€Œ:ref:`playbooks_advanced_syntax`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/playbook_guide/playbooks_variables.rst:520 +#: ../../rst/playbook_guide/playbooks_variables.rst:522 msgid "Jinja2 filters and their uses" msgstr "Jinja2 フィルターãŠã‚ˆã³ãã®ä½¿ç”¨" -#: ../../rst/playbook_guide/playbooks_variables.rst:527 +#: ../../rst/playbook_guide/playbooks_variables.rst:529 msgid ":ref:`special_variables`" msgstr ":ref:`special_variables`" -#: ../../rst/playbook_guide/playbooks_variables.rst:528 +#: ../../rst/playbook_guide/playbooks_variables.rst:530 msgid "List of special variables" msgstr "特殊ãªå¤‰æ•°ã®ãƒªã‚¹ãƒˆ" @@ -7718,7 +7730,7 @@ msgstr "``ansible_check_mode`` ㌠``--check`` 㧠Ansible を実行ã™ã‚‹å ´åˆ #: ../../rst/playbook_guide/playbooks_vars_facts.rst:698 msgid "Ansible version" -msgstr "Ansible version" +msgstr "Ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³" #: ../../rst/playbook_guide/playbooks_vars_facts.rst:702 msgid "To adapt playbook behavior to different versions of Ansible, you can use the variable ``ansible_version``, which has the following structure:" @@ -7732,4 +7744,7 @@ msgstr "Playbook ã§ã® Vault ã®ä½¿ç”¨" msgid "The documentation regarding Ansible Vault has moved. The new location is here: :ref:`vault`. Please update any links you may have made directly to this page." msgstr "Ansible Vault ã«é–¢ã™ã‚‹ãƒ‰ã‚ュメントãŒç§»å‹•ã—ã¾ã—ãŸã€‚æ–°ã—ã„å ´æ‰€ã¯ã€Œ:ref:`vault`ã€ã§ã™ã€‚ã“ã®ãƒšãƒ¼ã‚¸ã«ç›´æŽ¥ä½œæˆã—ãŸå¯èƒ½æ€§ã®ã‚るリンクを更新ã—ã¦ãã ã•ã„。" +#~ msgid "If the option is a boolean value, you can use any of the boolean values recognized by Ansible: (such as true/false or yes/no). Choose the one that reads better in the context of the option." +#~ msgstr "オプションãŒãƒ–ール値ã®å ´åˆã¯ã€Ansible ãŒèªè˜ã™ã‚‹ä»»æ„ã®ãƒ–ール値 (true/falseã€yes/no ãªã©) を使用ã§ãã¾ã™ã€‚オプションã®ã‚³ãƒ³ãƒ†ã‚ストã§èªã¿å–ã‚ŠãŒé©åˆ‡ã§ã‚ã‚Œã°ã“れをé¸æŠžã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/plugins.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/plugins.po index 05fee16c..0a618d11 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/plugins.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/plugins.po @@ -7,17 +7,17 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/plugins/action.rst:4 ../../rst/plugins/cache.rst:123 -#: ../../rst/plugins/callback.rst:81 +#: ../../rst/plugins/callback.rst:100 msgid "Action plugins" msgstr "action プラグイン" @@ -46,9 +46,9 @@ msgid "Action plugin are executed by default when an associated module is used; msgstr "action プラグインã¯ã€é–¢é€£ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹å ´åˆã«ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§å®Ÿè¡Œã™ã‚‹ãŸã‚ã€ç‰¹ã«ä½œæ¥ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" #: ../../rst/plugins/action.rst:29 ../../rst/plugins/cache.rst:115 -#: ../../rst/plugins/callback.rst:73 ../../rst/plugins/connection.rst:55 +#: ../../rst/plugins/callback.rst:92 ../../rst/plugins/connection.rst:55 #: ../../rst/plugins/filter.rst:43 ../../rst/plugins/inventory.rst:159 -#: ../../rst/plugins/lookup.rst:137 ../../rst/plugins/strategy.rst:55 +#: ../../rst/plugins/lookup.rst:147 ../../rst/plugins/strategy.rst:57 #: ../../rst/plugins/test.rst:78 ../../rst/plugins/vars.rst:53 msgid "Plugin list" msgstr "プラグイン一覧" @@ -61,21 +61,21 @@ msgstr "直接 action プラグインã®ä¸€è¦§ã‚’表示ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã msgid "Use ``ansible-doc -l`` to see the list of available modules. Use ``ansible-doc <name>`` to see specific documentation and examples, this should note if the module has a corresponding action plugin." msgstr "``ansible-doc -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚特定ã®ãƒ‰ã‚ュメントãŠã‚ˆã³ä¾‹ã‚’å‚ç…§ã™ã‚‹ã«ã¯ ``ansible-doc <name>`` を使用ã—ã¦ãã ã•ã„。モジュールã«å¯¾å¿œã® action プラグインãŒã‚ã‚‹å ´åˆã«ã¯ã€ã“ã®ç‚¹ã«æ³¨æ„ã—ã¦ãã ã•ã„。" -#: ../../rst/plugins/action.rst:38 ../../rst/plugins/callback.rst:82 +#: ../../rst/plugins/action.rst:38 ../../rst/plugins/callback.rst:101 #: ../../rst/plugins/vars.rst:60 msgid ":ref:`cache_plugins`" msgstr ":ref:`cache_plugins`" #: ../../rst/plugins/action.rst:39 ../../rst/plugins/cache.rst:4 -#: ../../rst/plugins/callback.rst:83 ../../rst/plugins/vars.rst:61 +#: ../../rst/plugins/callback.rst:102 ../../rst/plugins/vars.rst:61 msgid "Cache plugins" msgstr "Cache プラグイン" #: ../../rst/plugins/action.rst:40 ../../rst/plugins/become.rst:56 #: ../../rst/plugins/cache.rst:124 ../../rst/plugins/connection.rst:65 #: ../../rst/plugins/filter.rst:54 ../../rst/plugins/inventory.rst:168 -#: ../../rst/plugins/lookup.rst:148 ../../rst/plugins/shell.rst:42 -#: ../../rst/plugins/strategy.rst:67 +#: ../../rst/plugins/lookup.rst:158 ../../rst/plugins/shell.rst:42 +#: ../../rst/plugins/strategy.rst:69 msgid ":ref:`callback_plugins`" msgstr ":ref:`callback_plugins`" @@ -83,64 +83,64 @@ msgstr ":ref:`callback_plugins`" #: ../../rst/plugins/cache.rst:125 ../../rst/plugins/callback.rst:4 #: ../../rst/plugins/connection.rst:66 ../../rst/plugins/filter.rst:55 #: ../../rst/plugins/inventory.rst:169 ../../rst/plugins/shell.rst:43 -#: ../../rst/plugins/strategy.rst:68 +#: ../../rst/plugins/strategy.rst:70 msgid "Callback plugins" msgstr "callback プラグイン" #: ../../rst/plugins/action.rst:42 ../../rst/plugins/cache.rst:126 -#: ../../rst/plugins/callback.rst:84 ../../rst/plugins/inventory.rst:170 +#: ../../rst/plugins/callback.rst:103 ../../rst/plugins/inventory.rst:170 #: ../../rst/plugins/terminal.rst:44 msgid ":ref:`connection_plugins`" msgstr ":ref:`connection_plugins`" #: ../../rst/plugins/action.rst:43 ../../rst/plugins/cache.rst:127 -#: ../../rst/plugins/callback.rst:85 ../../rst/plugins/connection.rst:4 +#: ../../rst/plugins/callback.rst:104 ../../rst/plugins/connection.rst:4 #: ../../rst/plugins/inventory.rst:171 ../../rst/plugins/terminal.rst:45 msgid "Connection plugins" msgstr "connection プラグイン" #: ../../rst/plugins/action.rst:44 ../../rst/plugins/become.rst:54 -#: ../../rst/plugins/cache.rst:128 ../../rst/plugins/callback.rst:86 -#: ../../rst/plugins/filter.rst:52 ../../rst/plugins/lookup.rst:146 -#: ../../rst/plugins/shell.rst:40 ../../rst/plugins/strategy.rst:65 +#: ../../rst/plugins/cache.rst:128 ../../rst/plugins/callback.rst:105 +#: ../../rst/plugins/filter.rst:52 ../../rst/plugins/lookup.rst:156 +#: ../../rst/plugins/shell.rst:40 ../../rst/plugins/strategy.rst:67 msgid ":ref:`inventory_plugins`" msgstr ":ref:`inventory_plugins`" #: ../../rst/plugins/action.rst:45 ../../rst/plugins/become.rst:55 -#: ../../rst/plugins/cache.rst:129 ../../rst/plugins/callback.rst:87 +#: ../../rst/plugins/cache.rst:129 ../../rst/plugins/callback.rst:106 #: ../../rst/plugins/filter.rst:53 ../../rst/plugins/inventory.rst:4 -#: ../../rst/plugins/shell.rst:41 ../../rst/plugins/strategy.rst:66 +#: ../../rst/plugins/shell.rst:41 ../../rst/plugins/strategy.rst:68 msgid "Inventory plugins" msgstr "inventory プラグイン" #: ../../rst/plugins/action.rst:46 ../../rst/plugins/cache.rst:130 -#: ../../rst/plugins/callback.rst:88 +#: ../../rst/plugins/callback.rst:107 msgid ":ref:`shell_plugins`" msgstr ":ref:`shell_plugins`" #: ../../rst/plugins/action.rst:47 ../../rst/plugins/cache.rst:131 -#: ../../rst/plugins/callback.rst:89 ../../rst/plugins/shell.rst:4 +#: ../../rst/plugins/callback.rst:108 ../../rst/plugins/shell.rst:4 msgid "Shell plugins" msgstr "shell プラグイン" #: ../../rst/plugins/action.rst:48 ../../rst/plugins/cache.rst:132 -#: ../../rst/plugins/callback.rst:90 +#: ../../rst/plugins/callback.rst:109 msgid ":ref:`strategy_plugins`" msgstr ":ref:`strategy_plugins`" #: ../../rst/plugins/action.rst:49 ../../rst/plugins/cache.rst:133 -#: ../../rst/plugins/callback.rst:91 ../../rst/plugins/strategy.rst:4 +#: ../../rst/plugins/callback.rst:110 ../../rst/plugins/strategy.rst:4 msgid "Strategy plugins" msgstr "strategy プラグイン" #: ../../rst/plugins/action.rst:50 ../../rst/plugins/cache.rst:134 -#: ../../rst/plugins/callback.rst:92 ../../rst/plugins/connection.rst:73 +#: ../../rst/plugins/callback.rst:111 ../../rst/plugins/connection.rst:73 #: ../../rst/plugins/inventory.rst:178 msgid ":ref:`vars_plugins`" msgstr ":ref:`vars_plugins`" #: ../../rst/plugins/action.rst:51 ../../rst/plugins/cache.rst:135 -#: ../../rst/plugins/callback.rst:93 ../../rst/plugins/connection.rst:74 +#: ../../rst/plugins/callback.rst:112 ../../rst/plugins/connection.rst:74 #: ../../rst/plugins/inventory.rst:179 ../../rst/plugins/vars.rst:4 msgid "Vars plugins" msgstr "vars プラグイン" @@ -149,43 +149,43 @@ msgstr "vars プラグイン" #: ../../rst/plugins/cliconf.rst:44 ../../rst/plugins/connection.rst:75 #: ../../rst/plugins/docs_fragment.rst:32 ../../rst/plugins/filter.rst:60 #: ../../rst/plugins/httpapi.rst:69 ../../rst/plugins/inventory.rst:180 -#: ../../rst/plugins/lookup.rst:154 ../../rst/plugins/module.rst:40 +#: ../../rst/plugins/lookup.rst:164 ../../rst/plugins/module.rst:40 #: ../../rst/plugins/module_util.rst:32 ../../rst/plugins/netconf.rst:44 #: ../../rst/plugins/plugins.rst:45 ../../rst/plugins/shell.rst:50 -#: ../../rst/plugins/strategy.rst:75 ../../rst/plugins/terminal.rst:46 +#: ../../rst/plugins/strategy.rst:77 ../../rst/plugins/terminal.rst:46 #: ../../rst/plugins/test.rst:98 ../../rst/plugins/vars.rst:64 msgid "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" msgstr "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" #: ../../rst/plugins/action.rst:53 ../../rst/plugins/become.rst:65 -#: ../../rst/plugins/cache.rst:137 ../../rst/plugins/callback.rst:95 +#: ../../rst/plugins/cache.rst:137 ../../rst/plugins/callback.rst:114 #: ../../rst/plugins/cliconf.rst:45 ../../rst/plugins/connection.rst:76 #: ../../rst/plugins/docs_fragment.rst:33 ../../rst/plugins/filter.rst:61 #: ../../rst/plugins/httpapi.rst:70 ../../rst/plugins/inventory.rst:181 -#: ../../rst/plugins/lookup.rst:155 ../../rst/plugins/module.rst:41 +#: ../../rst/plugins/lookup.rst:165 ../../rst/plugins/module.rst:41 #: ../../rst/plugins/module_util.rst:33 ../../rst/plugins/netconf.rst:45 #: ../../rst/plugins/plugins.rst:46 ../../rst/plugins/shell.rst:51 -#: ../../rst/plugins/strategy.rst:76 ../../rst/plugins/terminal.rst:47 +#: ../../rst/plugins/strategy.rst:78 ../../rst/plugins/terminal.rst:47 #: ../../rst/plugins/test.rst:99 ../../rst/plugins/vars.rst:65 msgid "Have a question? Stop by the google group!" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" #: ../../rst/plugins/action.rst:54 ../../rst/plugins/become.rst:66 -#: ../../rst/plugins/cache.rst:138 ../../rst/plugins/callback.rst:96 +#: ../../rst/plugins/cache.rst:138 ../../rst/plugins/callback.rst:115 #: ../../rst/plugins/connection.rst:77 ../../rst/plugins/docs_fragment.rst:34 #: ../../rst/plugins/filter.rst:62 ../../rst/plugins/inventory.rst:182 -#: ../../rst/plugins/lookup.rst:156 ../../rst/plugins/plugins.rst:47 -#: ../../rst/plugins/shell.rst:52 ../../rst/plugins/strategy.rst:77 +#: ../../rst/plugins/lookup.rst:166 ../../rst/plugins/plugins.rst:47 +#: ../../rst/plugins/shell.rst:52 ../../rst/plugins/strategy.rst:79 #: ../../rst/plugins/test.rst:100 ../../rst/plugins/vars.rst:66 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" #: ../../rst/plugins/action.rst:55 ../../rst/plugins/become.rst:67 -#: ../../rst/plugins/cache.rst:139 ../../rst/plugins/callback.rst:97 +#: ../../rst/plugins/cache.rst:139 ../../rst/plugins/callback.rst:116 #: ../../rst/plugins/connection.rst:78 ../../rst/plugins/docs_fragment.rst:35 #: ../../rst/plugins/filter.rst:63 ../../rst/plugins/inventory.rst:183 -#: ../../rst/plugins/lookup.rst:157 ../../rst/plugins/plugins.rst:48 -#: ../../rst/plugins/shell.rst:53 ../../rst/plugins/strategy.rst:78 +#: ../../rst/plugins/lookup.rst:167 ../../rst/plugins/plugins.rst:48 +#: ../../rst/plugins/shell.rst:53 ../../rst/plugins/strategy.rst:80 #: ../../rst/plugins/test.rst:101 ../../rst/plugins/vars.rst:67 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -231,59 +231,59 @@ msgid "You can use ``ansible-doc -t become -l`` to see the list of available plu msgstr "``ansible-doc -t become -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ—ラグインã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚``ansible-doc -t become <plugin name>`` を使用ã—ã¦ã€ç‰¹å®šã®ãƒ‰ã‚ュメントã¨ä¾‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/plugins/become.rst:52 ../../rst/plugins/filter.rst:50 -#: ../../rst/plugins/inventory.rst:166 ../../rst/plugins/lookup.rst:144 +#: ../../rst/plugins/inventory.rst:166 ../../rst/plugins/lookup.rst:154 #: ../../rst/plugins/module.rst:34 ../../rst/plugins/shell.rst:38 -#: ../../rst/plugins/strategy.rst:63 ../../rst/plugins/test.rst:86 +#: ../../rst/plugins/strategy.rst:65 ../../rst/plugins/test.rst:86 msgid ":ref:`about_playbooks`" msgstr ":ref:`about_playbooks`" #: ../../rst/plugins/become.rst:53 ../../rst/plugins/connection.rst:64 #: ../../rst/plugins/filter.rst:51 ../../rst/plugins/inventory.rst:167 -#: ../../rst/plugins/lookup.rst:145 ../../rst/plugins/module.rst:35 -#: ../../rst/plugins/shell.rst:39 ../../rst/plugins/strategy.rst:64 +#: ../../rst/plugins/lookup.rst:155 ../../rst/plugins/module.rst:35 +#: ../../rst/plugins/shell.rst:39 ../../rst/plugins/strategy.rst:66 #: ../../rst/plugins/test.rst:87 msgid "An introduction to playbooks" msgstr "Playbook ã®æ¦‚è¦" #: ../../rst/plugins/become.rst:58 ../../rst/plugins/connection.rst:67 -#: ../../rst/plugins/inventory.rst:172 ../../rst/plugins/lookup.rst:150 -#: ../../rst/plugins/shell.rst:44 ../../rst/plugins/strategy.rst:69 +#: ../../rst/plugins/inventory.rst:172 ../../rst/plugins/lookup.rst:160 +#: ../../rst/plugins/shell.rst:44 ../../rst/plugins/strategy.rst:71 #: ../../rst/plugins/test.rst:92 msgid ":ref:`filter_plugins`" -msgstr ":ref:`vars_plugins`" +msgstr ":ref:`filter_plugins`" #: ../../rst/plugins/become.rst:59 ../../rst/plugins/connection.rst:68 #: ../../rst/plugins/filter.rst:4 ../../rst/plugins/inventory.rst:173 -#: ../../rst/plugins/shell.rst:45 ../../rst/plugins/strategy.rst:70 +#: ../../rst/plugins/shell.rst:45 ../../rst/plugins/strategy.rst:72 #: ../../rst/plugins/test.rst:93 msgid "Filter plugins" msgstr "filter プラグイン" #: ../../rst/plugins/become.rst:60 ../../rst/plugins/connection.rst:69 #: ../../rst/plugins/filter.rst:56 ../../rst/plugins/inventory.rst:174 -#: ../../rst/plugins/lookup.rst:152 ../../rst/plugins/shell.rst:46 -#: ../../rst/plugins/strategy.rst:71 +#: ../../rst/plugins/lookup.rst:162 ../../rst/plugins/shell.rst:46 +#: ../../rst/plugins/strategy.rst:73 msgid ":ref:`test_plugins`" -msgstr ":ref:`vars_plugins`" +msgstr ":ref:`test_plugins`" #: ../../rst/plugins/become.rst:61 ../../rst/plugins/connection.rst:70 #: ../../rst/plugins/filter.rst:57 ../../rst/plugins/inventory.rst:175 -#: ../../rst/plugins/shell.rst:47 ../../rst/plugins/strategy.rst:72 +#: ../../rst/plugins/shell.rst:47 ../../rst/plugins/strategy.rst:74 #: ../../rst/plugins/test.rst:4 msgid "Test plugins" msgstr "test プラグイン" #: ../../rst/plugins/become.rst:62 ../../rst/plugins/connection.rst:71 #: ../../rst/plugins/filter.rst:58 ../../rst/plugins/inventory.rst:176 -#: ../../rst/plugins/shell.rst:48 ../../rst/plugins/strategy.rst:73 +#: ../../rst/plugins/shell.rst:48 ../../rst/plugins/strategy.rst:75 #: ../../rst/plugins/test.rst:96 ../../rst/plugins/vars.rst:62 msgid ":ref:`lookup_plugins`" -msgstr ":ref:`shell_plugins`" +msgstr ":ref:`lookup_plugins`" #: ../../rst/plugins/become.rst:63 ../../rst/plugins/connection.rst:72 #: ../../rst/plugins/filter.rst:59 ../../rst/plugins/inventory.rst:177 #: ../../rst/plugins/lookup.rst:4 ../../rst/plugins/shell.rst:49 -#: ../../rst/plugins/strategy.rst:74 ../../rst/plugins/test.rst:97 +#: ../../rst/plugins/strategy.rst:76 ../../rst/plugins/test.rst:97 #: ../../rst/plugins/vars.rst:63 msgid "Lookup plugins" msgstr "lookup プラグイン" @@ -368,11 +368,11 @@ msgstr "cache プラグインã¯ã€æœ‰åŠ¹ã«ãªã‚‹ã¨è‡ªå‹•çš„ã«ä½¿ç”¨ã•ã‚Œã¾ msgid "You can use ``ansible-doc -t cache -l`` to see the list of available plugins. Use ``ansible-doc -t cache <plugin name>`` to see specific documentation and examples." msgstr "``ansible-doc -t cache -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ—ラグインã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚``ansible-doc -t cache <plugin name>`` を使用ã—ã¦ã€ç‰¹å®šã®ãƒ‰ã‚ュメントã¨ä¾‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/plugins/cache.rst:122 ../../rst/plugins/callback.rst:80 +#: ../../rst/plugins/cache.rst:122 ../../rst/plugins/callback.rst:99 msgid ":ref:`action_plugins`" msgstr ":ref:`action_plugins`" -#: ../../rst/plugins/cache.rst:136 ../../rst/plugins/callback.rst:94 +#: ../../rst/plugins/cache.rst:136 ../../rst/plugins/callback.rst:113 msgid "`User Mailing List <https://groups.google.com/forum/#!forum/ansible-devel>`_" msgstr "`User Mailing List <https://groups.google.com/forum/#!forum/ansible-devel>`_" @@ -413,8 +413,8 @@ msgid "Setting a callback plugin for ``ansible-playbook``" msgstr "``ansible-playbook`` ã® callback プラグインã®è¨å®š" #: ../../rst/plugins/callback.rst:39 -msgid "You can only have one plugin be the main manager of your console output. If you want to replace the default, you should define CALLBACK_TYPE = stdout in the subclass and then configure the stdout plugin in :ref:`ansible.cfg <ansible_configuration_settings>`. For example:" -msgstr "コンソール出力ã®ãƒ¡ã‚¤ãƒ³ãƒžãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã¯ã€1 ã¤ã®ãƒ—ラグインã®ã¿ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚デフォルトを置ãæ›ãˆã‚‹å ´åˆã¯ã€ã‚µãƒ–クラス㫠CALLBACK_TYPE = stdout を定義ã—ã¦ã€:ref:`ansible.cfg <ansible_configuration_settings>` ã« stdout プラグインをè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" +msgid "You can only have one plugin be the main manager of your console output. If you want to replace the default, you should define ``CALLBACK_TYPE = stdout`` in the subclass and then configure the stdout plugin in :ref:`ansible.cfg <ansible_configuration_settings>`. For example:" +msgstr "コンソール出力ã®ãƒ¡ã‚¤ãƒ³ãƒžãƒãƒ¼ã‚¸ãƒ£ãƒ¼ã¯ã€1 ã¤ã®ãƒ—ラグインã®ã¿ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚デフォルトを置ãæ›ãˆã‚‹å ´åˆã¯ã€ã‚µãƒ–クラス㫠``CALLBACK_TYPE = stdout`` を定義ã—ã¦ã€:ref:`ansible.cfg <ansible_configuration_settings>` ã« stdout プラグインをè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" #: ../../rst/plugins/callback.rst:45 msgid "or for my custom callback:" @@ -436,7 +436,39 @@ msgstr ":ref:`ansible` アドホックコマンドã¯ã€ç‰¹ã« stdout ã«ã¯åˆ¥ã msgid "You can also set this as an environment variable:" msgstr "ã“れを環境変数ã¨ã—ã¦è¨å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" +#: ../../rst/plugins/callback.rst:73 +msgid "Types of callback plugins" +msgstr "callback プラグインã®ã‚¿ã‚¤ãƒ—" + #: ../../rst/plugins/callback.rst:75 +msgid "There are three types of callback plugins:" +msgstr "callback プラグインã«ã¯ 3 種類ã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/plugins/callback.rst +msgid "stdout callback plugins" +msgstr "stdout callback プラグイン" + +#: ../../rst/plugins/callback.rst:79 +msgid "These plugins handle the main console output. Only one of these can be active." +msgstr "ã“れらã®ãƒ—ラグインã¯ã€ãƒ¡ã‚¤ãƒ³ã‚³ãƒ³ã‚½ãƒ¼ãƒ«å‡ºåŠ›ã‚’処ç†ã—ã¾ã™ã€‚ã“れらã®ã†ã¡ã€ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ã«ã§ãã‚‹ã®ã¯ 1 ã¤ã ã‘ã§ã™ã€‚" + +#: ../../rst/plugins/callback.rst +msgid "aggregate callback plugins" +msgstr "aggregate callback プラグイン" + +#: ../../rst/plugins/callback.rst:83 +msgid "Aggregate callbacks can add additional console output next to a stdout callback. This can be aggregate information at the end of a playbook run, additional per-task output, or anything else." +msgstr "aggregate callback ã¯ã€stdout callback ã®éš£ã«è¿½åŠ ã®ã‚³ãƒ³ã‚½ãƒ¼ãƒ«å‡ºåŠ›ã‚’è¿½åŠ ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€Playbook 実行ã®çµ‚了時ã®é›†è¨ˆæƒ…å ±ã€è¿½åŠ ã®ã‚¿ã‚¹ã‚¯ã”ã¨ã®å‡ºåŠ›ãªã©ã®å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/plugins/callback.rst +msgid "notification callback plugins" +msgstr "notification callback プラグイン" + +#: ../../rst/plugins/callback.rst:87 +msgid "Notification callbacks inform other applications, services, or systems. This can be anything from logging to databases, informing on errors in Instant Messaging applications, or sending emails when a server is unreachable." +msgstr "notification callback ã¯ã€ä»–ã®ã‚¢ãƒ—リケーションã€ã‚µãƒ¼ãƒ“スã€ã¾ãŸã¯ã‚·ã‚¹ãƒ†ãƒ ã«é€šçŸ¥ã—ã¾ã™ã€‚ã“ã‚Œã«ã¯ã€ãƒ‡ãƒ¼ã‚¿ãƒ™ãƒ¼ã‚¹ã¸ã®ãƒã‚°è¨˜éŒ²ã€ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ãƒˆãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒ³ã‚°ã‚¢ãƒ—リケーションã§ã®ã‚¨ãƒ©ãƒ¼ã®é€šçŸ¥ã€ã‚µãƒ¼ãƒãƒ¼ã«åˆ°é”ã§ããªã„å ´åˆã®ãƒ¡ãƒ¼ãƒ«ã®é€ä¿¡ãªã©ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/plugins/callback.rst:94 msgid "You can use ``ansible-doc -t callback -l`` to see the list of available plugins. Use ``ansible-doc -t callback <plugin name>`` to see specific documents and examples." msgstr "``ansible-doc -t callback -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ—ラグインã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚``ansible-doc -t callback <plugin name>`` を使用ã—ã¦ã€ç‰¹å®šã®ãƒ‰ã‚ュメントã¨ä¾‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -835,70 +867,70 @@ msgid "You can use lookup plugins anywhere you can use templating in Ansible: in msgstr "lookup プラグインã¯ã€Ansible ã§ãƒ†ãƒ³ãƒ—レートを使用ã§ãã‚‹å ´æ‰€ã§ä½¿ç”¨ã§ãã¾ã™ã€‚ã“ã‚Œã¯ãƒ—レイã€å¤‰æ•°ãƒ•ã‚¡ã‚¤ãƒ«ã€ã¾ãŸã¯ :ref:`template <template_module>` モジュール㮠Jinja2 テンプレートã§ä½¿ç”¨ã§ãã¾ã™ã€‚lookup プラグインã®ä½¿ç”¨ã®è©³ç´°ã¯ã€:ref:`playbooks_lookups` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/plugins/lookup.rst:42 -msgid "Lookups are an integral part of loops. Wherever you see ``with_``, the part after the underscore is the name of a lookup. For this reason, lookups are expected to output lists; for example, ``with_items`` uses the :ref:`items <items_lookup>` lookup::" -msgstr "lookups ã¯ãƒ«ãƒ¼ãƒ—ã«ã¯æ¬ ã‹ã›ãªã„è¦ç´ ã§ã™ã€‚``with_`` ã¨è¡¨ç¤ºã•ã‚Œã‚‹å ´åˆã¯ã€ã‚¢ãƒ³ãƒ€ãƒ¼ã‚¹ã‚³ã‚¢ã®å¾Œã®éƒ¨åˆ†ãŒãƒ«ãƒƒã‚¯ã‚¢ãƒƒãƒ—ã®åå‰ã«ãªã‚Šã¾ã™ã€‚ã“ã®ã‚ˆã†ãªç†ç”±ã‹ã‚‰ã€ã»ã¨ã‚“ã©ã®ãƒ«ãƒƒã‚¯ã‚¢ãƒƒãƒ—ã¯ãƒªã‚¹ãƒˆã‚’出力ã™ã‚‹ã“ã¨ãŒæƒ³å®šã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€``with_items`` 㯠:ref:`items <items_lookup>` lookup を使用ã—ã¾ã™::" +msgid "Lookups are an integral part of loops. Wherever you see ``with_``, the part after the underscore is the name of a lookup. For this reason, lookups are expected to output lists; for example, ``with_items`` uses the :ref:`items <items_lookup>` lookup:" +msgstr "lookup ã¯ãƒ«ãƒ¼ãƒ—ã«ã¯æ¬ ã‹ã›ãªã„è¦ç´ ã§ã™ã€‚``with_`` ã¨è¡¨ç¤ºã•ã‚Œã‚‹å ´åˆã¯ã€ã‚¢ãƒ³ãƒ€ãƒ¼ã‚¹ã‚³ã‚¢ã®å¾Œã®éƒ¨åˆ†ãŒ lookup ã®åå‰ã«ãªã‚Šã¾ã™ã€‚ã“ã®ã‚ˆã†ãªç†ç”±ã‹ã‚‰ã€lookup ã¯ãƒªã‚¹ãƒˆã‚’出力ã™ã‚‹ã“ã¨ãŒæƒ³å®šã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€``with_items`` 㯠:ref:`items <items_lookup>` lookup を使用ã—ã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:49 -msgid "You can combine lookups with :ref:`filters <playbooks_filters>`, :ref:`tests <playbooks_tests>` and even each other to do some complex data generation and manipulation. For example::" +#: ../../rst/plugins/lookup.rst:51 +msgid "You can combine lookups with :ref:`filters <playbooks_filters>`, :ref:`tests <playbooks_tests>` and even each other to do some complex data generation and manipulation. For example:" msgstr "lookup 㨠:ref:`filters <playbooks_filters>`ã€:ref:`tests <playbooks_tests>`ã€ã¾ãŸã¯ãã‚Œãžã‚Œã‚’組ã¿åˆã‚ã›ã¦è¤‡é›‘ãªãƒ‡ãƒ¼ã‚¿ç”Ÿæˆã‚„データæ“作ãŒå¯èƒ½ã§ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:61 +#: ../../rst/plugins/lookup.rst:65 msgid "You can control how errors behave in all lookup plugins by setting ``errors`` to ``ignore``, ``warn``, or ``strict``. The default setting is ``strict``, which causes the task to fail if the lookup returns an error. For example:" msgstr "``errors`` ã‚’ ``ignore``ã€``warn``ã€ã¾ãŸã¯ ``strict`` ã«è¨å®šã—ã¦ã€ã™ã¹ã¦ã® lookup プラグインã§ã‚¨ãƒ©ãƒ¼ã®å‹•ä½œã‚’制御ã§ãã¾ã™ã€‚デフォルトè¨å®šã¯ ``strict`` ã§ã€lookup ãŒã‚¨ãƒ©ãƒ¼ã‚’è¿”ã™ã¨ã‚¿ã‚¹ã‚¯ã¯å¤±æ•—ã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:63 -msgid "To ignore lookup errors::" -msgstr "ルックアップエラーを無視ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" +#: ../../rst/plugins/lookup.rst:67 +msgid "To ignore lookup errors:" +msgstr "lookup エラーを無視ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:77 -msgid "To get a warning instead of a failure::" +#: ../../rst/plugins/lookup.rst:83 +msgid "To get a warning instead of a failure:" msgstr "失敗ã•ã›ã‚‹ã®ã§ã¯ãªãè¦å‘Šã‚’出ã™ã«ã¯ã€ä»¥ä¸‹ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:93 -msgid "To get a fatal error (the default)::" +#: ../../rst/plugins/lookup.rst:101 +msgid "To get a fatal error (the default):" msgstr "致命的ãªã‚¨ãƒ©ãƒ¼ã‚’å–å¾—ã™ã‚‹ (デフォルト) ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™::" -#: ../../rst/plugins/lookup.rst:108 +#: ../../rst/plugins/lookup.rst:118 msgid "Forcing lookups to return lists: ``query`` and ``wantlist=True``" msgstr "ルックアップãŒå¼·åˆ¶çš„ã«ãƒªã‚¹ãƒˆã‚’è¿”ã™ã‚ˆã†ã«ã™ã‚‹ï¼š ``query`` ãŠã‚ˆã³ ``wantlist=True``" -#: ../../rst/plugins/lookup.rst:112 +#: ../../rst/plugins/lookup.rst:122 msgid "In Ansible 2.5, a new Jinja2 function called ``query`` was added for invoking lookup plugins. The difference between ``lookup`` and ``query`` is largely that ``query`` will always return a list. The default behavior of ``lookup`` is to return a string of comma separated values. ``lookup`` can be explicitly configured to return a list using ``wantlist=True``." msgstr "Ansible 2.5 ã§ã¯ã€lookup プラグインを呼ã³å‡ºã™ãŸã‚ã« ``query`` ã¨å‘¼ã°ã‚Œã‚‹æ–°ã—ã„ Jinja2 関数ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚``lookup`` 㨠``query`` ã®ç›¸é•ç‚¹ã¯ã€``query`` ãŒå¸¸ã«ãƒªã‚¹ãƒˆã‚’è¿”ã™ã“ã¨ã§ã™ã€‚``lookup`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå‹•ä½œã¯ã€ã‚³ãƒ³ãƒžåŒºåˆ‡ã‚Šã®å€¤ã®æ–‡å—列を返ã™ã“ã¨ã§ã™ã€‚``lookup`` ã¯ã€``wantlist=True`` を使用ã—ã¦ãƒªã‚¹ãƒˆã‚’è¿”ã™ã‚ˆã†ã«æ˜Žç¤ºçš„ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:115 +#: ../../rst/plugins/lookup.rst:125 msgid "This feature provides an easier and more consistent interface for interacting with the new ``loop`` keyword, while maintaining backwards compatibility with other uses of ``lookup``." msgstr "ã“ã®æ©Ÿèƒ½ã«ã‚ˆã‚Šã€æ–°ã—ã„ ``loop`` ã‚ーワードをæ“作ã™ã‚‹ãŸã‚ã®ã€ã‚ˆã‚Šç°¡å˜ã§ä¸€è²«æ€§ã®ã‚るインターフェースãŒæä¾›ã•ã‚Œã€åŒæ™‚ã« ``lookup`` ã®ä»–ã®ä½¿ã„æ–¹ã¨ã®å¾Œæ–¹äº’æ›æ€§ã‚‚ç¶æŒã•ã‚Œã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:117 +#: ../../rst/plugins/lookup.rst:127 msgid "The following examples are equivalent:" msgstr "以下ã®ä¾‹ã¯ã©ã¡ã‚‰ã‚‚åŒç‰ã®æ“作ãŒã§ãã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:125 +#: ../../rst/plugins/lookup.rst:135 msgid "As demonstrated above, the behavior of ``wantlist=True`` is implicit when using ``query``." msgstr "上記ã®ä¾‹ã®ã‚ˆã†ã«ã€``query`` を使用ã™ã‚‹å ´åˆã€``wantlist=True`` ã®å‹•ä½œã¯æš—黙的ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/plugins/lookup.rst:127 +#: ../../rst/plugins/lookup.rst:137 msgid "Additionally, ``q`` was introduced as a shortform of ``query``:" msgstr "ã¾ãŸã€``query`` ã®çŸç¸®å½¢ã¨ãªã‚‹ ``q`` ãŒå°Žå…¥ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/plugins/lookup.rst:139 +#: ../../rst/plugins/lookup.rst:149 msgid "You can use ``ansible-doc -t lookup -l`` to see the list of available plugins. Use ``ansible-doc -t lookup <plugin name>`` to see specific documents and examples." msgstr "``ansible-doc -t lookup -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ—ラグインã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚``ansible-doc -t lookup <plugin name>`` を使用ã—ã¦ã€ç‰¹å®šã®ãƒ‰ã‚ュメントã¨ä¾‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/plugins/lookup.rst:147 +#: ../../rst/plugins/lookup.rst:157 msgid "Ansible inventory plugins" msgstr "Ansible inventory プラグインã®ä½¿ç”¨" -#: ../../rst/plugins/lookup.rst:149 +#: ../../rst/plugins/lookup.rst:159 msgid "Ansible callback plugins" msgstr "Ansible callback プラグイン" -#: ../../rst/plugins/lookup.rst:151 +#: ../../rst/plugins/lookup.rst:161 msgid "Jinja2 filter plugins" msgstr "Jinja2 filter プラグイン" -#: ../../rst/plugins/lookup.rst:153 +#: ../../rst/plugins/lookup.rst:163 msgid "Jinja2 test plugins" msgstr "Jinja2 test プラグイン" @@ -1099,10 +1131,10 @@ msgid "or in the `ansible.cfg` file:" msgstr "ã¾ãŸã¯ `ansible.cfg` ファイルã§ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" #: ../../rst/plugins/strategy.rst:38 -msgid "You can also specify the strategy plugin in the play via the :ref:`strategy keyword <playbook_keywords>` in a play::" -msgstr "プレイ㮠:ref:`strategy ã‚ーワード <playbook_keywords>` を使用ã—ã¦ã€ãƒ—レイ㮠strategy プラグインを指定ã§ãã¾ã™ã€‚" +msgid "You can also specify the strategy plugin in the play via the :ref:`strategy keyword <playbook_keywords>` in a play:" +msgstr "プレイ㮠:ref:`strategy keyword <playbook_keywords>` を使用ã—ã¦ã€ãƒ—レイ㮠strategy プラグインを指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/plugins/strategy.rst:57 +#: ../../rst/plugins/strategy.rst:59 msgid "You can use ``ansible-doc -t strategy -l`` to see the list of available plugins. Use ``ansible-doc -t strategy <plugin name>`` to see plugin-specific specific documentation and examples." msgstr "``ansible-doc -t strategy -l`` を使用ã—ã¦ã€åˆ©ç”¨å¯èƒ½ãªãƒ—ラグインã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚``ansible-doc -t strategy <plugin name>`` を使用ã—ã¦ã€ãƒ—ラグイン固有ã®ãƒ‰ã‚ュメントã¨ä¾‹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -1128,7 +1160,7 @@ msgstr "``terminal_plugins`` ディレクトリーã«ã‚«ã‚¹ã‚¿ãƒ ã®ãƒ—ラグイ #: ../../rst/plugins/terminal.rst:24 msgid "Using terminal plugins" -msgstr "terminal プラグイン" +msgstr "terminal プラグインã®ä½¿ç”¨" #: ../../rst/plugins/terminal.rst:26 msgid "Ansible determines which terminal plugin to use automatically from the ``ansible_network_os`` variable. There should be no reason to override this functionality." diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/porting_guides.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/porting_guides.po index 2209651a..9d16f26e 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/porting_guides.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/porting_guides.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/porting_guides/core_porting_guides.rst:5 msgid "Ansible Core Porting Guides" @@ -53,7 +53,7 @@ msgstr "本ガイドã¯ã€ã“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible ã§å‹•ä½œã™ã‚‹ã‚ˆã† #: ../../rst/porting_guides/porting_guide_2.0.rst:13 msgid "We suggest you read this page along with `Ansible Changelog for 2.0 <https://github.com/ansible/ansible/blob/stable-2.0/CHANGELOG.md>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.0 <https://github.com/ansible/ansible/blob/stable-2.0/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.0 <https://github.com/ansible/ansible/blob/stable-2.0/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.0.rst:15 #: ../../rst/porting_guides/porting_guide_2.3.rst:15 @@ -67,7 +67,7 @@ msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã› #: ../../rst/porting_guides/porting_guide_core_2.13.rst:14 #: ../../rst/porting_guides/porting_guide_core_2.14.rst:14 msgid "This document is part of a collection on porting. The complete list of porting guides can be found at :ref:`porting guides <porting_guides>`." -msgstr "ã“ã®ãƒ‰ã‚ュメントã¯ã€ç§»æ¤ã«é–¢ã™ã‚‹å†…容ã®ä¸€éƒ¨ã§ã™ã€‚移æ¤ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ã€Œ:ref:`移æ¤ã‚¬ã‚¤ãƒ‰ <porting_guides>`ã€ã«ã‚ã‚Šã¾ã™ã€‚" +msgstr "ã“ã®ãƒ‰ã‚ュメントã¯ã€ç§»æ¤ã«é–¢ã™ã‚‹å†…容ã®ä¸€éƒ¨ã§ã™ã€‚移æ¤ã‚¬ã‚¤ãƒ‰ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ :ref:`porting guides <porting_guides>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.0.rst:17 #: ../../rst/porting_guides/porting_guide_2.3.rst:17 @@ -106,67 +106,84 @@ msgstr "Playbook" msgid "This section discusses any changes you may need to make to your playbooks." msgstr "本セクションã§ã¯ã€Playbook ã«åŠ ãˆã‚‹å¿…è¦ã®ã‚る変更を説明ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:36 +#: ../../rst/porting_guides/porting_guide_2.0.rst:24 +msgid "Syntax in 1.9.x" +msgstr "1.9.x ã®æ§‹æ–‡" + +#: ../../rst/porting_guides/porting_guide_2.0.rst:32 +#: ../../rst/porting_guides/porting_guide_2.0.rst:75 +msgid "Syntax in 2.0.x" +msgstr "2.0.x ã®æ§‹æ–‡" + +#: ../../rst/porting_guides/porting_guide_2.0.rst:40 +msgid "Output:" +msgstr "出力:" + +#: ../../rst/porting_guides/porting_guide_2.0.rst:46 msgid "To make an escaped string that will work on all versions you have two options::" msgstr "ã™ã¹ã¦ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§æ©Ÿèƒ½ã™ã‚‹ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã•ã‚ŒãŸæ–‡å—列を作æˆã™ã‚‹ã«ã¯ã€2 ã¤ã®ã‚ªãƒ—ションãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:40 +#: ../../rst/porting_guides/porting_guide_2.0.rst:50 msgid "uses key=value escaping which has not changed. The other option is to check for the ansible version::" msgstr "key=value エスケープを使用ã—ã¾ã™ãŒã€ã“ã‚Œã¯ã€å¤‰æ›´ã•ã‚Œã¦ã„ã¾ã›ã‚“。もㆠ1 ã¤ã®æ–¹æ³•ã¯ã€ansible ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’確èªã™ã‚‹ã“ã¨ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:44 -msgid "trailing newline When a string with a trailing newline was specified in the playbook via yaml dict format, the trailing newline was stripped. When specified in key=value format, the trailing newlines were kept. In v2, both methods of specifying the string will keep the trailing newlines. If you relied on the trailing newline being stripped, you can change your playbook using the following as an example::" +#: ../../rst/porting_guides/porting_guide_2.0.rst:54 +msgid "trailing newline When a string with a trailing newline was specified in the playbook through yaml dict format, the trailing newline was stripped. When specified in key=value format, the trailing newlines were kept. In v2, both methods of specifying the string will keep the trailing newlines. If you relied on the trailing newline being stripped, you can change your playbook using the following as an example::" msgstr "末尾ã«æ”¹è¡Œ: 末尾ã«æ”¹è¡ŒãŒã‚ã‚‹æ–‡å—列㌠yaml dict å½¢å¼ã§ Playbook ã«æŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã€æœ«å°¾ã®æ”¹è¡Œã¯å‰Šé™¤ã•ã‚Œã¾ã™ã€‚key=value å½¢å¼ã§æŒ‡å®šã™ã‚‹ã¨ã€æœ«å°¾ã«æ”¹è¡ŒãŒä¿æŒã•ã‚Œã¾ã™ã€‚v2 ã§ã¯ã€ã“ã®æ–‡å—列を指定ã™ã‚‹ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã¨ã‚‚ã«æ”¹è¡Œã‚’ä¿æŒã—ã¾ã™ã€‚末尾ã®æ”¹è¡ŒãŒè‡ªå‹•çš„ã«å‰Šé™¤ã•ã‚Œã‚‹ã®ã«ä¾å˜ã—ã¦ã„ãŸå ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã« Playbook を変更ã§ãã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:71 +#: ../../rst/porting_guides/porting_guide_2.0.rst:88 +msgid "Output" +msgstr "出力" + +#: ../../rst/porting_guides/porting_guide_2.0.rst:94 msgid "Behavior of templating DOS-type text files changes with Ansible v2." msgstr "DOS タイプã®ãƒ†ã‚ストファイルをテンプレート化ã™ã‚‹å‹•ä½œã¯ Ansible v2 ã§å¤‰ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:73 +#: ../../rst/porting_guides/porting_guide_2.0.rst:96 msgid "A bug in Ansible v1 causes DOS-type text files (using a carriage return and newline) to be templated to Unix-type text files (using only a newline). In Ansible v2 this long-standing bug was finally fixed and DOS-type text files are preserved correctly. This may be confusing when you expect your playbook to not show any differences when migrating to Ansible v2, while in fact you will see every DOS-type file being completely replaced (with what appears to be the exact same content)." msgstr "Ansible v1 ã®ãƒã‚°ã«ã‚ˆã‚Šã€DOS タイプã®ãƒ†ã‚ストファイル (ã‚ャリッジリターンã¨æ”¹è¡Œã‚’使用) ãŒã€Unix タイプã®ãƒ†ã‚ストファイル (改行ã®ã¿ã‚’使用) ã«ãƒ†ãƒ³ãƒ—レート化ã—ã¦ã„ã¾ã—ãŸã€‚Ansible v2 ã§ã¯ã€ã“ã®é•·å¹´ã®ãƒã‚°ãŒã‚ˆã†ã‚„ãä¿®æ£ã•ã‚Œã€DOS å½¢å¼ã®ãƒ†ã‚ストファイルãŒæ£ã—ãä¿å˜ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯ã€Ansible v2 ã¸ã®ç§»è¡Œæ™‚ã« Playbook ã«å¤‰æ›´ãŒãªã„ã“ã¨ã‚’期待ã—ã¦ã„ã‚‹å ´åˆã«ã¯æ··ä¹±ã™ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“ãŒã€å®Ÿéš›ã«ã¯ã€ã™ã¹ã¦ã® DOS 型ファイルãŒå®Œå…¨ã«ç½®ãæ›ãˆã‚‰ã‚Œã¦ã„ã¾ã™ (ãŸã ã—ã€å®Œå…¨ã«åŒä¸€ã®å†…容ã§ã‚るよã†ã«è¡¨ç¤ºã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™)。" -#: ../../rst/porting_guides/porting_guide_2.0.rst:75 -msgid "When specifying complex args as a variable, the variable must use the full jinja2 variable syntax (```{{var_name}}```) - bare variable names there are no longer accepted. In fact, even specifying args with variables has been deprecated, and will not be allowed in future versions::" -msgstr "複雑ãªå¼•æ•°ã‚’変数ã¨ã—ã¦æŒ‡å®šã™ã‚‹å ´åˆã€å¤‰æ•°ã¯å®Œå…¨ãª jinja2 変数構文 (```{{var_name}}```) を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ベア変数åã¯ä½¿ç”¨ã§ããªããªã‚Šã¾ã—ãŸã€‚実際ã€å¤‰æ•°ã§å¼•æ•°ã‚’指定ã™ã‚‹ã“ã¨ãŒéžæŽ¨å¥¨ã¨ãªã£ã¦ãŠã‚Šã€å°†æ¥ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ä½¿ç”¨ã§ããªããªã‚Šã¾ã™ã€‚" +#: ../../rst/porting_guides/porting_guide_2.0.rst:98 +msgid "When specifying complex args as a variable, the variable must use the full jinja2 variable syntax (```{{var_name}}```) - bare variable names there are no longer accepted. In fact, even specifying args with variables has been deprecated, and will not be allowed in future versions:" +msgstr "複雑ãªå¼•æ•°ã‚’変数ã¨ã—ã¦æŒ‡å®šã™ã‚‹å ´åˆã€å¤‰æ•°ã¯å®Œå…¨ãª jinja2 変数構文 (```{{var_name}}```) を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ベア変数åã¯ä½¿ç”¨ã§ããªããªã‚Šã¾ã—ãŸã€‚実際ã€å¤‰æ•°ã§å¼•æ•°ã‚’指定ã™ã‚‹ã“ã¨ã‚‚éžæŽ¨å¥¨ã¨ãªã‚Šã€å°†æ¥ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ä½¿ç”¨ã§ããªããªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:93 +#: ../../rst/porting_guides/porting_guide_2.0.rst:118 msgid "porting task includes" msgstr "移æ¤ã‚¿ã‚¹ã‚¯ã«å«ã¾ã‚Œã‚‹ã‚‚ã®" -#: ../../rst/porting_guides/porting_guide_2.0.rst:94 +#: ../../rst/porting_guides/porting_guide_2.0.rst:119 msgid "More dynamic. Corner-case formats that were not supposed to work now do not, as expected." msgstr "より動的ã«ã€‚動作ã™ã‚‹ã¨æƒ³å®šã—ã¦ã„ãªã‹ã£ãŸã‚³ãƒ¼ãƒŠãƒ¼ã‚±ãƒ¼ã‚¹ (ã‚ã£ãŸã«ç™ºç”Ÿã—ãªã„厄介ãªã‚±ãƒ¼ã‚¹) ã®å½¢å¼ãŒã€æœŸå¾…通りã«å‹•ä½œã—ãªããªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:95 -msgid "variables defined in the yaml dict format https://github.com/ansible/ansible/issues/13324" -msgstr "yaml ã® dict å½¢å¼ã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•° (https://github.com/ansible/ansible/issues/13324)" +#: ../../rst/porting_guides/porting_guide_2.0.rst:120 +msgid "variables defined in the yaml dict format see `issue 13324 <https://github.com/ansible/ansible/issues/13324>`_" +msgstr "yaml ã® dict å½¢å¼ã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã¯ã€`issue 13324 <https://github.com/ansible/ansible/issues/13324>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„" -#: ../../rst/porting_guides/porting_guide_2.0.rst:96 +#: ../../rst/porting_guides/porting_guide_2.0.rst:121 msgid "templating (variables in playbooks and template lookups) has improved with regard to keeping the original instead of turning everything into a string. If you need the old behavior, quote the value to pass it around as a string." msgstr "テンプレート化 (Playbook ãŠã‚ˆã³ãƒ†ãƒ³ãƒ—レート検索ã®å¤‰æ•°) ã¯ã€ã™ã¹ã¦ã‚’æ–‡å—列ã«ã™ã‚‹ã®ã§ã¯ãªãã€ã‚ªãƒªã‚¸ãƒŠãƒ«ã‚’ç¶æŒã™ã‚‹ã¨ã„ã†ç‚¹ã§æ”¹å–„ã•ã‚Œã¾ã—ãŸã€‚以å‰ã®å‹•ä½œãŒå¿…è¦ãªå ´åˆã¯ã€å€¤ã‚’引用符ã§å›²ã¿ã€æ–‡å—列ã¨ã—ã¦æ¸¡ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_2.0.rst:98 +#: ../../rst/porting_guides/porting_guide_2.0.rst:123 msgid "Empty variables and variables set to null in yaml are no longer converted to empty strings. They will retain the value of `None`. You can override the `null_representation` setting to an empty string in your config file by setting the :envvar:`ANSIBLE_NULL_REPRESENTATION` environment variable." msgstr "空ã®å¤‰æ•°ã¨ã€yaml 㧠null ã«è¨å®šã•ã‚ŒãŸå¤‰æ•°ã¯ã€ç©ºã®æ–‡å—列ã«å¤‰æ›ã•ã‚Œãªããªã‚Šã€`None` ã®å€¤ã‚’ç¶æŒã—ã¾ã™ã€‚環境変数 :envvar:`ANSIBLE_NULL_REPRESENTATION` ã‚’è¨å®šã™ã‚‹ã“ã¨ã§ã€è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ `null_representation` ãŒç©ºæ–‡å—列ã«è¨å®šã•ã‚Œã‚‹ã®ã‚’上書ãã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:100 +#: ../../rst/porting_guides/porting_guide_2.0.rst:125 msgid "Extras callbacks must be enabled in ansible.cfg. Copying is no longer necessary but you must enable them in ansible.cfg." msgstr "ansible.cfg ã§è¿½åŠ ã®ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã‚’有効ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚コピーã¯ä¸è¦ã«ãªã‚Šã¾ã™ãŒã€ansible.cfg ã§æœ‰åŠ¹ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:101 +#: ../../rst/porting_guides/porting_guide_2.0.rst:126 msgid "dnf module has been rewritten. Some minor changes in behavior may be observed." msgstr "dnf モジュールãŒæ›¸ãç›´ã•ã‚Œã¾ã—ãŸã€‚ã„ãã¤ã‹ã®ç´°ã‹ã„動作ã®å¤‰æ›´ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:102 +#: ../../rst/porting_guides/porting_guide_2.0.rst:127 msgid "win_updates has been rewritten and works as expected now." msgstr "win_updates ã¯æ›¸ãç›´ã•ã‚Œã€æœŸå¾…通りã«å‹•ä½œã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:103 +#: ../../rst/porting_guides/porting_guide_2.0.rst:128 msgid "from 2.0.1 onwards, the implicit setup task from gather_facts now correctly inherits everything from play, but this might cause issues for those setting `environment` at the play level and depending on `ansible_env` existing. Previously this was ignored but now might issue an 'Undefined' error." msgstr "2.0.1 以é™ã€gather_facts ã®æš—黙的ãªè¨å®šã‚¿ã‚¹ã‚¯ã¯ã€ãƒ—レイã‹ã‚‰ã™ã¹ã¦æ£ã—ã継承ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸãŒã€ã“ã‚Œã«ã‚ˆã‚Šã€ãƒ—レイレベル㧠`environment` ã‚’è¨å®šã—ã€`ansible_env` ã®å˜åœ¨ã«ä¾å˜ã—ã¦ã„ã‚‹å ´åˆã«å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã—ãŸãŒã€ä»¥å‰ã¯ã“ã®å•é¡Œã¯ç„¡è¦–ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚ã“ã‚Œã‹ã‚‰ã¯ã€ŒUndefinedã€ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:107 +#: ../../rst/porting_guides/porting_guide_2.0.rst:132 #: ../../rst/porting_guides/porting_guide_2.10.rst:51 #: ../../rst/porting_guides/porting_guide_2.4.rst:52 #: ../../rst/porting_guides/porting_guide_2.5.rst:101 @@ -186,228 +203,232 @@ msgstr "2.0.1 以é™ã€gather_facts ã®æš—黙的ãªè¨å®šã‚¿ã‚¹ã‚¯ã¯ã€ãƒ—レ゠msgid "Deprecated" msgstr "éžæŽ¨å¥¨" -#: ../../rst/porting_guides/porting_guide_2.0.rst:109 +#: ../../rst/porting_guides/porting_guide_2.0.rst:134 msgid "While all items listed here will show a deprecation warning message, they still work as they did in 1.9.x. Please note that they will be removed in 2.2 (Ansible always waits two major releases to remove a deprecated feature)." msgstr "ã“ã“ã«æŽ²è¼‰ã•ã‚Œã¦ã„ã‚‹ã™ã¹ã¦ã®é …ç›®ã«ã¯ã€éžæŽ¨å¥¨ã®è¦å‘Šãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ãŒã€1.9.x ã§ã®å‹•ä½œã¨åŒã˜å‹•ä½œã«ãªã‚Šã¾ã™ã€‚ãŸã ã—ã€2.2 ã§å‰Šé™¤ã•ã‚Œã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„ (Ansible ã¯å¸¸ã« 2 ã¤ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã‚’å¾…ã£ã¦ã‹ã‚‰éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™)。" -#: ../../rst/porting_guides/porting_guide_2.0.rst:111 +#: ../../rst/porting_guides/porting_guide_2.0.rst:136 msgid "Bare variables in ``with_`` loops should instead use the ``\"{{ var }}\"`` syntax, which helps eliminate ambiguity." msgstr "``with_`` ループ内ã®ãƒ™ã‚¢å¤‰æ•°ã¯ã€ä»£ã‚ã‚Šã« ``\"{{ var }}\"`` 構文を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€æ›–昧ã•ãŒãªããªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:112 +#: ../../rst/porting_guides/porting_guide_2.0.rst:137 msgid "The ansible-galaxy text format requirements file. Users should use the YAML format for requirements instead." msgstr "ansible-galaxy テã‚スト形å¼ã®è¦ä»¶ãƒ•ã‚¡ã‚¤ãƒ«ã€‚ユーザーã¯ã€ä»£ã‚ã‚Šã«è¦ä»¶ã« YAML å½¢å¼ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:113 +#: ../../rst/porting_guides/porting_guide_2.0.rst:138 msgid "Undefined variables within a ``with_`` loop's list currently do not interrupt the loop, but they do issue a warning; in the future, they will issue an error." msgstr "``with_`` ループã®ãƒªã‚¹ãƒˆã«å«ã¾ã‚Œã‚‹æœªå®šç¾©ã®å¤‰æ•°ã¯ã€ç¾åœ¨ã®ã¨ã“ã‚ループをä¸æ–ã™ã‚‹ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€è¦å‘Šã‚’出力ã—ã¾ã™ã€‚今後ã¯ã‚¨ãƒ©ãƒ¼ã‚’出力ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:114 -msgid "Using dictionary variables to set all task parameters is unsafe and will be removed in a future version. For example::" -msgstr "ディクショナリー変数を使用ã—ã¦ã™ã¹ã¦ã®ã‚¿ã‚¹ã‚¯ãƒ‘ラメーターをè¨å®šã™ã‚‹ã“ã¨ã¯å®‰å…¨ã§ã¯ãªã„ãŸã‚ã€å°†æ¥ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" +#: ../../rst/porting_guides/porting_guide_2.0.rst:139 +msgid "Using dictionary variables to set all task parameters is unsafe and will be removed in a future version. Example of a deprecated variant:" +msgstr "ディクショナリー変数を使用ã—ã¦ã™ã¹ã¦ã®ã‚¿ã‚¹ã‚¯ãƒ‘ラメーターをè¨å®šã™ã‚‹ã“ã¨ã¯å®‰å…¨ã§ã¯ãªã„ãŸã‚ã€å°†æ¥ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚以下ã¯ã€éžæŽ¨å¥¨ã®ãƒãƒªã‚¢ãƒ³ãƒˆã®ä¾‹ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:131 +#: ../../rst/porting_guides/porting_guide_2.0.rst:153 +msgid "Example of a recommended variant:" +msgstr "推奨ã•ã‚Œã‚‹ãƒãƒªã‚¢ãƒ³ãƒˆã®ä¾‹ã¯ä»¥ä¸‹ã®ã¨ãŠã‚Šã§ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_2.0.rst:166 msgid "Host patterns should use a comma (,) or colon (:) instead of a semicolon (;) to separate hosts/groups in the pattern." msgstr "ホストパターンã§ã€ãƒ‘ターン内ã®ãƒ›ã‚¹ãƒˆ/グループを分離ã™ã‚‹å ´åˆã¯ã€ã‚»ãƒŸã‚³ãƒãƒ³ (;) ã®ä»£ã‚ã‚Šã«ã‚³ãƒ³ãƒž (,) ã¾ãŸã¯ã‚³ãƒãƒ³ (:) を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:132 +#: ../../rst/porting_guides/porting_guide_2.0.rst:167 msgid "Ranges specified in host patterns should use the [x:y] syntax, instead of [x-y]." msgstr "ホストパターンã§æŒ‡å®šã—ãŸç¯„囲ã¯ã€[x-y] 構文ã§ã¯ãªã [x:y] 構文を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:133 +#: ../../rst/porting_guides/porting_guide_2.0.rst:168 msgid "Playbooks using privilege escalation should always use \"become*\" options rather than the old su*/sudo* options." msgstr "権é™æ˜‡æ ¼ã‚’使用ã—㟠Playbook ã¯ã€å¤ã„ su*/sudo* オプションã§ã¯ãªã「become*ã€ã‚ªãƒ—ションを常ã«ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:134 +#: ../../rst/porting_guides/porting_guide_2.0.rst:169 msgid "The \"short form\" for vars_prompt is no longer supported. For example::" msgstr "vars_prompt ã®ã€ŒçŸç¸®å½¢ã€ã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:140 +#: ../../rst/porting_guides/porting_guide_2.0.rst:175 msgid "Specifying variables at the top level of a task include statement is no longer supported. For example::" msgstr "タスクã®include æ–‡ã®æœ€ä¸Šä½ã§å¤‰æ•°ã‚’指定ã™ã‚‹ã“ã¨ã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚ãŸã¨ãˆã°æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:145 +#: ../../rst/porting_guides/porting_guide_2.0.rst:180 msgid "Should now be::" msgstr "以下ã®ã‚ˆã†ã«ãªã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:151 +#: ../../rst/porting_guides/porting_guide_2.0.rst:186 msgid "Setting any_errors_fatal on a task is no longer supported. This should be set at the play level only." msgstr "タスク㧠any_errors_fatal ã®è¨å®šãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯ãƒ—レイレベルã§ã®ã¿è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:152 -msgid "Bare variables in the `environment` dictionary (for plays/tasks/etc.) are no longer supported. Variables specified there should use the full variable syntax: '{{foo}}'." +#: ../../rst/porting_guides/porting_guide_2.0.rst:187 +msgid "Bare variables in the `environment` dictionary (for plays/tasks/and so on) are no longer supported. Variables specified there should use the full variable syntax: '{{foo}}'." msgstr "`environment` ディクショナリー (プレイã€ã‚¿ã‚¹ã‚¯ãªã©) ã®ãƒ™ã‚¢ãƒ¡ã‚¿ãƒ«å¤‰æ•°ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚指定ã•ã‚Œã‚‹å¤‰æ•°ã¯ã€å®Œå…¨ãªå¤‰æ•°æ§‹æ–‡ (「{{foo}}ã€) を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:153 +#: ../../rst/porting_guides/porting_guide_2.0.rst:188 msgid "Tags (or any directive) should no longer be specified with other parameters in a task include. Instead, they should be specified as an option on the task. For example::" msgstr "ã‚¿ã‚° (ã¾ãŸã¯ä»–ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–) ã¯ã€ã‚¿ã‚¹ã‚¯ã®ã‚¤ãƒ³ã‚¯ãƒ«ãƒ¼ãƒ‰ã®ä¸ã§ä»–ã®ãƒ‘ラメーターã¨ä¸€ç·’ã«æŒ‡å®šã—ãªã„ã§ãã ã•ã„。代ã‚ã‚Šã«ã€ã‚¿ã‚¹ã‚¯ã®ã‚ªãƒ—ションã¨ã—ã¦æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:158 +#: ../../rst/porting_guides/porting_guide_2.0.rst:193 msgid "Should be::" msgstr "以下ã®ã‚ˆã†ã«ãªã‚‹ã¯ãšã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:163 +#: ../../rst/porting_guides/porting_guide_2.0.rst:198 msgid "The first_available_file option on tasks has been deprecated. Users should use the with_first_found option or lookup ('first_found', …) plugin." msgstr "タスク㮠first_available_file オプションãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚ユーザーã¯ã€with_first_found オプションã¾ãŸã¯ lookup ('first_found', …) プラグインを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:167 +#: ../../rst/porting_guides/porting_guide_2.0.rst:202 #: ../../rst/porting_guides/porting_guide_2.3.rst:100 #: ../../rst/porting_guides/porting_guide_2.4.rst:72 msgid "Other caveats" msgstr "ãã®ä»–ã®æ³¨æ„äº‹é …" -#: ../../rst/porting_guides/porting_guide_2.0.rst:169 +#: ../../rst/porting_guides/porting_guide_2.0.rst:204 msgid "Here are some corner cases encountered when updating. These are mostly caused by the more stringent parser validation and the capture of errors that were previously ignored." msgstr "ã“ã“ã§ã¯ã€æ›´æ–°æ™‚ã«éé‡ã™ã‚‹ã„ãã¤ã‹ã®ã‚³ãƒ¼ãƒŠãƒ¼ã‚±ãƒ¼ã‚¹ (ã‚ã£ãŸã«ç™ºç”Ÿã—ãªã„厄介ãªã‚±ãƒ¼ã‚¹) を紹介ã—ã¾ã™ã€‚ã“れらã¯ä¸»ã«ã€ãƒ‘ーサーã®æ¤œè¨¼ãŒã‚ˆã‚ŠåŽ³ã—ããªã£ãŸã“ã¨ã¨ã€ä»¥å‰ã¯ç„¡è¦–ã•ã‚Œã¦ã„ãŸã‚¨ãƒ©ãƒ¼ãŒæ•æ‰ã•ã‚ŒãŸã“ã¨ãŒåŽŸå› ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:171 +#: ../../rst/porting_guides/porting_guide_2.0.rst:206 msgid "Bad variable composition::" msgstr "誤ã£ãŸå¤‰æ•°ã®æ§‹æˆ:" -#: ../../rst/porting_guides/porting_guide_2.0.rst:175 +#: ../../rst/porting_guides/porting_guide_2.0.rst:210 msgid "This worked 'by accident' as the errors were retemplated and ended up resolving the variable, it was never intended as valid syntax and now properly returns an error, use the following instead.::" msgstr "ã“ã‚Œã¯ã€ã‚¨ãƒ©ãƒ¼ãŒå†ãƒ†ãƒ³ãƒ—レート化ã•ã‚Œã€å¤‰æ•°ã‚’解決ã™ã‚‹ã“ã¨ã«ãªã£ãŸãŸã‚ã€ã€Œå¶ç„¶ã€æ©Ÿèƒ½ã—ã¾ã—ãŸãŒã€æœ‰åŠ¹ãªæ§‹æ–‡ã¨ã—ã¦æ„図ã•ã‚ŒãŸã‚‚ã®ã§ã¯ã‚ã‚Šã¾ã›ã‚“ã§ã—ãŸãŒã€ç¾åœ¨ã¯é©åˆ‡ã«ã‚¨ãƒ©ãƒ¼ã‚’è¿”ã—ã¦ã„ã¾ã™ã€‚代ã‚ã‚Šã«ä»¥ä¸‹ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:179 +#: ../../rst/porting_guides/porting_guide_2.0.rst:214 msgid "Misspelled directives::" msgstr "スペルãŒé–“é•ã£ã¦ã„るディレクティブ:" -#: ../../rst/porting_guides/porting_guide_2.0.rst:184 +#: ../../rst/porting_guides/porting_guide_2.0.rst:219 msgid "The task always ran without using privilege escalation (for that you need `become`) but was also silently ignored so the play 'ran' even though it should not, now this is a parsing error." msgstr "タスクã¯å¸¸ã«ã€æ¨©é™ã‚¨ã‚¹ã‚«ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã‚’使用ã›ãšã« (`become` ãŒå¿…è¦ãªãŸã‚) 実行ã•ã‚Œã¾ã™ãŒã€é€šçŸ¥ãªã無視ã•ã‚Œã‚‹ãŸã‚ã«ã€ãƒ—レイãŒå®Ÿè¡Œã•ã›ã‚‹ã¹ãã§ãªã„ã«ã‚‚é–¢ã‚らãšã€Œå®Ÿè¡Œã€ã•ã‚Œã¦ã„ã¾ã—ãŸãŒã€ã“ã‚Œã¯è§£æžã‚¨ãƒ©ãƒ¼ã¨ãªã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:187 +#: ../../rst/porting_guides/porting_guide_2.0.rst:222 msgid "Duplicate directives::" msgstr "é‡è¤‡ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–:" -#: ../../rst/porting_guides/porting_guide_2.0.rst:193 +#: ../../rst/porting_guides/porting_guide_2.0.rst:228 msgid "The first `when` was ignored and only the 2nd one was used as the play ran w/o warning it was ignoring one of the directives, now this produces a parsing error." msgstr "最åˆã® `when` ã¯ç„¡è¦–ã•ã‚Œã€2 ã¤ç›®ã®ã‚‚ã®ã ã‘ãŒä½¿ç”¨ã•ã‚Œã¾ã—ãŸã€‚プレーã¯è¦å‘Šãªã—ã«å®Ÿè¡Œã•ã‚Œã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ã® 1 ã¤ã‚’無視ã—ã¦ã„ã¾ã—ãŸãŒã€è§£æžã‚¨ãƒ©ãƒ¼ãŒç”Ÿæˆã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:195 +#: ../../rst/porting_guides/porting_guide_2.0.rst:230 msgid "Conflating variables and directives::" msgstr "変数ãŠã‚ˆã³ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ã®åˆ¶é™::" -#: ../../rst/porting_guides/porting_guide_2.0.rst:202 +#: ../../rst/porting_guides/porting_guide_2.0.rst:237 msgid "The `port` variable is reserved as a play/task directive for overriding the connection port, in previous versions this got conflated with a variable named `port` and was usable later in the play, this created issues if a host tried to reconnect or was using a non caching connection. Now it will be correctly identified as a directive and the `port` variable will appear as undefined, this now forces the use of non conflicting names and removes ambiguity when adding settings and variables to a role invocation." msgstr "`port` 変数ã¯ã€æŽ¥ç¶šãƒãƒ¼ãƒˆã‚’上書ãã™ã‚‹ãŸã‚ã® play/task ディレクティブã¨ã—ã¦äºˆç´„ã•ã‚Œã¦ã„ã¾ã™ã€‚以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€`port` ã¨ã„ã†åå‰ã®å¤‰æ•°ã¨èžåˆã—ã€å¾Œã§ãƒ—レイã§ä½¿ç”¨ã§ãã¾ã™ãŒã€ãã®ãƒ›ã‚¹ãƒˆãŒå†æŽ¥ç¶šã‚’ã—よã†ã¨ã—ãŸã‚Šã€éžã‚ャッシュ接続を使用ã—ã¦ã„ãŸå ´åˆã«ã“ã®å•é¡ŒãŒç™ºç”Ÿã—ã¾ã™ã€‚今回ã®ãƒªãƒªãƒ¼ã‚¹ã‚ˆã‚Šã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ–ã¨ã—ã¦æ£ã—ãè˜åˆ¥ã•ã‚Œã€`port` 変数ã¯æœªå®šç¾©ã¨ã—ã¦è¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ç«¶åˆã™ã‚‹åå‰ã‚’使用ã—ãªã„よã†ã«ã—ã€ãƒãƒ¼ãƒ«ã®å‘¼ã³å‡ºã—ã«è¨å®šãŠã‚ˆã³å¤‰æ•°ã‚’è¿½åŠ ã™ã‚‹éš›ã«æ›–昧ã•ãŒãªããªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:206 +#: ../../rst/porting_guides/porting_guide_2.0.rst:241 msgid "Bare operations on `with_`::" msgstr "`with_` ã§ã®ãƒ™ã‚¢æ“作:" -#: ../../rst/porting_guides/porting_guide_2.0.rst:210 +#: ../../rst/porting_guides/porting_guide_2.0.rst:245 msgid "An issue with the 'bare variable' features, which was supposed only template a single variable without the need of braces ({{ )}}, would in some versions of Ansible template full expressions. Now you need to use proper templating and braces for all expressions everywhere except conditionals (`when`)::" msgstr "「ベア変数ã€é–¢æ•°ã®å•é¡Œã¯ã€ä¸æ‹¬å¼§ ({{ )}} ã‚’å¿…è¦ã¨ã—ãªã„å˜ä¸€ã®å¤‰æ•°ã®ã¿ã‚’テンプレート化ã™ã‚‹ã“ã¨ã«ãªã£ã¦ã„ã¾ã—ãŸãŒã€Ansible ã®ä¸€éƒ¨ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯å®Œå…¨ãªå¼ã‚’テンプレート化ã—ã¦ã„ã¾ã—ãŸã€‚ç¾åœ¨ã§ã¯ã€æ¡ä»¶å¼ (`when`) を除ãã™ã¹ã¦ã®å ´æ‰€ã®ã™ã¹ã¦ã®å¼ã«å¯¾ã—ã¦ã€é©åˆ‡ãªãƒ†ãƒ³ãƒ—レート化ã¨ä¸æ‹¬å¼§ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:215 +#: ../../rst/porting_guides/porting_guide_2.0.rst:250 msgid "The bare feature itself is deprecated as an undefined variable is indistinguishable from a string which makes it difficult to display a proper error." msgstr "未定義ã®å¤‰æ•°ã¯æ–‡å—列ã¨åŒºåˆ¥ãŒã¤ã‹ãšã€é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ã‚’表示ã™ã‚‹ã“ã¨ãŒé›£ã—ã„ãŸã‚ã€ãƒ™ã‚¢é–¢æ•°è‡ªä½“ãŒéžæŽ¨å¥¨ã¨ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:218 +#: ../../rst/porting_guides/porting_guide_2.0.rst:253 msgid "Porting plugins" msgstr "Porting プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:220 +#: ../../rst/porting_guides/porting_guide_2.0.rst:255 msgid "In ansible-1.9.x, you would generally copy an existing plugin to create a new one. Simply implementing the methods and attributes that the caller of the plugin expected made it a plugin of that type. In ansible-2.0, most plugins are implemented by subclassing a base class for each plugin type. This way the custom plugin does not need to contain methods which are not customized." msgstr "ansible-1.9.xã§ã¯ã€é€šå¸¸ã€æ—¢å˜ã®ãƒ—ラグインをコピーã—ã¦æ–°ã—ã„プラグインを作æˆã—ã¾ã™ã€‚プラグインã®å‘¼ã³å‡ºã—å…ƒãŒæœŸå¾…ã™ã‚‹ãƒ¡ã‚½ãƒƒãƒ‰ãŠã‚ˆã³å±žæ€§ã‚’実装ã™ã‚‹ã ã‘ã§ã€ãã®ã‚¿ã‚¤ãƒ—ã®ãƒ—ラグインã«ãªã‚Šã¾ã—ãŸã€‚ansible-2.0ã§ã¯ã€ã»ã¨ã‚“ã©ã®ãƒ—ラグインãŒã€å„プラグインタイプã®ãƒ™ãƒ¼ã‚¹ã‚¯ãƒ©ã‚¹ã‚’サブクラス化ã™ã‚‹ã“ã¨ã§å®Ÿè£…ã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã†ã™ã‚‹ã“ã¨ã§ã€ã‚«ã‚¹ã‚¿ãƒ プラグインã¯ã‚«ã‚¹ã‚¿ãƒžã‚¤ã‚ºã•ã‚Œã¦ã„ãªã„メソッドをå«ã‚€å¿…è¦ãŒãªããªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:224 -#: ../../rst/porting_guides/porting_guide_2.0.rst:305 +#: ../../rst/porting_guides/porting_guide_2.0.rst:259 +#: ../../rst/porting_guides/porting_guide_2.0.rst:340 msgid "Lookup plugins" msgstr "lookup プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:226 +#: ../../rst/porting_guides/porting_guide_2.0.rst:261 msgid "lookup plugins ; import version" msgstr "lookup プラグイン; ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆ" -#: ../../rst/porting_guides/porting_guide_2.0.rst:230 -#: ../../rst/porting_guides/porting_guide_2.0.rst:277 -#: ../../rst/porting_guides/porting_guide_2.0.rst:373 -#: ../../rst/porting_guides/porting_guide_2.0.rst:388 +#: ../../rst/porting_guides/porting_guide_2.0.rst:265 +#: ../../rst/porting_guides/porting_guide_2.0.rst:312 +#: ../../rst/porting_guides/porting_guide_2.0.rst:408 +#: ../../rst/porting_guides/porting_guide_2.0.rst:423 msgid "Connection plugins" msgstr "connection プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:232 -#: ../../rst/porting_guides/porting_guide_2.0.rst:279 -#: ../../rst/porting_guides/porting_guide_2.0.rst:375 -#: ../../rst/porting_guides/porting_guide_2.0.rst:390 +#: ../../rst/porting_guides/porting_guide_2.0.rst:267 +#: ../../rst/porting_guides/porting_guide_2.0.rst:314 +#: ../../rst/porting_guides/porting_guide_2.0.rst:410 +#: ../../rst/porting_guides/porting_guide_2.0.rst:425 msgid "connection plugins" msgstr "conneciton プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:235 -#: ../../rst/porting_guides/porting_guide_2.0.rst:378 +#: ../../rst/porting_guides/porting_guide_2.0.rst:270 +#: ../../rst/porting_guides/porting_guide_2.0.rst:413 msgid "Action plugins" msgstr "action プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:238 -#: ../../rst/porting_guides/porting_guide_2.0.rst:380 +#: ../../rst/porting_guides/porting_guide_2.0.rst:273 +#: ../../rst/porting_guides/porting_guide_2.0.rst:415 msgid "action plugins" msgstr "action プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:241 -#: ../../rst/porting_guides/porting_guide_2.0.rst:383 +#: ../../rst/porting_guides/porting_guide_2.0.rst:276 +#: ../../rst/porting_guides/porting_guide_2.0.rst:418 #: ../../rst/porting_guides/porting_guide_2.4.rst:132 msgid "Callback plugins" msgstr "callback プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:243 +#: ../../rst/porting_guides/porting_guide_2.0.rst:278 msgid "Although Ansible 2.0 provides a new callback API the old one continues to work for most callback plugins. However, if your callback plugin makes use of :attr:`self.playbook`, :attr:`self.play`, or :attr:`self.task` then you will have to store the values for these yourself as ansible no longer automatically populates the callback with them. Here's a short snippet that shows you how:" msgstr "Ansible 2.0 ã§ã¯æ–°ã—ã„コールãƒãƒƒã‚¯ API ãŒæä¾›ã•ã‚Œã¦ã„ã¾ã™ãŒã€ã»ã¨ã‚“ã©ã®ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ãƒ—ラグインã§ã¯å¤ã„ API も引ã続ã使用ã§ãã¾ã™ã€‚ãŸã ã—ã€ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ãƒ—ラグイン㌠:attr:`self.playbook`ã€:attr:`self.play`ã€ã¾ãŸã¯ :attr:`self.task` を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ansible ãŒã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã«è‡ªå‹•çš„ã«å€¤ã‚’入力ã—ãªããªã£ãŸãŸã‚ã€ã“れらã®å€¤ã‚’自分ã§ä¿å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã“ã§ã¯ã€ãã®æ–¹æ³•ã‚’示ã™çŸã„スニペットをã”紹介ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:283 +#: ../../rst/porting_guides/porting_guide_2.0.rst:318 msgid "Hybrid plugins" msgstr "ãƒã‚¤ãƒ–リッドプラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:285 +#: ../../rst/porting_guides/porting_guide_2.0.rst:320 msgid "In specific cases you may want a plugin that supports both ansible-1.9.x *and* ansible-2.0. Much like porting plugins from v1 to v2, you need to understand how plugins work in each version and support both requirements." msgstr "特定ã®ã‚±ãƒ¼ã‚¹ã§ã¯ã€ansible-1.9.x *ãŠã‚ˆã³* ansible-2.0 ã®ä¸¡æ–¹ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ãƒ—ラグインãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚v1 ã‹ã‚‰ v2 ã¸ã®ãƒ—ラグインã®ç§»æ¤ã¨åŒæ§˜ã«ã€å„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ãƒ—ラグインãŒã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã—ã€ä¸¡æ–¹ã®è¦ä»¶ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã‹ã‚’ç†è§£ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:287 +#: ../../rst/porting_guides/porting_guide_2.0.rst:322 msgid "Since the ansible-2.0 plugin system is more advanced, it is easier to adapt your plugin to provide similar pieces (subclasses, methods) for ansible-1.9.x as ansible-2.0 expects. This way your code will look a lot cleaner." msgstr "ansible-2.0 プラグインシステムã¯ã‚ˆã‚Šé«˜åº¦ãªãŸã‚ã€ansible-2.0 ãŒæƒ³å®šã™ã‚‹ã¨ãŠã‚Šã«ã€ansible-1.9.x ã®åŒæ§˜ã®éƒ¨åˆ† (サブクラスã€ãƒ¡ã‚½ãƒƒãƒ‰) ã‚’æä¾›ã™ã‚‹ãŸã‚ã«ãƒ—ラグインを調整ã™ã‚‹ã“ã¨ãŒã‚ˆã‚Šå®¹æ˜“ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:289 +#: ../../rst/porting_guides/porting_guide_2.0.rst:324 msgid "You may find the following tips useful:" msgstr "以下ã®ãƒ’ントをå‚考ã«ã—ã¦ã¿ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_2.0.rst:291 +#: ../../rst/porting_guides/porting_guide_2.0.rst:326 msgid "Check whether the ansible-2.0 class(es) are available and if they are missing (ansible-1.9.x) mimic them with the needed methods (for example, ``__init__``)" msgstr "ansible-2.0 ã®ã‚¯ãƒ©ã‚¹ãŒåˆ©ç”¨å¯èƒ½ã‹ã©ã†ã‹ã‚’確èªã—ã€ã‚¯ãƒ©ã‚¹ãŒä¸è¶³ã—ã¦ã„ã‚‹å ´åˆ (ansible-1.9.x) ã¯ã€å¿…è¦ãªãƒ¡ã‚½ãƒƒãƒ‰ (``__init__`` ãªã©) ã§ãれらを模倣ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:293 +#: ../../rst/porting_guides/porting_guide_2.0.rst:328 msgid "When ansible-2.0 python modules are imported, and they fail (ansible-1.9.x), catch the ``ImportError`` exception and perform the equivalent imports for ansible-1.9.x. With possible translations (for example, importing specific methods)." msgstr "ansible-2.0 python モジュールをインãƒãƒ¼ãƒˆã—ã¦å¤±æ•—ã™ã‚‹ã¨ (ansible-1.9.x)ã€``ImportError`` 例外をæ•æ‰ã—ã¦ã€ansible-1.9.x ã®åŒç‰ã®ã‚¤ãƒ³ãƒãƒ¼ãƒˆã‚’実行ã—ã¾ã™ã€‚翻訳 (ãŸã¨ãˆã°ã€ç‰¹å®šã®ãƒ¡ã‚½ãƒƒãƒ‰ã‚’インãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨) ãŒè¡Œã‚れるã“ã¨ã‚‚ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:295 +#: ../../rst/porting_guides/porting_guide_2.0.rst:330 msgid "Use the existence of these methods as a qualifier to what version of Ansible you are running. So rather than using version checks, you can do capability checks instead. (See examples below)" msgstr "ã“れらã®ãƒ¡ã‚½ãƒƒãƒ‰ã®å˜åœ¨ã‚’ã€å®Ÿè¡Œä¸ã® Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¸ã®ä¿®é£¾åã¨ã—ã¦ä½¿ç”¨ã—ã¾ã™ã€‚ãã®ãŸã‚ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãƒã‚§ãƒƒã‚¯ã‚’使用ã™ã‚‹ã®ã§ã¯ãªãã€ä»£ã‚ã‚Šã«æ©Ÿèƒ½ãƒã‚§ãƒƒã‚¯ã‚’è¡Œã†ã“ã¨ãŒã§ãã¾ã™ (以下ã®ä¾‹ã‚’å‚ç…§)。" -#: ../../rst/porting_guides/porting_guide_2.0.rst:297 +#: ../../rst/porting_guides/porting_guide_2.0.rst:332 msgid "Document for each if-then-else case for which specific version each block is needed. This will help others to understand how they have to adapt their plugins, but it will also help you to remove the older ansible-1.9.x support when it is deprecated." msgstr "å„ブãƒãƒƒã‚¯ãŒã©ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¿…è¦ã¨ã•ã‚Œã¦ã„ã‚‹ã‹ã€if-then-else ã®ã‚±ãƒ¼ã‚¹ã”ã¨ã«æ–‡æ›¸åŒ–ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ä»–ã®äººãŒè‡ªåˆ†ã®ãƒ—ラグインをã©ã®ã‚ˆã†ã«é©å¿œã•ã›ãªã‘ã‚Œã°ãªã‚‰ãªã„ã‹ã‚’ç†è§£ã™ã‚‹ã®ã«å½¹ç«‹ã¤ã ã‘ã§ãªãã€ä»¥å‰ã® ansible-1.9.x ã®ã‚µãƒãƒ¼ãƒˆãŒéžæŽ¨å¥¨ã«ãªã£ãŸã¨ãã«å‰Šé™¤ã™ã‚‹ã®ã«å½¹ç«‹ã¡ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:299 +#: ../../rst/porting_guides/porting_guide_2.0.rst:334 msgid "When doing plugin development, it is very useful to have the ``warning()`` method during development, but it is also important to emit warnings for deadends (cases that you expect should never be triggered) or corner cases (for example, cases where you expect misconfigurations)." msgstr "プラグインã®é–‹ç™ºã‚’è¡Œã†å ´åˆã¯ã€é–‹ç™ºä¸ã« ``warning()`` メソッドãŒã‚ã‚‹ã¨éžå¸¸ã«ä¾¿åˆ©ã§ã™ãŒã€ãƒ‡ãƒƒãƒ‰ã‚¨ãƒ³ãƒ‰ (絶対ã«ç™ºç”Ÿã—ã¦ã¯ã„ã‘ãªã„ã¨äºˆæƒ³ã•ã‚Œã‚‹ã‚±ãƒ¼ã‚¹ï¼‰ã‚„コーナーケース (ã‚ã£ãŸã«ç™ºç”Ÿã—ãªã„厄介ãªã‚±ãƒ¼ã‚¹ã€ãŸã¨ãˆã°è¨å®šãŒé–“é•ã£ã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚るケース) ã«å¯¾ã—ã¦è¦å‘Šã‚’発ã™ã‚‹ã“ã¨ã‚‚é‡è¦ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:301 +#: ../../rst/porting_guides/porting_guide_2.0.rst:336 msgid "It helps to look at other plugins in ansible-1.9.x and ansible-2.0 to understand how the API works and what modules, classes and methods are available." msgstr "API ãŒã©ã®ã‚ˆã†ã«æ©Ÿèƒ½ã™ã‚‹ã‹ã€ã©ã®ã‚ˆã†ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ã‚¯ãƒ©ã‚¹ã€ãƒ¡ã‚½ãƒƒãƒ‰ãŒåˆ©ç”¨ã§ãã‚‹ã‹ã‚’ç†è§£ã™ã‚‹ã«ã¯ã€ansible-1.9.x ã‚„ ansible-2.0 ã®ä»–ã®ãƒ—ラグインを確èªã™ã‚‹ã®ãŒæœ‰åŠ¹ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:307 +#: ../../rst/porting_guides/porting_guide_2.0.rst:342 msgid "As a simple example we are going to make a hybrid ``fileglob`` lookup plugin." msgstr "ç°¡å˜ãªä¾‹ã¨ã—ã¦ã€ãƒã‚¤ãƒ–リッド㮠``fileglob`` lookup プラグインを作æˆã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:368 +#: ../../rst/porting_guides/porting_guide_2.0.rst:403 msgid "In the above example we did not use the ``warning()`` method as we had no direct use for it in the final version. However we left this code in so people can use this part during development/porting/use." msgstr "上記ã®ä¾‹ã§ã¯ã€æœ€çµ‚ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ç›´æŽ¥ä½¿ç”¨ã™ã‚‹ã“ã¨ãŒãªã‹ã£ãŸãŸã‚ã€``warning()`` メソッドを使用ã—ã¦ã„ã¾ã›ã‚“。ã—ã‹ã—ã€é–‹ç™ºã€ç§»æ¤ã€ãŠã‚ˆã³ä½¿ç”¨ã®éš›ã«ã“ã®éƒ¨åˆ†ã‚’利用ã§ãるよã†ã«ã€ã“ã®ã‚³ãƒ¼ãƒ‰ã‚’残ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_2.0.rst:385 +#: ../../rst/porting_guides/porting_guide_2.0.rst:420 msgid "callback plugins" msgstr "callback プラグイン" -#: ../../rst/porting_guides/porting_guide_2.0.rst:394 +#: ../../rst/porting_guides/porting_guide_2.0.rst:429 #: ../../rst/porting_guides/porting_guide_2.10.rst:97 #: ../../rst/porting_guides/porting_guide_2.3.rst:160 #: ../../rst/porting_guides/porting_guide_2.5.rst:281 @@ -427,7 +448,7 @@ msgstr "callback プラグイン" msgid "Porting custom scripts" msgstr "カスタムスクリプトã®ç§»æ¤" -#: ../../rst/porting_guides/porting_guide_2.0.rst:396 +#: ../../rst/porting_guides/porting_guide_2.0.rst:431 msgid "Custom scripts that used the ``ansible.runner.Runner`` API in 1.x have to be ported in 2.x. Please refer to: :ref:`developing_api`" msgstr "1.x 㧠``ansible.runner.Runner`` API を使用ã—ãŸã‚«ã‚¹ã‚¿ãƒ スクリプトã¯ã€2.x ã«ç§»æ¤ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚「:ref:`developing_api`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -445,7 +466,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.9 ã‹ã‚‰ Ansible 2.10 ã«ãŠã‘ã #: ../../rst/porting_guides/porting_guide_2.10.rst:18 msgid "We suggest you read this page along with the `Ansible Changelog for 2.10 <https://github.com/ansible-community/ansible-build-data/blob/main/2.10/CHANGELOG-v2.10.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 2.10 ã®ãƒã‚§ãƒ³ã‚¸ãƒã‚° <https://github.com/ansible-community/ansible-build-data/blob/main/2.10/CHANGELOG-v2.10.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 2.10 ã®ãƒã‚§ãƒ³ã‚¸ãƒã‚° <https://github.com/ansible-community/ansible-build-data/blob/main/2.10/CHANGELOG-v2.10.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:20 msgid "Since 2.10, Ansible consists of two parts:" @@ -491,8 +512,8 @@ msgstr "コマンドライン" #: ../../rst/porting_guides/porting_guide_2.10.rst:45 #: ../../rst/porting_guides/porting_guide_base_2.10.rst:38 -msgid "The ``ansible-galaxy login`` command has been removed, as the underlying API it used for GitHub auth is being shut down. Publishing roles or collections to Galaxy via ``ansible-galaxy`` now requires that a Galaxy API token be passed to the CLI via a token file (default location ``~/.ansible/galaxy_token``) or (insecurely) via the ``--token`` argument to ``ansible-galaxy``." -msgstr "GitHub èªè¨¼ã«ä½¿ç”¨ã•ã‚Œã‚‹åŸºç¤Žã¨ãªã‚‹ API ãŒã‚·ãƒ£ãƒƒãƒˆãƒ€ã‚¦ãƒ³ã•ã‚Œã‚‹ãŸã‚ã€``ansible-galaxy login`` コマンドãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚``ansible-galaxy`` 経由㧠Galaxy ã«ãƒãƒ¼ãƒ«ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’公開ã™ã‚‹å ´åˆã¯ã€Galaxy API トークンをトークンファイル (デフォルトã®å ´æ‰€ ``~/.ansible/galaxy_token``) ã¾ãŸã¯ ``--token`` 引数ã‹ã‚‰ ``ansible-galaxy`` ã« (ã‚»ã‚ュリティーを確ä¿ã›ãšã«ã‚»ã‚ュアã«) 渡ã™ã“ã¨ãŒå¿…è¦ã«ãªã‚Šã¾ã—ãŸã€‚" +msgid "The ``ansible-galaxy login`` command has been removed, as the underlying API it used for GitHub auth is being shut down. Publishing roles or collections to Galaxy through ``ansible-galaxy`` now requires that a Galaxy API token be passed to the CLI through a token file (default location ``~/.ansible/galaxy_token``) or (insecurely) through the ``--token`` argument to ``ansible-galaxy``." +msgstr "GitHub èªè¨¼ã«ä½¿ç”¨ã•ã‚Œã‚‹åŸºç¤Žã¨ãªã‚‹ API ãŒã‚·ãƒ£ãƒƒãƒˆãƒ€ã‚¦ãƒ³ã•ã‚ŒãŸãŸã‚ã€``ansible-galaxy login`` コマンドãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚``ansible-galaxy`` 経由㧠Galaxy ã«ãƒãƒ¼ãƒ«ã¾ãŸã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’公開ã™ã‚‹å ´åˆã¯ã€Galaxy API トークンをトークンファイル (デフォルトã®å ´æ‰€ ``~/.ansible/galaxy_token``) ã¾ãŸã¯ ``--token`` 引数ã‹ã‚‰ ``ansible-galaxy`` ã« (ã‚»ã‚ュリティーを確ä¿ã›ãšã«ã‚»ã‚ュアã«) 渡ã™ã“ã¨ãŒå¿…è¦ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:53 #: ../../rst/porting_guides/porting_guide_base_2.10.rst:46 @@ -603,7 +624,7 @@ msgstr "大文å—å°æ–‡å—を区別ã—ã¦ãƒ—ラグインåã®æ¤œç´¢" #: ../../rst/porting_guides/porting_guide_2.10.rst:83 #: ../../rst/porting_guides/porting_guide_base_2.10.rst:76 -msgid "Prior to Ansible ``2.10`` lookup plugin names passed in as an argument to the ``lookup()`` function were treated as case-insensitive as opposed to lookups invoked via ``with_<lookup_name>``. ``2.10`` brings consistency to ``lookup()`` and ``with_`` to be both case-sensitive." +msgid "Prior to Ansible ``2.10`` lookup plugin names passed in as an argument to the ``lookup()`` function were treated as case-insensitive as opposed to lookups invoked through ``with_<lookup_name>``. ``2.10`` brings consistency to ``lookup()`` and ``with_`` to be both case-sensitive." msgstr "Ansible ``2.10`` ã® lookup プラグインå㌠``lookup()`` 関数ã«å¼•æ•°ã¨ã—ã¦æ¸¡ã•ã‚Œã‚‹å‰ã«ã€``with_<lookup_name>`` を介ã—ã¦å‘¼ã³å‡ºã•ã‚Œã‚‹ãƒ«ãƒƒã‚¯ã‚¢ãƒƒãƒ—ã¨ã¯ç•°ãªã‚Šã€å¤§æ–‡å—ã¨å°æ–‡å—を区別ã—ãªã„ã‚‚ã®ã¨ã—ã¦å‡¦ç†ã•ã‚Œã¾ã™ã€‚``2.10`` ã§ã¯ã€``lookup()`` 㨠``with_`` ã®ä¸¡æ–¹ã§å¤§æ–‡å—å°æ–‡å—を区別ã™ã‚‹ã‚ˆã†ã«æ•´åˆæ€§ãŒå–られã¦ã„ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:86 @@ -685,7 +706,7 @@ msgstr "モジュールを呼ã³å‡ºã™ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ãƒ—ラグインã¯ã€å¯èƒ½ #: ../../rst/porting_guides/porting_guide_core_2.14.rst:85 #: ../../rst/porting_guides/porting_guide_core_2.14.rst:91 msgid "No notable changes" -msgstr "主ãªå¤‰æ›´ã¯ã‚ã‚Šã¾ã›ã‚“。" +msgstr "主ãªå¤‰æ›´ã¯ã‚ã‚Šã¾ã›ã‚“" #: ../../rst/porting_guides/porting_guide_2.10.rst:102 msgid "Porting Guide for v2.10.7" @@ -704,8 +725,10 @@ msgstr "v2.10.7 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:169 #: ../../rst/porting_guides/porting_guide_5.rst:460 #: ../../rst/porting_guides/porting_guide_6.rst:80 -#: ../../rst/porting_guides/porting_guide_6.rst:295 -#: ../../rst/porting_guides/porting_guide_7.rst:128 +#: ../../rst/porting_guides/porting_guide_6.rst:171 +#: ../../rst/porting_guides/porting_guide_6.rst:431 +#: ../../rst/porting_guides/porting_guide_7.rst:121 +#: ../../rst/porting_guides/porting_guide_7.rst:304 #: ../../rst/porting_guides/porting_guide_core_2.11.rst:39 #: ../../rst/porting_guides/porting_guide_core_2.13.rst:78 msgid "Breaking Changes" @@ -739,14 +762,25 @@ msgstr "互æ›æ€§ã‚’失ã‚ã›ã‚‹å¤‰æ›´ç‚¹" #: ../../rst/porting_guides/porting_guide_5.rst:706 #: ../../rst/porting_guides/porting_guide_5.rst:850 #: ../../rst/porting_guides/porting_guide_5.rst:969 -#: ../../rst/porting_guides/porting_guide_6.rst:115 -#: ../../rst/porting_guides/porting_guide_6.rst:239 -#: ../../rst/porting_guides/porting_guide_6.rst:268 -#: ../../rst/porting_guides/porting_guide_6.rst:382 -#: ../../rst/porting_guides/porting_guide_6.rst:554 -#: ../../rst/porting_guides/porting_guide_6.rst:666 -#: ../../rst/porting_guides/porting_guide_6.rst:795 -#: ../../rst/porting_guides/porting_guide_7.rst:503 +#: ../../rst/porting_guides/porting_guide_6.rst:150 +#: ../../rst/porting_guides/porting_guide_6.rst:174 +#: ../../rst/porting_guides/porting_guide_6.rst:182 +#: ../../rst/porting_guides/porting_guide_6.rst:203 +#: ../../rst/porting_guides/porting_guide_6.rst:234 +#: ../../rst/porting_guides/porting_guide_6.rst:251 +#: ../../rst/porting_guides/porting_guide_6.rst:375 +#: ../../rst/porting_guides/porting_guide_6.rst:404 +#: ../../rst/porting_guides/porting_guide_6.rst:518 +#: ../../rst/porting_guides/porting_guide_6.rst:690 +#: ../../rst/porting_guides/porting_guide_6.rst:802 +#: ../../rst/porting_guides/porting_guide_6.rst:931 +#: ../../rst/porting_guides/porting_guide_7.rst:124 +#: ../../rst/porting_guides/porting_guide_7.rst:176 +#: ../../rst/porting_guides/porting_guide_7.rst:261 +#: ../../rst/porting_guides/porting_guide_7.rst:434 +#: ../../rst/porting_guides/porting_guide_7.rst:606 +#: ../../rst/porting_guides/porting_guide_7.rst:870 +#: ../../rst/porting_guides/porting_guide_7.rst:1034 msgid "community.general" msgstr "community.general" @@ -785,11 +819,16 @@ msgstr "utm_proxy_auth_profile - ``frontend_cookie_secret`` ã®æˆ»ã‚Šå€¤ã«ã€ãƒ #: ../../rst/porting_guides/porting_guide_5.rst:372 #: ../../rst/porting_guides/porting_guide_5.rst:421 #: ../../rst/porting_guides/porting_guide_5.rst:594 -#: ../../rst/porting_guides/porting_guide_6.rst:123 -#: ../../rst/porting_guides/porting_guide_6.rst:159 -#: ../../rst/porting_guides/porting_guide_6.rst:199 -#: ../../rst/porting_guides/porting_guide_6.rst:430 -#: ../../rst/porting_guides/porting_guide_7.rst:195 +#: ../../rst/porting_guides/porting_guide_6.rst:115 +#: ../../rst/porting_guides/porting_guide_6.rst:179 +#: ../../rst/porting_guides/porting_guide_6.rst:218 +#: ../../rst/porting_guides/porting_guide_6.rst:259 +#: ../../rst/porting_guides/porting_guide_6.rst:295 +#: ../../rst/porting_guides/porting_guide_6.rst:335 +#: ../../rst/porting_guides/porting_guide_6.rst:566 +#: ../../rst/porting_guides/porting_guide_7.rst:129 +#: ../../rst/porting_guides/porting_guide_7.rst:232 +#: ../../rst/porting_guides/porting_guide_7.rst:470 msgid "Major Changes" msgstr "主ãªå¤‰æ›´ç‚¹" @@ -803,7 +842,7 @@ msgstr "community.okd コレクションã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ 1.0.0 ã«åˆ¶é™ã— #: ../../rst/porting_guides/porting_guide_3.rst:415 #: ../../rst/porting_guides/porting_guide_4.rst:287 #: ../../rst/porting_guides/porting_guide_5.rst:795 -#: ../../rst/porting_guides/porting_guide_6.rst:626 +#: ../../rst/porting_guides/porting_guide_6.rst:762 msgid "ovirt.ovirt" msgstr "ovirt.ovirt" @@ -870,12 +909,17 @@ msgstr "0.6.0 以é™ã® pysnow ã§æ–°ã—ã„ API ã®ä½¿ç”¨" #: ../../rst/porting_guides/porting_guide_5.rst:348 #: ../../rst/porting_guides/porting_guide_5.rst:389 #: ../../rst/porting_guides/porting_guide_5.rst:872 -#: ../../rst/porting_guides/porting_guide_6.rst:112 -#: ../../rst/porting_guides/porting_guide_6.rst:137 -#: ../../rst/porting_guides/porting_guide_6.rst:167 -#: ../../rst/porting_guides/porting_guide_6.rst:214 -#: ../../rst/porting_guides/porting_guide_6.rst:753 -#: ../../rst/porting_guides/porting_guide_7.rst:429 +#: ../../rst/porting_guides/porting_guide_6.rst:147 +#: ../../rst/porting_guides/porting_guide_6.rst:193 +#: ../../rst/porting_guides/porting_guide_6.rst:227 +#: ../../rst/porting_guides/porting_guide_6.rst:248 +#: ../../rst/porting_guides/porting_guide_6.rst:273 +#: ../../rst/porting_guides/porting_guide_6.rst:303 +#: ../../rst/porting_guides/porting_guide_6.rst:350 +#: ../../rst/porting_guides/porting_guide_6.rst:889 +#: ../../rst/porting_guides/porting_guide_7.rst:151 +#: ../../rst/porting_guides/porting_guide_7.rst:258 +#: ../../rst/porting_guides/porting_guide_7.rst:935 msgid "Deprecated Features" msgstr "éžæŽ¨å¥¨ã®æ©Ÿèƒ½" @@ -890,8 +934,10 @@ msgstr "éžæŽ¨å¥¨ã®æ©Ÿèƒ½" #: ../../rst/porting_guides/porting_guide_4.rst:844 #: ../../rst/porting_guides/porting_guide_5.rst:392 #: ../../rst/porting_guides/porting_guide_5.rst:920 -#: ../../rst/porting_guides/porting_guide_6.rst:540 -#: ../../rst/porting_guides/porting_guide_6.rst:777 +#: ../../rst/porting_guides/porting_guide_6.rst:676 +#: ../../rst/porting_guides/porting_guide_6.rst:913 +#: ../../rst/porting_guides/porting_guide_7.rst:573 +#: ../../rst/porting_guides/porting_guide_7.rst:750 msgid "cisco.nxos" msgstr "cisco.nxos" @@ -911,9 +957,11 @@ msgstr "`nxos_bgp` モジュールãŠã‚ˆã³ `nxos_bgp_neighbor` モジュールã #: ../../rst/porting_guides/porting_guide_4.rst:887 #: ../../rst/porting_guides/porting_guide_5.rst:726 #: ../../rst/porting_guides/porting_guide_5.rst:1001 -#: ../../rst/porting_guides/porting_guide_6.rst:407 -#: ../../rst/porting_guides/porting_guide_6.rst:578 -#: ../../rst/porting_guides/porting_guide_6.rst:711 +#: ../../rst/porting_guides/porting_guide_6.rst:543 +#: ../../rst/porting_guides/porting_guide_6.rst:714 +#: ../../rst/porting_guides/porting_guide_6.rst:847 +#: ../../rst/porting_guides/porting_guide_7.rst:446 +#: ../../rst/porting_guides/porting_guide_7.rst:900 msgid "community.vmware" msgstr "community.vmware" @@ -948,9 +996,11 @@ msgstr "ansible-base を使用ã—㦠``community.general`` を手動ã§ã‚¤ãƒ³ã‚¹ #: ../../rst/porting_guides/porting_guide_3.rst:629 #: ../../rst/porting_guides/porting_guide_4.rst:807 #: ../../rst/porting_guides/porting_guide_5.rst:200 -#: ../../rst/porting_guides/porting_guide_6.rst:564 -#: ../../rst/porting_guides/porting_guide_6.rst:695 -#: ../../rst/porting_guides/porting_guide_6.rst:816 +#: ../../rst/porting_guides/porting_guide_6.rst:700 +#: ../../rst/porting_guides/porting_guide_6.rst:831 +#: ../../rst/porting_guides/porting_guide_6.rst:952 +#: ../../rst/porting_guides/porting_guide_7.rst:617 +#: ../../rst/porting_guides/porting_guide_7.rst:884 msgid "community.network" msgstr "community.network" @@ -991,7 +1041,7 @@ msgstr "ansible-base を使用ã—㦠``community.network`` を手動ã§ã‚¤ãƒ³ã‚¹ #: ../../rst/porting_guides/porting_guide_4.rst:813 #: ../../rst/porting_guides/porting_guide_4.rst:892 #: ../../rst/porting_guides/porting_guide_5.rst:303 -#: ../../rst/porting_guides/porting_guide_6.rst:596 +#: ../../rst/porting_guides/porting_guide_6.rst:732 msgid "f5networks.f5_modules" msgstr "f5networks.f5_modules" @@ -1022,10 +1072,12 @@ msgstr "v2.10.5 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:556 #: ../../rst/porting_guides/porting_guide_5.rst:866 #: ../../rst/porting_guides/porting_guide_5.rst:989 -#: ../../rst/porting_guides/porting_guide_6.rst:170 -#: ../../rst/porting_guides/porting_guide_6.rst:687 -#: ../../rst/porting_guides/porting_guide_6.rst:808 -#: ../../rst/porting_guides/porting_guide_7.rst:509 +#: ../../rst/porting_guides/porting_guide_6.rst:306 +#: ../../rst/porting_guides/porting_guide_6.rst:823 +#: ../../rst/porting_guides/porting_guide_6.rst:944 +#: ../../rst/porting_guides/porting_guide_7.rst:209 +#: ../../rst/porting_guides/porting_guide_7.rst:440 +#: ../../rst/porting_guides/porting_guide_7.rst:1051 msgid "community.hashi_vault" msgstr "community.hashi_vault" @@ -1105,8 +1157,8 @@ msgstr "nb_lookup - ID を渡ã™ã“ã¨ãŒã§ãã€``.filter`` ã®ä»£ã‚ã‚Šã« `` #: ../../rst/porting_guides/porting_guide_2.10.rst:235 #: ../../rst/porting_guides/porting_guide_3.rst:412 -msgid "nb_lookup - Allow ``api_endpoint`` and ``token`` to be found via env. (#391)" -msgstr "nb_lookup - ``api_endpoint`` ãŠã‚ˆã³ ``token`` ã‚’ env 経由ã§æ¤œç´¢ã™ã‚‹ã“ã¨ã‚’許å¯ã—ã¾ã™ã€‚(#391)" +msgid "nb_lookup - Allow ``api_endpoint`` and ``token`` to be found through env. (#391)" +msgstr "nb_lookup - env.ã‹ã‚‰``api_endpoint`` ã¨``token`` を検索ã§ãるよã†ã«ã—ã¾ã—㟠(#391)。" #: ../../rst/porting_guides/porting_guide_2.10.rst:241 #: ../../rst/porting_guides/porting_guide_2.10.rst:892 @@ -1117,13 +1169,13 @@ msgstr "nb_lookup - ``api_endpoint`` ãŠã‚ˆã³ ``token`` ã‚’ env 経由ã§æ¤œç´¢ #: ../../rst/porting_guides/porting_guide_5.rst:498 #: ../../rst/porting_guides/porting_guide_5.rst:681 #: ../../rst/porting_guides/porting_guide_5.rst:926 -#: ../../rst/porting_guides/porting_guide_6.rst:222 -#: ../../rst/porting_guides/porting_guide_6.rst:337 -#: ../../rst/porting_guides/porting_guide_6.rst:548 -#: ../../rst/porting_guides/porting_guide_7.rst:163 -#: ../../rst/porting_guides/porting_guide_7.rst:223 -#: ../../rst/porting_guides/porting_guide_7.rst:327 -#: ../../rst/porting_guides/porting_guide_7.rst:473 +#: ../../rst/porting_guides/porting_guide_6.rst:358 +#: ../../rst/porting_guides/porting_guide_6.rst:473 +#: ../../rst/porting_guides/porting_guide_6.rst:684 +#: ../../rst/porting_guides/porting_guide_7.rst:357 +#: ../../rst/porting_guides/porting_guide_7.rst:579 +#: ../../rst/porting_guides/porting_guide_7.rst:768 +#: ../../rst/porting_guides/porting_guide_7.rst:1002 msgid "community.aws" msgstr "community.aws" @@ -1145,12 +1197,12 @@ msgstr "ec2_vpc_igw_info - 2022-06-22 以é™ã€``convert_tags`` パラメータã #: ../../rst/porting_guides/porting_guide_5.rst:544 #: ../../rst/porting_guides/porting_guide_5.rst:842 #: ../../rst/porting_guides/porting_guide_5.rst:962 -#: ../../rst/porting_guides/porting_guide_6.rst:233 -#: ../../rst/porting_guides/porting_guide_6.rst:787 -#: ../../rst/porting_guides/porting_guide_7.rst:176 -#: ../../rst/porting_guides/porting_guide_7.rst:228 -#: ../../rst/porting_guides/porting_guide_7.rst:417 -#: ../../rst/porting_guides/porting_guide_7.rst:497 +#: ../../rst/porting_guides/porting_guide_6.rst:369 +#: ../../rst/porting_guides/porting_guide_6.rst:923 +#: ../../rst/porting_guides/porting_guide_7.rst:423 +#: ../../rst/porting_guides/porting_guide_7.rst:584 +#: ../../rst/porting_guides/porting_guide_7.rst:858 +#: ../../rst/porting_guides/porting_guide_7.rst:1026 msgid "community.docker" msgstr "community.docker" @@ -1311,8 +1363,8 @@ msgstr "openshift_auth - æ–°ã—ã„モジュール (community.kubernetes ã® k8s_ #: ../../rst/porting_guides/porting_guide_4.rst:703 #: ../../rst/porting_guides/porting_guide_5.rst:381 #: ../../rst/porting_guides/porting_guide_5.rst:800 -#: ../../rst/porting_guides/porting_guide_6.rst:651 -#: ../../rst/porting_guides/porting_guide_7.rst:295 +#: ../../rst/porting_guides/porting_guide_6.rst:787 +#: ../../rst/porting_guides/porting_guide_7.rst:686 msgid "Removed Features" msgstr "削除ã•ã‚ŒãŸæ©Ÿèƒ½" @@ -1465,8 +1517,6 @@ msgid "Ansible-base" msgstr "Ansible-base" #: ../../rst/porting_guides/porting_guide_2.10.rst:381 -#: ../../rst/porting_guides/porting_guide_3.rst:210 -#: ../../rst/porting_guides/porting_guide_4.rst:550 msgid "ansible-galaxy login command has been removed (see https://github.com/ansible/ansible/issues/71560)" msgstr "ansible-galaxy login コマンドãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible/ansible/issues/71560 ã‚’å‚ç…§))。" @@ -1585,10 +1635,14 @@ msgstr "v2.10.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:320 #: ../../rst/porting_guides/porting_guide_5.rst:359 #: ../../rst/porting_guides/porting_guide_5.rst:439 -#: ../../rst/porting_guides/porting_guide_6.rst:151 -#: ../../rst/porting_guides/porting_guide_6.rst:183 -#: ../../rst/porting_guides/porting_guide_6.rst:255 -#: ../../rst/porting_guides/porting_guide_7.rst:107 +#: ../../rst/porting_guides/porting_guide_6.rst:106 +#: ../../rst/porting_guides/porting_guide_6.rst:163 +#: ../../rst/porting_guides/porting_guide_6.rst:287 +#: ../../rst/porting_guides/porting_guide_6.rst:319 +#: ../../rst/porting_guides/porting_guide_6.rst:391 +#: ../../rst/porting_guides/porting_guide_7.rst:105 +#: ../../rst/porting_guides/porting_guide_7.rst:223 +#: ../../rst/porting_guides/porting_guide_7.rst:278 msgid "Known Issues" msgstr "既知ã®å•é¡Œ" @@ -1676,13 +1730,13 @@ msgstr "purestorage.flashblade.purefb_fs - éžæŽ¨å¥¨ã® ``nfs`` オプションã #: ../../rst/porting_guides/porting_guide_5.rst:481 #: ../../rst/porting_guides/porting_guide_5.rst:618 #: ../../rst/porting_guides/porting_guide_5.rst:883 -#: ../../rst/porting_guides/porting_guide_6.rst:305 #: ../../rst/porting_guides/porting_guide_6.rst:441 -#: ../../rst/porting_guides/porting_guide_6.rst:765 -#: ../../rst/porting_guides/porting_guide_7.rst:142 -#: ../../rst/porting_guides/porting_guide_7.rst:207 -#: ../../rst/porting_guides/porting_guide_7.rst:317 -#: ../../rst/porting_guides/porting_guide_7.rst:446 +#: ../../rst/porting_guides/porting_guide_6.rst:577 +#: ../../rst/porting_guides/porting_guide_6.rst:901 +#: ../../rst/porting_guides/porting_guide_7.rst:321 +#: ../../rst/porting_guides/porting_guide_7.rst:482 +#: ../../rst/porting_guides/porting_guide_7.rst:708 +#: ../../rst/porting_guides/porting_guide_7.rst:956 msgid "amazon.aws" msgstr "amazon.aws" @@ -1698,6 +1752,7 @@ msgstr "aws_s3 - ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚¢ãƒƒãƒ—ã•ã‚ŒãŸãƒã‚±ãƒƒãƒˆãŒç©ºã§ãªã㦠#: ../../rst/porting_guides/porting_guide_4.rst:481 #: ../../rst/porting_guides/porting_guide_5.rst:810 #: ../../rst/porting_guides/porting_guide_5.rst:895 +#: ../../rst/porting_guides/porting_guide_7.rst:141 msgid "ansible.windows" msgstr "ansible.windows" @@ -1744,7 +1799,10 @@ msgstr "win_user - 大文å—ã¨å°æ–‡å—を区別ã™ã‚‹ãŸã‚ã« ``fullname`` ã #: ../../rst/porting_guides/porting_guide_2.10.rst:495 #: ../../rst/porting_guides/porting_guide_2.10.rst:642 #: ../../rst/porting_guides/porting_guide_5.rst:343 -#: ../../rst/porting_guides/porting_guide_6.rst:535 +#: ../../rst/porting_guides/porting_guide_6.rst:118 +#: ../../rst/porting_guides/porting_guide_6.rst:671 +#: ../../rst/porting_guides/porting_guide_7.rst:116 +#: ../../rst/porting_guides/porting_guide_7.rst:235 msgid "cisco.meraki" msgstr "cisco.meraki" @@ -1916,6 +1974,8 @@ msgstr "win_pester - 未知ã®ã‚¹ã‚¯ãƒªãƒ—トを実行ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ã #: ../../rst/porting_guides/porting_guide_2.10.rst:953 #: ../../rst/porting_guides/porting_guide_4.rst:195 #: ../../rst/porting_guides/porting_guide_5.rst:573 +#: ../../rst/porting_guides/porting_guide_6.rst:124 +#: ../../rst/porting_guides/porting_guide_7.rst:241 msgid "community.zabbix" msgstr "community.zabbix" @@ -1948,7 +2008,7 @@ msgid "This version has a few breaking changes due to new namespace and collecti msgstr "ã“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã¯ã€æ–°ã—ã„åå‰ç©ºé–“ã¨ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã®ãŸã‚ã«ã„ãã¤ã‹ã®é‡å¤§ãªå¤‰æ›´ãŒã‚ã‚Šã¾ã™ã€‚lookup プラグイン㨠inventory プラグインã®åå‰ã‚’変更ã—ã¦ã€ãれを使用ã™ã‚‹ãŸã‚ã®éžè¨˜è¿°çš„ãªåå‰ç©ºé–“呼ã³å‡ºã—ã‚’è¡Œã‚ãªã„よã†ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã¨æ„Ÿã˜ã¾ã—ãŸã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚inventory プラグイン㨠lookup プラグインã®ä¸¡æ–¹ã« ``netbox.netbox.netbox`` ãŒä½¿ç”¨ã•ã‚Œã¾ã™ãŒã€ã‚³ãƒ³ãƒ†ã‚ストãŒç•°ãªã‚‹ãŸã‚ã€è¡çªã¯ç™ºç”Ÿã—ã¾ã›ã‚“ãŒã€æ··ä¹±ãŒç™ºç”Ÿã—ã¾ã™ã€‚lookup プラグインã®åå‰ã‚’ ``nb_lookup`` ã«å¤‰æ›´ã—ã¾ã—ãŸã€‚ãã®ãŸã‚ã€FQCN ``netbox.netbox.nb_lookup`` ã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚インベントリープラグインã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«å†…㧠``netbox.netbox.nb_inventory`` ã«ã‚ˆã‚Šå‘¼ã³å‡ºã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:570 -msgid "To pass in integers via Ansible Jinja filters for a key in ``data`` that requires querying an endpoint is now done by making it a dictionary with an ``id`` key. The previous behavior was to just pass in an integer and it was converted when normalizing the data, but some people may have names that are all integers and those were being converted erroneously so we made the decision to change the method to convert to an integer for the NetBox API." +msgid "To pass in integers through Ansible Jinja filters for a key in ``data`` that requires querying an endpoint is now done by making it a dictionary with an ``id`` key. The previous behavior was to just pass in an integer and it was converted when normalizing the data, but some people may have names that are all integers and those were being converted erroneously so we made the decision to change the method to convert to an integer for the NetBox API." msgstr "エンドãƒã‚¤ãƒ³ãƒˆã¸ã®å•ã„åˆã‚ã›ãŒå¿…è¦ãª ``data`` ã®ã‚ーã«å¯¾ã—ã¦ã€Ansible Jinja ã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã§æ•´æ•°ã‚’渡ã™ãŸã‚ã«ã¯ã€``id`` ã‚ーをæŒã¤ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã«ã™ã‚‹ã“ã¨ã§è¡Œã†ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¾ã§ã®å‹•ä½œã§ã¯ã€æ•´æ•°ã‚’渡ã™ã ã‘ã§ãƒ‡ãƒ¼ã‚¿ã®æ£è¦åŒ–時ã«å¤‰æ›ã•ã‚Œã¦ã„ã¾ã—ãŸãŒã€äººã«ã‚ˆã£ã¦ã¯åå‰ãŒã™ã¹ã¦æ•´æ•°ã§ã‚ã‚‹å ´åˆãŒã‚ã‚Šã€ãれらãŒèª¤ã£ã¦å¤‰æ›ã•ã‚Œã¦ã„ãŸãŸã‚ã€NetBox API ã§ã¯æ•´æ•°ã«å¤‰æ›ã™ã‚‹æ–¹æ³•ã«å¤‰æ›´ã™ã‚‹ã“ã¨ã«ã—ã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:593 @@ -1957,7 +2017,7 @@ msgstr "``pynetbox`` ã¯ã€NetBox API クライアントを構築ã™ã‚‹éš›ã« `` #: ../../rst/porting_guides/porting_guide_2.10.rst:599 #: ../../rst/porting_guides/porting_guide_4.rst:589 -#: ../../rst/porting_guides/porting_guide_6.rst:424 +#: ../../rst/porting_guides/porting_guide_6.rst:560 msgid "theforeman.foreman" msgstr "theforeman.foreman" @@ -2032,9 +2092,10 @@ msgstr "ec2 module_utils - ``AWSRetry`` デコレーターã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã #: ../../rst/porting_guides/porting_guide_4.rst:613 #: ../../rst/porting_guides/porting_guide_4.rst:839 #: ../../rst/porting_guides/porting_guide_5.rst:890 -#: ../../rst/porting_guides/porting_guide_6.rst:263 -#: ../../rst/porting_guides/porting_guide_6.rst:324 -#: ../../rst/porting_guides/porting_guide_6.rst:446 +#: ../../rst/porting_guides/porting_guide_6.rst:399 +#: ../../rst/porting_guides/porting_guide_6.rst:460 +#: ../../rst/porting_guides/porting_guide_6.rst:582 +#: ../../rst/porting_guides/porting_guide_7.rst:718 msgid "ansible.netcommon" msgstr "ansible.netcommon" @@ -2140,7 +2201,7 @@ msgid "k8s_config_resource_name - Filter plugin migrated from Ansible 2.9 to Kub msgstr "k8s_config_resource_name - Ansible 2.9 ã‹ã‚‰ Kubernetes コレクションã«ç§»è¡Œã—ãŸãƒ—ラグインã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚’è¨å®šã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.10.rst:677 -msgid "k8s_exec - New module for executing commands on pods via Kubernetes API (https://github.com/ansible-collections/community.kubernetes/pull/14)." +msgid "k8s_exec - New module for executing commands on pods through Kubernetes API (https://github.com/ansible-collections/community.kubernetes/pull/14)." msgstr "k8s_exec - Kubernetes API を使用ã—㦠Pod ã§ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹æ–°è¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (https://github.com/ansible-collections/community.kubernetes/pull/14)。" #: ../../rst/porting_guides/porting_guide_2.10.rst:678 @@ -2355,8 +2416,8 @@ msgstr "ovirt_vm_os_info - モジュールを作æˆã—ã¾ã™ (https://github.com #: ../../rst/porting_guides/porting_guide_2.10.rst:747 #: ../../rst/porting_guides/porting_guide_5.rst:335 #: ../../rst/porting_guides/porting_guide_5.rst:351 -#: ../../rst/porting_guides/porting_guide_6.rst:290 -#: ../../rst/porting_guides/porting_guide_6.rst:826 +#: ../../rst/porting_guides/porting_guide_6.rst:426 +#: ../../rst/porting_guides/porting_guide_6.rst:962 msgid "purestorage.flasharray" msgstr "purestorage.flasharray" @@ -2510,8 +2571,8 @@ msgstr "win_stat - éžæŽ¨å¥¨ã® ``get_md55`` オプション㨠``md5`` ã®æˆ»ã‚ #: ../../rst/porting_guides/porting_guide_5.rst:515 #: ../../rst/porting_guides/porting_guide_5.rst:815 #: ../../rst/porting_guides/porting_guide_5.rst:952 -#: ../../rst/porting_guides/porting_guide_6.rst:228 -#: ../../rst/porting_guides/porting_guide_7.rst:492 +#: ../../rst/porting_guides/porting_guide_6.rst:364 +#: ../../rst/porting_guides/porting_guide_7.rst:1021 msgid "community.crypto" msgstr "community.crypto" @@ -2883,7 +2944,7 @@ msgid "vmware_tag_info - in a later release, the module will not return ``tag_fa msgstr "vmware_tag_info - 今後ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€åŒã˜åå‰ã§ç•°ãªã‚‹ã‚«ãƒ†ã‚´ãƒªãƒ¼ ID ã‚’æŒã¤è¤‡æ•°ã®ã‚¿ã‚°ã‚’è¿”ã•ãªã„ãŸã‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``tag_facts`` ã‚’è¿”ã—ã¾ã›ã‚“。既å˜ã®å‹•ä½œã‚’ç¶æŒã™ã‚‹ã«ã¯ã€ã‚¿ã‚°ã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã®ãƒªã‚¹ãƒˆã§ã‚ã‚‹ ``tag_info`` を使用ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.10.rst:955 -msgid "zabbix_proxy (module) - deprecates ``interface`` sub-options ``type`` and ``main`` when proxy type is set to passive via ``status=passive``. Make sure these suboptions are removed from your playbook as they were never supported by Zabbix in the first place." +msgid "zabbix_proxy (module) - deprecates ``interface`` sub-options ``type`` and ``main`` when proxy type is set to passive through ``status=passive``. Make sure these suboptions are removed from your playbook as they were never supported by Zabbix in the first place." msgstr "zabbix_proxy (モジュール) - ``status=passive`` ã§ãƒ—ãƒã‚シー㌠passive ã«è¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€``interface`` ã®ã‚µãƒ–オプション ``type`` 㨠``main`` ã‚’éžæŽ¨å¥¨ã¨ã—ã¾ã™ã€‚ã“れらã®ã‚µãƒ–オプションã¯ãã‚‚ãã‚‚ Zabbix ã§ã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„ãŸã‚ã€å¿…ãš Playbook ã‹ã‚‰å‰Šé™¤ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.10.rst:960 @@ -2908,7 +2969,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.2 ã‹ã‚‰ Ansible 2.3 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.3.rst:13 msgid "We suggest you read this page along with `Ansible Changelog for 2.3 <https://github.com/ansible/ansible/blob/stable-2.3/CHANGELOG.md>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.3 <https://github.com/ansible/ansible/blob/stable-2.3/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.3 <https://github.com/ansible/ansible/blob/stable-2.3/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:23 msgid "Restructured async to work with action plugins" @@ -2955,7 +3016,7 @@ msgid "Specifying ``--tags`` (or ``--skip-tags``) multiple times on the command msgstr "ç¾åœ¨ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ ``--tags`` (ã¾ãŸã¯ ``--skip-tags``) を複数回指定ã™ã‚‹ã¨ã€æœ€å¾Œã«æŒ‡å®šã—ãŸã‚¿ã‚°ãŒä»–ã®ã™ã¹ã¦ã®æŒ‡å®šã—ãŸã‚¿ã‚°ã‚ˆã‚Šã‚‚優先ã•ã‚Œã¾ã™ã€‚ã“ã®å‹•ä½œã¯æŽ¨å¥¨ã•ã‚Œã¾ã›ã‚“。将æ¥çš„ã«ã¯ã€--tags を複数回指定ã—ãŸå ´åˆã€ã‚¿ã‚°ã¯çµ±åˆã•ã‚Œã¾ã™ã€‚今後ã¯ã€1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ ``--tags`` を複数回使用ã™ã‚‹ã¨ã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚``ansible.cfg`` ファイル㧠``merge_multiple_cli_tags`` オプションを True ã«è¨å®šã™ã‚‹ã¨ã€æ–°ã—ã„動作ãŒæœ‰åŠ¹ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:95 -msgid "In 2.4, the default will be to merge the tags. You can enable the old overwriting behavior via the config option. In 2.5, multiple ``--tags`` options will be merged with no way to go back to the old behaviour." +msgid "In 2.4, the default will be to merge the tags. You can enable the old overwriting behavior through the config option. In 2.5, multiple ``--tags`` options will be merged with no way to go back to the old behaviour." msgstr "2.4 ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚¿ã‚°ã®ãƒžãƒ¼ã‚¸ãŒè¡Œã‚ã‚Œã¾ã™ã€‚å¤ã„上書ãã®å‹•ä½œã¯ã€è¨å®šã‚ªãƒ—ションã§æœ‰åŠ¹ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚2.5 ã§ã¯ã€è¤‡æ•°ã® ``--tags`` オプションãŒãƒžãƒ¼ã‚¸ã•ã‚Œã¾ã™ãŒã€ä»¥å‰ã®å‹•ä½œã«æˆ»ã™ã“ã¨ã¯ã§ãã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_2.3.rst:102 @@ -3148,15 +3209,15 @@ msgid "Will result in:" msgstr "çµæžœã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:223 -msgid "delegate_to vs ProxyCommand" -msgstr "delegate_to 対 ProxyCommand" +msgid "ProxyCommand replaces delegate_to" +msgstr "ProxyCommand 㯠delegate_to ã‚’ç½®ãæ›ãˆã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:225 msgid "The new connection framework for Network Modules in Ansible 2.3 that uses ``cli`` transport no longer supports the use of the ``delegate_to`` directive. In order to use a bastion or intermediate jump host to connect to network devices over ``cli`` transport, network modules now support the use of ``ProxyCommand``." msgstr "``cli`` トランスãƒãƒ¼ãƒˆã‚’使用ã™ã‚‹ Ansible 2.3 ã®ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®æ–°ã—ã„接続フレームワークã¯ã€``delegate_to`` ディレクティブã®ä½¿ç”¨ã‚’サãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—ãŸã€‚bastion ã¾ãŸã¯ä¸é–“ジャンプホストを使用ã—㦠``cli`` トランスãƒãƒ¼ãƒˆã§ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ‡ãƒã‚¤ã‚¹ã«æŽ¥ç¶šã™ã‚‹ãŸã‚ã«ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``ProxyCommand`` ã®ä½¿ç”¨ã«å¯¾å¿œã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:230 -msgid "To use ``ProxyCommand`` configure the proxy settings in the Ansible inventory file to specify the proxy host via ``ansible_ssh_common_args``." +msgid "To use ``ProxyCommand`` configure the proxy settings in the Ansible inventory file to specify the proxy host through ``ansible_ssh_common_args``." msgstr "``ProxyCommand`` を使用ã™ã‚‹ã«ã¯ã€Ansible インベントリーファイルã§ãƒ—ãƒã‚シーè¨å®šã‚’構æˆã—ã¦ã€``ansible_ssh_common_args`` を使用ã—ã¦ãƒ—ãƒã‚シーホストを指定ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.3.rst:233 @@ -3173,7 +3234,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.3 ã‹ã‚‰ Ansible 2.4 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.4.rst:13 msgid "We suggest you read this page along with `Ansible Changelog for 2.4 <https://github.com/ansible/ansible/blob/stable-2.4/CHANGELOG.md>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.4 <https://github.com/ansible/ansible/blob/stable-2.4/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.4 <https://github.com/ansible/ansible/blob/stable-2.4/CHANGELOG.md>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.4.rst:20 msgid "Python version" @@ -3190,7 +3251,7 @@ msgid "Inventory" msgstr "インベントリー" #: ../../rst/porting_guides/porting_guide_2.4.rst:28 -msgid "Inventory has been refactored to be implemented via plugins and now allows for multiple sources. This change is mostly transparent to users." +msgid "Inventory has been refactored to be implemented through plugins and now allows for multiple sources. This change is mostly transparent to users." msgstr "インベントリーã¯ãƒ—ラグインã§å®Ÿè£…ã§ãるよã†ã«ãƒªãƒ•ã‚¡ã‚¯ã‚¿ãƒªãƒ³ã‚°ã•ã‚Œã€è¤‡æ•°ã®ã‚½ãƒ¼ã‚¹ã‚’使用ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®å¤‰æ›´ã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ã¯ã»ã¨ã‚“ã©ã‚ã‹ã‚Šã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_2.4.rst:30 @@ -3238,7 +3299,7 @@ msgid "Specifying ``--tags`` (or ``--skip-tags``) multiple times on the command msgstr "ç¾åœ¨ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ ``--tags`` (ã¾ãŸã¯ ``--skip-tags``) を複数回指定ã™ã‚‹ã¨ã€æœ€å¾Œã«æŒ‡å®šã—ãŸã‚¿ã‚°ãŒãã®å‰ã«æŒ‡å®šã—ãŸã™ã¹ã¦ã®ã‚¿ã‚°ã‚ˆã‚Šã‚‚優先ã•ã‚Œã¾ã™ã€‚ã“ã®å‹•ä½œã¯æŽ¨å¥¨ã•ã‚Œã¾ã›ã‚“。将æ¥çš„ã«ã¯ã€--tags を複数回指定ã—ãŸå ´åˆã€ã‚¿ã‚°ã¯çµ±åˆã•ã‚Œã¾ã™ã€‚今後ã¯ã€1 ã¤ã®ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ ``--tags`` を複数回使用ã™ã‚‹ã¨ã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚``ansible.cfg`` ファイル㧠``merge_multiple_cli_tags`` オプションを True ã«è¨å®šã™ã‚‹ã¨ã€æ–°ã—ã„動作ãŒæœ‰åŠ¹ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.4.rst:66 -msgid "In 2.4, the default has change to merge the tags. You can enable the old overwriting behavior via the config option." +msgid "In 2.4, the default has change to merge the tags. You can enable the old overwriting behavior through the config option." msgstr "2.4 ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚¿ã‚°ã®ãƒžãƒ¼ã‚¸ãŒè¡Œã‚れるよã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã®ä¸Šæ›¸ãã®å‹•ä½œã¯ã€è¨å®šã‚ªãƒ—ションã§æœ‰åŠ¹ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.4.rst:68 @@ -3329,7 +3390,7 @@ msgid "Inventory plugins" msgstr "inventory プラグイン" #: ../../rst/porting_guides/porting_guide_2.4.rst:127 -msgid "Developers should start migrating from hardcoded inventory with dynamic inventory scripts to the new Inventory Plugins. The scripts will still work via the ``script`` inventory plugin but Ansible development efforts will now concentrate on writing plugins rather than enhancing existing scripts." +msgid "Developers should start migrating from hardcoded inventory with dynamic inventory scripts to the new Inventory Plugins. The scripts will still work through the ``script`` inventory plugin but Ansible development efforts will now concentrate on writing plugins rather than enhancing existing scripts." msgstr "開発者ã¯ã€å‹•çš„インベントリーリスクリプトã«ã‚ˆã‚‹ãƒãƒ¼ãƒ‰ã‚³ãƒ¼ãƒ‰ã•ã‚ŒãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‹ã‚‰ã€æ–°ã—ã„インベントリースクリプトã¸ã®ç§»è¡Œã‚’開始ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚スクリプトã¯ã€``script`` インベントリープラグインを介ã—ã¦å¼•ã続ã動作ã—ã¾ã™ãŒã€Ansible ã®é–‹ç™ºåŠªåŠ›ã¯ã€æ—¢å˜ã®ã‚¹ã‚¯ãƒªãƒ—トã®æ”¹è‰¯ã§ã¯ãªãã€ãƒ—ラグインã®ä½œæˆã«é›†ä¸ã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.4.rst:129 @@ -3349,8 +3410,8 @@ msgid "Developers:" msgstr "開発者:" #: ../../rst/porting_guides/porting_guide_2.4.rst:141 -msgid "If your callback does not inherit from ``CallbackBase`` (directly or indirectly via another callback), it will still work, but issue a deprecation notice. To avoid this and ensure it works in the future change it to inherit from ``CallbackBase`` so it has the new options handling methods and properties. You can also implement the new options handling methods and properties but that won't automatically inherit changes added in the future. You can look at ``CallbackBase`` itself and/or ``AnsiblePlugin`` for details." -msgstr "コールãƒãƒƒã‚¯ãŒ ``CallbackBase`` を継承ã—ã¦ã„ãªã„å ´åˆ (直接ã¾ãŸã¯ä»–ã®ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã‚’経由ã—ã¦é–“接的ã«)ã€ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã¯å‹•ä½œã—ã¾ã™ãŒã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“れを回é¿ã—ã€å°†æ¥ã‚‚確実ã«å‹•ä½œã•ã›ã‚‹ã«ã¯ã€``CallbackBase`` を継承ã™ã‚‹ã‚ˆã†ã«å¤‰æ›´ã—ã€æ–°ã—ã„オプション処ç†ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¨ãƒ—ãƒãƒ‘ティーをæŒã¤ã‚ˆã†ã«ã—ã¾ã™ã€‚æ–°ã—ã„オプション処ç†ã®ãƒ¡ã‚½ãƒƒãƒ‰ã‚„プãƒãƒ‘ティーを実装ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€å°†æ¥è¿½åŠ ã•ã‚Œã‚‹å¤‰æ›´ã‚’自動的ã«ç¶™æ‰¿ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。詳細ã¯ã€``CallbackBase`` 自体や``AnsiblePlugin`` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "If your callback does not inherit from ``CallbackBase`` (directly or indirectly through another callback), it will still work, but issue a deprecation notice. To avoid this and ensure it works in the future change it to inherit from ``CallbackBase`` so it has the new options handling methods and properties. You can also implement the new options handling methods and properties but that won't automatically inherit changes added in the future. You can look at ``CallbackBase`` itself and/or ``AnsiblePlugin`` for details." +msgstr "コールãƒãƒƒã‚¯ãŒ ``CallbackBase`` を継承ã—ã¦ã„ãªã„å ´åˆ (直接ã¾ãŸã¯ä»–ã®ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã‚’経由ã—ã¦é–“接的ã«)ã€ã‚³ãƒ¼ãƒ«ãƒãƒƒã‚¯ã¯å‹•ä½œã—ã¾ã™ãŒã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“れを回é¿ã—ã€å°†æ¥ã‚‚確実ã«å‹•ä½œã•ã›ã‚‹ã«ã¯ã€``CallbackBase`` を継承ã™ã‚‹ã‚ˆã†ã«å¤‰æ›´ã—ã€æ–°ã—ã„オプション処ç†ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¨ãƒ—ãƒãƒ‘ティーをæŒã¤ã‚ˆã†ã«ã—ã¾ã™ã€‚æ–°ã—ã„オプション処ç†ã®ãƒ¡ã‚½ãƒƒãƒ‰ã‚„プãƒãƒ‘ティーを実装ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€å°†æ¥è¿½åŠ ã•ã‚Œã‚‹å¤‰æ›´ã‚’自動的ã«ç¶™æ‰¿ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。詳細ã¯ã€``CallbackBase`` 自体や ``AnsiblePlugin`` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.4.rst:144 msgid "Any callbacks inheriting from other callbacks might need to also be updated to contain the same documented options as the parent or the options won't be available. This is noted in the developer guide." @@ -3414,7 +3475,7 @@ msgstr "詳細ã¯ã€ã€Œ:ref:`Ansible Network debug guide <network_debug_troubles #: ../../rst/porting_guides/porting_guide_2.4.rst:216 msgid "Configuration" -msgstr "è¨å®š" +msgstr "Configuration (構æˆ)" #: ../../rst/porting_guides/porting_guide_2.4.rst:219 msgid "The configuration system has had some major changes. Users should be unaffected except for the following:" @@ -3446,7 +3507,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.4 ã‹ã‚‰ Ansible 2.5 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.5.rst:11 msgid "We suggest you read this page along with `Ansible Changelog for 2.5 <https://github.com/ansible/ansible/blob/stable-2.5/changelogs/CHANGELOG-v2.5.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.5 <https://github.com/ansible/ansible/blob/stable-2.5/changelogs/CHANGELOG-v2.5.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.5 <https://github.com/ansible/ansible/blob/stable-2.5/changelogs/CHANGELOG-v2.5.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.5.rst:21 msgid "Dynamic includes and attribute inheritance" @@ -3577,27 +3638,31 @@ msgstr "with_sequence" msgid "``with_sequence`` is replaced by ``loop`` and the ``range`` function, and potentially the ``format`` filter." msgstr "``with_sequence`` ã¯ã€``loop`` 関数㨠``range`` ã®é–¢æ•°ã€ãã—ã¦æ½œåœ¨çš„ã«ã¯ ``format`` フィルターã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:153 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:151 +msgid "The range of the loop is exclusive of the end point." +msgstr "ループã®ç¯„囲ã¯ã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã‚’除ãã¾ã™ã€‚" + +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:154 msgid "with_subelements" msgstr "with_subelements" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:155 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:156 msgid "``with_subelements`` is replaced by ``loop`` and the ``subelements`` filter." msgstr "``with_subelements`` ã¯ã€``loop`` フィルターãŠã‚ˆã³ ``subelements`` フィルターã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:172 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:173 msgid "with_nested/with_cartesian" msgstr "with_nested/with_cartesian" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:174 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:175 msgid "``with_nested`` and ``with_cartesian`` are replaced by loop and the ``product`` filter." msgstr "``with_nested`` ã¨``with_cartesian`` ã¯ã€ãƒ«ãƒ¼ãƒ—㨠``product`` ã®ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:191 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:192 msgid "with_random_choice" msgstr "with_random_choice" -#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:193 +#: ../../rst/playbook_guide/shared_snippets/with2loop.txt:194 msgid "``with_random_choice`` is replaced by just use of the ``random`` filter, without need of ``loop``." msgstr "``with_random_choice`` ã¯ã€``random`` フィルターを使用ã™ã‚‹ã ã‘ã§ã€``loop`` ã‚’å¿…è¦ã¨ã›ãšã«ç½®ãæ›ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" @@ -3930,7 +3995,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.5 ã‹ã‚‰ Ansible 2.6 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.6.rst:11 msgid "We suggest you read this page along with `Ansible Changelog for 2.6 <https://github.com/ansible/ansible/blob/stable-2.6/changelogs/CHANGELOG-v2.6.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.6 <https://github.com/ansible/ansible/blob/stable-2.6/changelogs/CHANGELOG-v2.6.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.6 <https://github.com/ansible/ansible/blob/stable-2.6/changelogs/CHANGELOG-v2.6.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.6.rst:20 msgid "The deprecated task option ``always_run`` has been removed, please use ``check_mode: no`` instead." @@ -4063,7 +4128,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.6 ã‹ã‚‰ Ansible 2.7 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.7.rst:11 msgid "We suggest you read this page along with `Ansible Changelog for 2.7 <https://github.com/ansible/ansible/blob/stable-2.7/changelogs/CHANGELOG-v2.7.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.7 <https://github.com/ansible/ansible/blob/stable-2.7/changelogs/CHANGELOG-v2.7.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.7 <https://github.com/ansible/ansible/blob/stable-2.7/changelogs/CHANGELOG-v2.7.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.7.rst:20 msgid "If you specify ``--tags`` or ``--skip-tags`` multiple times on the command line, Ansible will merge the specified tags together. In previous versions of Ansible, you could set ``merge_multiple_cli_tags`` to ``False`` if you wanted to keep only the last-specified ``--tags``. This config option existed for backwards compatibility. The overwriting behavior was deprecated in 2.3 and the default behavior was changed in 2.4. Ansible-2.7 removes the config option; multiple ``--tags`` are now always merged." @@ -4082,7 +4147,7 @@ msgid "Ansible has dropped compatibility with Python-2.6 on the controller (The msgstr "Ansible ã¯ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ (:command:`/usr/bin/ansible` ã¾ãŸã¯ :command:`/usr/bin/ansible-playbook` ãŒå®Ÿè¡Œã•ã‚Œã‚‹ãƒ›ã‚¹ãƒˆ) ã§ã® Python-2.6 ã¨ã®äº’æ›æ€§ã‚’失ã„ã¾ã—ãŸã€‚Ansible ã«åŒæ¢±ã•ã‚Œã¦ã„るモジュールã¯ã€Python-2.6 ã—ã‹æ載ã—ã¦ã„ãªã„ホストã®ç®¡ç†ã«ä½¿ç”¨ã§ãã¾ã™ã€‚ãŸã ã—ã€Python-2.7 以上ã¾ãŸã¯ Python-3.5 以上ã®ãƒ›ã‚¹ãƒˆã‹ã‚‰ç®¡ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.7.rst:39 -msgid "One thing that this does affect is the ability to use :command:`/usr/bin/ansible-pull` to manage a host which has Python-2.6. ``ansible-pull`` runs on the host being managed but it is a controller script, not a module so it will need an updated Python. Actively developed Linux distros which ship with Python-2.6 have some means to install newer Python versions (For instance, you can install Python-2.7 via an SCL on RHEL-6) but you may need to also install Python bindings for many common modules to work (For RHEL-6, for instance, selinux bindings and yum would have to be installed for the updated Python install)." +msgid "One thing that this does affect is the ability to use :command:`/usr/bin/ansible-pull` to manage a host which has Python-2.6. ``ansible-pull`` runs on the host being managed but it is a controller script, not a module so it will need an updated Python. Actively developed Linux distros which ship with Python-2.6 have some means to install newer Python versions (For instance, you can install Python-2.7 through an SCL on RHEL-6) but you may need to also install Python bindings for many common modules to work (For RHEL-6, for instance, selinux bindings and yum would have to be installed for the updated Python install)." msgstr "ã“ã‚ŒãŒå½±éŸ¿ã™ã‚‹ã“ã¨ã® 1 ã¤ã¯ã€:command:`/usr/bin/ansible-pull` を使用ã—ã¦ã€Python-2.6 ã‚’æ載ã—ãŸãƒ›ã‚¹ãƒˆã‚’管ç†ã™ã‚‹æ©Ÿèƒ½ã§ã™ã€‚``ansible-pull`` ã¯ç®¡ç†å¯¾è±¡ã®ãƒ›ã‚¹ãƒˆã§å®Ÿè¡Œã—ã¾ã™ãŒã€ã“ã‚Œã¯ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã§ã‚ã‚Šã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯ãªã„ãŸã‚ã€æ›´æ–°ã•ã‚ŒãŸ Python ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚Python-2.6 ã«åŒæ¢±ã•ã‚Œã¦ã„るアクティブã«é–‹ç™ºã•ã‚ŒãŸ Linux ディストリビューションã«ã¯ã€æ–°ã—ã„ Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’インストールã™ã‚‹æ‰‹æ®µãŒã‚ã‚Šã¾ã™ (ãŸã¨ãˆã°ã€RHEL-6 ã® SCL を介ã—㦠Python-2.7 をインストールã™ã‚‹ã“ã¨ãŒå¯èƒ½) ãŒã€å¤šãã®ä¸€èˆ¬çš„ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã® Python ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã‚‚インストールã—ãªã„ã¨ã„ã‘ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ (ãŸã¨ãˆã°ã€RHEL-6 ã®å ´åˆã€æ›´æ–°ã•ã‚ŒãŸ Python インストールã«ã¯ selinux ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã¨ yum をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)。" #: ../../rst/porting_guides/porting_guide_2.7.rst:47 @@ -4170,8 +4235,8 @@ msgid "If you are the author of a third-party module which uses ``__file__`` wit msgstr "``__file__`` 㨠``AnsibleModule`` を併用ã—ã¦ã„るサードパーティーモジュールを作æˆã—ãŸå ´åˆã¯ã€``__file__`` ãŒåˆ©ç”¨å¯èƒ½ãªçŠ¶æ…‹ã§ã¯ã‚ã£ã¦ã‚‚ãã®ä½¿ç”¨ãŒéžæŽ¨å¥¨ã¨ãªã£ã¦ã„ã‚‹é–“ã«ã€ã”自身ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’æ›´æ–°ã—ã¦ãã ã•ã„。``__file__`` ã®æœ€ã‚‚一般的ãªä½¿ã„æ–¹ã¯ã€ä¸€æ™‚ファイルを書ã込むディレクトリーを探ã™ã“ã¨ã§ã™ã€‚Ansible 2.5 以é™ã§ã¯ã€:ref:`apt モジュール <ansible_2_7:apt_module>` ã®ã‚³ãƒ¼ãƒ‰ã«ã‚るよã†ã«ã€``AnsibleModule`` インスタンス㫠``tmpdir`` 属性を使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.7.rst:127 -msgid "Using a loop on a package module via squash_actions" -msgstr "squash_actions ã«ã‚ˆã‚‹ãƒ‘ッケージモジュールã§ã®ãƒ«ãƒ¼ãƒ—ã®ä½¿ç”¨" +msgid "Using a loop on a package module through squash_actions" +msgstr "squash_actions を使ã£ãŸãƒ‘ッケージモジュールã®ãƒ«ãƒ¼ãƒ—ã®åˆ©ç”¨" #: ../../rst/porting_guides/porting_guide_2.7.rst:129 msgid "The use of ``squash_actions`` to invoke a package module, such as \"yum\", to only invoke the module once is deprecated, and will be removed in Ansible 2.11." @@ -4323,7 +4388,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€Ansible 2.7 ã‹ã‚‰ Ansible 2.8 ã«ãŠã‘ã‚ #: ../../rst/porting_guides/porting_guide_2.8.rst:11 msgid "We suggest you read this page along with `Ansible Changelog for 2.8 <https://github.com/ansible/ansible/blob/stable-2.8/changelogs/CHANGELOG-v2.8.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.8 <https://github.com/ansible/ansible/blob/stable-2.8/changelogs/CHANGELOG-v2.8.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible Changelog for 2.8 <https://github.com/ansible/ansible/blob/stable-2.8/changelogs/CHANGELOG-v2.8.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_2.8.rst:22 msgid "Distribution Facts" @@ -4624,8 +4689,8 @@ msgid "The ``FactCache.update()`` method has been converted to follow the dict A msgstr "``FactCache.update()`` メソッドã¯ã€dict API ã«å¾“ã†ã‚ˆã†ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚ディレクトリーを唯一ã®å¼•æ•°ã¨ã—ã¦å—ã‘å–ã‚Šã€ãã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã®é …ç›®ã§è‡ªèº«ã‚’æ›´æ–°ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚``update()`` ãŒã‚ーã¨å€¤ã‚’å—ã‘å–ã£ã¦ã„ãŸä»¥å‰ã® API ã¯ã€ç¾åœ¨ã¯éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã•ã‚Œã€2.12 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚以å‰ã®å‹•ä½œãŒå¿…è¦ãªå ´åˆã¯ã€ä»£ã‚ã‚Šã« ``FactCache.first_order_merge()`` ã«åˆ‡ã‚Šæ›¿ãˆã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.8.rst:350 -msgid "Supporting file-backed caching via self.cache is deprecated and will be removed in Ansible 2.12. If you maintain an inventory plugin, update it to use ``self._cache`` as a dictionary. For implementation details, see the :ref:`developer guide on inventory plugins<inventory_plugin_caching>`." -msgstr "self.cache ã«ã‚ˆã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ãƒãƒƒã‚¯ã‚ャッシングã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã§ã€Ansible 2.12 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚インベントリープラグインを管ç†ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¨ã—㦠``self._cache`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã—ã¦ãã ã•ã„。実装ã®è©³ç´°ã¯ã€ã€Œ:ref:`inventory プラグインã®é–‹ç™ºè€…ガイド<inventory_plugin_caching>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "Supporting file-backed caching through self.cache is deprecated and will be removed in Ansible 2.12. If you maintain an inventory plugin, update it to use ``self._cache`` as a dictionary. For implementation details, see the :ref:`developer guide on inventory plugins<inventory_plugin_caching>`." +msgstr "self.cache ã«ã‚ˆã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ãƒãƒƒã‚¯ã‚ャッシングã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã§ã€Ansible 2.12 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚インベントリープラグインを管ç†ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¨ã—㦠``self._cache`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã—ã¦ãã ã•ã„。実装ã®è©³ç´°ã¯ã€ã€Œ:ref:`developer guide on inventory plugins<inventory_plugin_caching>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.8.rst:354 msgid "Importing cache plugins directly is deprecated and will be removed in Ansible 2.12. Use the plugin_loader so direct options, environment variables, and other means of configuration can be reconciled using the config system rather than constants." @@ -4896,8 +4961,8 @@ msgid "``osx_say`` callback plugin was renamed into :ref:`say <say_callback>`." msgstr "``osx_say`` callback プラグインã®åå‰ãŒ :ref:`say <say_callback>` ã«å¤‰æ›´ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_2.8.rst:546 -msgid "Inventory plugins now support caching via cache plugins. To start using a cache plugin with your inventory see the section on caching in the :ref:`inventory guide<using_inventory>`. To port a custom cache plugin to be compatible with inventory see :ref:`developer guide on cache plugins<developing_cache_plugins>`." -msgstr "inventory プラグイン㌠cache プラグインã«ã‚ˆã‚‹ã‚ャッシュè¨å®šã«å¯¾å¿œã—ã¾ã—ãŸã€‚インベントリー㧠cache プラグインã®ä½¿ç”¨ã‚’開始ã™ã‚‹ã«ã¯ã€ã€Œ:ref:`インベントリーガイド<using_inventory>`ã€ã®ã‚ャッシュè¨å®šã«é–¢ã™ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。カスタムcache プラグインをインベントリーã¨äº’æ›æ€§ãŒã‚るよã†ã«ç§»æ¤ã™ã‚‹ã«ã¯ã€ã€Œ:ref:`cache プラグインã®é–‹ç™ºè€…ガイド<developing_cache_plugins>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "Inventory plugins now support caching through cache plugins. To start using a cache plugin with your inventory see the section on caching in the :ref:`inventory guide<using_inventory>`. To port a custom cache plugin to be compatible with inventory see :ref:`developer guide on cache plugins<developing_cache_plugins>`." +msgstr "inventory プラグイン㌠cache プラグインã«ã‚ˆã‚‹ã‚ャッシュè¨å®šã«å¯¾å¿œã—ã¾ã—ãŸã€‚インベントリー㧠cache プラグインã®ä½¿ç”¨ã‚’開始ã™ã‚‹ã«ã¯ã€ã€Œ:ref:`inventory guide<using_inventory>`ã€ã®ã‚ャッシュè¨å®šã«é–¢ã™ã‚‹ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã‚’å‚ç…§ã—ã¦ãã ã•ã„。カスタムcache プラグインをインベントリーã¨äº’æ›æ€§ãŒã‚るよã†ã«ç§»æ¤ã™ã‚‹ã«ã¯ã€ã€Œ:ref:`developer guide on cache plugins<developing_cache_plugins>`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_2.8.rst:552 msgid "Display class" @@ -6417,7 +6482,7 @@ msgstr "Ansible 3 ã¯ã€Ansible 2.10 ã¨åŒã˜ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã§ã‚ã‚‹ #: ../../rst/porting_guides/porting_guide_3.rst:17 msgid "We suggest you read this page along with the `Ansible 3 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/3/CHANGELOG-v3.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 3 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/3/CHANGELOG-v3.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 3 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/3/CHANGELOG-v3.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_3.rst:20 msgid "Porting Guide for v3.4.0" @@ -6439,12 +6504,12 @@ msgstr "v3.4.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:362 #: ../../rst/porting_guides/porting_guide_5.rst:447 #: ../../rst/porting_guides/porting_guide_5.rst:737 -#: ../../rst/porting_guides/porting_guide_6.rst:186 -#: ../../rst/porting_guides/porting_guide_6.rst:274 -#: ../../rst/porting_guides/porting_guide_6.rst:419 -#: ../../rst/porting_guides/porting_guide_6.rst:589 -#: ../../rst/porting_guides/porting_guide_7.rst:110 -#: ../../rst/porting_guides/porting_guide_7.rst:268 +#: ../../rst/porting_guides/porting_guide_6.rst:322 +#: ../../rst/porting_guides/porting_guide_6.rst:410 +#: ../../rst/porting_guides/porting_guide_6.rst:555 +#: ../../rst/porting_guides/porting_guide_6.rst:725 +#: ../../rst/porting_guides/porting_guide_7.rst:286 +#: ../../rst/porting_guides/porting_guide_7.rst:636 msgid "dellemc.openmanage" msgstr "dellemc.openmanage" @@ -6492,9 +6557,9 @@ msgstr "ansible-test - ``centos6`` ãŠã‚ˆã³ ``default`` テストコンテナム#: ../../rst/porting_guides/porting_guide_5.rst:187 #: ../../rst/porting_guides/porting_guide_5.rst:218 #: ../../rst/porting_guides/porting_guide_5.rst:721 -#: ../../rst/porting_guides/porting_guide_6.rst:162 -#: ../../rst/porting_guides/porting_guide_6.rst:569 -#: ../../rst/porting_guides/porting_guide_7.rst:255 +#: ../../rst/porting_guides/porting_guide_6.rst:298 +#: ../../rst/porting_guides/porting_guide_6.rst:705 +#: ../../rst/porting_guides/porting_guide_7.rst:623 msgid "community.postgresql" msgstr "community.postgresql" @@ -6506,8 +6571,8 @@ msgstr "postgresql_query - ``as_single_query`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ #: ../../rst/porting_guides/porting_guide_3.rst:47 #: ../../rst/porting_guides/porting_guide_4.rst:679 -#: ../../rst/porting_guides/porting_guide_6.rst:154 -#: ../../rst/porting_guides/porting_guide_7.rst:123 +#: ../../rst/porting_guides/porting_guide_6.rst:290 +#: ../../rst/porting_guides/porting_guide_7.rst:299 msgid "netapp.ontap" msgstr "netapp.ontap" @@ -6535,10 +6600,10 @@ msgstr "v3.3.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_3.rst:139 #: ../../rst/porting_guides/porting_guide_4.rst:653 #: ../../rst/porting_guides/porting_guide_5.rst:182 -#: ../../rst/porting_guides/porting_guide_6.rst:126 -#: ../../rst/porting_guides/porting_guide_6.rst:399 -#: ../../rst/porting_guides/porting_guide_6.rst:559 -#: ../../rst/porting_guides/porting_guide_7.rst:250 +#: ../../rst/porting_guides/porting_guide_6.rst:262 +#: ../../rst/porting_guides/porting_guide_6.rst:535 +#: ../../rst/porting_guides/porting_guide_6.rst:695 +#: ../../rst/porting_guides/porting_guide_7.rst:612 msgid "community.mysql" msgstr "community.mysql" @@ -6719,6 +6784,10 @@ msgstr "Issue 2(187956): 無効ãªjob_idãŒæä¾›ã•ã‚ŒãŸå ´åˆã€idrac_lifecyc msgid "Issue 3(188267): While updating the iDRAC firmware, the idrac_firmware module completes execution before the firmware update job is completed. An incorrect message is displayed in the task output as 'DRAC WSMAN endpoint returned HTTP code '400' Reason 'Bad Request''. This issue may occur if the target iDRAC firmware version is less than 3.30.30.30" msgstr "Issue 3(188267): iDRACファームウェアã®æ›´æ–°ä¸ã«ã€idrac_firmwareモジュールã¯ã€ãƒ•ã‚¡ãƒ¼ãƒ ウェア更新ジョブãŒå®Œäº†ã™ã‚‹å‰ã«å®Ÿè¡Œã‚’完了ã—ã¾ã™ã€‚タスク出力ã«èª¤ã£ãŸãƒ¡ãƒƒã‚»ãƒ¼ã‚¸'DRAC WSMAN endpoint returned HTTP code '400' Reason 'Bad Request''ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚ã“ã®å•é¡Œã¯ã€ã‚¿ãƒ¼ã‚²ãƒƒãƒˆiDRACファームウェアãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒ3.30.30.30未満ã®å ´åˆã«ç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™" +#: ../../rst/porting_guides/porting_guide_3.rst:210 +msgid "ansible-galaxy login command has been removed ( see `issue 71560 <https://github.com/ansible/ansible/issues/71560>`_)" +msgstr "ansible-galaxy login コマンドãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(`issue 71560 <https://github.com/ansible/ansible/issues/71560>` ã‚’å‚ç…§))。" + #: ../../rst/porting_guides/porting_guide_3.rst:213 msgid "ansible.utils" msgstr "ansible.utils" @@ -6805,7 +6874,7 @@ msgid "archive - remove path folder itself when ``remove`` parameter is true (ht msgstr "archive - ``remove`` パラメーター㌠true ã®å ´åˆã«ãƒ‘スフォルダー自体を削除ã—ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.general/issues/1041）。" #: ../../rst/porting_guides/porting_guide_3.rst:265 -msgid "passwordstore lookup plugin - now parsing a password store entry as YAML if possible, skipping the first line (which by convention only contains the password and nothing else). If it cannot be parsed as YAML, the old ``key: value`` parser will be used to process the entry. Can break backwards compatibility if YAML formatted code was parsed in a non-YAML interpreted way, e.g. ``foo: [bar, baz]`` will become a list with two elements in the new version, but a string ``'[bar, baz]'`` in the old (https://github.com/ansible-collections/community.general/issues/1673)." +msgid "passwordstore lookup plugin - now parsing a password store entry as YAML if possible, skipping the first line (which by convention only contains the password and nothing else). If it cannot be parsed as YAML, the old ``key: value`` parser will be used to process the entry. Can break backwards compatibility if YAML formatted code was parsed in a non-YAML interpreted way, for example ``foo: [bar, baz]``, will become a list with two elements in the new version, but a string ``'[bar, baz]'`` in the old (https://github.com/ansible-collections/community.general/issues/1673)." msgstr "passwordstore lookup プラグイン - パスワードストアã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’å¯èƒ½ãªé™ã‚Š YAML ã¨ã—ã¦è§£æžã™ã‚‹ã‚ˆã†ã«ãªã‚Šã€æœ€åˆã®è¡Œ (慣例ã§ã¯ãƒ‘スワードã®ã¿ã‚’å«ã¿ã€ä»–ã«ã¯ä½•ã‚‚ãªã„) をスã‚ップã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚YAML ã¨ã—ã¦è§£æžã§ããªã„å ´åˆã¯ã€å¤ã„ ``key: value`` パーサーãŒã‚¨ãƒ³ãƒˆãƒªãƒ¼ã®å‡¦ç†ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚YAML å½¢å¼ã®ã‚³ãƒ¼ãƒ‰ãŒ YAML ã§ã¯ãªã„解釈方法ã§è§£æžã•ã‚ŒãŸå ´åˆã¯ã€ä¸‹ä½äº’æ›æ€§ã‚’失ã†å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€``foo: [bar, baz]`` ã¯æ–°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ 2 ã¤ã®è¦ç´ ã‚’æŒã¤ãƒªã‚¹ãƒˆã«ãªã‚Šã¾ã™ãŒã€æ—§ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯æ–‡å—列 ``'[bar, baz]'`` ã«ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/issues/1673)。" #: ../../rst/porting_guides/porting_guide_3.rst:268 @@ -6865,7 +6934,7 @@ msgid "ngine_io.cloudstack" msgstr "ngine_io.cloudstack" #: ../../rst/porting_guides/porting_guide_3.rst:317 -msgid "Authentication option using INI files e.g. ``cloudstack.ini`` has been removed. The only supported option to authenticate is by using the module params with fallback to the ENV variables." +msgid "Authentication option using INI files for example ``cloudstack.ini``, has been removed. The only supported option to authenticate is by using the module params with fallback to the ENV variables." msgstr "INI ファイル (例: ``cloudstack.ini``) を使用ã—ãŸèªè¨¼ã‚ªãƒ—ションã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ç¾åœ¨ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹èªè¨¼æ–¹æ³•ã¯ã€ENV 変数ã«ãƒ•ã‚©ãƒ¼ãƒ«ãƒãƒƒã‚¯ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‘ラメーターを使用ã™ã‚‹æ–¹æ³•ã®ã¿ã§ã™ã€‚" #: ../../rst/porting_guides/porting_guide_3.rst:318 @@ -6955,7 +7024,7 @@ msgid "k8s_* - Add support for vaulted kubeconfig and src (https://github.com/an msgstr "k8s_* - Vault 済㿠kubeconfig ãŠã‚ˆã³ src ã®ã‚µãƒãƒ¼ãƒˆã‚’è¿½åŠ ã—ã¾ã™ (https://github.com/ansible-collections/kubernetes.core/pull/193)。" #: ../../rst/porting_guides/porting_guide_3.rst:395 -msgid "k8s_exec - New module for executing commands on pods via Kubernetes API (https://github.com/ansible-collections/kubernetes.core/pull/14)." +msgid "k8s_exec - New module for executing commands on pods through Kubernetes API (https://github.com/ansible-collections/kubernetes.core/pull/14)." msgstr "k8s_exec - Kubernetes API を使用ã—㦠Pod ã§ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹æ–°è¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« (https://github.com/ansible-collections/kubernetes.core/pull/14)。" #: ../../rst/porting_guides/porting_guide_3.rst:396 @@ -7288,7 +7357,7 @@ msgstr "Ansible 4 移æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_4.rst:15 msgid "We suggest you read this page along with the `Ansible 4 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/4/CHANGELOG-v4.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 4 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/4/CHANGELOG-v4.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 4 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/4/CHANGELOG-v4.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:20 #: ../../rst/porting_guides/porting_guide_core_2.11.rst:23 @@ -7558,55 +7627,57 @@ msgstr "v4.10.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_4.rst:257 #: ../../rst/porting_guides/porting_guide_5.rst:375 #: ../../rst/porting_guides/porting_guide_5.rst:731 -#: ../../rst/porting_guides/porting_guide_6.rst:583 +#: ../../rst/porting_guides/porting_guide_6.rst:130 +#: ../../rst/porting_guides/porting_guide_6.rst:719 +#: ../../rst/porting_guides/porting_guide_7.rst:247 msgid "containers.podman" msgstr "containers.podman" #: ../../rst/porting_guides/porting_guide_4.rst:144 #: ../../rst/porting_guides/porting_guide_5.rst:377 -#: ../../rst/porting_guides/porting_guide_6.rst:585 +#: ../../rst/porting_guides/porting_guide_6.rst:721 msgid "Add podman_tag module" msgstr "podman_tag モジュールã®è¿½åŠ " #: ../../rst/porting_guides/porting_guide_4.rst:145 #: ../../rst/porting_guides/porting_guide_5.rst:378 -#: ../../rst/porting_guides/porting_guide_6.rst:586 +#: ../../rst/porting_guides/porting_guide_6.rst:722 msgid "Add secrets driver and driver opts support" msgstr "シークレットドライãƒãƒ¼ãŠã‚ˆã³ãƒ‰ãƒ©ã‚¤ãƒãƒ¼ã‚ªãƒ—ションã®ã‚µãƒãƒ¼ãƒˆã®è¿½åŠ " #: ../../rst/porting_guides/porting_guide_4.rst:153 #: ../../rst/porting_guides/porting_guide_5.rst:394 -#: ../../rst/porting_guides/porting_guide_6.rst:779 +#: ../../rst/porting_guides/porting_guide_6.rst:915 msgid "Deprecated nxos_snmp_community module." msgstr "nxos_snmp_community モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:154 #: ../../rst/porting_guides/porting_guide_5.rst:395 -#: ../../rst/porting_guides/porting_guide_6.rst:780 +#: ../../rst/porting_guides/porting_guide_6.rst:916 msgid "Deprecated nxos_snmp_contact module." msgstr "nxos_snmp_contact モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:155 #: ../../rst/porting_guides/porting_guide_5.rst:396 -#: ../../rst/porting_guides/porting_guide_6.rst:781 +#: ../../rst/porting_guides/porting_guide_6.rst:917 msgid "Deprecated nxos_snmp_host module." msgstr "nxos_snmp_host モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:156 #: ../../rst/porting_guides/porting_guide_5.rst:397 -#: ../../rst/porting_guides/porting_guide_6.rst:782 +#: ../../rst/porting_guides/porting_guide_6.rst:918 msgid "Deprecated nxos_snmp_location module." msgstr "nxos_snmp_location モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:157 #: ../../rst/porting_guides/porting_guide_5.rst:398 -#: ../../rst/porting_guides/porting_guide_6.rst:783 +#: ../../rst/porting_guides/porting_guide_6.rst:919 msgid "Deprecated nxos_snmp_traps module." msgstr "nxos_snmp_traps モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:158 #: ../../rst/porting_guides/porting_guide_5.rst:399 -#: ../../rst/porting_guides/porting_guide_6.rst:784 +#: ../../rst/porting_guides/porting_guide_6.rst:920 msgid "Deprecated nxos_snmp_user module." msgstr "nxos_snmp_user モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" @@ -7617,14 +7688,16 @@ msgstr "nxos_snmp_user モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:673 #: ../../rst/porting_guides/porting_guide_5.rst:413 #: ../../rst/porting_guides/porting_guide_5.rst:1022 -#: ../../rst/porting_guides/porting_guide_6.rst:619 -#: ../../rst/porting_guides/porting_guide_6.rst:821 +#: ../../rst/porting_guides/porting_guide_6.rst:755 +#: ../../rst/porting_guides/porting_guide_6.rst:957 +#: ../../rst/porting_guides/porting_guide_7.rst:671 +#: ../../rst/porting_guides/porting_guide_7.rst:912 msgid "junipernetworks.junos" msgstr "junipernetworks.junos" #: ../../rst/porting_guides/porting_guide_4.rst:163 #: ../../rst/porting_guides/porting_guide_5.rst:415 -#: ../../rst/porting_guides/porting_guide_6.rst:823 +#: ../../rst/porting_guides/porting_guide_6.rst:959 msgid "'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resuorce module." msgstr "junos_ospf_interfacesã€junos_ospfv2ã€ãŠã‚ˆã³ junos_ospfv3リソースモジュールã®'router_id' オプションãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚" @@ -7647,9 +7720,11 @@ msgstr "purefb_lag - å¿œç”ã® mac_address フィールドã«å€¤ãŒåæ˜ ã•ã‚Œã #: ../../rst/porting_guides/porting_guide_5.rst:143 #: ../../rst/porting_guides/porting_guide_5.rst:223 #: ../../rst/porting_guides/porting_guide_5.rst:746 -#: ../../rst/porting_guides/porting_guide_6.rst:131 -#: ../../rst/porting_guides/porting_guide_6.rst:602 -#: ../../rst/porting_guides/porting_guide_7.rst:278 +#: ../../rst/porting_guides/porting_guide_6.rst:142 +#: ../../rst/porting_guides/porting_guide_6.rst:267 +#: ../../rst/porting_guides/porting_guide_6.rst:738 +#: ../../rst/porting_guides/porting_guide_7.rst:253 +#: ../../rst/porting_guides/porting_guide_7.rst:657 msgid "fortinet.fortios" msgstr "fortinet.fortios" @@ -7683,13 +7758,12 @@ msgid "Porting Guide for v4.8.0" msgstr "v4.8.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_4.rst:197 -#: ../../rst/porting_guides/porting_guide_5.rst:575 -msgid "all roles now reference other roles and modules via their fully qualified collection names, which makes Ansible 2.10 minimum supported version for roles (See https://github.com/ansible-collections/community.zabbix/pull/477)." -msgstr "ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã¯ã€å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã§ä»–ã®ãƒãƒ¼ãƒ«ãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å‚ç…§ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒãƒ¼ãƒ«ã®Ansible 2.10 最低サãƒãƒ¼ãƒˆãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’作æˆã—ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.zabbix/pull/477ã‚’å‚ç…§ã—ã¦ãã ã•ã„）。" +msgid "all roles now reference other roles and modules through their fully qualified collection names, which makes Ansible 2.10 minimum supported version for roles (see `issue 477 <https://github.com/ansible-collections/community.zabbix/pull/477>`_)." +msgstr "ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã¯ã€å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã§ä»–ã®ãƒãƒ¼ãƒ«ãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å‚ç…§ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒãƒ¼ãƒ«ã®Ansible 2.10 最低サãƒãƒ¼ãƒˆãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’作æˆã—ã¾ã™ (`issue 477 <https://github.com/ansible-collections/community.zabbix/pull/477>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„)。" #: ../../rst/porting_guides/porting_guide_4.rst:203 #: ../../rst/porting_guides/porting_guide_5.rst:943 -#: ../../rst/porting_guides/porting_guide_7.rst:340 +#: ../../rst/porting_guides/porting_guide_7.rst:781 msgid "community.azure" msgstr "community.azure" @@ -7744,10 +7818,13 @@ msgstr "誤ã£ã¦ãƒªãƒã‚¸ãƒˆãƒªãƒ¼ãŒ 2.0.0 ã«ã‚¿ã‚°ä»˜ã‘ã•ã‚Œã¾ã—ãŸã€‚ã #: ../../rst/porting_guides/porting_guide_5.rst:248 #: ../../rst/porting_guides/porting_guide_5.rst:292 #: ../../rst/porting_guides/porting_guide_5.rst:908 -#: ../../rst/porting_guides/porting_guide_6.rst:217 -#: ../../rst/porting_guides/porting_guide_6.rst:470 -#: ../../rst/porting_guides/porting_guide_6.rst:771 -#: ../../rst/porting_guides/porting_guide_7.rst:468 +#: ../../rst/porting_guides/porting_guide_6.rst:353 +#: ../../rst/porting_guides/porting_guide_6.rst:606 +#: ../../rst/porting_guides/porting_guide_6.rst:907 +#: ../../rst/porting_guides/porting_guide_7.rst:164 +#: ../../rst/porting_guides/porting_guide_7.rst:561 +#: ../../rst/porting_guides/porting_guide_7.rst:736 +#: ../../rst/porting_guides/porting_guide_7.rst:992 msgid "cisco.ios" msgstr "cisco.ios" @@ -7842,7 +7919,9 @@ msgstr "v4.4.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_4.rst:325 #: ../../rst/porting_guides/porting_guide_4.rst:635 #: ../../rst/porting_guides/porting_guide_5.rst:915 -#: ../../rst/porting_guides/porting_guide_6.rst:477 +#: ../../rst/porting_guides/porting_guide_6.rst:613 +#: ../../rst/porting_guides/porting_guide_7.rst:567 +#: ../../rst/porting_guides/porting_guide_7.rst:745 msgid "cisco.iosxr" msgstr "cisco.iosxr" @@ -7870,7 +7949,9 @@ msgstr "junos_logging モジュールãŒéžæŽ¨å¥¨ã¨ãªã‚Šã€'2023-08-01' ã®å¾Œ #: ../../rst/porting_guides/porting_guide_4.rst:696 #: ../../rst/porting_guides/porting_guide_5.rst:284 #: ../../rst/porting_guides/porting_guide_5.rst:1029 -#: ../../rst/porting_guides/porting_guide_6.rst:637 +#: ../../rst/porting_guides/porting_guide_6.rst:773 +#: ../../rst/porting_guides/porting_guide_7.rst:676 +#: ../../rst/porting_guides/porting_guide_7.rst:925 msgid "vyos.vyos" msgstr "vyos.vyos" @@ -8012,7 +8093,7 @@ msgstr "モニター API ã®ã‚¹ã‚ーマã®çµ±ä¸€" #: ../../rst/porting_guides/porting_guide_4.rst:467 #: ../../rst/porting_guides/porting_guide_5.rst:787 -msgid "packages is now a required Python package and gets installed via Ansible 2.10+." +msgid "packages is now a required Python package and gets installed through Ansible 2.10+." msgstr "パッケージãŒå¿…è¦ãª Python パッケージã«ãªã‚Šã€Ansible 2.10 以é™ã‹ã‚‰ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_4.rst:475 @@ -8129,21 +8210,23 @@ msgstr "v4.0.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:597 #: ../../rst/porting_guides/porting_guide_5.rst:803 #: ../../rst/porting_guides/porting_guide_5.rst:875 -#: ../../rst/porting_guides/porting_guide_6.rst:258 -#: ../../rst/porting_guides/porting_guide_6.rst:298 -#: ../../rst/porting_guides/porting_guide_6.rst:435 -#: ../../rst/porting_guides/porting_guide_6.rst:657 -#: ../../rst/porting_guides/porting_guide_6.rst:758 -#: ../../rst/porting_guides/porting_guide_7.rst:131 -#: ../../rst/porting_guides/porting_guide_7.rst:198 -#: ../../rst/porting_guides/porting_guide_7.rst:298 -#: ../../rst/porting_guides/porting_guide_7.rst:434 +#: ../../rst/porting_guides/porting_guide_6.rst:394 +#: ../../rst/porting_guides/porting_guide_6.rst:434 +#: ../../rst/porting_guides/porting_guide_6.rst:571 +#: ../../rst/porting_guides/porting_guide_6.rst:793 +#: ../../rst/porting_guides/porting_guide_6.rst:894 +#: ../../rst/porting_guides/porting_guide_7.rst:108 +#: ../../rst/porting_guides/porting_guide_7.rst:132 +#: ../../rst/porting_guides/porting_guide_7.rst:309 +#: ../../rst/porting_guides/porting_guide_7.rst:473 +#: ../../rst/porting_guides/porting_guide_7.rst:689 +#: ../../rst/porting_guides/porting_guide_7.rst:944 msgid "Ansible-core" msgstr "Ansible-core" #: ../../rst/porting_guides/porting_guide_4.rst:525 -msgid "ansible-test - The ``pylint`` sanity test no longer correctly detects \"bad\" variable names for non-constants. See https://github.com/PyCQA/pylint/issues/3701 for additional details." -msgstr "ansible-test - ``pylint`` å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¯ã€éžåˆ¶ç´„ã®ãŸã‚\"bad\" 変数åã‚’æ£ã—ã検出ã—ãªããªã‚Šã¾ã—ãŸã€‚詳細ã¯ã€https://github.com/PyCQA/pylint/issues/3701 ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "ansible-test - The ``pylint`` sanity test no longer correctly detects \"bad\" variable names for non-constants. See `issue 3701 <https://github.com/PyCQA/pylint/issues/3701>`_ for additional details." +msgstr "ansible-test - ``pylint`` å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã¯ã€éžåˆ¶ç´„ã®ãŸã‚\"bad\" 変数åã‚’æ£ã—ã検出ã—ãªããªã‚Šã¾ã—ãŸã€‚詳細ã¯ã€`issue 3701 <https://github.com/PyCQA/pylint/issues/3701>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_4.rst:538 msgid "Modules for monitor API are not versioned yet." @@ -8165,6 +8248,10 @@ msgstr "ツリー内ã®ä¾å˜é–¢ä¿‚リゾルãƒãƒ¼ãŒã€pip> = 20.3ãŒãƒ‡ãƒ•ã‚©ã msgid "The ``meta`` module now supports tags for user-defined tasks. Internal ``meta`` tasks continue to always run. (https://github.com/ansible/ansible/issues/64558)" msgstr "``meta`` モジュールã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼å®šç¾©ã®ã‚¿ã‚¹ã‚¯ã®ã‚¿ã‚°ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚内部 ``meta`` タスクã¯å¸¸ã«å®Ÿè¡Œã•ã‚Œã¾ã™ï¼ˆhttps://github.com/ansible/ansible/issues/64558）。" +#: ../../rst/porting_guides/porting_guide_4.rst:550 +msgid "ansible-galaxy login command has been removed (see `issue 71560 <https://github.com/ansible/ansible/issues/71560>`_)" +msgstr "ansible-galaxy login コマンドãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(`issue 71560 <https://github.com/ansible/ansible/issues/71560>`_ ã‚’å‚ç…§)。" + #: ../../rst/porting_guides/porting_guide_4.rst:555 msgid "Removed vendored ipaddress package from collection. If you use ansible_collections.ansible.netcommon.plugins.module_utils.compat.ipaddress in your collection, you will need to change this to import ipaddress instead. If your content using ipaddress supports Python 2.7, you will additionally need to make sure that the user has the ipaddress package installed. Please refer to https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_best_practices.html#importing-and-using-shared-code to see how to safely import external packages that may be missing from the user's system A backport of ipaddress for Python 2.7 is available at https://pypi.org/project/ipaddress/" msgstr "コレクションã‹ã‚‰ãƒ™ãƒ³ãƒ€ãƒ¼åŒ–ã•ã‚ŒãŸ ipaddress パッケージãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚コレクションã®ansible_collections.ansible.netcommon.plugins.module_utils.compat.ipaddress を使用ã™ã‚‹å ´åˆã¯ã€ä»£ã‚ã‚Šã« ipaddress をインãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã«ã“れを変更ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ipaddress を使用ã™ã‚‹ã‚³ãƒ³ãƒ†ãƒ³ãƒ„㌠Python 2.7 ã«å¯¾å¿œã—ã¦ã„ã‚‹å ´åˆã¯ã€ã•ã‚‰ã«ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒ ipaddress パッケージãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ユーザーã®ã‚·ã‚¹ãƒ†ãƒ A ã«æ¬ è½ã—ã¦ã„ã‚‹å¯èƒ½æ€§ã®ã‚る外部パッケージを安全ã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦ã¯ã€https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_best_practices.html#importing-and-using-shared-codeã‚’å‚ç…§ã—ã¦ãã ã•ã„。Python 2.7用ã®ipaddressã®ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã¯ã€https://pypi.org/project/ipaddress/ã§åˆ©ç”¨ã§ãã¾ã™ã€‚" @@ -8248,8 +8335,9 @@ msgstr "netconf_config ã‹ã‚‰éžæŽ¨å¥¨ã®æŽ¥ç¶šå¼•æ•°ã‚’削除" #: ../../rst/porting_guides/porting_guide_4.rst:618 #: ../../rst/porting_guides/porting_guide_5.rst:493 #: ../../rst/porting_guides/porting_guide_5.rst:903 -#: ../../rst/porting_guides/porting_guide_6.rst:331 -#: ../../rst/porting_guides/porting_guide_6.rst:452 +#: ../../rst/porting_guides/porting_guide_6.rst:467 +#: ../../rst/porting_guides/porting_guide_6.rst:588 +#: ../../rst/porting_guides/porting_guide_7.rst:527 msgid "arista.eos" msgstr "arista.eos" @@ -8258,7 +8346,8 @@ msgid "Requires ansible.netcommon v2.0.0+ to support `ansible_network_single_use msgstr "`ansible_network_single_user_mode` ãŠã‚ˆã³ `ansible_network_import_modules` をサãƒãƒ¼ãƒˆã™ã‚‹ã«ã¯ã€ansible.netcommon v2.0.0 以é™ãŒå¿…è¦ã§ã™ã€‚詳細ã¯ã€ansible.netcommon ã® `changelog <https://github.com/ansible-collections/ansible.netcommon/blob/main/changelogs/CHANGELOG.rst#ansible-netcommon-collection-release-notes>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_4.rst:623 -#: ../../rst/porting_guides/porting_guide_6.rst:464 +#: ../../rst/porting_guides/porting_guide_6.rst:600 +#: ../../rst/porting_guides/porting_guide_7.rst:550 msgid "cisco.asa" msgstr "cisco.asa" @@ -8773,7 +8862,7 @@ msgstr "Ansible 5 㯠Ansible-core 2.12 をベースã«ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:18 msgid "We suggest you read this page along with the `Ansible 5 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/5/CHANGELOG-v5.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 5 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/5/CHANGELOG-v5.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible 5 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/5/CHANGELOG-v5.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:24 #: ../../rst/porting_guides/porting_guide_core_2.12.rst:22 @@ -8861,9 +8950,8 @@ msgid "Set theory filters (``intersect``, ``difference``, ``symmetric_difference msgstr "ç†è«–フィルター（``intersect``ã€``difference``ã€``symmetric_difference``ã€ãŠã‚ˆã³ ``union``）ã®è¨å®šã¯ã€å¤§æ–‡å—ã¨å°æ–‡å—ãŒåŒºåˆ¥ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚明示的㪠``case_sensitive=False`` を使用ã—ã¦ä»¥å‰ã®å‹•ä½œã‚’ç¶æŒã—ã¾ã™ã€‚2.10 よりå‰ã® Jinja2 ã§ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã¯ã™ã§ã«å¤§æ–‡å—ã¨å°æ–‡å—を区別ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:117 -#: ../../rst/porting_guides/porting_guide_core_2.12.rst:115 -msgid "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, e.g. ``bcrypt_sha256`` now default to the \"2b\" format and if the \"2a\" format is required it must be specified." -msgstr "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, e.g. ``bcrypt_sha256`` ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€Œ2bã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã«ãªã‚Šã€ã€Œ2aã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆãŒå¿…è¦ãªå ´åˆã¯æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" +msgid "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, for example ``bcrypt_sha256``, now default to the \"2b\" format and if the \"2a\" format is required it must be specified." +msgstr "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, for example ``bcrypt_sha256`` ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€Œ2bã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã«ãªã‚Šã€ã€Œ2aã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆãŒå¿…è¦ãªå ´åˆã¯æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:131 msgid "Porting Guide for v5.9.0" @@ -8873,52 +8961,55 @@ msgstr "v5.9.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:164 #: ../../rst/porting_guides/porting_guide_5.rst:240 #: ../../rst/porting_guides/porting_guide_5.rst:429 -#: ../../rst/porting_guides/porting_guide_6.rst:106 -#: ../../rst/porting_guides/porting_guide_6.rst:146 -#: ../../rst/porting_guides/porting_guide_6.rst:178 -#: ../../rst/porting_guides/porting_guide_6.rst:247 +#: ../../rst/porting_guides/porting_guide_6.rst:158 +#: ../../rst/porting_guides/porting_guide_6.rst:242 +#: ../../rst/porting_guides/porting_guide_6.rst:282 +#: ../../rst/porting_guides/porting_guide_6.rst:314 +#: ../../rst/porting_guides/porting_guide_6.rst:383 #: ../../rst/porting_guides/porting_guide_7.rst:99 +#: ../../rst/porting_guides/porting_guide_7.rst:218 +#: ../../rst/porting_guides/porting_guide_7.rst:269 msgid "Added Collections" msgstr "コレクションã®è¿½åŠ " #: ../../rst/porting_guides/porting_guide_5.rst:136 -#: ../../rst/porting_guides/porting_guide_6.rst:249 +#: ../../rst/porting_guides/porting_guide_6.rst:385 msgid "cisco.dnac (version 6.4.0)" msgstr "cisco.dnac (version 6.4.0)" #: ../../rst/porting_guides/porting_guide_5.rst:137 -#: ../../rst/porting_guides/porting_guide_6.rst:251 +#: ../../rst/porting_guides/porting_guide_6.rst:387 msgid "community.sap_libs (version 1.1.0)" msgstr "community.sap_libs (version 1.1.0)" #: ../../rst/porting_guides/porting_guide_5.rst:145 #: ../../rst/porting_guides/porting_guide_5.rst:225 -#: ../../rst/porting_guides/porting_guide_6.rst:604 +#: ../../rst/porting_guides/porting_guide_6.rst:740 msgid "Support FortiOS 7.0.2, 7.0.3, 7.0.4, 7.0.5." msgstr "FortiOS 7.0.2ã€7.0.3ã€7.0.4ã€7.0.5 をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:150 -#: ../../rst/porting_guides/porting_guide_6.rst:755 +#: ../../rst/porting_guides/porting_guide_6.rst:891 msgid "The collection ``community.sap`` has been renamed to ``community.sap_libs``. For now both collections are included in Ansible. The content in ``community.sap`` will be replaced with deprecated redirects to the new collection in Ansible 7.0.0, and these redirects will eventually be removed from Ansible. Please update your FQCNs for ``community.sap``." msgstr "コレクション ``community.sap`` ã®åå‰ãŒ ``community.sap_libs`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚両方ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŒ Ansible ã«å«ã¾ã‚Œã¦ã„ã¾ã™ã€‚``community.sap`` ã®å†…容ã¯ã€Ansible 7.0.0 ã®æ–°ã—ã„コレクションã¸ã®éžæŽ¨å¥¨ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚ã“れらã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯ã€æœ€çµ‚çš„ã« Ansible ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚``community.sap`` ã® FQCN ã‚’æ›´æ–°ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_5.rst:155 -#: ../../rst/porting_guides/porting_guide_6.rst:789 +#: ../../rst/porting_guides/porting_guide_6.rst:925 msgid "Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.docker 3.0.0). Some modules might still work with these versions afterwards, but we will no longer keep compatibility code that was needed to support them (https://github.com/ansible-collections/community.docker/pull/361)." msgstr "Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã«ãªã‚Šã€æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ (community.docker 3.0.0) ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚モジュールã«ã‚ˆã£ã¦ã¯ã€ãã®å¾Œã‚‚ã“れらã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã動作ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€ã‚µãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã«å¿…è¦ãªäº’æ›æ€§ã‚³ãƒ¼ãƒ‰ã¯ä¿æŒã•ã‚Œãªããªã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/361)。" #: ../../rst/porting_guides/porting_guide_5.rst:156 -#: ../../rst/porting_guides/porting_guide_6.rst:790 +#: ../../rst/porting_guides/porting_guide_6.rst:926 msgid "The dependency on docker-compose for Execution Environments is deprecated and will be removed in community.docker 3.0.0. The `Python docker-compose library <https://pypi.org/project/docker-compose/>`__ is unmaintained and can cause dependency issues. You can manually still install it in an Execution Environment when needed (https://github.com/ansible-collections/community.docker/pull/373)." msgstr "実行環境㮠docker-compose ã¸ã®ä¾å˜ã¯éžæŽ¨å¥¨ã«ãªã‚Šã€community.docker3.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`Python docker-compose library <https://pypi.org/project/docker-compose/>`__ ã¯ä¿å®ˆã•ã‚Œã¦ãŠã‚‰ãšã€ä¾å˜é–¢ä¿‚ã®å•é¡Œã‚’引ãèµ·ã“ã™å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚å¿…è¦ã«å¿œã˜ã¦ã€å®Ÿè¡Œç’°å¢ƒã«æ‰‹å‹•ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ (https://github.com/ansible-collections/community.docker/pull/373)。" #: ../../rst/porting_guides/porting_guide_5.rst:157 -#: ../../rst/porting_guides/porting_guide_6.rst:791 +#: ../../rst/porting_guides/porting_guide_6.rst:927 msgid "Various modules - the default of ``tls_hostname`` that was supposed to be removed in community.docker 2.0.0 will now be removed in version 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362)." msgstr "ã•ã¾ã–ã¾ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« - community.docker 2.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã‚ã£ãŸ ``tls_hostname`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362) ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:158 -#: ../../rst/porting_guides/porting_guide_6.rst:792 +#: ../../rst/porting_guides/porting_guide_6.rst:928 msgid "docker_stack - the return values ``out`` and ``err`` that were supposed to be removed in community.docker 2.0.0 will now be removed in version 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362)." msgstr "docker_stack - community.docker 2.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã‚ã£ãŸæˆ»ã‚Šå€¤ ``out`` ãŠã‚ˆã³ ``err`` ãŒã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362) ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚" @@ -8927,9 +9018,9 @@ msgid "Porting Guide for v5.8.0" msgstr "v5.8.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:166 -#: ../../rst/porting_guides/porting_guide_6.rst:252 +#: ../../rst/porting_guides/porting_guide_6.rst:388 msgid "vmware.vmware_rest (version 2.1.5)" -msgstr "vmware.vmware_rest (version 2.1.5)" +msgstr "vmware.vmware_rest (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.1.5)" #: ../../rst/porting_guides/porting_guide_5.rst:172 #: ../../rst/porting_guides/porting_guide_5.rst:205 @@ -8949,22 +9040,22 @@ msgid "vcenter_vm_storage_policy - the module has a new mandatory paramter: ``vm msgstr "vcenter_vm_storage_policy - モジュールã«ã¯ã€å¿…é ˆã®ãƒ‘ラメーターãŒæ–°ãŸã«è¿½åŠ ã•ã‚Œã¾ã—㟠(``vm_home``)。" #: ../../rst/porting_guides/porting_guide_5.rst:184 -#: ../../rst/porting_guides/porting_guide_6.rst:561 +#: ../../rst/porting_guides/porting_guide_6.rst:697 msgid "The community.mysql collection no longer supports ``Ansible 2.9`` and ``ansible-base 2.10``. While we take no active measures to prevent usage and there are no plans to introduce incompatible code to the modules, we will stop testing against ``Ansible 2.9`` and ``ansible-base 2.10``. Both will very soon be End of Life and if you are still using them, you should consider upgrading to the ``latest Ansible / ansible-core 2.11 or later`` as soon as possible (https://github.com/ansible-collections/community.mysql/pull/343)." msgstr "community.mysql コレクション㯠``Ansible 2.9`` ãŠã‚ˆã³ ``ansible-base 2.10`` をサãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—ãŸã€‚使用を防ããŸã‚ã®ç©æ¥µçš„ãªæŽªç½®ã¯è¬›ã˜ã¦ãŠã‚‰ãšã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«äº’æ›æ€§ã®ãªã„コードを導入ã™ã‚‹äºˆå®šã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€``Ansible 2.9`` ãŠã‚ˆã³ ``ansible-base 2.10`` ã«å¯¾ã™ã‚‹ãƒ†ã‚¹ãƒˆã¯åœæ¢ã—ã¾ã™ã€‚ã©ã¡ã‚‰ã‚‚é–“ã‚‚ãªãライフサイクル終了日ã«é”ã—ã¾ã™ã€‚使用を継続ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã§ãã‚‹ã ã‘æ—©ã ``latest Ansible / ansible-core 2.11 or later`` ã¸ã®ã‚¢ãƒƒãƒ—グレードを検討ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.mysql/pull/343)。" #: ../../rst/porting_guides/porting_guide_5.rst:189 -#: ../../rst/porting_guides/porting_guide_6.rst:571 +#: ../../rst/porting_guides/porting_guide_6.rst:707 msgid "The community.postgresql collection no longer supports ``Ansible 2.9`` and ``ansible-base 2.10``. While we take no active measures to prevent usage and there are no plans to introduce incompatible code to the modules, we will stop testing against ``Ansible 2.9`` and ``ansible-base 2.10``. Both will very soon be End of Life and if you are still using them, you should consider upgrading to the ``latest Ansible / ansible-core 2.11 or later`` as soon as possible (https://github.com/ansible-collections/community.postgresql/pull/245)." msgstr "community.postgresql コレクション㯠``Ansible 2.9`` ãŠã‚ˆã³ ``ansible-base 2.10`` をサãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—ãŸã€‚使用を防ããŸã‚ã®ç©æ¥µçš„ãªæŽªç½®ã¯è¬›ã˜ã¦ãŠã‚‰ãšã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«äº’æ›æ€§ã®ãªã„コードを導入ã™ã‚‹äºˆå®šã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€``Ansible 2.9`` ãŠã‚ˆã³ ``ansible-base 2.10`` ã«å¯¾ã™ã‚‹ãƒ†ã‚¹ãƒˆã¯åœæ¢ã—ã¾ã™ã€‚ã©ã¡ã‚‰ã‚‚é–“ã‚‚ãªãライフサイクル終了日ã«é”ã—ã¾ã™ã€‚使用を継続ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã§ãã‚‹ã ã‘æ—©ã ``latest Ansible / ansible-core 2.11 or later`` ã¸ã®ã‚¢ãƒƒãƒ—グレードを検討ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.postgresql/pull/245)。" #: ../../rst/porting_guides/porting_guide_5.rst:197 -#: ../../rst/porting_guides/porting_guide_6.rst:812 +#: ../../rst/porting_guides/porting_guide_6.rst:948 msgid "token_validate options - the shared auth option ``token_validate`` will change its default from ``True`` to ``False`` in community.hashi_vault version 4.0.0. The ``vault_login`` lookup and module will keep the default value of ``True`` (https://github.com/ansible-collections/community.hashi_vault/issues/248)." msgstr "token_validate オプション - 共有èªè¨¼ã‚ªãƒ—ション ``token_validate`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€community.hashi_vault ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 4.0.0 㧠``True`` ã‹ã‚‰ ``False`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚``vault_login`` ルックアップãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã® ``True`` ã‚’ä¿æŒã—ã¾ã™ (https://github.com/ansible-collections/community.hashi_vault/issues/248)。" #: ../../rst/porting_guides/porting_guide_5.rst:202 -#: ../../rst/porting_guides/porting_guide_6.rst:818 +#: ../../rst/porting_guides/porting_guide_6.rst:954 msgid "Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.network 4.0.0) this spring. While most content will probably still work with ansible-base 2.10, we will remove symbolic links for modules and action plugins, which will make it impossible to use them with Ansible 2.9 anymore. Please use community.network 3.x.y with Ansible 2.9 and ansible-base 2.10, as these releases will continue to support Ansible 2.9 and ansible-base 2.10 even after they are End of Life (https://github.com/ansible-community/community-topics/issues/50, https://github.com/ansible-collections/community.network/pull/382)." msgstr "Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã«ãªã‚Šã€ä»Šæ˜¥ã®æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ (community.network 4.0.0) ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚ã»ã¨ã‚“ã©ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„㯠ansible-base 2.10 ã§å¼•ã続ã機能ã™ã‚‹ã¨äºˆæƒ³ã•ã‚Œã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŠã‚ˆã³ action プラグインã®ã‚·ãƒ³ãƒœãƒªãƒƒã‚¯ãƒªãƒ³ã‚¯ã¯å‰Šé™¤ã•ã‚Œã€Ansible 2.9 ã§ã¯ä½¿ç”¨ã§ããªã„よã†ã«ãªã‚Šã¾ã™ã€‚ Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã§ã¯ community.network 3.x.y を使用ã—ã¦ãã ã•ã„。ライフサイクル終了後ã§ã‚‚ã€ã“れらã®ãƒªãƒªãƒ¼ã‚¹ã¯ Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆã‚’継続ã™ã‚‹ãŸã‚ã§ã™ (https://github.com/ansible-community/community-topics/issues/50ã€https://github.com/ansible-collections/community.network/pull/382)。" @@ -8985,17 +9076,17 @@ msgid "Porting Guide for v5.7.0" msgstr "v5.7.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:220 -#: ../../rst/porting_guides/porting_guide_6.rst:575 +#: ../../rst/porting_guides/porting_guide_6.rst:711 msgid "postgresql_user - the ``priv`` argument has been deprecated and will be removed in ``community.postgresql 3.0.0``. Please use the ``postgresql_privs`` module to grant/revoke privileges instead (https://github.com/ansible-collections/community.postgresql/issues/212)." msgstr "postgresql_user - ``priv`` 引数ã¯éžæŽ¨å¥¨ã«ãªã‚Šã€``community.postgresql 3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚権é™ã‚’付与/å–り消ã™ã«ã¯ã€ä»£ã‚ã‚Šã« ``postgresql_privs``を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/212)。" #: ../../rst/porting_guides/porting_guide_5.rst:233 -#: ../../rst/porting_guides/porting_guide_6.rst:802 +#: ../../rst/porting_guides/porting_guide_6.rst:938 msgid "nmcli - deprecate default hairpin mode for a bridge. This so we can change it to ``false`` in community.general 7.0.0, as this is also the default in ``nmcli`` (https://github.com/ansible-collections/community.general/pull/4334)." msgstr "nmcli - ブリッジã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ hairpin モードをéžæŽ¨å¥¨ã«ã—ã¾ã™ã€‚ã—ãŸãŒã£ã¦ã€community.general 7.0.0 ã§ã¯ã“れを ``false`` ã«å¤‰æ›´ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€``nmcli`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚‚ã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/4334)。" #: ../../rst/porting_guides/porting_guide_5.rst:234 -#: ../../rst/porting_guides/porting_guide_6.rst:804 +#: ../../rst/porting_guides/porting_guide_6.rst:940 msgid "proxmox inventory plugin - the current default ``true`` of the ``want_proxmox_nodes_ansible_host`` option has been deprecated. The default will change to ``false`` in community.general 6.0.0. To keep the current behavior, explicitly set ``want_proxmox_nodes_ansible_host`` to ``true`` in your inventory configuration. We suggest to already switch to the new behavior by explicitly setting it to ``false``, and by using ``compose:`` to set ``ansible_host`` to the correct value. See the examples in the plugin documentation for details (https://github.com/ansible-collections/community.general/pull/4466)." msgstr "proxmox インベントリープラグイン - ``want_proxmox_nodes_ansible_host`` オプションã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ ``true`` ãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚community.general 6.0.0 ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒ ``false`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚ç¾åœ¨ã®å‹•ä½œã‚’ç¶æŒã™ã‚‹ã«ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼è¨å®šã§ ``want_proxmox_nodes_ansible_host`` を明示的㫠``true`` ã«è¨å®šã—ã¾ã™ã€‚明示的㫠``false`` ã«è¨å®šã—ã€``compose:`` を使用ã—㦠``ansible_host`` ã‚’æ£ã—ã„値ã«è¨å®šã™ã‚‹ã“ã¨ã§æ–°ã—ã„動作ã«åˆ‡ã‚Šæ›¿ãˆã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚詳細ã¯ã€ãƒ—ラグインドã‚ュメントã®ä¾‹ (https://github.com/ansible-collections/community.general/pull/4466) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -9004,12 +9095,12 @@ msgid "Porting Guide for v5.6.0" msgstr "v5.6.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:242 -#: ../../rst/porting_guides/porting_guide_6.rst:250 +#: ../../rst/porting_guides/porting_guide_6.rst:386 msgid "community.sap (version 1.0.0)" msgstr "community.sap (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.0.0)" #: ../../rst/porting_guides/porting_guide_5.rst:250 -#: ../../rst/porting_guides/porting_guide_6.rst:773 +#: ../../rst/porting_guides/porting_guide_6.rst:909 msgid "Deprecates lldp module." msgstr "lldp モジュールãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã™ã€‚" @@ -9018,17 +9109,17 @@ msgid "Porting Guide for v5.5.0" msgstr "v5.5.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:261 -#: ../../rst/porting_guides/porting_guide_6.rst:270 +#: ../../rst/porting_guides/porting_guide_6.rst:406 msgid "pacman - ``update_cache`` cannot differentiate between up to date and outdated package lists and will report ``changed`` in both situations (https://github.com/ansible-collections/community.general/pull/4318)." msgstr "pacman - ``update_cache`` ã¯æœ€æ–°ã®ãƒ‘ッケージ一覧ã¨å¤ã„パッケージ一覧を区別ã§ããšã€ä¸¡æ–¹ã®çŠ¶æ³ã§ ``changed`` ã‚’å ±å‘Šã—ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.general/pull/4318）。" #: ../../rst/porting_guides/porting_guide_5.rst:262 -#: ../../rst/porting_guides/porting_guide_6.rst:271 +#: ../../rst/porting_guides/porting_guide_6.rst:407 msgid "pacman - binaries specified in the ``executable`` parameter must support ``--print-format`` in order to be used by this module. In particular, AUR helper ``yay`` is known not to currently support it (https://github.com/ansible-collections/community.general/pull/4312)." msgstr "pacman - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«ã¯ã€``executable`` パラメーターã§æŒ‡å®šã•ã‚ŒãŸãƒã‚¤ãƒŠãƒªãƒ¼ã¯ ``--print-format`` をサãƒãƒ¼ãƒˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚特ã«ã€AUR ヘルパー ``yay`` ã¯ç¾åœ¨ã‚µãƒãƒ¼ãƒˆã—ã¦ã„ãªã„ã“ã¨ãŒçŸ¥ã‚‰ã‚Œã¦ã„ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.general/pull/4312）。" #: ../../rst/porting_guides/porting_guide_5.rst:270 -#: ../../rst/porting_guides/porting_guide_6.rst:803 +#: ../../rst/porting_guides/porting_guide_6.rst:939 msgid "pacman - from community.general 5.0.0 on, the ``changed`` status of ``update_cache`` will no longer be ignored if ``name`` or ``upgrade`` is specified. To keep the old behavior, add something like ``register: result`` and ``changed_when: result.packages | length > 0`` to your task (https://github.com/ansible-collections/community.general/pull/4329)." msgstr "pacman - community.general 5.0.0 ã‹ã‚‰ã€``name`` ã¾ãŸã¯ ``upgrade`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ ``update_cache`` ã®``changed``ステータスã¯ç„¡è¦–ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚以å‰ã®å‹•ä½œã‚’ç¶æŒã™ã‚‹ã«ã¯ã€``register: result`` ãŠã‚ˆã³``changed_when: result.packages | length > 0``をタスクã«è¿½åŠ ã—ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.general/pull/4329）。" @@ -9037,24 +9128,25 @@ msgid "Porting Guide for v5.4.0" msgstr "v5.4.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:279 -#: ../../rst/porting_guides/porting_guide_6.rst:202 -#: ../../rst/porting_guides/porting_guide_6.rst:459 -#: ../../rst/porting_guides/porting_guide_7.rst:217 +#: ../../rst/porting_guides/porting_guide_6.rst:338 +#: ../../rst/porting_guides/porting_guide_6.rst:595 +#: ../../rst/porting_guides/porting_guide_7.rst:146 +#: ../../rst/porting_guides/porting_guide_7.rst:159 +#: ../../rst/porting_guides/porting_guide_7.rst:544 msgid "chocolatey.chocolatey" msgstr "chocolatey.chocolatey" #: ../../rst/porting_guides/porting_guide_5.rst:281 -#: ../../rst/porting_guides/porting_guide_6.rst:461 +#: ../../rst/porting_guides/porting_guide_6.rst:597 msgid "win_chocolatey - Added choco_args option to pass additional arguments directly to Chocolatey." msgstr "win_chocolatey - è¿½åŠ ã®å¼•æ•°ã‚’直接 Chocolatey ã«æ¸¡ã™ãŸã‚ã« choco_args オプションãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:286 -#: ../../rst/porting_guides/porting_guide_6.rst:639 +#: ../../rst/porting_guides/porting_guide_6.rst:775 msgid "Add 'pool' as value to server key in ntp_global." msgstr "ntp_global ã®ã‚µãƒ¼ãƒãƒ¼ã‚ーã«ã€Œpoolã€ãŒå€¤ã¨ã—ã¦è¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:294 -#: ../../rst/porting_guides/porting_guide_6.rst:774 msgid "`ios_acls` - Deprecated fragment attribute added boolean alternate as enable_fragment." msgstr "`ios_acls` - éžæŽ¨å¥¨ã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆå±žæ€§ã«ã‚ˆã‚Šã€enable_fragment ã¨ã—ã¦ãƒ–ール値代替ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" @@ -9063,17 +9155,17 @@ msgid "Porting Guide for v5.3.0" msgstr "v5.3.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:305 -#: ../../rst/porting_guides/porting_guide_6.rst:598 +#: ../../rst/porting_guides/porting_guide_6.rst:734 msgid "bigip_device_info - pagination logic has also been added to help with api stability." msgstr "bigip_device_info - API ã®å®‰å®šæ€§ã«å½¹ç«‹ã¤ãƒšãƒ¼ã‚¸ãƒãƒ¼ã‚·ãƒ§ãƒ³ãƒã‚¸ãƒƒã‚¯ã‚‚è¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:306 -#: ../../rst/porting_guides/porting_guide_6.rst:599 +#: ../../rst/porting_guides/porting_guide_6.rst:735 msgid "bigip_device_info - the module no longer gathers information from all partitions on device. This change will stabalize the module by gathering resources only from the given partition and prevent the module from gathering way too much information that might result in crashing." msgstr "bigip_device_info - モジュールã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã®ã™ã¹ã¦ã®ãƒ‘ーティションã‹ã‚‰æƒ…å ±ã‚’åŽé›†ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã®å¤‰æ›´ã«ã‚ˆã‚Šã€æŒ‡å®šã®ãƒ‘ーティションã‹ã‚‰ã®ã¿ãƒªã‚½ãƒ¼ã‚¹ã‚’åŽé›†ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå¤§é‡ã®æƒ…å ±ã‚’åŽé›†ã—ã¦ã‚¯ãƒ©ãƒƒã‚·ãƒ¥ã™ã‚‹ã®ã‚’防ãã“ã¨ã§ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’安定ã•ã›ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:314 -#: ../../rst/porting_guides/porting_guide_6.rst:800 +#: ../../rst/porting_guides/porting_guide_6.rst:936 msgid "mail callback plugin - not specifying ``sender`` is deprecated and will be disallowed in community.general 6.0.0 (https://github.com/ansible-collections/community.general/pull/4140)." msgstr "メールコールãƒãƒƒã‚¯ãƒ—ラグイン - ``sender`` を指定ã—ãªã„è¨å®šã¯éžæŽ¨å¥¨ã«ãªã‚Šã€community.general 6.0.0 ã§ã¯è¨±å¯ã•ã‚Œã¾ã›ã‚“（https://github.com/ansible-collections/community.general/pull/4140）。" @@ -9083,76 +9175,76 @@ msgstr "v5.2.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:325 #: ../../rst/porting_guides/porting_guide_5.rst:364 -#: ../../rst/porting_guides/porting_guide_6.rst:188 -#: ../../rst/porting_guides/porting_guide_6.rst:276 -#: ../../rst/porting_guides/porting_guide_7.rst:112 +#: ../../rst/porting_guides/porting_guide_6.rst:324 +#: ../../rst/porting_guides/porting_guide_6.rst:412 +#: ../../rst/porting_guides/porting_guide_7.rst:288 msgid "idrac_user - Issue(192043) The module may error out with the message ``unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress``. Wait for the job to complete and run the task again." msgstr "idrac_user - Issue(192043)。モジュール㯠``unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress`` メッセージã§ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ジョブãŒå®Œäº†ã™ã‚‹ã¾ã§å¾…æ©Ÿã—ã€ã‚¿ã‚¹ã‚¯ã‚’å†åº¦å®Ÿè¡Œã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:326 #: ../../rst/porting_guides/porting_guide_5.rst:365 -#: ../../rst/porting_guides/porting_guide_6.rst:189 -#: ../../rst/porting_guides/porting_guide_6.rst:277 -#: ../../rst/porting_guides/porting_guide_7.rst:113 +#: ../../rst/porting_guides/porting_guide_6.rst:325 +#: ../../rst/porting_guides/porting_guide_6.rst:413 +#: ../../rst/porting_guides/porting_guide_7.rst:289 msgid "ome_application_alerts_smtp - Issue(212310) - The module does not provide a proper error message if the destination_address is more than 255 characters." msgstr "ome_application_alerts_smtp - Issue(212310)。destination_address ㌠255 æ–‡å—を超ãˆã‚‹å ´åˆã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’æä¾›ã—ã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:327 #: ../../rst/porting_guides/porting_guide_5.rst:366 -#: ../../rst/porting_guides/porting_guide_6.rst:190 -#: ../../rst/porting_guides/porting_guide_6.rst:278 -#: ../../rst/porting_guides/porting_guide_7.rst:114 +#: ../../rst/porting_guides/porting_guide_6.rst:326 +#: ../../rst/porting_guides/porting_guide_6.rst:414 +#: ../../rst/porting_guides/porting_guide_7.rst:290 msgid "ome_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters." msgstr "ome_application_alerts_syslog - Issue(215374)。destination_address ㌠255 æ–‡å—を超ãˆã‚‹å ´åˆã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’æä¾›ã—ã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:328 -#: ../../rst/porting_guides/porting_guide_6.rst:191 -#: ../../rst/porting_guides/porting_guide_6.rst:280 -#: ../../rst/porting_guides/porting_guide_7.rst:115 +#: ../../rst/porting_guides/porting_guide_6.rst:327 +#: ../../rst/porting_guides/porting_guide_6.rst:416 +#: ../../rst/porting_guides/porting_guide_7.rst:291 msgid "ome_device_local_access_configuration - Issue(215035) - The module reports ``Successfully updated the local access setting`` if an unsupported value is provided for the parameter timeout_limit. However, this value is not actually applied on OpenManage Enterprise Modular." msgstr "ome_device_local_access_configuration - Issue(215035)。パラメーター timeout_limit ã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„値ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``Successfully updated the local access setting`` ã‚’å ±å‘Šã—ã¾ã™ã€‚ãŸã ã—ã€ã“ã®å€¤ã¯ OpenManage Enterprise Modular ã§ã¯å®Ÿéš›ã«ã¯é©ç”¨ã•ã‚Œã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:329 -#: ../../rst/porting_guides/porting_guide_6.rst:192 -#: ../../rst/porting_guides/porting_guide_6.rst:281 -#: ../../rst/porting_guides/porting_guide_7.rst:116 +#: ../../rst/porting_guides/porting_guide_6.rst:328 +#: ../../rst/porting_guides/porting_guide_6.rst:417 +#: ../../rst/porting_guides/porting_guide_7.rst:292 msgid "ome_device_local_access_configuration - Issue(217865) - The module does not display a proper error message if an unsupported value is provided for the user_defined and lcd_language parameters." msgstr "ome_device_local_access_configuration - Issue(217865)。user_defined ãŠã‚ˆã³ lcd_language パラメーターã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„値を指定ã™ã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’表示ã—ã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:330 #: ../../rst/porting_guides/porting_guide_5.rst:367 -#: ../../rst/porting_guides/porting_guide_6.rst:193 -#: ../../rst/porting_guides/porting_guide_6.rst:282 -#: ../../rst/porting_guides/porting_guide_7.rst:117 +#: ../../rst/porting_guides/porting_guide_6.rst:329 +#: ../../rst/porting_guides/porting_guide_6.rst:418 +#: ../../rst/porting_guides/porting_guide_7.rst:293 msgid "ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the parameters- port_number, community_name, max_sessions, max_auth_retries, and idle_timeout." msgstr "ome_device_network_services - Issue(212681)。パラメーター port_numberã€community_nameã€max_sessionsã€max_auth_retriesã€ãŠã‚ˆã³ idle_timeout ã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„値を指定ã™ã‚‹ã¨ã€ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’æä¾›ã—ã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:331 #: ../../rst/porting_guides/porting_guide_5.rst:368 -#: ../../rst/porting_guides/porting_guide_6.rst:284 +#: ../../rst/porting_guides/porting_guide_6.rst:420 msgid "ome_device_power_settings - Issue(212679) - The module errors out with the following message if the value provided for the parameter ``power_cap`` is not within the supported range of 0 to 32767, ``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``" msgstr "ome_device_power_settings - Issue(212679)。パラメーター ``power_cap`` ã«æŒ‡å®šã•ã‚ŒãŸå€¤ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ 0 ã‹ã‚‰ 32767 ã®ç¯„囲内ã«ãªã„å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¨å…±ã«ã‚¨ãƒ©ãƒ¼ã‚’発生ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:332 #: ../../rst/porting_guides/porting_guide_5.rst:369 -#: ../../rst/porting_guides/porting_guide_6.rst:196 -#: ../../rst/porting_guides/porting_guide_6.rst:287 -#: ../../rst/porting_guides/porting_guide_7.rst:120 +#: ../../rst/porting_guides/porting_guide_6.rst:332 +#: ../../rst/porting_guides/porting_guide_6.rst:423 +#: ../../rst/porting_guides/porting_guide_7.rst:296 msgid "ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation of multiple uplinks of the same name even though it is supported by OpenManage Enterprise Modular. If an uplink is created using the same name as an existing uplink, the existing uplink is modified." msgstr "ome_smart_fabric_uplink - Issue(186024)。OpenManage Enterprise Modular ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã¦ã‚‚ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯åŒã˜åå‰ã®è¤‡æ•°ã®ã‚¢ãƒƒãƒ—リンクã®ä½œæˆã¯ã§ãã¾ã›ã‚“。アップリンクãŒæ—¢å˜ã®ã‚¢ãƒƒãƒ—リンクã¨åŒã˜åå‰ã‚’使用ã—ã¦ä½œæˆã•ã‚Œã‚‹ã¨ã€æ—¢å˜ã®ã‚¢ãƒƒãƒ—リンクãŒå¤‰æ›´ã•ã‚Œã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:337 -#: ../../rst/porting_guides/porting_guide_6.rst:292 +#: ../../rst/porting_guides/porting_guide_6.rst:428 msgid "purefa_admin - Once `max_login` and `lockout` have been set there is currently no way to rest these to zero except through the FlashArray GUI" msgstr "purefa_admin - `max_login` ãŠã‚ˆã³ `lockout` ã‚’è¨å®šã™ã‚‹ã¨ã€ç¾åœ¨ FlashArray GUI 以外ã¯ã‚¼ãƒã«æˆ»ã™æ–¹æ³•ã¯ã‚ã‚Šã¾ã›ã‚“。" #: ../../rst/porting_guides/porting_guide_5.rst:345 -#: ../../rst/porting_guides/porting_guide_6.rst:537 +#: ../../rst/porting_guides/porting_guide_6.rst:673 msgid "meraki_mr_radio - New module" msgstr "meraki_mr_radio - æ–°ã—ã„モジュール" #: ../../rst/porting_guides/porting_guide_5.rst:353 -#: ../../rst/porting_guides/porting_guide_6.rst:828 +#: ../../rst/porting_guides/porting_guide_6.rst:964 msgid "purefa_sso - Deprecated in favor of M(purefa_admin). Will be removed in Collection 2.0" msgstr "purefa_sso - M（purefa_admin）ãŒå„ªå…ˆã•ã‚Œã‚‹ãŸã‚éžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸã€‚コレクション 2.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" @@ -9161,22 +9253,22 @@ msgid "Porting Guide for v5.1.0" msgstr "v5.1.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" #: ../../rst/porting_guides/porting_guide_5.rst:386 -#: ../../rst/porting_guides/porting_guide_6.rst:692 +#: ../../rst/porting_guides/porting_guide_6.rst:828 msgid "the \"legacy\" integration test setup has been removed; this does not affect end users and is only relevant to contributors (https://github.com/ansible-collections/community.hashi_vault/pull/191)." msgstr "「レガシーã€ã‚¤ãƒ³ãƒ†ã‚°ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ãƒ†ã‚¹ãƒˆã®è¨å®šãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“ã‚Œã¯ã‚¨ãƒ³ãƒ‰ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ã¯å½±éŸ¿ã—ã¾ã›ã‚“ãŒã€ã‚³ãƒ³ãƒˆãƒªãƒ“ューターã«é–¢ä¿‚ã—ã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.hashi_vault/pull/191）。" #: ../../rst/porting_guides/porting_guide_5.rst:404 -#: ../../rst/porting_guides/porting_guide_6.rst:801 +#: ../../rst/porting_guides/porting_guide_6.rst:937 msgid "module_helper module utils - deprecated the attribute ``ModuleHelper.VarDict`` (https://github.com/ansible-collections/community.general/pull/3801)." msgstr "module_helper モジュールユーティリティー - 属性``ModuleHelper.VarDict``ãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—ãŸï¼ˆhttps://github.com/ansible-collections/community.general/pull/3801）。" #: ../../rst/porting_guides/porting_guide_5.rst:409 -#: ../../rst/porting_guides/porting_guide_6.rst:810 +#: ../../rst/porting_guides/porting_guide_6.rst:946 msgid "Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.hashi_vault 3.0.0) next spring (https://github.com/ansible-community/community-topics/issues/50, https://github.com/ansible-collections/community.hashi_vault/issues/189)." msgstr "Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã«ãªã‚Šã€æ¥å¹´æ˜¥ã®æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹(community.hashi_vault 3.0.0)ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ï¼ˆhttps://github.com/ansible-community/community-topics/issues/50ã€https://github.com/ansible-collections/community.hashi_vault/issues/189）。" #: ../../rst/porting_guides/porting_guide_5.rst:410 -#: ../../rst/porting_guides/porting_guide_6.rst:811 +#: ../../rst/porting_guides/porting_guide_6.rst:947 msgid "aws_iam_login auth method - the ``aws_iam_login`` method has been renamed to ``aws_iam``. The old name will be removed in collection version ``3.0.0``. Until then both names will work, and a warning will be displayed when using the old name (https://github.com/ansible-collections/community.hashi_vault/pull/193)." msgstr "aws_iam_login èªè¨¼ãƒ¡ã‚½ãƒƒãƒ‰ - ``aws_iam_login`` メソッドã®åå‰ãŒ ``aws_iam`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚å¤ã„åå‰ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚ãã‚Œã¾ã§ã¯ä¸¡æ–¹ã®åå‰ãŒæ©Ÿèƒ½ã—ã€å¤ã„åå‰ã‚’使用ã™ã‚‹ã¨è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ï¼ˆhttps://github.com/ansible-collections/community.hashi_vault/pull/193）。" @@ -9217,8 +9309,8 @@ msgid "netapp.storagegrid (version 21.7.0)" msgstr "netapp.storagegrid (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 21.7.0)" #: ../../rst/porting_guides/porting_guide_5.rst:444 -msgid "ansible-test - Tab completion anywhere other than the end of the command with the new composite options will provide incorrect results. See https://github.com/kislyuk/argcomplete/issues/351 for additional details." -msgstr "ansible-test - æ–°ã—ã„複åˆã‚ªãƒ—ションを使用ã—ãŸã‚³ãƒžãƒ³ãƒ‰ã®çµ‚ã‚り以外ã®å ´æ‰€ã§ã‚¿ãƒ–補完を行ã†ã¨ã€èª¤ã£ãŸçµæžœãŒå¾—られã¾ã™ã€‚詳細ã¯ã€https://github.com/kislyuk/argcomplete/issues/351 ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgid "ansible-test - Tab completion anywhere other than the end of the command with the new composite options will provide incorrect results. See `issue 351 <https://github.com/kislyuk/argcomplete/issues/351>`_ for additional details." +msgstr "ansible-test - æ–°ã—ã„複åˆã‚ªãƒ—ションを使用ã—ãŸã‚³ãƒžãƒ³ãƒ‰ã®çµ‚ã‚り以外ã®å ´æ‰€ã§ã‚¿ãƒ–補完を行ã†ã¨ã€èª¤ã£ãŸçµæžœãŒå¾—られã¾ã™ã€‚詳細ã¯ã€`issue 351 <https://github.com/kislyuk/argcomplete/issues/351>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_5.rst:450 msgid "ome_device_power_settings - Issue(212679) The ome_device_power_settings module errors out with the following message if the value provided for the parameter ``power_cap`` is not within the supported range of 0 to 32767, ``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``" @@ -9424,6 +9516,7 @@ msgstr "x509_crl - 冪ç‰æ€§ãƒã‚§ãƒƒã‚¯ã®å ´åˆã€``issuer`` ã®é †åºã¯ç„¡è¦ #: ../../rst/porting_guides/porting_guide_5.rst:529 #: ../../rst/porting_guides/porting_guide_5.rst:701 #: ../../rst/porting_guides/porting_guide_5.rst:957 +#: ../../rst/porting_guides/porting_guide_7.rst:171 msgid "community.dns" msgstr "community.dns" @@ -9496,6 +9589,10 @@ msgid "drop python 2 support (https://github.com/openshift/community.okd/pull/93 msgstr "Python 2 サãƒãƒ¼ãƒˆãŒå»ƒæ¢ã•ã‚Œã¾ã—㟠(https://github.com/openshift/community.okd/pull/93)。" #: ../../rst/porting_guides/porting_guide_5.rst:566 +#: ../../rst/porting_guides/porting_guide_6.rst:109 +#: ../../rst/porting_guides/porting_guide_6.rst:166 +#: ../../rst/porting_guides/porting_guide_7.rst:226 +#: ../../rst/porting_guides/porting_guide_7.rst:281 msgid "community.routeros" msgstr "community.routeros" @@ -9511,6 +9608,10 @@ msgstr "api - 分割コマンドã¯ã€ã‚¹ãƒšãƒ¼ã‚¹ã«ã‚ˆã‚‹ã‚·ãƒ³ãƒ—ルãªåˆ†å‰² msgid "command - the module now always indicates that a change happens. If this is not correct, please use ``changed_when`` to determine the correct changed status for a task (https://github.com/ansible-collections/community.routeros/pull/50)." msgstr "command - モジュールã¯ã€å¤‰æ›´ãŒç™ºç”Ÿã—ãŸã“ã¨ã‚’常ã«ç¤ºã™ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚ŒãŒæ£ã—ããªã„å ´åˆã¯ã€``changed_when`` を使用ã—ã¦ã‚¿ã‚¹ã‚¯ã®æ£ã—ã„変更ã•ã‚ŒãŸã‚¹ãƒ†ãƒ¼ã‚¿ã‚¹ã‚’判æ–ã—ã¦ãã ã•ã„（https://github.com/ansible-collections/community.routeros/pull/50）。" +#: ../../rst/porting_guides/porting_guide_5.rst:575 +msgid "all roles now reference other roles and modules through their fully qualified collection names, which makes Ansible 2.10 minimum supported version for roles (See `issue 477 <https://github.com/ansible-collections/community.zabbix/pull/477>`_)." +msgstr "ã™ã¹ã¦ã®ãƒãƒ¼ãƒ«ã¯ã€å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åã§ä»–ã®ãƒãƒ¼ãƒ«ãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å‚ç…§ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ãƒãƒ¼ãƒ«ã®Ansible 2.10 最低サãƒãƒ¼ãƒˆãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’作æˆã—ã¾ã™ (`issue 477 <https://github.com/ansible-collections/community.zabbix/pull/477>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„)。" + #: ../../rst/porting_guides/porting_guide_5.rst:580 msgid "Drop python 2 support (https://github.com/ansible-collections/kubernetes.core/pull/86)." msgstr "Python 2 サãƒãƒ¼ãƒˆãŒå»ƒæ¢ã•ã‚Œã¾ã—ãŸï¼ˆhttps://github.com/ansible-collections/kubernetes.core/pull/86）。" @@ -9624,7 +9725,7 @@ msgid "ec2_vpc_igw_facts - The module has been migrated from the ``community.aws msgstr "ec2_vpc_igw_facts - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_vpc_igw_facts`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:634 -#: ../../rst/porting_guides/porting_guide_7.rst:169 +#: ../../rst/porting_guides/porting_guide_7.rst:377 msgid "ec2_vpc_route_table - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_vpc_route_table``." msgstr "ec2_vpc_route_table - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_vpc_route_table`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -9633,12 +9734,12 @@ msgid "ec2_vpc_route_table_facts - The module has been migrated from the ``commu msgstr "ec2_vpc_route_table_facts - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_vpc_route_table_facts`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:636 -#: ../../rst/porting_guides/porting_guide_7.rst:170 +#: ../../rst/porting_guides/porting_guide_7.rst:378 msgid "ec2_vpc_route_table_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_vpc_route_table_info``." msgstr "ec2_vpc_route_table_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_vpc_route_table_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_5.rst:639 -#: ../../rst/porting_guides/porting_guide_6.rst:484 +#: ../../rst/porting_guides/porting_guide_6.rst:620 msgid "cisco.ise" msgstr "cisco.ise" @@ -10160,7 +10261,7 @@ msgstr "Ansible 6 㯠Ansible-core 2.13 をベースã«ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_6.rst:18 msgid "We suggest you read this page along with the `Ansible 6 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/6/CHANGELOG-v6.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ `Ansible 6 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/6/CHANGELOG-v6.rst>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ `Ansible 6 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/6/CHANGELOG-v6.rst>`_ ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_6.rst:24 #: ../../rst/porting_guides/porting_guide_core_2.13.rst:22 @@ -10189,1229 +10290,1439 @@ msgid "``ansible.module_utils.urls.fetch_url`` will now return the captured ``HT msgstr "``ansible.module_utils.urls.fetch_url`` ã¯ã€ã‚ャプãƒãƒ£ãƒ¼ã•ã‚ŒãŸ ``HTTPError`` 例外を ``r`` ã¨ã—ã¦è¿”ã™ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚``HTTPError`` ã¯ã‚ªãƒ–ジェクトã®ã‚ˆã†ãªå¿œç”ã§ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä½œæˆè€…ã«ã‚ˆã‚Šå¤šãã®æƒ…å ±ã‚’æä¾›ã§ãã¾ã™ã€‚失敗ãŒã‚ã£ãŸã‹ã©ã†ã‹åˆ¤æ–ã™ã‚‹ã®ã«ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯``r.read()`` を試ã¿ã‚‹éš›ã«``r is None`` を使用ã—ãŸã‚Š ``AttributeError`` ã‚’ã‚ャッãƒã—ãŸã‚Šã™ã‚‹ä»£ã‚ã‚Šã«ã€``info['status'] >= 400``ã«ä¾å˜ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_6.rst:103 +msgid "Porting Guide for v6.7.0" +msgstr "v6.7.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_6.rst:111 +#: ../../rst/porting_guides/porting_guide_7.rst:228 +msgid "api_modify - when limits for entries in ``queue tree`` are defined as human readable - for example ``25M`` -, the configuration will be correctly set in ROS, but the module will indicate the item is changed on every run even when there was no change done. This is caused by the ROS API which returns the number in bytes - for example ``25000000`` (which is inconsistent with the CLI behavior). In order to mitigate that, the limits have to be defined in bytes (those will still appear as human readable in the ROS CLI) (https://github.com/ansible-collections/community.routeros/pull/131)." +msgstr "api_modify - ``queue tree`` ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã®åˆ¶é™ãŒäººé–“ãŒåˆ¤èªã§ãるよã†ã«å®šç¾©ã•ã‚Œã¦ã„ã‚‹ (``25M`` ãªã©) å ´åˆã¯ã€è¨å®šã¯ ROS ã§æ£ã—ãè¨å®šã•ã‚Œã¾ã™ãŒã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€å¤‰æ›´ãŒè¡Œã‚ã‚Œã¦ã„ãªãã¦ã‚‚ã€å®Ÿè¡Œã”ã¨ã«é …ç›®ãŒå¤‰æ›´ã•ã‚ŒãŸã“ã¨ã‚’示ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€æ•°å€¤ã‚’``25000000`` (ã“れ㯠CLI ã®å‹•ä½œã¨çŸ›ç›¾ã—ã¦ã„ã¾ã™) ãªã©ã®ãƒã‚¤ãƒˆå˜ä½ã§è¿”ã™ ROS API ãŒåŽŸå› ã§ã™ã€‚ãれを軽減ã™ã‚‹ãŸã‚ã«ã€åˆ¶é™ã‚’ãƒã‚¤ãƒˆå˜ä½ã§å®šç¾©ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (ã“れらã¯ã€ROS CLI ã§äººé–“ãŒåˆ¤èªã§ãるよã†ã«å¼•ã続ã表示ã•ã‚Œã¾ã™) (https://github.com/ansible-collections/community.routeros/pull/131)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:112 +#: ../../rst/porting_guides/porting_guide_7.rst:229 +msgid "api_modify, api_info - ``routing ospf area``, ``routing ospf area range``, ``routing ospf instance``, ``routing ospf interface-template`` paths are not fully implemeted for ROS6 due to the significat changes between ROS6 and ROS7 (https://github.com/ansible-collections/community.routeros/pull/131)." +msgstr "api_modify, api_info - ``routing ospf area``ã€``routing ospf area range``ã€``routing ospf instance``ã€``routing ospf interface-template`` パスã¯ã€ROS6 㨠ROS7 ã®é–“ã§å¤§å¹…ãªå¤‰æ›´ãŒè¡Œã‚ã‚ŒãŸãŸã‚ã€ROS6 ã§ã¯å®Œå…¨ã«ã¯å®Ÿè£…ã•ã‚Œã¦ã„ã¾ã›ã‚“ (https://github.com/ansible-collections/community.routeros/pull/131)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:120 +#: ../../rst/porting_guides/porting_guide_7.rst:237 +msgid "meraki_mr_l7_firewall - New module" +msgstr "meraki_mr_l7_firewall - æ–°ã—ã„モジュール" + +#: ../../rst/porting_guides/porting_guide_6.rst:121 +#: ../../rst/porting_guides/porting_guide_7.rst:238 +msgid "meraki_webhook_payload_template - New module" +msgstr "meraki_webhook_payload_template - æ–°ã—ã„モジュール" + +#: ../../rst/porting_guides/porting_guide_6.rst:126 +#: ../../rst/porting_guides/porting_guide_7.rst:243 +msgid "all modules are opting away from zabbix-api and using httpapi ansible.netcommon plugin. We will support zabbix-api for backwards compatibility until next major release. See our README.md for more information about how to migrate" +msgstr "ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ zabbix-api を使用ã›ãšã€httpapi ansible.netcommon プラグインを使用ã—ã¦ã„ã¾ã™ã€‚次ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ã§ã€å¾Œæ–¹äº’æ›æ€§ã®ãŸã‚ã« zabbix-api をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚移行方法ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€README.md ã‚’å‚ç…§ã—ã¦ãã ã•ã„" + +#: ../../rst/porting_guides/porting_guide_6.rst:127 +#: ../../rst/porting_guides/porting_guide_7.rst:244 +msgid "zabbix_agent and zabbix_proxy roles are opting away from zabbix-api and use httpapi ansible.netcommon plugin. We will support zabbix-api for backwards compatibility until next major release. See our README.md for more information about how to migrate" +msgstr "zabbix_agent ãŠã‚ˆã³ zabbix_proxy ã®ãƒãƒ¼ãƒ«ã¯ã€zabbix-api を使用ã›ãšã€httpapi ansible.netcommon プラグインを使用ã—ã¾ã™ã€‚次ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¾ã§ã€å¾Œæ–¹äº’æ›æ€§ã®ãŸã‚ã« zabbix-api をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚移行方法ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€README.md ã‚’å‚ç…§ã—ã¦ãã ã•ã„" + +#: ../../rst/porting_guides/porting_guide_6.rst:132 +#: ../../rst/porting_guides/porting_guide_7.rst:249 +msgid "New become plugin - podman_unshare" +msgstr "æ–°ã—ã„ become プラグイン - podman_unshare" + +#: ../../rst/porting_guides/porting_guide_6.rst:133 +#: ../../rst/porting_guides/porting_guide_7.rst:250 +msgid "Podman generate systemd module" +msgstr "Podman 㯠systemd モジュールを生æˆã—ã¾ã™" + +#: ../../rst/porting_guides/porting_guide_6.rst:136 +#: ../../rst/porting_guides/porting_guide_6.rst:187 +#: ../../rst/porting_guides/porting_guide_7.rst:649 +msgid "fortinet.fortimanager" +msgstr "fortinet.fortimanager" + +#: ../../rst/porting_guides/porting_guide_6.rst:138 +#: ../../rst/porting_guides/porting_guide_7.rst:651 +msgid "Fix compatibility issue for ansible 2.9.x and ansible-base 2.10.x." +msgstr "ansible 2.9.x ãŠã‚ˆã³ ansible-base 2.10.x ã®äº’æ›æ€§ã®å•é¡Œã‚’ä¿®æ£ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:139 +#: ../../rst/porting_guides/porting_guide_7.rst:654 +msgid "support Ansible changelogs." +msgstr "Ansible changelog をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:144 +#: ../../rst/porting_guides/porting_guide_7.rst:255 +msgid "Support FortiOS v7.0.6, v7.0.7, v7.0.8, v7.2.1, v7.2.2." +msgstr "FortiOS v7.0.6ã€v7.0.7ã€v7.0.8ã€v7.2.1ã€v7.2.2 をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:152 +msgid "Please note that some tools, like the VScode plugin (https://github.com/ansible/vscode-ansible/issues/573), or ``ansible-doc --list --type module``, suggest to replace the correct FQCNs for modules and actions in community.general with internal names that have more than three components. For example, ``community.general.ufw`` is suggested to be replaced by ``community.general.system.ufw``. While these longer names do work, they are considered **internal names** by the collection and are subject to change and be removed at all time. They **will** be removed in community.general 6.0.0 and result in deprecation messages. Avoid using these internal names, and use general three-component FQCNs (``community.general.<name_of_module>``) instead (https://github.com/ansible-collections/community.general/pull/5373)." +msgstr "VScode プラグイン (https://github.com/ansible/vscode-ansible/issues/573) ã¾ãŸã¯ ``ansible-doc --list --type module`` ãªã©ã®ä¸€éƒ¨ã®ãƒ„ールã¯ã€community.general ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã®æ£ã—ã„ FQCN ã‚’ã€3 ã¤ä»¥ä¸Šã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã‚’æŒã¤ã‚¤ãƒ³ã‚¿ãƒ¼ãƒŠãƒ«åã«ç½®ãæ›ãˆã‚‹ã“ã¨ã‚’æ案ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€``community.general.ufw`` 㯠``community.general.system.ufw`` ã«ç½®ãæ›ãˆã‚‹ã“ã¨ãŒæ案ã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ã‚ˆã†ãªé•·ã„åå‰ã§ã‚‚å•é¡Œã‚ã‚Šã¾ã›ã‚“ãŒã€ã“れらã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ã‚ˆã£ã¦ **インターナルå** ã¨è¦‹ãªã•ã‚Œã€å¤‰æ›´ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã„ã¤ã§ã‚‚削除ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“れら㯠community.general 6.0.0 㧠**削除ã•ã‚Œã‚‹äºˆå®š**ã§ã€ãã®çµæžœã€éžæŽ¨å¥¨ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãŒè¡¨ç¤ºã•ã‚Œã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚ã“れらã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒŠãƒ«åã®ä½¿ç”¨ã‚’é¿ã‘ã€ä»£ã‚ã‚Šã«ä¸€èˆ¬çš„㪠3 ã¤ã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã® FQCN (``community.general.<name_of_module>``) を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.general/pull/5373)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:155 +msgid "Porting Guide for v6.6.0" +msgstr "v6.6.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_6.rst:160 +#: ../../rst/porting_guides/porting_guide_7.rst:273 +msgid "lowlydba.sqlserver (version 1.0.4)" +msgstr "lowlydba.sqlserver (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.0.4)" + +#: ../../rst/porting_guides/porting_guide_6.rst:168 +#: ../../rst/porting_guides/porting_guide_7.rst:283 +msgid "The ``community.routeros.command`` module claims to support check mode. Since it cannot judge whether the commands executed modify state or not, this behavior is incorrect. Since this potentially breaks existing playbooks, we will not change this behavior until community.routeros 3.0.0." +msgstr "``community.routeros.command`` モジュールã¯ã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã¨ä¸»å¼µã—ã¦ã„ã¾ã™ã€‚実行ã•ã‚ŒãŸã‚³ãƒžãƒ³ãƒ‰ãŒçŠ¶æ…‹ã‚’変更ã™ã‚‹ã‹ã©ã†ã‹ã‚’判æ–ã§ããªã„ãŸã‚ã€ã“ã®å‹•ä½œã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“。ã“ã‚Œã¯æ—¢å˜ã® Playbook を壊ã™å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€community.routeros 3.0.0 ã¾ã§ã“ã®å‹•ä½œã¯å¤‰æ›´ã—ã¾ã›ã‚“。" + +#: ../../rst/porting_guides/porting_guide_6.rst:176 +#: ../../rst/porting_guides/porting_guide_7.rst:436 +msgid "newrelic_deployment - ``revision`` is required for v2 API (https://github.com/ansible-collections/community.general/pull/5341)." +msgstr "newrelic_deployment -``revision`` ã¯ã€v2 API 用ã«å¿…è¦ã§ã™ (https://github.com/ansible-collections/community.general/pull/5341)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:184 +#: ../../rst/porting_guides/porting_guide_7.rst:609 +msgid "newrelic_deployment - removed New Relic v1 API, added support for v2 API (https://github.com/ansible-collections/community.general/pull/5341)." +msgstr "newrelic_deployment - New Relic v1 API を削除ã—ã€v2 API ã®ã‚µãƒãƒ¼ãƒˆã‚’è¿½åŠ ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5341)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:189 +#: ../../rst/porting_guides/porting_guide_7.rst:652 +msgid "Many fixes for Ansible sanity test warnings & errors." +msgstr "Ansible ã®å¥å…¨æ€§ãƒ†ã‚¹ãƒˆã®è¦å‘Šã¨ã‚¨ãƒ©ãƒ¼ã«å¯¾ã™ã‚‹å¤šãã®ä¿®æ£ã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:190 +#: ../../rst/porting_guides/porting_guide_7.rst:653 +msgid "Support FortiManager Schema 7.2.0 , 98 new modules" +msgstr "FortiManager Schema 7.2.0ã€98 個ã®æ–°ã—ã„モジュールをサãƒãƒ¼ãƒˆã—ã¾ã™" + +#: ../../rst/porting_guides/porting_guide_6.rst:195 +#: ../../rst/porting_guides/porting_guide_7.rst:941 +msgid "The mellanox.onyx collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/136)." +msgstr "mellanox.onyx コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 8 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 8 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-community/community-topics/issues/136)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:198 +#: ../../rst/porting_guides/porting_guide_7.rst:997 +msgid "cisco.mso" +msgstr "cisco.mso" + +#: ../../rst/porting_guides/porting_guide_6.rst:200 +#: ../../rst/porting_guides/porting_guide_7.rst:999 +msgid "The mso_schema_template_contract_filter contract_filter_type attribute is deprecated. The value is now deduced from filter_type." +msgstr "mso_schema_template_contract_filter contract_filter_type 属性ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚ã“ã®å€¤ã¯ filter_type ã‹ã‚‰æŽ¨æ¸¬ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:205 +#: ../../rst/porting_guides/porting_guide_7.rst:1036 +msgid "ArgFormat module utils - deprecated along ``CmdMixin``, in favor of the ``cmd_runner_fmt`` module util (https://github.com/ansible-collections/community.general/pull/5370)." +msgstr "ArgFormat モジュール utils - ``CmdMixin`` ã¨ã¨ã‚‚ã«éžæŽ¨å¥¨ã¨ãªã‚Šã€``cmd_runner_fmt`` モジュール utils ãŒä½¿ç”¨ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5370)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:206 +#: ../../rst/porting_guides/porting_guide_7.rst:1037 +msgid "CmdMixin module utils - deprecated in favor of the ``CmdRunner`` module util (https://github.com/ansible-collections/community.general/pull/5370)." +msgstr "CmdMixin モジュール utils - éžæŽ¨å¥¨ã¨ãªã‚Šã€``CmdRunner`` モジュール util ã«ç§»è¡Œã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5370)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:207 +#: ../../rst/porting_guides/porting_guide_7.rst:1038 +msgid "CmdModuleHelper module utils - deprecated in favor of the ``CmdRunner`` module util (https://github.com/ansible-collections/community.general/pull/5370)." +msgstr "CmdModuleHelper モジュール utils - éžæŽ¨å¥¨ã¨ãªã‚Šã€``CmdRunner`` モジュール util ã«ç§»è¡Œã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5370)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:208 +#: ../../rst/porting_guides/porting_guide_7.rst:1039 +msgid "CmdStateModuleHelper module utils - deprecated in favor of the ``CmdRunner`` module util (https://github.com/ansible-collections/community.general/pull/5370)." +msgstr "CmdStateModuleHelper モジュール utils - éžæŽ¨å¥¨ã¨ãªã‚Šã€``CmdRunner`` モジュール util ã«ç§»è¡Œã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5370)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:209 +#: ../../rst/porting_guides/porting_guide_7.rst:1041 +msgid "django_manage - support for Django releases older than 4.1 has been deprecated and will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5400)." +msgstr "django_manage - 4.1 よりå¤ã„ Django ã®ãƒªãƒªãƒ¼ã‚¹ã«å¯¾ã™ã‚‹ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.general 9.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ (https://github.com/ansible-collections/community.general/pull/5400)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:210 +#: ../../rst/porting_guides/porting_guide_7.rst:1042 +msgid "django_manage - support for the commands ``cleanup``, ``syncdb`` and ``validate`` that have been deprecated in Django long time ago will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5400)." +msgstr "django_manage - ã ã„ã¶å‰ã« Django ã§éžæŽ¨å¥¨ã¨ãªã£ãŸã‚³ãƒžãƒ³ãƒ‰ ``cleanup``ã€``syncdb``ã€``validate`` ã®ã‚µãƒãƒ¼ãƒˆã¯ community.general 9.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ (https://github.com/ansible-collections/community.general/pull/5400)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:211 +#: ../../rst/porting_guides/porting_guide_7.rst:1043 +msgid "django_manage - the behavior of \"creating the virtual environment when missing\" is being deprecated and will be removed in community.general version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5405)." +msgstr "django_manage - 「ä¸è¶³æ™‚ã«ä»®æƒ³ç’°å¢ƒã‚’作æˆã™ã‚‹ã€ã¨ã„ã†å‹•ä½œã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.general ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ (https://github.com/ansible-collections/community.general/pull/5405)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:212 +#: ../../rst/porting_guides/porting_guide_7.rst:1046 +msgid "newrelic_deployment - ``appname`` and ``environment`` are no longer valid options in the v2 API. They will be removed in community.general 7.0.0 (https://github.com/ansible-collections/community.general/pull/5341)." +msgstr "newrelic_deployment -``appname`` ã¨``environment`` ã¯ã€v2 API ã§ã¯æœ‰åŠ¹ãªã‚ªãƒ—ションã§ã¯ãªããªã‚Šã¾ã—ãŸã€‚community.general 7.0.0 (https://github.com/ansible-collections/community.general/pull/5341) ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:215 +msgid "Porting Guide for v6.5.0" +msgstr "v6.5.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_6.rst:221 +#: ../../rst/porting_guides/porting_guide_6.rst:344 +#: ../../rst/porting_guides/porting_guide_7.rst:663 +msgid "infoblox.nios_modules" +msgstr "infoblox.nios_modules" + +#: ../../rst/porting_guides/porting_guide_6.rst:223 +#: ../../rst/porting_guides/porting_guide_7.rst:665 +msgid "Feature for extra layer security , with `cert` and `key` parameters in playbooks for authenticating using certificate and key ``*.pem`` file absolute path `#154 <https://github.com/infobloxopen/infoblox-ansible/pull/154>`_" +msgstr "証明書ã¨ã‚ー ``*.pem`` ファイルã®çµ¶å¯¾ãƒ‘スを使用ã—ã¦èªè¨¼ã™ã‚‹ãŸã‚ã® Playbook ã® `cert` 㨠`key` パラメーターを使用ã—ãŸã€è¿½åŠ ã®ãƒ¬ã‚¤ãƒ¤ãƒ¼ã‚»ã‚ュリティーã®æ©Ÿèƒ½ `#154 <https://github.com/infobloxopen/infoblox-ansible/pull/154>`_" + +#: ../../rst/porting_guides/porting_guide_6.rst:224 +#: ../../rst/porting_guides/porting_guide_7.rst:666 +msgid "Fix to remove issue causing due to template attr in deleting network using Ansible module nios network `#147 <https://github.com/infobloxopen/infoblox-ansible/pull/147>`_" +msgstr "Ansible モジュール nios network を使用ã—ã¦ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã‚’削除ã™ã‚‹éš›ã«ãƒ†ãƒ³ãƒ—レート attr ãŒåŽŸå› ã§ç™ºç”Ÿã™ã‚‹å•é¡Œã‚’削除ã™ã‚‹ä¿®æ£ `#147 <https://github.com/infobloxopen/infoblox-ansible/pull/147>`_" + +#: ../../rst/porting_guides/porting_guide_6.rst:229 +#: ../../rst/porting_guides/porting_guide_7.rst:937 +msgid "The dellemc.os10 collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/134)." +msgstr "dellemc.os10 コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 8 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 8 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/134) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_6.rst:230 +#: ../../rst/porting_guides/porting_guide_7.rst:938 +msgid "The dellemc.os6 collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/132)." +msgstr "dellemc.os6 コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 8 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 8 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/132) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_6.rst:231 +#: ../../rst/porting_guides/porting_guide_7.rst:939 +msgid "The dellemc.os9 collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/133)." +msgstr "dellemc.os9 コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 8 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 8 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/133) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_6.rst:236 +#: ../../rst/porting_guides/porting_guide_7.rst:1045 +msgid "lxc_container - the module will no longer make any effort to support Python 2 (https://github.com/ansible-collections/community.general/pull/5304)." +msgstr "lxc_container - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ Python 2 をサãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5304)。" + +#: ../../rst/porting_guides/porting_guide_6.rst:239 msgid "Porting Guide for v6.4.0" msgstr "v6.4.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" -#: ../../rst/porting_guides/porting_guide_6.rst:108 -#: ../../rst/porting_guides/porting_guide_7.rst:102 +#: ../../rst/porting_guides/porting_guide_6.rst:244 msgid "inspur.ispim (version 1.0.1)" msgstr "inspur.ispim (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.0.1)" -#: ../../rst/porting_guides/porting_guide_6.rst:109 -#: ../../rst/porting_guides/porting_guide_7.rst:104 +#: ../../rst/porting_guides/porting_guide_6.rst:245 msgid "vultr.cloud (version 1.1.0)" msgstr "vultr.cloud (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.1.0)" -#: ../../rst/porting_guides/porting_guide_6.rst:117 -#: ../../rst/porting_guides/porting_guide_7.rst:506 +#: ../../rst/porting_guides/porting_guide_6.rst:253 +#: ../../rst/porting_guides/porting_guide_7.rst:1047 msgid "proxmox - deprecated the current ``unprivileged`` default value, will be changed to ``true`` in community.general 7.0.0 (https://github.com/pull/5224)." msgstr "proxmox - ç¾åœ¨ã® ``unprivileged`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.general 7.0.0 㧠``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ (https://github.com/pull/5224)。" -#: ../../rst/porting_guides/porting_guide_6.rst:120 +#: ../../rst/porting_guides/porting_guide_6.rst:256 msgid "Porting Guide for v6.3.0" msgstr "v6.3.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" -#: ../../rst/porting_guides/porting_guide_6.rst:128 -#: ../../rst/porting_guides/porting_guide_7.rst:252 +#: ../../rst/porting_guides/porting_guide_6.rst:264 +#: ../../rst/porting_guides/porting_guide_7.rst:614 msgid "mysql_db - the ``pipefail`` argument's default value will be changed to ``true`` in community.mysql 4.0.0. If your target machines do not use ``bash`` as a default interpreter, set ``pipefail`` to ``false`` explicitly. However, we strongly recommend setting up ``bash`` as a default and ``pipefail=true`` as it will protect you from getting broken dumps you don't know about (https://github.com/ansible-collections/community.mysql/issues/407)." msgstr "mysql_db - ``pipefail`` 引数ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ community.mysql 4.0.0 ã§ã¯ ``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚ターゲットマシンãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã¨ã—㦠``bash`` を使用ã—ãªã„å ´åˆã¯ã€``pipefail`` ã‚’ ``false`` ã«æ˜Žç¤ºçš„ã«è¨å®šã—ã¦ãã ã•ã„。ãŸã ã—ã€çŸ¥ã‚‰ãªã„é–“ã«å£Šã‚ŒãŸãƒ€ãƒ³ãƒ—ã‚’å–å¾—ã™ã‚‹ã“ã¨ã‹ã‚‰ä¿è·ã™ã‚‹ãŸã‚ã€``bash`` (デフォルト) ãŠã‚ˆã³ ``pipefail=true`` をセットアップã™ã‚‹ã“ã¨ã‚’å¼·ããŠå‹§ã‚ã—ã¾ã™ (https://github.com/ansible-collections/community.mysql/issues/407)。" -#: ../../rst/porting_guides/porting_guide_6.rst:133 -#: ../../rst/porting_guides/porting_guide_7.rst:280 +#: ../../rst/porting_guides/porting_guide_6.rst:269 +#: ../../rst/porting_guides/porting_guide_7.rst:659 msgid "Support Diff feature in check_mode." msgstr "check_mode 㧠Diff 機能をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:134 -#: ../../rst/porting_guides/porting_guide_7.rst:281 +#: ../../rst/porting_guides/porting_guide_6.rst:270 +#: ../../rst/porting_guides/porting_guide_7.rst:660 msgid "Support Fortios 7.2.0." msgstr "Fortios 7.2.0 をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:139 -#: ../../rst/porting_guides/porting_guide_7.rst:431 +#: ../../rst/porting_guides/porting_guide_6.rst:275 +#: ../../rst/porting_guides/porting_guide_7.rst:940 msgid "The google.cloud collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/105)." msgstr "google.cloud コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 8 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 8 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/105) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:140 +#: ../../rst/porting_guides/porting_guide_6.rst:276 msgid "The servicenow.servicenow collection has been deprecated by its maintainers (https://github.com/ServiceNowITOM/servicenow-ansible/pull/69) and will be removed from Ansible 7. It can still be installed manually, but it is suggested to swich to `servicenow.itsm <https://galaxy.ansible.com/servicenow/itsm>`__ instead (https://github.com/ansible-community/community-topics/issues/124)." msgstr "servicenow.servicenow コレクションã¯ã€ãã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«ã‚ˆã£ã¦éžæŽ¨å¥¨ã¨ãªã‚Š (https://github.com/ServiceNowITOM/servicenow-ansible/pull/69)ã€Ansible 7 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚引ã続ã手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ãŒã€`servicenow.itsm <https://galaxy.ansible.com/servicenow/itsm>`__ instead ã«åˆ‡ã‚Šæ›¿ãˆã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ (https://github.com/ansible-community/community-topics/issues/124)。" -#: ../../rst/porting_guides/porting_guide_6.rst:143 +#: ../../rst/porting_guides/porting_guide_6.rst:279 msgid "Porting Guide for v6.2.0" msgstr "v6.2.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" -#: ../../rst/porting_guides/porting_guide_6.rst:148 -#: ../../rst/porting_guides/porting_guide_7.rst:101 +#: ../../rst/porting_guides/porting_guide_6.rst:284 msgid "ibm.spectrum_virtualize (version 1.9.0)" msgstr "ibm.spectrum_virtualize (version 1.9.0)" -#: ../../rst/porting_guides/porting_guide_6.rst:156 -#: ../../rst/porting_guides/porting_guide_7.rst:125 +#: ../../rst/porting_guides/porting_guide_6.rst:292 +#: ../../rst/porting_guides/porting_guide_7.rst:301 msgid "na_ontap_snapshot - added documentation to use UTC format for ``expiry_time``." msgstr "na_ontap_snapshot - ``expiry_time`` 用㮠UTC å½¢å¼ã‚’使用ã™ã‚‹ãŸã‚ã®ãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:164 -#: ../../rst/porting_guides/porting_guide_7.rst:257 +#: ../../rst/porting_guides/porting_guide_6.rst:300 +#: ../../rst/porting_guides/porting_guide_7.rst:625 msgid "postgresql_user - the ``groups`` argument has been deprecated and will be removed in ``community.postgresql 3.0.0``. Please use the ``postgresql_membership`` module to specify group/role memberships instead (https://github.com/ansible-collections/community.postgresql/issues/277)." msgstr "postgresql_user - ``groups`` 引数ã¯éžæŽ¨å¥¨ã«ãªã‚Šã€``community.postgresql 3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚グループ/ãƒãƒ¼ãƒ«ãƒ¡ãƒ³ãƒãƒ¼ã‚·ãƒƒãƒ—ã®æŒ‡å®šã«ã¯ã€ä»£ã‚ã‚Šã« ``postgresql_membership``を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/277)。" -#: ../../rst/porting_guides/porting_guide_6.rst:172 -#: ../../rst/porting_guides/porting_guide_7.rst:511 +#: ../../rst/porting_guides/porting_guide_6.rst:308 +#: ../../rst/porting_guides/porting_guide_7.rst:1053 msgid "vault_kv2_get lookup - the ``engine_mount_point option`` in the ``vault_kv2_get`` lookup only will change its default from ``kv`` to ``secret`` in community.hashi_vault version 4.0.0 (https://github.com/ansible-collections/community.hashi_vault/issues/279)." msgstr "vault_kv2_get ルックアップ - ``vault_kv2_get`` ルックアップ㮠``engine_mount_point option`` ã®ã¿ãŒã€community.hashi_vault ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 4.0.0 ã§ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’ ``kv`` ã‹ã‚‰ ``secret`` ã«å¤‰æ›´ã—ã¾ã™ (https://github.com/ansible-collections/community.hashi_vault/issues/279)。" -#: ../../rst/porting_guides/porting_guide_6.rst:175 +#: ../../rst/porting_guides/porting_guide_6.rst:311 msgid "Porting Guide for v6.1.0" msgstr "v6.1.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" -#: ../../rst/porting_guides/porting_guide_6.rst:180 +#: ../../rst/porting_guides/porting_guide_6.rst:316 msgid "purestorage.fusion (version 1.0.2)" msgstr "purestorage.fusion (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.0.2)" -#: ../../rst/porting_guides/porting_guide_6.rst:194 -#: ../../rst/porting_guides/porting_guide_6.rst:283 -#: ../../rst/porting_guides/porting_guide_7.rst:118 +#: ../../rst/porting_guides/porting_guide_6.rst:330 +#: ../../rst/porting_guides/porting_guide_6.rst:419 +#: ../../rst/porting_guides/porting_guide_7.rst:294 msgid "ome_device_power_settings - Issue(212679) - The module displays the following message if the value provided for the parameter ``power_cap`` is not within the supported range of 0 to 32767, ``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``" msgstr "ome_device_power_settings - Issue(212679)。パラメーター ``power_cap`` ã«æŒ‡å®šã•ã‚ŒãŸå€¤ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ 0 ã‹ã‚‰ 32767 ã®ç¯„囲内ã«ãªã„å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.`` woã¨å…±ã«ã‚¨ãƒ©ãƒ¼ã‚’発生ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:195 -#: ../../rst/porting_guides/porting_guide_6.rst:286 -#: ../../rst/porting_guides/porting_guide_7.rst:119 +#: ../../rst/porting_guides/porting_guide_6.rst:331 +#: ../../rst/porting_guides/porting_guide_6.rst:422 +#: ../../rst/porting_guides/porting_guide_7.rst:295 msgid "ome_device_quick_deploy - Issue(216352) - The module does not display a proper error message if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters." msgstr "ome_device_quick_deploy - Issue(216352)。ipv6_prefix_length ãŠã‚ˆã³ vlan_id パラメーターã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„値を指定ã™ã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’表示ã—ã¾ã›ã‚“。" -#: ../../rst/porting_guides/porting_guide_6.rst:204 -#: ../../rst/porting_guides/porting_guide_7.rst:219 +#: ../../rst/porting_guides/porting_guide_6.rst:340 +#: ../../rst/porting_guides/porting_guide_7.rst:546 msgid "win_chocolatey - Added bootstrap_script option to allow users to target a script URL for installing Chocolatey on clients." msgstr "win_chocolatey - クライアント㫠Chocolatey をインストールã™ã‚‹ãŸã‚ã®ã‚¹ã‚¯ãƒªãƒ—ト URL をユーザーãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆã«ã§ãるよã†ã«ã™ã‚‹ãŸã‚ã® bootstrap_script ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã‚’è¿½åŠ ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:205 -#: ../../rst/porting_guides/porting_guide_7.rst:220 +#: ../../rst/porting_guides/porting_guide_6.rst:341 +#: ../../rst/porting_guides/porting_guide_7.rst:547 msgid "win_chocolatey_facts - Added outdated packages list to data returned." msgstr "win_chocolatey_facts - è¿”ã•ã‚Œã‚‹ãƒ‡ãƒ¼ã‚¿ã«å¤ã„パッケージã®ãƒªã‚¹ãƒˆã‚’è¿½åŠ ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:208 -#: ../../rst/porting_guides/porting_guide_7.rst:284 -msgid "infoblox.nios_modules" -msgstr "infoblox.nios_modules" - -#: ../../rst/porting_guides/porting_guide_6.rst:210 -#: ../../rst/porting_guides/porting_guide_7.rst:286 +#: ../../rst/porting_guides/porting_guide_6.rst:346 +#: ../../rst/porting_guides/porting_guide_7.rst:667 msgid "Update `text` field of TXT Record `#128 <https://github.com/infobloxopen/infoblox-ansible/pull/128>`_" msgstr "TXT Record `#128 <https://github.com/infobloxopen/infoblox-ansible/pull/128>`_ ã® `text` フィールドを更新ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_6.rst:211 -#: ../../rst/porting_guides/porting_guide_7.rst:287 +#: ../../rst/porting_guides/porting_guide_6.rst:347 +#: ../../rst/porting_guides/porting_guide_7.rst:668 msgid "Update operation using `old_name` and `new_name` for the object with dummy name in `old_name` (which does not exist in system) will not create a new object in the system. An error will be thrown stating the object does not exist in the system `#129 <https://github.com/infobloxopen/infoblox-ansible/pull/129>`_" msgstr "`old_name` (システム内ã«å˜åœ¨ã—ãªã„) ã«ãƒ€ãƒŸãƒ¼åã‚’æŒã¤ã‚ªãƒ–ジェクト㮠`old_name` ãŠã‚ˆã³ `new_name` を使用ã—ã¦æ“作を更新ã—ã¦ã‚‚ã€ã‚·ã‚¹ãƒ†ãƒ 内ã«æ–°ã—ã„オブジェクトã¯ä½œæˆã•ã‚Œã¾ã›ã‚“。ãã®ã‚ªãƒ–ジェクトã¯ã‚·ã‚¹ãƒ†ãƒ ã«å˜åœ¨ã—ãªã„ã¨ã„ã†ã‚¨ãƒ©ãƒ¼ãŒæŠ•ã’られã¾ã™ `#129 <https://github.com/infobloxopen/infoblox-ansible/pull/129>`_" -#: ../../rst/porting_guides/porting_guide_6.rst:219 -#: ../../rst/porting_guides/porting_guide_7.rst:470 +#: ../../rst/porting_guides/porting_guide_6.rst:355 +#: ../../rst/porting_guides/porting_guide_7.rst:994 msgid "Deprecated ios_linkagg_module in favor of ios_lag_interfaces." msgstr "ios_lag_interfaces を優先ã—㦠ios_linkagg_module ã‚’éžæŽ¨å¥¨ã¨ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:224 -#: ../../rst/porting_guides/porting_guide_7.rst:476 +#: ../../rst/porting_guides/porting_guide_6.rst:360 +#: ../../rst/porting_guides/porting_guide_7.rst:1005 msgid "aws_codebuild - The ``tags`` parameter currently uses a non-standard format and has been deprecated. In release 6.0.0 this parameter will accept a simple key/value pair dictionary instead of the current list of dictionaries. It is recommended to migrate to using the resource_tags parameter which already accepts the simple dictionary format (https://github.com/ansible-collections/community.aws/pull/1221)." msgstr "aws_codebuild - ``tags`` パラメーターã¯ç¾åœ¨ã€éžæ¨™æº–å½¢å¼ã‚’使用ã—ã¦ã„ã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚リリース 6.0.0 ã§ã¯ã€ã“ã®ãƒ‘ラメーターã¯ã€ç¾åœ¨ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒªã‚¹ãƒˆã§ã¯ãªãã€å˜ç´”ãªã‚ーã¨å€¤ã®ãƒšã‚¢ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã‚’å—ã‘入れã¾ã™ã€‚å˜ç´”ãªãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼å½¢å¼ã‚’ã™ã§ã«å—ã‘入れã¦ã„ã‚‹ resource_tags パラメーターを使用ã™ã‚‹ã‚ˆã†ã«ç§»è¡Œã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1221)。" -#: ../../rst/porting_guides/porting_guide_6.rst:225 -#: ../../rst/porting_guides/porting_guide_7.rst:487 +#: ../../rst/porting_guides/porting_guide_6.rst:361 +#: ../../rst/porting_guides/porting_guide_7.rst:1016 msgid "route53_info - The CamelCase return values for ``HostedZones``, ``ResourceRecordSets``, and ``HealthChecks`` have been deprecated, in the future release you must use snake_case return values ``hosted_zones``, ``resource_record_sets``, and ``health_checks`` instead respectively\"." msgstr "route53_info - ``HostedZones``ã€``ResourceRecordSets`` ã® CamelCase ã®æˆ»ã‚Šå€¤ãŠã‚ˆã³ ``HealthChecks`` ãŒéžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚今後ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€ä»£ã‚ã‚Šã« ``hosted_zones``ã€``resource_record_sets`` ã® snake_case ã®æˆ»ã‚Šå€¤ãŠã‚ˆã³ ``health_checks`` ã‚’ãã‚Œãžã‚Œä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:230 -#: ../../rst/porting_guides/porting_guide_7.rst:494 +#: ../../rst/porting_guides/porting_guide_6.rst:366 +#: ../../rst/porting_guides/porting_guide_7.rst:1023 msgid "Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.crypto 3.0.0). Some modules might still work with these versions afterwards, but we will no longer keep compatibility code that was needed to support them (https://github.com/ansible-collections/community.crypto/pull/460)." msgstr "Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã«ãªã‚Šã€æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ (community.crypto 3.0.0) ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚モジュールã«ã‚ˆã£ã¦ã¯ã€ãã®å¾Œã‚‚ã“れらã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã動作ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€ã‚µãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã«å¿…è¦ãªäº’æ›æ€§ã‚³ãƒ¼ãƒ‰ã¯ä¿æŒã•ã‚Œãªããªã‚Šã¾ã™ (https://github.com/ansible-collections/community.crypto/pull/460)。" -#: ../../rst/porting_guides/porting_guide_6.rst:235 -#: ../../rst/porting_guides/porting_guide_7.rst:499 +#: ../../rst/porting_guides/porting_guide_6.rst:371 +#: ../../rst/porting_guides/porting_guide_7.rst:1028 msgid "Support for Docker API version 1.20 to 1.24 has been deprecated and will be removed in community.docker 3.0.0. The first Docker version supporting API version 1.25 was Docker 1.13, released in January 2017. This affects the modules ``docker_container``, ``docker_container_exec``, ``docker_container_info``, ``docker_compose``, ``docker_login``, ``docker_image``, ``docker_image_info``, ``docker_image_load``, ``docker_host_info``, ``docker_network``, ``docker_network_info``, ``docker_node_info``, ``docker_swarm_info``, ``docker_swarm_service``, ``docker_swarm_service_info``, ``docker_volume_info``, and ``docker_volume``, whose minimally supported API version is between 1.20 and 1.24 (https://github.com/ansible-collections/community.docker/pull/396)." msgstr "Docker API ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.20 ã‹ã‚‰ 1.24 ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.docker 3.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚API ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.25 をサãƒãƒ¼ãƒˆã™ã‚‹æœ€åˆã® Docker ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€2017 å¹´ 1 月ã«ãƒªãƒªãƒ¼ã‚¹ã•ã‚ŒãŸ Docker 1.13 ã§ã—ãŸã€‚ã“ã‚Œã¯ã€``docker_container``ã€``docker_container_exec``ã€``docker_container_info``ã€``docker_compose``ã€``docker_login``ã€``docker_image``ã€``docker_image_info``ã€``docker_image_load``ã€``docker_host_info``ã€``docker_network``ã€``docker_network_info``ã€``docker_node_info``ã€``docker_swarm_info``ã€``docker_swarm_service``ã€``docker_swarm_service_info``ã€``docker_volume_info`` ãŠã‚ˆã³ ``docker_volume`` モジュールã«å½±éŸ¿ã—ã¾ã™ã€‚ã“れらã®æœ€ä½Žé™ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ API ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ 1.20 ã‹ã‚‰ 1.24 ã®é–“ã«ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/396)。" -#: ../../rst/porting_guides/porting_guide_6.rst:236 -#: ../../rst/porting_guides/porting_guide_7.rst:500 +#: ../../rst/porting_guides/porting_guide_6.rst:372 +#: ../../rst/porting_guides/porting_guide_7.rst:1029 msgid "Support for Python 2.6 is deprecated and will be removed in the next major release (community.docker 3.0.0). Some modules might still work with Python 2.6, but we will no longer try to ensure compatibility (https://github.com/ansible-collections/community.docker/pull/388)." msgstr "Python 2.6 ã®ã‚µãƒãƒ¼ãƒˆãŒéžæŽ¨å¥¨ã¨ãªã‚Šã€æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ (community.docker 3.0.0) ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚一部ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å¼•ã続ã Python 2.6 ã§å‹•ä½œã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€ä»Šå¾Œã¯äº’æ›æ€§ã®ç¢ºä¿ã‚’試行ã™ã‚‹ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“ (https://github.com/ansible-collections/community.docker/pull/388)。" -#: ../../rst/porting_guides/porting_guide_6.rst:241 -#: ../../rst/porting_guides/porting_guide_7.rst:505 +#: ../../rst/porting_guides/porting_guide_6.rst:377 +#: ../../rst/porting_guides/porting_guide_7.rst:1040 msgid "cmd_runner module utils - deprecated ``fmt`` in favour of ``cmd_runner_fmt`` as the parameter format object (https://github.com/ansible-collections/community.general/pull/4777)." msgstr "cmd_runner モジュール utils - パラメーター形å¼ã‚ªãƒ–ジェクトã¨ã—ã¦ã€``cmd_runner_fmt`` を優先ã—㦠``fmt`` ã‚’éžæŽ¨å¥¨ã¨ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4777)。" -#: ../../rst/porting_guides/porting_guide_6.rst:244 +#: ../../rst/porting_guides/porting_guide_6.rst:380 msgid "Porting Guide for v6.0.0" msgstr "v6.0.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" -#: ../../rst/porting_guides/porting_guide_6.rst:260 +#: ../../rst/porting_guides/porting_guide_6.rst:396 msgid "get_url - document ``check_mode`` correctly with unreliable changed status (https://github.com/ansible/ansible/issues/65687)." msgstr "get_url - ä¿¡é ¼ã§ããªã„ changed ステータス㮠``check_mode`` ã‚’æ£ã—ã記録ã—ã¾ã™ (https://github.com/ansible/ansible/issues/65687)。" -#: ../../rst/porting_guides/porting_guide_6.rst:265 +#: ../../rst/porting_guides/porting_guide_6.rst:401 msgid "eos - When using eos modules on Ansible 2.9, tasks will occasionally fail with ``import_modules`` enabled. This can be avoided by setting ``import_modules: no``" msgstr "EOS - Ansible 2.9 㧠eos モジュールを使用ã™ã‚‹ã¨ã€``import_modules`` ãŒæœ‰åŠ¹åŒ–ã•ã‚Œã¦ã‚¿ã‚¹ã‚¯ãŒå¤±æ•—ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€``import_modules: no`` ã‚’è¨å®šã™ã‚‹ã“ã¨ã§å›žé¿ã§ãã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:279 +#: ../../rst/porting_guides/porting_guide_6.rst:415 msgid "ome_application_console_preferences - Issue(224690) - The module does not display a proper error message when an unsupported value is provided for the parameters report_row_limit, email_sender_settings, and metric_collection_settings, and the value is applied on OpenManage Enterprise." msgstr "ome_application_console_preferences - Issue (224690)。モジュールã¯ã€report_row_limitã€email_sender_settingsã€metric_collection_settings パラメーターã«ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„値を指定ã™ã‚‹ã¨ã€é©åˆ‡ãªã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã‚’表示ã—ã¾ã›ã‚“。ã¾ãŸã€å€¤ã¯ OpenManage Enterprise ã«é©ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:285 +#: ../../rst/porting_guides/porting_guide_6.rst:421 msgid "ome_device_power_settings - Issue(212679) - The module errors out with the following message if the value provided for the parameter ``power_cap`` is not within the supported range of 0 to 32767, ``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``" msgstr "ome_device_power_settings - Issue(212679)。パラメーター ``power_cap`` ã«æŒ‡å®šã•ã‚ŒãŸå€¤ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ 0 ã‹ã‚‰ 32767 ã®ç¯„囲内ã«ãªã„å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯``Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.``ã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¨å…±ã«ã‚¨ãƒ©ãƒ¼ã‚’発生ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:300 +#: ../../rst/porting_guides/porting_guide_6.rst:436 msgid "Module Python Dependency - Drop support for Python 2.6 in module execution." msgstr "モジュール Python ã®ä¾å˜é–¢ä¿‚ - モジュール実行㧠Python 2.6 ã®ãƒ‰ãƒãƒƒãƒ—サãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:301 +#: ../../rst/porting_guides/porting_guide_6.rst:437 msgid "Templating - it is no longer allowed to perform arithmetic and concatenation operations outside of the jinja template (https://github.com/ansible/ansible/pull/75587)" msgstr "テンプレート化 - jinja テンプレートã®å¤–部ã§ç®—術演算ã¨é€£çµæ¼”算を実行ã§ããªããªã‚Šã¾ã—㟠(https://github.com/ansible/ansible/pull/75587)。" -#: ../../rst/porting_guides/porting_guide_6.rst:302 +#: ../../rst/porting_guides/porting_guide_6.rst:438 msgid "The ``finalize`` method is no longer exposed in the globals for use in templating." msgstr "``finalize`` メソッドã¯ã€ãƒ†ãƒ³ãƒ—レートã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«ã‚°ãƒãƒ¼ãƒãƒ«ã§å…¬é–‹ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:307 +#: ../../rst/porting_guides/porting_guide_6.rst:443 msgid "aws_caller_facts - Remove deprecated ``aws_caller_facts`` alias. Please use ``aws_caller_info`` instead." msgstr "aws_caller_facts - éžæŽ¨å¥¨ã® ``aws_caller_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_caller_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:308 +#: ../../rst/porting_guides/porting_guide_6.rst:444 msgid "cloudformation_facts - Remove deprecated ``cloudformation_facts`` alias. Please use ``cloudformation_info`` instead." msgstr "cloudformation_facts - éžæŽ¨å¥¨ã® ``cloudformation_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``cloudformation_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:309 +#: ../../rst/porting_guides/porting_guide_6.rst:445 msgid "ec2_ami_facts - Remove deprecated ``ec2_ami_facts`` alias. Please use ``ec2_ami_info`` instead." msgstr "ec2_ami_facts - éžæŽ¨å¥¨ã® ``ec2_ami_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_ami_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:310 +#: ../../rst/porting_guides/porting_guide_6.rst:446 msgid "ec2_eni_facts - Remove deprecated ``ec2_eni_facts`` alias. Please use ``ec2_eni_info`` instead." msgstr "ec2_eni_facts - éžæŽ¨å¥¨ã® ``ec2_eni_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_eni_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:311 +#: ../../rst/porting_guides/porting_guide_6.rst:447 msgid "ec2_group_facts - Remove deprecated ``ec2_group_facts`` alias. Please use ``ec2_group_info`` instead." msgstr "ec2_group_facts - éžæŽ¨å¥¨ã® ``ec2_group_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_group_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:312 +#: ../../rst/porting_guides/porting_guide_6.rst:448 msgid "ec2_instance_facts - Remove deprecated ``ec2_instance_facts`` alias. Please use ``ec2_instance_info`` instead." msgstr "ec2_instance_facts - éžæŽ¨å¥¨ã® ``ec2_instance_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_instance_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:313 +#: ../../rst/porting_guides/porting_guide_6.rst:449 msgid "ec2_snapshot_facts - Remove deprecated ``ec2_snapshot_facts`` alias. Please use ``ec2_snapshot_info`` instead." msgstr "ec2_snapshot_facts - éžæŽ¨å¥¨ã® ``ec2_snapshot_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_snapshot_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:314 +#: ../../rst/porting_guides/porting_guide_6.rst:450 msgid "ec2_vol_facts - Remove deprecated ``ec2_vol_facts`` alias. Please use ``ec2_vol_info`` instead." msgstr "ec2_vol_facts - éžæŽ¨å¥¨ã® ``ec2_vol_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vol_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:315 +#: ../../rst/porting_guides/porting_guide_6.rst:451 msgid "ec2_vpc_dhcp_option_facts - Remove deprecated ``ec2_vpc_dhcp_option_facts`` alias. Please use ``ec2_vpc_dhcp_option_info`` instead." msgstr "ec2_vpc_dhcp_option_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_dhcp_option_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_dhcp_option_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:316 +#: ../../rst/porting_guides/porting_guide_6.rst:452 msgid "ec2_vpc_endpoint_facts - Remove deprecated ``ec2_vpc_endpoint_facts`` alias. Please use ``ec2_vpc_endpoint_info`` instead." msgstr "ec2_vpc_endpoint_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_endpoint_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_endpoint_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:317 +#: ../../rst/porting_guides/porting_guide_6.rst:453 msgid "ec2_vpc_igw_facts - Remove deprecated ``ec2_vpc_igw_facts`` alias. Please use ``ec2_vpc_igw_info`` instead." msgstr "ec2_vpc_igw_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_igw_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_igw_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:318 +#: ../../rst/porting_guides/porting_guide_6.rst:454 msgid "ec2_vpc_nat_gateway_facts - Remove deprecated ``ec2_vpc_nat_gateway_facts`` alias. Please use ``ec2_vpc_nat_gateway_info`` instead." msgstr "ec2_vpc_nat_gateway_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_nat_gateway_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_nat_gateway_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:319 +#: ../../rst/porting_guides/porting_guide_6.rst:455 msgid "ec2_vpc_net_facts - Remove deprecated ``ec2_vpc_net_facts`` alias. Please use ``ec2_vpc_net_info`` instead." msgstr "ec2_vpc_net_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_net_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_net_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:320 +#: ../../rst/porting_guides/porting_guide_6.rst:456 msgid "ec2_vpc_route_table_facts - Remove deprecated ``ec2_vpc_route_table_facts`` alias. Please use ``ec2_vpc_route_table_info`` instead." msgstr "ec2_vpc_route_table_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_route_table_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_route_table_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:321 +#: ../../rst/porting_guides/porting_guide_6.rst:457 msgid "ec2_vpc_subnet_facts - Remove deprecated ``ec2_vpc_subnet_facts`` alias. Please use ``ec2_vpc_subnet_info`` instead." msgstr "ec2_vpc_subnet_facts - éžæŽ¨å¥¨ã® ``ec2_vpc_subnet_facts`` エイリアスを削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_subnet_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:326 +#: ../../rst/porting_guides/porting_guide_6.rst:462 msgid "httpapi - Change default value of ``import_modules`` option from ``no`` to ``yes``" msgstr "httpapi - ``import_modules`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ ``no`` ã‹ã‚‰ ``yes`` ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:327 +#: ../../rst/porting_guides/porting_guide_6.rst:463 msgid "netconf - Change default value of ``import_modules`` option from ``no`` to ``yes``" msgstr "netconf - ``import_modules`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ ``no`` ã‹ã‚‰ ``yes`` ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:328 +#: ../../rst/porting_guides/porting_guide_6.rst:464 msgid "network_cli - Change default value of ``import_modules`` option from ``no`` to ``yes``" msgstr "network_cli - ``import_modules`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ ``no`` ã‹ã‚‰ ``yes`` ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:333 +#: ../../rst/porting_guides/porting_guide_6.rst:469 msgid "eos_command - new suboption ``version`` of parameter ``command``, which controls the JSON response version. Previously the value was assumed to be \"latest\" for network_cli and \"1\" for httpapi, but the default will now be \"latest\" for both connections. This option is also available for use in modules making their own device requests with ``plugins.module_utils.network.eos.eos.run_commands()`` with the same new default behavior. (https://github.com/ansible-collections/arista.eos/pull/258)." msgstr "eos_command - パラメーター ``command`` ã®æ–°ã—ã„サブオプション ``version`` ã¯ã€JSON å¿œç”ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’制御ã—ã¾ã™ã€‚ã“ã‚Œã¾ã§ã¯ã€å€¤ã¯ network_cli ã®å ´åˆã¯ã€Œlatestã€ã€httpapi ã®å ´åˆã¯ã€Œ1ã€ã¨æƒ³å®šã•ã‚Œã¦ã„ã¾ã—ãŸãŒã€ä¸¡æ–¹ã®æŽ¥ç¶šã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€Œlatestã€ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®ã‚ªãƒ—ションã¯ã€åŒã˜æ–°ã—ã„デフォルトã®å‹•ä½œã§ ``plugins.module_utils.network.eos.eos.run_commands()`` を使用ã—ã¦ç‹¬è‡ªã®ãƒ‡ãƒã‚¤ã‚¹è¦æ±‚ã‚’è¡Œã†ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã‚‚使用ã§ãã¾ã™ (https://github.com/ansible-collections/arista.eos/pull/258)。" -#: ../../rst/porting_guides/porting_guide_6.rst:334 +#: ../../rst/porting_guides/porting_guide_6.rst:470 msgid "httpapi - the ``eos_use_sessions`` option is now a boolean instead of an integer." msgstr "httpapi - ``eos_use_sessions`` オプションã¯æ•´æ•°ã§ã¯ãªãブール値ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:339 +#: ../../rst/porting_guides/porting_guide_6.rst:475 msgid "aws_acm_facts - Remove deprecated alias ``aws_acm_facts``. Please use ``aws_acm_info`` instead." msgstr "aws_acm_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_acm_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_acm_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:340 +#: ../../rst/porting_guides/porting_guide_6.rst:476 msgid "aws_kms_facts - Remove deprecated alias ``aws_kms_facts``. Please use ``aws_kms_info`` instead." msgstr "aws_kms_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_kms_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_kms_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:341 +#: ../../rst/porting_guides/porting_guide_6.rst:477 msgid "aws_kms_info - Deprecated ``keys_attr`` field is now ignored (https://github.com/ansible-collections/community.aws/pull/838)." msgstr "aws_kms_info - éžæŽ¨å¥¨ã® ``keys_attr`` フィールドã¯ç„¡è¦–ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/838)。" -#: ../../rst/porting_guides/porting_guide_6.rst:342 +#: ../../rst/porting_guides/porting_guide_6.rst:478 msgid "aws_region_facts - Remove deprecated alias ``aws_region_facts``. Please use ``aws_region_info`` instead." msgstr "aws_region_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_region_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_region_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:343 +#: ../../rst/porting_guides/porting_guide_6.rst:479 msgid "aws_s3_bucket_facts - Remove deprecated alias ``aws_s3_bucket_facts``. Please use ``aws_s3_bucket_info`` instead." msgstr "aws_s3_bucket_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_s3_bucket_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_s3_bucket_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:344 +#: ../../rst/porting_guides/porting_guide_6.rst:480 msgid "aws_sgw_facts - Remove deprecated alias ``aws_sgw_facts``. Please use ``aws_sgw_info`` instead." msgstr "aws_sgw_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_sgw_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_sgw_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:345 +#: ../../rst/porting_guides/porting_guide_6.rst:481 msgid "aws_waf_facts - Remove deprecated alias ``aws_waf_facts``. Please use ``aws_waf_info`` instead." msgstr "aws_waf_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_waf_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``aws_waf_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:346 +#: ../../rst/porting_guides/porting_guide_6.rst:482 msgid "cloudfront_facts - Remove deprecated alias ``cloudfront_facts``. Please use ``cloudfront_info`` instead." msgstr "cloudfront_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``cloudfront_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``cloudfront_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:347 +#: ../../rst/porting_guides/porting_guide_6.rst:483 msgid "cloudwatchlogs_log_group_facts - Remove deprecated alias ``cloudwatchlogs_log_group_facts``. Please use ``cloudwatchlogs_log_group_info`` instead." msgstr "cloudwatchlogs_log_group_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``cloudwatchlogs_log_group_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``cloudwatchlogs_log_group_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:348 +#: ../../rst/porting_guides/porting_guide_6.rst:484 msgid "dynamodb_table - deprecated updates currently ignored for primary keys and global_all indexes will now result in a failure. (https://github.com/ansible-collections/community.aws/pull/837)." msgstr "dynamodb_table - プライマリーã‚ー㨠global_all インデックスã§ç¾åœ¨ç„¡è¦–ã•ã‚Œã¦ã„ã‚‹æ›´æ–°ãŒéžæŽ¨å¥¨ã«ãªã‚Šã€ä»Šå¾Œã¯å¤±æ•—ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.aws/pull/837)。" -#: ../../rst/porting_guides/porting_guide_6.rst:349 +#: ../../rst/porting_guides/porting_guide_6.rst:485 msgid "ec2_asg_facts - Remove deprecated alias ``ec2_asg_facts``. Please use ``ec2_asg_info`` instead." msgstr "ec2_asg_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_asg_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_asg_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:350 +#: ../../rst/porting_guides/porting_guide_6.rst:486 msgid "ec2_customer_gateway_facts - Remove deprecated alias ``ec2_customer_gateway_facts``. Please use ``ec2_customer_gateway_info`` instead." msgstr "ec2_customer_gateway_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_customer_gateway_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_customer_gateway_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:351 +#: ../../rst/porting_guides/porting_guide_6.rst:487 msgid "ec2_eip_facts - Remove deprecated alias ``ec2_eip_facts``. Please use ``ec2_eip_info`` instead." msgstr "ec2_eip_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_eip_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_eip_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:352 +#: ../../rst/porting_guides/porting_guide_6.rst:488 msgid "ec2_elb_facts - Remove deprecated alias ``ec2_elb_facts``. Please use ``ec2_elb_info`` instead." msgstr "ec2_elb_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_elb_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_elb_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:353 +#: ../../rst/porting_guides/porting_guide_6.rst:489 msgid "ec2_elb_info - The ``ec2_elb_info`` module has been removed. Please use ``the ``elb_classic_lb_info`` module." msgstr "ec2_elb_info - ``ec2_elb_info`` モジュールãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚``the ``elb_classic_lb_info'' モジュールを使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:354 +#: ../../rst/porting_guides/porting_guide_6.rst:490 msgid "ec2_lc_facts - Remove deprecated alias ``ec2_lc_facts``. Please use ``ec2_lc_info`` instead." msgstr "ec2_lc_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_lc_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_lc_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:355 +#: ../../rst/porting_guides/porting_guide_6.rst:491 msgid "ec2_placement_group_facts - Remove deprecated alias ``ec2_placement_group_facts``. Please use ``ec2_placement_group_info`` instead." msgstr "ec2_placement_group_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_placement_group_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_placement_group_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:356 +#: ../../rst/porting_guides/porting_guide_6.rst:492 msgid "ec2_vpc_nacl_facts - Remove deprecated alias ``ec2_vpc_nacl_facts``. Please use ``ec2_vpc_nacl_info`` instead." msgstr "ec2_vpc_nacl_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_vpc_nacl_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_nacl_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:357 +#: ../../rst/porting_guides/porting_guide_6.rst:493 msgid "ec2_vpc_peering_facts - Remove deprecated alias ``ec2_vpc_peering_facts``. Please use ``ec2_vpc_peering_info`` instead." msgstr "ec2_vpc_peering_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_vpc_peering_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_peering_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:358 +#: ../../rst/porting_guides/porting_guide_6.rst:494 msgid "ec2_vpc_route_table_facts - Remove deprecated alias ``ec2_vpc_route_table_facts``. Please use ``ec2_vpc_route_table_info`` instead." msgstr "ec2_vpc_route_table_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_vpc_route_table_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_route_table_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:359 +#: ../../rst/porting_guides/porting_guide_6.rst:495 msgid "ec2_vpc_vgw_facts - Remove deprecated alias ``ec2_vpc_vgw_facts``. Please use ``ec2_vpc_vgw_info`` instead." msgstr "ec2_vpc_vgw_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_vpc_vgw_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_vgw_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:360 +#: ../../rst/porting_guides/porting_guide_6.rst:496 msgid "ec2_vpc_vpn_facts - Remove deprecated alias ``ec2_vpc_vpn_facts``. Please use ``ec2_vpc_vpn_info`` instead." msgstr "ec2_vpc_vpn_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ec2_vpc_vpn_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ec2_vpc_vpn_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:361 +#: ../../rst/porting_guides/porting_guide_6.rst:497 msgid "ecs_service_facts - Remove deprecated alias ``ecs_service_facts``. Please use ``ecs_service_info`` instead." msgstr "ecs_service_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ecs_service_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ecs_service_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:362 +#: ../../rst/porting_guides/porting_guide_6.rst:498 msgid "ecs_taskdefinition_facts - Remove deprecated alias ``ecs_taskdefinition_facts``. Please use ``ecs_taskdefinition_info`` instead." msgstr "ecs_taskdefinition_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``ecs_taskdefinition_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ecs_taskdefinition_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:363 +#: ../../rst/porting_guides/porting_guide_6.rst:499 msgid "efs_facts - Remove deprecated alias ``efs_facts``. Please use ``efs_info`` instead." msgstr "efs_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``efs_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``efs_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:364 +#: ../../rst/porting_guides/porting_guide_6.rst:500 msgid "elasticache_facts - Remove deprecated alias ``elasticache_facts``. Please use ``elasticache_info`` instead." msgstr "elasticache_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``elasticache_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``elasticache_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:365 +#: ../../rst/porting_guides/porting_guide_6.rst:501 msgid "elb_application_lb_facts - Remove deprecated alias ``elb_application_lb_facts``. Please use ``elb_application_lb_info`` instead." msgstr "elb_application_lb_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``elb_application_lb_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``elb_application_lb_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:366 +#: ../../rst/porting_guides/porting_guide_6.rst:502 msgid "elb_classic_lb_facts - Remove deprecated alias ``elb_classic_lb_facts``. Please use ``elb_classic_lb_info`` instead." msgstr "elb_classic_lb_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``elb_classic_lb_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``elb_classic_lb_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:367 +#: ../../rst/porting_guides/porting_guide_6.rst:503 msgid "elb_target_facts - Remove deprecated alias ``elb_target_facts``. Please use ``elb_target_info`` instead." msgstr "elb_target_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``elb_target_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``elb_target_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:368 +#: ../../rst/porting_guides/porting_guide_6.rst:504 msgid "elb_target_group_facts - Remove deprecated alias ``elb_target_group_facts``. Please use ``elb_target_group_info`` instead." msgstr "elb_target_group_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``elb_target_group_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``elb_target_group_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:369 +#: ../../rst/porting_guides/porting_guide_6.rst:505 msgid "iam - Removed deprecated ``community.aws.iam`` module. Please use ``community.aws.iam_user``, ``community.aws.iam_access_key`` or ``community.aws.iam_group`` (https://github.com/ansible-collections/community.aws/pull/839)." msgstr "iam - éžæŽ¨å¥¨ã® ``community.aws.iam`` モジュールを削除ã—ã¾ã—ãŸã€‚``community.aws.iam_user``ã€``community.aws.iam_access_key``ã€ã¾ãŸã¯ ``community.aws.iam_group`` (https://github.com/ansible-collections/community.aws/pull/839) を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:370 +#: ../../rst/porting_guides/porting_guide_6.rst:506 msgid "iam_cert_facts - Remove deprecated alias ``iam_cert_facts``. Please use ``iam_cert_info`` instead." msgstr "iam_cert_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``iam_cert_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``iam_cert_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:371 +#: ../../rst/porting_guides/porting_guide_6.rst:507 msgid "iam_mfa_device_facts - Remove deprecated alias ``iam_mfa_device_facts``. Please use ``iam_mfa_device_info`` instead." msgstr "iam_mfa_device_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``iam_mfa_device_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``iam_mfa_device_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:372 +#: ../../rst/porting_guides/porting_guide_6.rst:508 msgid "iam_role_facts - Remove deprecated alias ``iam_role_facts``. Please use ``iam_role_info`` instead." msgstr "iam_role_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``iam_role_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``iam_role_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:373 +#: ../../rst/porting_guides/porting_guide_6.rst:509 msgid "iam_server_certificate_facts - Remove deprecated alias ``iam_server_certificate_facts``. Please use ``iam_server_certificate_info`` instead." msgstr "iam_server_certificate_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``iam_server_certificate_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``iam_server_certificate_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:374 +#: ../../rst/porting_guides/porting_guide_6.rst:510 msgid "lambda_facts - Remove deprecated module lambda_facts``. Please use ``lambda_info`` instead." msgstr "lambda_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« lambda_facts を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã«``. Please use ``lambda_info'' を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:375 +#: ../../rst/porting_guides/porting_guide_6.rst:511 msgid "rds - Removed deprecated ``community.aws.rds`` module. Please use ``community.aws.rds_instance`` (https://github.com/ansible-collections/community.aws/pull/839)." msgstr "RDS - éžæŽ¨å¥¨ã® ``community.aws.rds`` モジュールを削除ã—ã¾ã—ãŸã€‚``community.aws.rds_instance`` を使用ã—ã¦ãã ã•ã„(https://github.com/ansible-collections/community.aws/pull/839)。" -#: ../../rst/porting_guides/porting_guide_6.rst:376 +#: ../../rst/porting_guides/porting_guide_6.rst:512 msgid "rds_instance_facts - Remove deprecated alias ``rds_instance_facts``. Please use ``rds_instance_info`` instead." msgstr "rds_instance_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``rds_instance_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``rds_instance_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:377 +#: ../../rst/porting_guides/porting_guide_6.rst:513 msgid "rds_snapshot_facts - Remove deprecated alias ``rds_snapshot_facts``. Please use ``rds_snapshot_info`` instead." msgstr "rds_snapshot_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``rds_snapshot_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``rds_snapshot_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:378 +#: ../../rst/porting_guides/porting_guide_6.rst:514 msgid "redshift_facts - Remove deprecated alias ``redshift_facts``. Please use ``redshift_info`` instead." msgstr "redshift_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``redshift_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``redshift_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:379 +#: ../../rst/porting_guides/porting_guide_6.rst:515 msgid "route53_facts - Remove deprecated alias ``route53_facts``. Please use ``route53_info`` instead." msgstr "route53_facts - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``route53_facts`` を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``route53_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:384 +#: ../../rst/porting_guides/porting_guide_6.rst:520 msgid "Parts of this collection do not work with ansible-core 2.11 on Python 3.12+. Please either upgrade to ansible-core 2.12+, or use Python 3.11 or earlier (https://github.com/ansible-collections/community.general/pull/3988)." msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€éƒ¨ã¯ã€Python 3.12+ ã® ansible-core 2.11 ã§ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。ansible-core 2.12+ ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã‹ã€Python 3.11 以å‰ã‚’使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.general/pull/3988)。" -#: ../../rst/porting_guides/porting_guide_6.rst:385 +#: ../../rst/porting_guides/porting_guide_6.rst:521 msgid "The symbolic links used to implement flatmapping for all modules were removed and replaced by ``meta/runtime.yml`` redirects. This effectively breaks compatibility with Ansible 2.9 for all modules (without using their \"long\" names, which is discouraged and which can change without previous notice since they are considered an implementation detail) (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ãƒ•ãƒ©ãƒƒãƒˆãƒžãƒƒãƒ”ングã®å®Ÿè£…ã«ä½¿ç”¨ã•ã‚Œã‚‹ã‚·ãƒ³ãƒœãƒªãƒƒã‚¯ãƒªãƒ³ã‚¯ãŒå‰Šé™¤ã•ã‚Œã€``meta/runtime.yml`` リダイレクトã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸã€‚ã“ã‚Œã«ã‚ˆã‚Šã€ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã® Ansible 2.9 ã¨ã®äº’æ›æ€§ãŒäº‹å®Ÿä¸Šå¤±ã‚ã‚Œã¾ã™ (éžæŽ¨å¥¨ã§ã‚ã‚Šã€å®Ÿè£…ã®è©³ç´°ã¨ã¿ãªã•ã‚Œã‚‹ãŸã‚事å‰ã®é€šçŸ¥ãªã—ã«å¤‰æ›´ã§ãã‚‹ã€ã€Œé•·ã„ã€åå‰ã¯ä½¿ç”¨ã—ã¾ã›ã‚“) (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:386 +#: ../../rst/porting_guides/porting_guide_6.rst:522 msgid "a_module test plugin - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "a_module テストプラグイン - Ansible 2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:387 +#: ../../rst/porting_guides/porting_guide_6.rst:523 msgid "archive - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "archive - Ansible 2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:388 +#: ../../rst/porting_guides/porting_guide_6.rst:524 msgid "git_config - remove Ansible 2.9 and early ansible-base 2.10 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "git_config - Ansible 2.9 ãŠã‚ˆã³åˆæœŸ ansible-base 2.10 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:389 +#: ../../rst/porting_guides/porting_guide_6.rst:525 msgid "java_keystore - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "java_keystore - Ansible 2.9 互æ›ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™(https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:390 +#: ../../rst/porting_guides/porting_guide_6.rst:526 msgid "lists_mergeby and groupby_as_dict filter plugins - adjust filter plugin filename. This change is not visible to end-users, it only affects possible other collections importing Python paths (https://github.com/ansible-collections/community.general/pull/4625)." msgstr "lists_mergeby ãŠã‚ˆã³ groupby_as_dict フィルタープラグイン - フィルタープラグインã®ãƒ•ã‚¡ã‚¤ãƒ«åを調整ã—ã¾ã™ã€‚ã“ã®å¤‰æ›´ã¯ã‚¨ãƒ³ãƒ‰ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«ã¯è¡¨ç¤ºã•ã‚Œã¾ã›ã‚“ãŒã€Python パスをインãƒãƒ¼ãƒˆã™ã‚‹ä»–ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ã®ã¿å½±éŸ¿ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/4625)。" -#: ../../rst/porting_guides/porting_guide_6.rst:391 +#: ../../rst/porting_guides/porting_guide_6.rst:527 msgid "lists_mergeby filter plugin - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "lists_mergeby フィルタープラグイン - Ansible2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:392 +#: ../../rst/porting_guides/porting_guide_6.rst:528 msgid "maven_artifact - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "maven_artifact - Ansible 2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:393 +#: ../../rst/porting_guides/porting_guide_6.rst:529 msgid "memcached cache plugin - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "memcached ã‚ャッシュプラグイン - Ansible2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:394 +#: ../../rst/porting_guides/porting_guide_6.rst:530 msgid "path_join filter plugin shim - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "path_join フィルタープラグインshim _ Ansible 2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:395 +#: ../../rst/porting_guides/porting_guide_6.rst:531 msgid "redis cache plugin - remove Ansible 2.9 compatibility code (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "redis ã‚ャッシュプラグイン - Ansible2.9 互æ›æ€§ã‚³ãƒ¼ãƒ‰ã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:396 +#: ../../rst/porting_guides/porting_guide_6.rst:532 msgid "yarn - remove unsupported and unnecessary ``--no-emoji`` flag (https://github.com/ansible-collections/community.general/pull/4662)." msgstr "yarn - サãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ãªã„ä¸è¦ãª ``--no-emoji`` フラグを削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4662)。" -#: ../../rst/porting_guides/porting_guide_6.rst:401 +#: ../../rst/porting_guides/porting_guide_6.rst:537 msgid "mysql_replication - remove ``Is_Slave`` and ``Is_Master`` return values (were replaced with ``Is_Primary`` and ``Is_Replica`` (https://github.com/ansible-collections /community.mysql/issues/145)." msgstr "mysql_replication - ``Is_Slave``ã¨``Is_Master``戻り値を削除ã—ã¾ã™ (``Is_Primary`` 㨠``Is_Replica`` ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.mysql/issues/145))。" -#: ../../rst/porting_guides/porting_guide_6.rst:402 +#: ../../rst/porting_guides/porting_guide_6.rst:538 msgid "mysql_replication - remove the mode options values containing ``master``/``slave`` and the master_use_gtid option ``slave_pos`` (were replaced with corresponding ``primary``/``replica`` values) (https://github.com/ansible-collections/community.mysql/issues/145)." msgstr "mysql_replication - ``master``/``slave`` ãŠã‚ˆã³ master_use_gtid オプション ``slave_pos`` (対応ã™ã‚‹ ``primary``/``replica`` ã®å€¤ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—ãŸ) ã‚’å«ã‚€ãƒ¢ãƒ¼ãƒ‰ã‚ªãƒ—ション値を削除ã—ã¾ã™ (https://github.com/ansible-collections/community.mysql/issues/145)。" -#: ../../rst/porting_guides/porting_guide_6.rst:403 +#: ../../rst/porting_guides/porting_guide_6.rst:539 msgid "mysql_user - remove support for the `REQUIRESSL` special privilege as it has ben superseded by the `tls_requires` option (https://github.com/ansible-collections/community.mysql/discussions/121)." msgstr "mysql_user - `tls_requires` オプションã«å–ã£ã¦ä»£ã‚られ㟠`REQUIRESSL` 特別権é™ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.mysql/discussions/121)。" -#: ../../rst/porting_guides/porting_guide_6.rst:404 +#: ../../rst/porting_guides/porting_guide_6.rst:540 msgid "mysql_user - validate privileges using database engine directly (https://github.com/ansible-collections/community.mysql/issues/234 https://github.com/ansible-collections/community.mysql/pull/243). Do not validate privileges in this module anymore." msgstr "mysql_user - データベースエンジンを直接使用ã—ã¦ç‰¹æ¨©ã‚’検証ã—ã¾ã™ (https://github.com/ansible-collections/community.mysql/issues/234 https://github.com/ansible-collections/community.mysql/pull/243)。ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ç‰¹æ¨©ã¯ã€ã“れ以上検証ã—ãªã„ã§ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:409 +#: ../../rst/porting_guides/porting_guide_6.rst:545 msgid "The collection now requires at least ansible-core 2.11.0. Ansible 3 and before, and ansible-base versions are no longer supported." msgstr "コレクションã«ã¯ã€å°‘ãªãã¨ã‚‚ ansible-core 2.11.0 ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚Ansible 3 以å‰ã¨ã€ansible-base ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:410 +#: ../../rst/porting_guides/porting_guide_6.rst:546 msgid "vmware_cluster_drs - The default for ``enable`` has been changed from ``false`` to ``true``." msgstr "vmware_cluster_drs - ``enable`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒ ``false`` ã‹ã‚‰ ``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:411 +#: ../../rst/porting_guides/porting_guide_6.rst:547 msgid "vmware_cluster_drs - The parameter alias ``enable_drs`` has been removed, use ``enable`` instead." msgstr "vmware_cluster_drs - パラメーターエイリアス ``enable_drs`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``enable`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:412 +#: ../../rst/porting_guides/porting_guide_6.rst:548 msgid "vmware_cluster_ha - The default for ``enable`` has been changed from ``false`` to ``true``." msgstr "vmware_cluster_ha - ``enable`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒ ``false`` ã‹ã‚‰ ``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:413 +#: ../../rst/porting_guides/porting_guide_6.rst:549 msgid "vmware_cluster_ha - The parameter alias ``enable_ha`` has been removed, use ``enable`` instead." msgstr "vmware_cluster_ha - パラメーターエイリアス ``enable_ha`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``enable`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:414 +#: ../../rst/porting_guides/porting_guide_6.rst:550 msgid "vmware_cluster_vsan - The default for ``enable`` has been changed from ``false`` to ``true``." msgstr "vmware_cluster_vsan - ``enable`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒ ``false`` ã‹ã‚‰ ``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:415 +#: ../../rst/porting_guides/porting_guide_6.rst:551 msgid "vmware_cluster_vsan - The parameter alias ``enable_vsan`` has been removed, use ``enable`` instead." msgstr "vmware_cluster_vsan - パラメーターエイリアス ``enable_vsan`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``enable`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:416 +#: ../../rst/porting_guides/porting_guide_6.rst:552 msgid "vmware_guest - Virtualization Based Security has some requirements (``nested_virt``, ``secure_boot`` and ``iommu``) that the module silently enabled. They have to be enabled explicitly now." msgstr "vmware_guest - 仮想化ベースã®ã‚»ã‚ュリティーã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒè¦å‘Šãªã—ã§æœ‰åŠ¹ã«ã™ã‚‹è¦ä»¶ (``nested_virt``ã€``secure_boot``ã€ãŠã‚ˆã³ ``iommu``) ãŒã„ãã¤ã‹ã‚ã‚Šã¾ã™ã€‚ã“れらã¯ã€æ˜Žç¤ºçš„ã«æœ‰åŠ¹ã«ã—ãªã‘ã‚Œã°ãªã‚‰ãªããªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:421 +#: ../../rst/porting_guides/porting_guide_6.rst:557 msgid "HTTPS SSL certificate validation is a **breaking change** and will require modification in the existing playbooks. Please refer to `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ section in the `README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ for modification to existing playbooks." msgstr "HTTPS SSL 証明書ã®æ¤œè¨¼ã¯**互æ›æ€§ã‚’æãªã†å¤‰æ›´**ã§ã€æ—¢å˜ã® Playbook ã¸ã®å¤‰æ›´ãŒå¿…è¦ã«ãªã‚Šã¾ã™ã€‚æ—¢å˜ã® Playbook ã®å¤‰æ›´ã«ã¤ã„ã¦ã¯ã€`README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ ã® `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ セクションをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:426 +#: ../../rst/porting_guides/porting_guide_6.rst:562 msgid "Set use_reports_api default value to true for the inventory plugin" msgstr "インベントリープラグイン㮠use_reports_api ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ true ã«è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:427 +#: ../../rst/porting_guides/porting_guide_6.rst:563 msgid "Support for Ansible 2.8 is removed" msgstr "Ansible 2.8 ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸ" -#: ../../rst/porting_guides/porting_guide_6.rst:432 +#: ../../rst/porting_guides/porting_guide_6.rst:568 msgid "Add a ``ansible-community`` CLI tool that allows to print the version of the Ansible community distribution. Use ``ansible-community --version`` to print this version." msgstr "Ansible コミュニティーディストリビューションã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å°åˆ·ã§ãるよã†ã«ã™ã‚‹ ``ansible-community`` CLI ãƒ„ãƒ¼ãƒ«ã‚’è¿½åŠ ã—ã¾ã™ã€‚``ansible-community --version`` を使用ã—ã¦ã“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’出力ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:437 +#: ../../rst/porting_guides/porting_guide_6.rst:573 msgid "Jinja2 Controller Requirement - Jinja2 3.0.0 or newer is required for the control node (the machine that runs Ansible) (https://github.com/ansible/ansible/pull/75881)" msgstr "Jinja2 コントãƒãƒ¼ãƒ©ãƒ¼ã®è¦ä»¶ - コントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ (Ansible を実行ã™ã‚‹ãƒžã‚·ãƒ³) ã«ã¯ Jinja2 3.0.0 以é™ãŒå¿…è¦ã§ã™ (https://github.com/ansible/ansible/pull/75881)。" -#: ../../rst/porting_guides/porting_guide_6.rst:438 +#: ../../rst/porting_guides/porting_guide_6.rst:574 msgid "Templating - remove ``safe_eval`` in favor of using ``NativeEnvironment`` but utilizing ``literal_eval`` only in cases when ``safe_eval`` was used (https://github.com/ansible/ansible/pull/75587)" msgstr "テンプレート化 - ``NativeEnvironment`` ã®ä½¿ç”¨ã‚’優先ã—㦠``safe_eval`` を削除ã—ã¾ã™ãŒã€``safe_eval`` ãŒä½¿ç”¨ã•ã‚ŒãŸå ´åˆã«é™ã‚Š ``literal_eval`` ãŒä½¿ç”¨ã•ã‚Œã¾ã™ (https://github.com/ansible/ansible/pull/75587)。" -#: ../../rst/porting_guides/porting_guide_6.rst:443 +#: ../../rst/porting_guides/porting_guide_6.rst:579 msgid "amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574)." msgstr "amazon.aws コレクション - amazon.aws コレクションã§ã¯ ``botocore<1.19.0`` ãŠã‚ˆã³ ``boto3<1.16.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® SDK を使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/574)。" -#: ../../rst/porting_guides/porting_guide_6.rst:448 +#: ../../rst/porting_guides/porting_guide_6.rst:584 msgid "cli_parse - this module has been moved to the ansible.utils collection. ``ansible.netcommon.cli_parse`` will continue to work to reference the module in its new location, but this redirect will be removed in a future release" msgstr "cli_parse - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ansible.utils コレクションã«ç§»å‹•ã•ã‚Œã¾ã—ãŸã€‚``ansible.netcommon.cli_parse`` ã¯ã€å¼•ã続ã機能ã—ã¦æ–°ã—ã„å ´æ‰€ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’å‚ç…§ã—ã¾ã™ãŒã€ã“ã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯ä»Šå¾Œã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:449 +#: ../../rst/porting_guides/porting_guide_6.rst:585 msgid "network_cli - Change default value of `ssh_type` option from `paramiko` to `auto`. This value will use libssh if the ansible-pylibssh module is installed, otherwise will fallback to paramiko." msgstr "network_cli - `ssh_type` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã‚’ `paramiko` ã‹ã‚‰ `auto` ã«å¤‰æ›´ã—ã¾ã™ã€‚ã“ã®å€¤ã¯ã€ansible-pylibssh モジュールãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ libssh を使用ã—ã€ãれ以外ã®å ´åˆã¯ paramiko ã«ãƒ•ã‚©ãƒ¼ãƒ«ãƒãƒƒã‚¯ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:454 -#: ../../rst/porting_guides/porting_guide_6.rst:466 -#: ../../rst/porting_guides/porting_guide_6.rst:472 -#: ../../rst/porting_guides/porting_guide_6.rst:479 -#: ../../rst/porting_guides/porting_guide_6.rst:609 +#: ../../rst/porting_guides/porting_guide_6.rst:590 +#: ../../rst/porting_guides/porting_guide_6.rst:602 +#: ../../rst/porting_guides/porting_guide_6.rst:608 #: ../../rst/porting_guides/porting_guide_6.rst:615 -#: ../../rst/porting_guides/porting_guide_6.rst:621 -#: ../../rst/porting_guides/porting_guide_6.rst:633 -#: ../../rst/porting_guides/porting_guide_6.rst:640 +#: ../../rst/porting_guides/porting_guide_6.rst:745 +#: ../../rst/porting_guides/porting_guide_6.rst:751 +#: ../../rst/porting_guides/porting_guide_6.rst:757 +#: ../../rst/porting_guides/porting_guide_6.rst:769 +#: ../../rst/porting_guides/porting_guide_6.rst:776 msgid "Minimum required ansible.netcommon version is 2.5.1." msgstr "最低é™å¿…è¦ãª ansible.netcommon ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ 2.5.1 ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:455 -#: ../../rst/porting_guides/porting_guide_6.rst:467 -#: ../../rst/porting_guides/porting_guide_6.rst:473 -#: ../../rst/porting_guides/porting_guide_6.rst:480 -#: ../../rst/porting_guides/porting_guide_6.rst:543 -#: ../../rst/porting_guides/porting_guide_6.rst:610 +#: ../../rst/porting_guides/porting_guide_6.rst:591 +#: ../../rst/porting_guides/porting_guide_6.rst:603 +#: ../../rst/porting_guides/porting_guide_6.rst:609 #: ../../rst/porting_guides/porting_guide_6.rst:616 -#: ../../rst/porting_guides/porting_guide_6.rst:622 -#: ../../rst/porting_guides/porting_guide_6.rst:634 -#: ../../rst/porting_guides/porting_guide_6.rst:641 +#: ../../rst/porting_guides/porting_guide_6.rst:679 +#: ../../rst/porting_guides/porting_guide_6.rst:746 +#: ../../rst/porting_guides/porting_guide_6.rst:752 +#: ../../rst/porting_guides/porting_guide_6.rst:758 +#: ../../rst/porting_guides/porting_guide_6.rst:770 +#: ../../rst/porting_guides/porting_guide_6.rst:777 msgid "Updated base plugin references to ansible.netcommon." msgstr "ansible.netcommon ã¸ã®ãƒ™ãƒ¼ã‚¹ãƒ—ラグインå‚照を更新ã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:456 +#: ../../rst/porting_guides/porting_guide_6.rst:592 msgid "`eos_facts` - change default gather_subset to `min` from `!config` (https://github.com/ansible-collections/arista.eos/issues/306)." msgstr "`eos_facts` - デフォルト㮠gather_subset ã‚’ `min` ã‹ã‚‰ `!config` ã«å¤‰æ›´ã—ã¾ã™ (https://github.com/ansible-collections/arista.eos/issues/306)。" -#: ../../rst/porting_guides/porting_guide_6.rst:474 -#: ../../rst/porting_guides/porting_guide_6.rst:481 +#: ../../rst/porting_guides/porting_guide_6.rst:610 +msgid "facts - default value for gather_subset is changed to min instead of !config." +msgstr "facts - gather_subset ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ !config ã®ä»£ã‚ã‚Šã« min ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:617 msgid "`facts` - default value for `gather_subset` is changed to min instead of !config." msgstr "`facts` - `gather_subset` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€ï¼config ã§ã¯ãªã min ã«å¤‰æ›´ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:486 +#: ../../rst/porting_guides/porting_guide_6.rst:622 msgid "Update ciscoisesdk requirement to 1.2.0" msgstr "ciscoisesdk è¦ä»¶ã‚’ 1.2.0 ã«æ›´æ–°" -#: ../../rst/porting_guides/porting_guide_6.rst:487 +#: ../../rst/porting_guides/porting_guide_6.rst:623 msgid "anc_endpoint_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "anc_endpoint_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:488 +#: ../../rst/porting_guides/porting_guide_6.rst:624 msgid "anc_policy_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "anc_policy_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:489 +#: ../../rst/porting_guides/porting_guide_6.rst:625 msgid "backup_last_status_info - change return value, it returns response content." msgstr "backup_last_status_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:490 +#: ../../rst/porting_guides/porting_guide_6.rst:626 msgid "device_administration_authentication_rules - deletes parameter identitySourceId." msgstr "device_administration_authentication_rules - パラメーター identitySourceId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:491 +#: ../../rst/porting_guides/porting_guide_6.rst:627 msgid "device_administration_authentication_rules_info - change return value, it returns response content." msgstr "device_administration_authentication_rules_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:492 +#: ../../rst/porting_guides/porting_guide_6.rst:628 msgid "device_administration_authorization_rules_info - change return value, it returns response content." msgstr "device_administration_authorization_rules_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:493 +#: ../../rst/porting_guides/porting_guide_6.rst:629 msgid "device_administration_conditions - deletes parameter attributeId." msgstr "device_administration_conditions - パラメーター attributeId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:494 +#: ../../rst/porting_guides/porting_guide_6.rst:630 msgid "device_administration_conditions_for_authentication_rule_info - change return value, it returns response content." msgstr "device_administration_conditions_for_authentication_rule_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:495 +#: ../../rst/porting_guides/porting_guide_6.rst:631 msgid "device_administration_conditions_for_authorization_rule_info - change return value, it returns response content." msgstr "device_administration_conditions_for_authorization_rule_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:496 +#: ../../rst/porting_guides/porting_guide_6.rst:632 msgid "device_administration_conditions_for_policy_set_info - change return value, it returns response content." msgstr "device_administration_conditions_for_policy_set_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:497 +#: ../../rst/porting_guides/porting_guide_6.rst:633 msgid "device_administration_conditions_info - change return value, it returns response content." msgstr "device_administration_conditions_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:498 +#: ../../rst/porting_guides/porting_guide_6.rst:634 msgid "device_administration_dictionary_attributes_authentication_info - change return value, it returns response content." msgstr "device_administration_dictionary_attributes_authentication_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:499 +#: ../../rst/porting_guides/porting_guide_6.rst:635 msgid "device_administration_dictionary_attributes_authorization_info - change return value, it returns response content." msgstr "device_administration_dictionary_attributes_authorization_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:500 +#: ../../rst/porting_guides/porting_guide_6.rst:636 msgid "device_administration_dictionary_attributes_policy_set_info - change return value, it returns response content." msgstr "device_administration_dictionary_attributes_policy_set_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:501 +#: ../../rst/porting_guides/porting_guide_6.rst:637 msgid "device_administration_global_exception_rules_info - change return value, it returns response content." msgstr "device_administration_global_exception_rules_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:502 +#: ../../rst/porting_guides/porting_guide_6.rst:638 msgid "device_administration_network_conditions_info - change return value, it returns response content." msgstr "device_administration_network_conditions_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:503 +#: ../../rst/porting_guides/porting_guide_6.rst:639 msgid "device_administration_time_date_conditions - deletes parameter attributeId." msgstr "device_administration_time_date_conditions - パラメーター attributeId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:504 +#: ../../rst/porting_guides/porting_guide_6.rst:640 msgid "device_administration_time_date_conditions_info - change return value, it returns response content." msgstr "device_administration_time_date_conditions_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:505 +#: ../../rst/porting_guides/porting_guide_6.rst:641 msgid "egress_matrix_cell_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "egress_matrix_cell_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:506 +#: ../../rst/porting_guides/porting_guide_6.rst:642 msgid "network_access_authentication_rules - deletes parameter identitySourceId." msgstr "network_access_authentication_rules - パラメーター identitySourceId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:507 +#: ../../rst/porting_guides/porting_guide_6.rst:643 msgid "network_access_conditions - deletes parameter attributeId." msgstr "network_access_conditions - パラメーター attributeId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:508 +#: ../../rst/porting_guides/porting_guide_6.rst:644 msgid "network_access_time_date_conditions - deletes parameter attributeId." msgstr "network_access_time_date_conditions - パラメーター attributeId を削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:509 +#: ../../rst/porting_guides/porting_guide_6.rst:645 msgid "node_deployment - update parameters." msgstr "node_deployment - パラメーターを更新ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:510 +#: ../../rst/porting_guides/porting_guide_6.rst:646 msgid "node_deployment_info - add filter and filterType parameters." msgstr "node_deployment_info - filter ãŠã‚ˆã³ filterType ãƒ‘ãƒ©ãƒ¡ãƒ¼ã‚¿ãƒ¼ã‚’è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:511 +#: ../../rst/porting_guides/porting_guide_6.rst:647 msgid "node_group - fixes response recollection." msgstr "node_group - å¿œç”ã®å†ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ä¿®æ£ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:512 +#: ../../rst/porting_guides/porting_guide_6.rst:648 msgid "node_group_info - fixes response recollection." msgstr "node_group_info - å¿œç”ã®å†ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ä¿®æ£ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:513 +#: ../../rst/porting_guides/porting_guide_6.rst:649 msgid "repository_files_info - change return value, it returns response content." msgstr "repository_files_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:514 +#: ../../rst/porting_guides/porting_guide_6.rst:650 msgid "repository_info - change return value, it returns response content." msgstr "repository_info - 戻り値を変更ã—ã¾ã™ã€‚å¿œç”コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:515 +#: ../../rst/porting_guides/porting_guide_6.rst:651 msgid "sg_acl_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sg_acl_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:516 +#: ../../rst/porting_guides/porting_guide_6.rst:652 msgid "sg_mapping_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sg_mapping_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:517 +#: ../../rst/porting_guides/porting_guide_6.rst:653 msgid "sg_mapping_group_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sg_mapping_group_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:518 +#: ../../rst/porting_guides/porting_guide_6.rst:654 msgid "sg_mapping_group_info - change return value, it returns BulkStatus content." msgstr "sg_mapping_group_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:519 +#: ../../rst/porting_guides/porting_guide_6.rst:655 msgid "sg_to_vn_to_vlan_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sg_to_vn_to_vlan_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:520 +#: ../../rst/porting_guides/porting_guide_6.rst:656 msgid "sgt - change generationId type from int to str." msgstr "Sgt - generationId タイプを int ã‹ã‚‰ str ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:521 +#: ../../rst/porting_guides/porting_guide_6.rst:657 msgid "sgt_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sgt_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:522 +#: ../../rst/porting_guides/porting_guide_6.rst:658 msgid "sxp_connections_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sxp_connections_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:523 +#: ../../rst/porting_guides/porting_guide_6.rst:659 msgid "sxp_local_bindings_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sxp_local_bindings_bulk_monitor_status_info - 戻り値を変更ã—ã€BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:524 +#: ../../rst/porting_guides/porting_guide_6.rst:660 msgid "sxp_vpns_bulk_monitor_status_info - change return value, it returns BulkStatus content." msgstr "sxp_vpns_bulk_monitor_status_info - 戻り値を変更ã—ã¾ã™ã€‚BulkStatus コンテンツを返ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:525 +#: ../../rst/porting_guides/porting_guide_6.rst:661 msgid "system_certificate - new parameters portalTagTransferForSameSubject and roleTransferForSameSubject." msgstr "system_certificate - æ–°ã—ã„パラメーター portalTagTransferForSameSubject ãŠã‚ˆã³ roleTransferForSameSubject。" -#: ../../rst/porting_guides/porting_guide_6.rst:526 +#: ../../rst/porting_guides/porting_guide_6.rst:662 msgid "system_certificate - portalTagTransferForSameSubject parameter renamed to allowPortalTagTransferForSameSubject." msgstr "system_certificate - portalTagTransferForSameSubject パラメーターã®åå‰ãŒ allowPortalTagTransferForSameSubject ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:527 +#: ../../rst/porting_guides/porting_guide_6.rst:663 msgid "system_certificate - roleTransferForSameSubject parameter renamed to allowRoleTransferForSameSubject." msgstr "system_certificate - roleTransferForSameSubject パラメーターã®åå‰ãŒ allowRoleTransferForSameSubject ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:528 +#: ../../rst/porting_guides/porting_guide_6.rst:664 msgid "system_certificate_import - new parameters portalTagTransferForSameSubject and roleTransferForSameSubject." msgstr "system_certificate_import - æ–°ã—ã„パラメーター portalTagTransferForSameSubject ãŠã‚ˆã³ roleTransferForSameSubject。" -#: ../../rst/porting_guides/porting_guide_6.rst:529 +#: ../../rst/porting_guides/porting_guide_6.rst:665 msgid "system_certificate_import - portalTagTransferForSameSubject parameter renamed to allowPortalTagTransferForSameSubject." msgstr "system_certificate_import - portalTagTransferForSameSubject パラメーターã®åå‰ãŒ allowPortalTagTransferForSameSubject ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:530 +#: ../../rst/porting_guides/porting_guide_6.rst:666 msgid "system_certificate_import - roleTransferForSameSubject parameter renamed to allowRoleTransferForSameSubject." msgstr "system_certificate_import - roleTransferForSameSubject パラメーターã®åå‰ãŒ allowRoleTransferForSameSubject ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:531 +#: ../../rst/porting_guides/porting_guide_6.rst:667 msgid "trustsec_nbar_app_info - change type from str to list." msgstr "trustsec_nbar_app_info - タイプを str ã‹ã‚‰ list ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:532 +#: ../../rst/porting_guides/porting_guide_6.rst:668 msgid "trustsec_vn_info - change type from str to list." msgstr "trustsec_vn_info - タイプを str ã‹ã‚‰ list ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:542 +#: ../../rst/porting_guides/porting_guide_6.rst:678 msgid "The minimum required ansible.netcommon version has been bumped to v2.6.1." msgstr "最低é™å¿…è¦ãª ansible.netcommon ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒ v2.6.1 ã«å¼•ã上ã’られã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:544 +#: ../../rst/porting_guides/porting_guide_6.rst:680 msgid "`nxos_facts` - change default gather_subset to `min` from `!config` (https://github.com/ansible-collections/cisco.nxos/issues/418)." msgstr "`nxos_facts` - デフォルト㮠gather_subset ã‚’ `min` ã‹ã‚‰ `!config` ã«å¤‰æ›´ã—ã¾ã™ (https://github.com/ansible-collections/cisco.nxos/issues/418)。" -#: ../../rst/porting_guides/porting_guide_6.rst:545 +#: ../../rst/porting_guides/porting_guide_6.rst:681 msgid "nxos_file_copy has been rewritten as a module. This change also removes the dependency on pexpect for file_pull operation. Since this now uses AnsibleModule class for argspec validation, the validation messages will be slighlty different. Expect changes in the return payload in some cases. All functionality remains unchanged." msgstr "nxos_file_copy ãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ã—ã¦æ›¸ãç›´ã•ã‚Œã¾ã—ãŸã€‚ã“ã®å¤‰æ›´ã«ã‚ˆã‚Šã€file_pull æ“作㮠pexpect ã¸ã®ä¾å˜ã‚‚ãªããªã‚Šã¾ã™ã€‚ã“れ㧠argspec 検証㫠AnsibleModule クラスãŒä½¿ç”¨ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã£ãŸãŸã‚ã€æ¤œè¨¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã¯å°‘ã—ç•°ãªã‚Šã¾ã™ã€‚å ´åˆã«ã‚ˆã£ã¦ã¯ã€ãƒªã‚¿ãƒ¼ãƒ³ãƒšã‚¤ãƒãƒ¼ãƒ‰ã®å¤‰æ›´ãŒäºˆæƒ³ã•ã‚Œã¾ã™ã€‚ã™ã¹ã¦ã®æ©Ÿèƒ½ã¯å¤‰æ›´ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/porting_guides/porting_guide_6.rst:550 +#: ../../rst/porting_guides/porting_guide_6.rst:686 msgid "community.aws collection - The community.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/809)." msgstr "community.aws コレクション - community.aws コレクションã§ã¯ ``botocore<1.19.0`` ãŠã‚ˆã³ ``boto3<1.16.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/809)。" -#: ../../rst/porting_guides/porting_guide_6.rst:551 +#: ../../rst/porting_guides/porting_guide_6.rst:687 msgid "s3_bucket_notifications - refactor module to support SNS / SQS targets as well as the existing support for Lambda functions (https://github.com/ansible-collections/community.aws/issues/140)." msgstr "s3_bucket_notifications - SNS/SQS ターゲットをサãƒãƒ¼ãƒˆã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ Lambda 関数ã®æ—¢å˜ã®ã‚µãƒãƒ¼ãƒˆã‚’リファクタリングã—ã¾ã™ (https://github.com/ansible-collections/community.aws/issues/140)。" -#: ../../rst/porting_guides/porting_guide_6.rst:556 +#: ../../rst/porting_guides/porting_guide_6.rst:692 msgid "The community.general collection no longer supports Ansible 2.9 and ansible-base 2.10. While we take no active measures to prevent usage, we will remove a lot of compatibility code and other compatility measures that will effectively prevent using most content from this collection with Ansible 2.9, and some content of this collection with ansible-base 2.10. Both Ansible 2.9 and ansible-base 2.10 will very soon be End of Life and if you are still using them, you should consider upgrading to ansible-core 2.11 or later as soon as possible (https://github.com/ansible-collections/community.general/pull/4548)." msgstr "community.general コレクションã¯ã€Ansible 2.9 㨠ansible-base 2.10 をサãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—ãŸã€‚使用を防ããŸã‚ã®ç©æ¥µçš„ãªæŽªç½®ã¯è¬›ã˜ã¦ã„ã¾ã›ã‚“ãŒã€Ansible 2.9 ã®å ´åˆã¯ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã»ã¨ã‚“ã©ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã€ansible-base 2.10 ã®å ´åˆã¯ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€éƒ¨ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ä½¿ç”¨ã‚’効果的ã«é˜²æ¢ã™ã‚‹å¤šæ•°ã®äº’æ›æ€§ã‚³ãƒ¼ãƒ‰ã¨ãã®ä»–ã®äº’æ›æ€§æŽªç½®ã‚’削除ã™ã‚‹äºˆå®šã§ã™ã€‚Ansible 2.9 㨠ansible-base 2.10 ã¯ã€ã©ã¡ã‚‰ã‚‚é–“ã‚‚ãªãライフサイクル終了日ã«é”ã™ã‚‹ãŸã‚ã€ã„ãšã‚Œã‹ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã¯æ—©æ€¥ã« ansible-core 2.11 以é™ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã“ã¨ã‚’検討ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/4548)。" -#: ../../rst/porting_guides/porting_guide_6.rst:566 +#: ../../rst/porting_guides/porting_guide_6.rst:702 +#: ../../rst/porting_guides/porting_guide_7.rst:619 msgid "The community.network collection no longer supports Ansible 2.9 and ansible-base 2.10. While we take no active measures to prevent usage, we will remove compatibility code and other compatility measures that will effectively prevent using most content from this collection with Ansible 2.9, and some content of this collection with ansible-base 2.10. Both Ansible 2.9 and ansible-base 2.10 will very soon be End of Life and if you are still using them, you should consider upgrading to ansible-core 2.11 or later as soon as possible (https://github.com/ansible-collections/community.network/pull/426)." msgstr "community.network コレクションã¯ã€Ansible 2.9 㨠ansible-base 2.10 をサãƒãƒ¼ãƒˆã—ãªããªã‚Šã¾ã—ãŸã€‚使用を防ããŸã‚ã®ç©æ¥µçš„ãªæŽªç½®ã¯è¬›ã˜ã¦ã„ã¾ã›ã‚“ãŒã€Ansible 2.9 ã®å ´åˆã¯ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ã»ã¨ã‚“ã©ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã€ansible-base 2.10 ã®å ´åˆã¯ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€éƒ¨ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ä½¿ç”¨ã‚’効果的ã«é˜²æ¢ã™ã‚‹äº’æ›æ€§ã‚³ãƒ¼ãƒ‰ã¨ãã®ä»–ã®äº’æ›æ€§æŽªç½®ã‚’削除ã™ã‚‹äºˆå®šã§ã™ã€‚Ansible 2.9 㨠ansible-base 2.10 ã¯ã€ã©ã¡ã‚‰ã‚‚é–“ã‚‚ãªãライフサイクル終了日ã«é”ã™ã‚‹ãŸã‚ã€ã„ãšã‚Œã‹ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã¯æ—©æ€¥ã« ansible-core 2.11 以é™ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã“ã¨ã‚’検討ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.network/pull/426)。" -#: ../../rst/porting_guides/porting_guide_6.rst:572 +#: ../../rst/porting_guides/porting_guide_6.rst:708 msgid "postgresql_privs - the ``usage_on_types`` feature have been deprecated and will be removed in ``community.postgresql 3.0.0``. Please use the ``type`` option with the ``type`` value to explicitly grant/revoke privileges on types (https://github.com/ansible-collections/community.postgresql/issues/207)." msgstr "postgresql_privs - ``usage_on_types`` 機能ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€``community.postgresql 3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚``type`` 値㧠``type`` オプション を使用ã—ã€ã‚¿ã‚¤ãƒ—ã®ç‰¹æ¨©ã‚’明示的ã«ä»˜ä¸Ž/å–り消ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/207)。" -#: ../../rst/porting_guides/porting_guide_6.rst:573 +#: ../../rst/porting_guides/porting_guide_6.rst:709 msgid "postgresql_query - the ``path_to_script`` and ``as_single_query`` options as well as the ``query_list`` and ``query_all_results`` return values have been deprecated and will be removed in ``community.postgresql 3.0.0``. Please use the ``community.postgresql.postgresql_script`` module to execute statements from scripts (https://github.com/ansible-collections/community.postgresql/issues/189)." -msgstr "postgresql_query - ``path_to_script`` オプション㨠``as_single_query`` オプションã€ãŠã‚ˆã³ ``query_list`` ãŠã‚ˆã³ ``query_all_results`` ã®æˆ»ã‚Šå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€``community.postgresql 3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚``community.postgresql.postgresql_script`` モジュールを使用ã—ã¦ã€ã‚¹ã‚¯ãƒªãƒ—トã‹ã‚‰ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã‚’実行ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/189)。" +msgstr "postgresql_query - ``path_to_script`` オプション㨠``as_single_query`` オプションã€ãŠã‚ˆã³ ``query_list`` 㨠``query_all_results`` ã®æˆ»ã‚Šå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€``community.postgresql 3.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚``community.postgresql.postgresql_script`` モジュールを使用ã—ã¦ã€ã‚¹ã‚¯ãƒªãƒ—トã‹ã‚‰ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¡ãƒ³ãƒˆã‚’実行ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/189)。" -#: ../../rst/porting_guides/porting_guide_6.rst:574 +#: ../../rst/porting_guides/porting_guide_6.rst:710 msgid "postgresql_query - the default value of the ``as_single_query`` option changes to ``yes``. If the related behavior of your tasks where the module is involved changes, please adjust the parameter's value correspondingly (https://github.com/ansible-collections/community.postgresql/issues/85)." msgstr "postgresql_query - ``as_single_query`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ ``yes`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚モジュールãŒé–¢ä¿‚ã™ã‚‹ã‚¿ã‚¹ã‚¯ã®é–¢é€£å‹•ä½œãŒå¤‰æ›´ã•ã‚Œã‚‹å ´åˆã¯ã€å¯¾å¿œã™ã‚‹ãƒ‘ラメーターã®å€¤ã‚’é©å®œèª¿æ•´ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.postgresql/issues/85)。" -#: ../../rst/porting_guides/porting_guide_6.rst:580 +#: ../../rst/porting_guides/porting_guide_6.rst:716 msgid "Drop VCSIM as a test target (https://github.com/ansible-collections/community.vmware/pull/1294)." msgstr "テストターゲットã¨ã—㦠VCSIM ã‚’ç ´æ£„ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1294)。" -#: ../../rst/porting_guides/porting_guide_6.rst:591 +#: ../../rst/porting_guides/porting_guide_6.rst:727 msgid "All modules can read custom or organizational CA signed certificate from the environment variables. Please refer to `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ section in the `README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ for modification to existing playbooks or setting environment variable." msgstr "ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ç’°å¢ƒå¤‰æ•°ã‹ã‚‰ã‚«ã‚¹ã‚¿ãƒ ã¾ãŸã¯çµ„ç¹” CA ç½²å証明書をèªã¿å–ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚æ—¢å˜ã® Playbook ã®å¤‰æ›´ã‚„環境変数ã®è¨å®šã«ã¤ã„ã¦ã¯ã€`README.md <https://github.com/dell/dellemc-openmanage-ansible-modules/blob/collections/README.md#SSL-Certificate-Validation>`_ ã® `SSL Certificate Validation <https://github.com/dell/dellemc-openmanage-ansible-modules#ssl-certificate-validation>`_ セクションをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:592 +#: ../../rst/porting_guides/porting_guide_6.rst:728 msgid "All modules now support SSL over HTTPS and socket level timeout." msgstr "ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒã€SSL over HTTPS ãŠã‚ˆã³ã‚½ã‚±ãƒƒãƒˆãƒ¬ãƒ™ãƒ«ã®ã‚¿ã‚¤ãƒ アウトをサãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:593 +#: ../../rst/porting_guides/porting_guide_6.rst:729 msgid "idrac_server_config_profile - The module is enhanced to support export, import, and preview the SCP configuration using Redfish and added support for check mode." msgstr "idrac_server_config_profile - モジュールã¯ã€Redfish を使用ã—㟠SCP è¨å®šã®ã‚¨ã‚¯ã‚¹ãƒãƒ¼ãƒˆã€ã‚¤ãƒ³ãƒãƒ¼ãƒˆã€ãŠã‚ˆã³ãƒ—レビューをサãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«æ‹¡å¼µã•ã‚Œã€ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã®ã‚µãƒãƒ¼ãƒˆãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:607 +#: ../../rst/porting_guides/porting_guide_6.rst:743 msgid "frr.frr" msgstr "frr.frr" -#: ../../rst/porting_guides/porting_guide_6.rst:613 +#: ../../rst/porting_guides/porting_guide_6.rst:749 msgid "ibm.qradar" msgstr "ibm.qradar" -#: ../../rst/porting_guides/porting_guide_6.rst:623 +#: ../../rst/porting_guides/porting_guide_6.rst:759 msgid "`junos_facts` - change default gather_subset to `min` from `!config`." msgstr "`junos_facts` - デフォルト㮠gather_subset ã‚’ `min` ã‹ã‚‰ `!config` ã«å¤‰æ›´ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:628 +#: ../../rst/porting_guides/porting_guide_6.rst:764 msgid "manageiq - role removed (https://github.com/oVirt/ovirt-ansible-collection/pull/375)." msgstr "pidgin - ãƒãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸ(https://github.com/oVirt/ovirt-ansible-collection/pull/375)。" -#: ../../rst/porting_guides/porting_guide_6.rst:631 +#: ../../rst/porting_guides/porting_guide_6.rst:767 msgid "splunk.es" msgstr "splunk.es" -#: ../../rst/porting_guides/porting_guide_6.rst:642 +#: ../../rst/porting_guides/porting_guide_6.rst:778 msgid "`vyos_facts` - change default gather_subset to `min` from `!config` (https://github.com/ansible-collections/vyos.vyos/issues/231)." msgstr "`vyos_facts` - デフォルト㮠gather_subset ã‚’ `min` ã‹ã‚‰ `!config` ã«å¤‰æ›´ã—ã¾ã™ (https://github.com/ansible-collections/vyos.vyos/issues/231)。" -#: ../../rst/porting_guides/porting_guide_6.rst:645 -#: ../../rst/porting_guides/porting_guide_7.rst:290 +#: ../../rst/porting_guides/porting_guide_6.rst:781 +#: ../../rst/porting_guides/porting_guide_7.rst:681 msgid "Removed Collections" msgstr "削除ã•ã‚ŒãŸã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³" -#: ../../rst/porting_guides/porting_guide_6.rst:647 +#: ../../rst/porting_guides/porting_guide_6.rst:783 msgid "community.kubernetes (previously included version: 2.0.1)" msgstr "community.kubernetes (ã“ã‚Œã¾ã§å«ã¾ã‚Œã¦ã„ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³:2.0.1)" -#: ../../rst/porting_guides/porting_guide_6.rst:648 +#: ../../rst/porting_guides/porting_guide_6.rst:784 msgid "community.kubevirt (previously included version: 1.0.0)" msgstr "community.kubevirt (ã“ã‚Œã¾ã§å«ã¾ã‚Œã¦ã„ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³:1.0.0)" -#: ../../rst/porting_guides/porting_guide_6.rst:653 +#: ../../rst/porting_guides/porting_guide_6.rst:789 msgid "The community.kubernetes collection has been removed from Ansible 6. It has been deprecated since Ansible 4.2, and version 2.0.0 included since Ansible 5 is only a set of deprecated redirects from community.kubernetes to kubernetes.core. If you still need the redirects, you can manually install community.kubernetes with ``ansible-galaxy collection install community.kubernetes`` (https://github.com/ansible-community/community-topics/issues/93)." msgstr "community.kubernetes コレクション㯠Ansible 6 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Ansible 4.2 以é™ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€Ansible5 ㌠community.kubernetes ã‹ã‚‰ kubernetes.core ã¸ã®éžæŽ¨å¥¨ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã®ã‚»ãƒƒãƒˆã§ã‚ã‚‹ãŸã‚ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.0.0 ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ãã‚Œã§ã‚‚リダイレクトãŒå¿…è¦ãªå ´åˆã¯ã€``ansible-galaxy collection install community.kubernetes`` 㧠community.kubernetes を手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ (https://github.com/ansible-community/community-topics/issues/93)。" -#: ../../rst/porting_guides/porting_guide_6.rst:654 +#: ../../rst/porting_guides/porting_guide_6.rst:790 msgid "The community.kubevirt collection has been removed from Ansible 6. It has not been working with the community.kubernetes collection included since Ansible 5.0.0, and unfortunately nobody managed to adjust the collection to work with kubernetes.core >= 2.0.0. If you need to use this collection, you need to manually install community.kubernetes < 2.0.0 together with community.kubevirt with ``ansible-galaxy collection install community.kubevirt 'community.kubernetes:<2.0.0'`` (https://github.com/ansible-community/community-topics/issues/92)." msgstr "community.kubevirt コレクション㯠Ansible 6 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Ansible 5.0.0 以é™ã«å«ã¾ã‚Œã¦ã„ã‚‹ community.kubernetes コレクションã§ã¯æ©Ÿèƒ½ã—ã¦ã„ã¾ã›ã‚“。残念ãªãŒã‚‰ã€kubernetes.core>=2.0.0 ã§æ©Ÿèƒ½ã™ã‚‹ã‚ˆã†ã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’調整ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“ã§ã—ãŸã€‚ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€2.0.0 よりå‰ã® community.kubernetes ã‚’ community.kubevirt 㨠``ansible-galaxy collection install community.kubevirt 'community.kubernetes:<2.0.0'`` ã¨ä¸€ç·’ã«æ‰‹å‹•ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-community/community-topics/issues/92)。" -#: ../../rst/porting_guides/porting_guide_6.rst:659 +#: ../../rst/porting_guides/porting_guide_6.rst:795 msgid "Remove deprecated ``Templar.set_available_variables()`` method (https://github.com/ansible/ansible/issues/75828)" msgstr "éžæŽ¨å¥¨ã® ``Templar.set_available_variables()`` メソッドを削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/75828)" -#: ../../rst/porting_guides/porting_guide_6.rst:660 +#: ../../rst/porting_guides/porting_guide_6.rst:796 msgid "cli - remove deprecated ability to set verbosity before the sub-command (https://github.com/ansible/ansible/issues/75823)" msgstr "cli - サブコマンドã®å‰ã«å†—長性をè¨å®šã™ã‚‹éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/75823)" -#: ../../rst/porting_guides/porting_guide_6.rst:661 +#: ../../rst/porting_guides/porting_guide_6.rst:797 msgid "copy - remove deprecated ``thirsty`` alias (https://github.com/ansible/ansible/issues/75824)" msgstr "copy - éžæŽ¨å¥¨ã® ``thirsty`` エイリアスを削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/75824)" -#: ../../rst/porting_guides/porting_guide_6.rst:662 +#: ../../rst/porting_guides/porting_guide_6.rst:798 msgid "psrp - Removed fallback on ``put_file`` with older ``pypsrp`` versions. Users must have at least ``pypsrp>=0.4.0``." msgstr "PSRP - å¤ã„ ``put_file`` ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ ``pypsrp`` ã®ãƒ•ã‚©ãƒ¼ãƒ«ãƒãƒƒã‚¯ã‚’削除ã—ã¾ã—ãŸã€‚ユーザーã¯å°‘ãªãã¨ã‚‚ ``pypsrp>=0.4.0`` ãŒå¿…è¦ã§ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:663 +#: ../../rst/porting_guides/porting_guide_6.rst:799 msgid "url_argument_spec - remove deprecated ``thirsty`` alias for ``get_url`` and ``uri`` modules (https://github.com/ansible/ansible/issues/75825, https://github.com/ansible/ansible/issues/75826)" msgstr "url_argument_spec - ``thirsty`` ãŠã‚ˆã³ ``get_url`` モジュールã®éžæŽ¨å¥¨ã® ``uri`` エイリアスを削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/75825ã€https://github.com/ansible/ansible/issues/75826)。" -#: ../../rst/porting_guides/porting_guide_6.rst:668 +#: ../../rst/porting_guides/porting_guide_6.rst:804 msgid "ali_instance_info - removed the options ``availability_zone``, ``instance_ids``, and ``instance_names``. Use filter item ``zone_id`` instead of ``availability_zone``, filter item ``instance_ids`` instead of ``instance_ids``, and filter item ``instance_name`` instead of ``instance_names`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "ali_instance_info - オプション ``availability_zone``ã€``instance_ids``ã€ãŠã‚ˆã³ ``instance_names`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚``availability_zone`` ã®ä»£ã‚ã‚Šã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚¢ã‚¤ãƒ†ãƒ ``zone_id``ã€``instance_ids`` ã®ä»£ã‚ã‚Šã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚¢ã‚¤ãƒ†ãƒ ``instance_ids``ã€``instance_names`` ã®ä»£ã‚ã‚Šã«ãƒ•ã‚£ãƒ«ã‚¿ãƒ¼ã‚¢ã‚¤ãƒ†ãƒ ``instance_name`` を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:669 +#: ../../rst/porting_guides/porting_guide_6.rst:805 msgid "apt_rpm - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "apt_rpm - ``update_cache`` ã®éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:670 +#: ../../rst/porting_guides/porting_guide_6.rst:806 msgid "compose - removed various deprecated aliases. Use the version with ``_`` instead of ``-`` instead (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "Compose - éžæŽ¨å¥¨ã®ã•ã¾ã–ã¾ãªã‚¨ã‚¤ãƒªã‚¢ã‚¹ã‚’削除ã—ã¾ã—ãŸã€‚ã“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ ``-`` ã®ä»£ã‚ã‚Šã« ``_`` を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:671 +#: ../../rst/porting_guides/porting_guide_6.rst:807 msgid "dnsimple - remove support for dnsimple < 2.0.0 (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "dnsimple - dnsimple < 2.0.0 ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:672 +#: ../../rst/porting_guides/porting_guide_6.rst:808 msgid "github_deploy_key - removed the deprecated alias ``2fa_token`` of ``otp`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "github_deploy_key - ``otp`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``2fa_token`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:673 +#: ../../rst/porting_guides/porting_guide_6.rst:809 msgid "homebrew, homebrew_cask - removed the deprecated alias ``update-brew`` of ``update_brew`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "homebrewã€homebrew_cask - ``update_brew`` ã®éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-brew`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:674 +#: ../../rst/porting_guides/porting_guide_6.rst:810 msgid "linode - removed the ``backupsenabled`` option. Use ``backupweeklyday`` or ``backupwindow`` to enable backups (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "linode - ``backupsenabled`` オプションを削除ã—ã¾ã—ãŸã€‚ãƒãƒƒã‚¯ã‚¢ãƒƒãƒ—を有効ã«ã™ã‚‹ã«ã¯ã€``backupweeklyday`` ã¾ãŸã¯ ``backupwindow`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:675 +#: ../../rst/porting_guides/porting_guide_6.rst:811 msgid "opkg - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "opkg - ``update_cache`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:676 +#: ../../rst/porting_guides/porting_guide_6.rst:812 msgid "pacman - if ``update_cache=true`` is used with ``name`` or ``upgrade``, the changed state will now also indicate if only the cache was updated. To keep the old behavior - only indicate ``changed`` when a package was installed/upgraded -, use ``changed_when`` as indicated in the module examples (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "pacman - ``update_cache=true`` ㌠``name`` ã¾ãŸã¯ ``upgrade`` ã¨ä½¿ç”¨ã•ã‚Œã¦ã„ã‚‹å ´åˆã€å¤‰æ›´ã•ã‚ŒãŸçŠ¶æ…‹ã¯ã‚ャッシュã®ã¿ãŒæ›´æ–°ã•ã‚Œã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚‚示ã™ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã®å‹•ä½œ (パッケージã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«/アップグレード時ã®ã¿ ``changed`` を示ã™) ã‚’ç¶æŒã™ã‚‹ã«ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ä¾‹ã«ç¤ºã•ã‚Œã¦ã„るよã†ã« ``changed_when`` を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:677 +#: ../../rst/porting_guides/porting_guide_6.rst:813 msgid "pacman - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "pacman - ``update_cache`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:678 +#: ../../rst/porting_guides/porting_guide_6.rst:814 msgid "proxmox, proxmox_kvm, proxmox_snap - no longer allow to specify a VM name that matches multiple VMs. If this happens, the modules now fail (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "proxmoxã€proxmox_kvmã€proxmox_snap - 複数ã®ä»®æƒ³ãƒžã‚·ãƒ³ã«ä¸€è‡´ã™ã‚‹ä»®æƒ³ãƒžã‚·ãƒ³åを指定ã§ããªããªã‚Šã¾ã—ãŸã€‚ã“ã‚ŒãŒç™ºç”Ÿã—ãŸå ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å¤±æ•—ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:679 +#: ../../rst/porting_guides/porting_guide_6.rst:815 msgid "serverless - removed the ``functions`` option. It was not used by the module (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "serverless - ``functions`` オプションを削除ã—ã¾ã—ãŸã€‚モジュールã§ä½¿ç”¨ã•ã‚Œã¦ã„ã¾ã›ã‚“ã§ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:680 +#: ../../rst/porting_guides/porting_guide_6.rst:816 msgid "slackpkg - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "slackpkg - ``update_cache`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:681 +#: ../../rst/porting_guides/porting_guide_6.rst:817 msgid "urpmi - removed the deprecated alias ``no-recommends`` of ``no_recommends`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "urpmi - ``no_recommends`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``no-recommends`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:682 +#: ../../rst/porting_guides/porting_guide_6.rst:818 msgid "urpmi - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "urpmi - ``update_cache`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:683 +#: ../../rst/porting_guides/porting_guide_6.rst:819 msgid "xbps - removed the deprecated alias ``update-cache`` of ``update_cache`` (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "xbps - ``update_cache`` ã® éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``update-cache`` を削除ã—ã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:684 +#: ../../rst/porting_guides/porting_guide_6.rst:820 msgid "xfconf - the ``get`` state has been removed. Use the ``xfconf_info`` module instead (https://github.com/ansible-collections/community.general/pull/4516)." msgstr "xfconf - ``get`` 状態ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``xfconf_info`` モジュールを使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.general/pull/4516)。" -#: ../../rst/porting_guides/porting_guide_6.rst:689 +#: ../../rst/porting_guides/porting_guide_6.rst:825 msgid "aws_iam auth - the deprecated alias ``aws_iam_login`` for the ``aws_iam`` value of the ``auth_method`` option has been removed (https://github.com/ansible-collections/community.hashi_vault/issues/194)." msgstr "aws_iam auth - ``auth_method`` オプション㮠``aws_iam`` 値ã®éžæŽ¨å¥¨ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_iam_login`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.hashi_vault/issues/194)。" -#: ../../rst/porting_guides/porting_guide_6.rst:690 +#: ../../rst/porting_guides/porting_guide_6.rst:826 msgid "community.hashi_vault collection - support for Ansible 2.9 and ansible-base 2.10 has been removed (https://github.com/ansible-collections/community.hashi_vault/issues/189)." msgstr "community.hashi_vault コレクション - Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.hashi_vault/issues/189)。" -#: ../../rst/porting_guides/porting_guide_6.rst:691 +#: ../../rst/porting_guides/porting_guide_6.rst:827 msgid "hashi_vault lookup - the deprecated ``[lookup_hashi_vault]`` INI config section has been removed in favor of the collection-wide ``[hashi_vault_collection]`` section (https://github.com/ansible-collections/community.hashi_vault/issues/179)." msgstr "hashi_vault ルックアップ - コレクション全体㮠``[lookup_hashi_vault]`` セクションãŒå„ªå…ˆã•ã‚Œã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã® ``[hashi_vault_collection]`` INI è¨å®šã‚»ã‚¯ã‚·ãƒ§ãƒ³ãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.hashi_vault/issues/179)。" -#: ../../rst/porting_guides/porting_guide_6.rst:697 +#: ../../rst/porting_guides/porting_guide_6.rst:833 +#: ../../rst/porting_guides/porting_guide_7.rst:886 msgid "aireos modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "aireos モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:698 +#: ../../rst/porting_guides/porting_guide_6.rst:834 +#: ../../rst/porting_guides/porting_guide_7.rst:887 msgid "aireos modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "aireos モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:699 +#: ../../rst/porting_guides/porting_guide_6.rst:835 +#: ../../rst/porting_guides/porting_guide_7.rst:888 msgid "aruba modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "aruba モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:700 +#: ../../rst/porting_guides/porting_guide_6.rst:836 +#: ../../rst/porting_guides/porting_guide_7.rst:889 msgid "aruba modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "aruba モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:701 +#: ../../rst/porting_guides/porting_guide_6.rst:837 +#: ../../rst/porting_guides/porting_guide_7.rst:890 msgid "ce modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "ce モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:702 +#: ../../rst/porting_guides/porting_guide_6.rst:838 +#: ../../rst/porting_guides/porting_guide_7.rst:891 msgid "ce modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "ce モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:703 +#: ../../rst/porting_guides/porting_guide_6.rst:839 +#: ../../rst/porting_guides/porting_guide_7.rst:892 msgid "enos modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "enos モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:704 +#: ../../rst/porting_guides/porting_guide_6.rst:840 +#: ../../rst/porting_guides/porting_guide_7.rst:893 msgid "enos modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "enos モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:705 +#: ../../rst/porting_guides/porting_guide_6.rst:841 +#: ../../rst/porting_guides/porting_guide_7.rst:894 msgid "ironware modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "ironware モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:706 +#: ../../rst/porting_guides/porting_guide_6.rst:842 +#: ../../rst/porting_guides/porting_guide_7.rst:895 msgid "ironware modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "ironware モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:707 +#: ../../rst/porting_guides/porting_guide_6.rst:843 +#: ../../rst/porting_guides/porting_guide_7.rst:896 msgid "sros modules - removed deprecated ``connection: local`` support. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "sros モジュール - éžæŽ¨å¥¨ã® ``connection: local`` サãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:708 +#: ../../rst/porting_guides/porting_guide_6.rst:844 +#: ../../rst/porting_guides/porting_guide_7.rst:897 msgid "sros modules - removed deprecated ``provider`` option. Use ``connection: network_cli`` instead (https://github.com/ansible-collections/community.network/pull/440)." msgstr "sros モジュール - éžæŽ¨å¥¨ã® ``provider`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``connection: network_cli`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.network/pull/440)。" -#: ../../rst/porting_guides/porting_guide_6.rst:713 +#: ../../rst/porting_guides/porting_guide_6.rst:849 msgid "vcenter_extension_facts - The deprecated module ``vcenter_extension_facts`` has been removed, use ``vcenter_extension_info`` instead." msgstr "vcenter_extension_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vcenter_extension_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vcenter_extension_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:714 +#: ../../rst/porting_guides/porting_guide_6.rst:850 msgid "vmware_about_facts - The deprecated module ``vmware_about_facts`` has been removed, use ``vmware_about_info`` instead." msgstr "vmware_about_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_about_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_about_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:715 +#: ../../rst/porting_guides/porting_guide_6.rst:851 msgid "vmware_category_facts - The deprecated module ``vmware_category_facts`` has been removed, use ``vmware_category_info`` instead." msgstr "vmware_category_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_category_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_category_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:716 +#: ../../rst/porting_guides/porting_guide_6.rst:852 msgid "vmware_cluster - Remove DRS configuration in favour of module ``vmware_cluster_drs``." msgstr "vmware_cluster - DRS è¨å®šã‚’削除ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_cluster_drs`` を優先ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:717 +#: ../../rst/porting_guides/porting_guide_6.rst:853 msgid "vmware_cluster - Remove HA configuration in favour of module ``vmware_cluster_ha``." msgstr "vmware_cluster - HA è¨å®šã‚’削除ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_cluster_ha`` を優先ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:718 +#: ../../rst/porting_guides/porting_guide_6.rst:854 msgid "vmware_cluster - Remove VSAN configuration in favour of module ``vmware_cluster_vsan``." msgstr "vmware_cluster - VSAN è¨å®šã‚’削除ã—ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_cluster_vsan`` を優先ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:719 +#: ../../rst/porting_guides/porting_guide_6.rst:855 msgid "vmware_cluster_facts - The deprecated module ``vmware_cluster_facts`` has been removed, use ``vmware_cluster_info`` instead." msgstr "vmware_cluster_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_cluster_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_cluster_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:720 +#: ../../rst/porting_guides/porting_guide_6.rst:856 msgid "vmware_datastore_facts - The deprecated module ``vmware_datastore_facts`` has been removed, use ``vmware_datastore_info`` instead." msgstr "vmware_datastore_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_datastore_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_datastore_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:721 +#: ../../rst/porting_guides/porting_guide_6.rst:857 msgid "vmware_drs_group_facts - The deprecated module ``vmware_drs_group_facts`` has been removed, use ``vmware_drs_group_info`` instead." msgstr "vmware_drs_group_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_drs_group_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_drs_group_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:722 +#: ../../rst/porting_guides/porting_guide_6.rst:858 msgid "vmware_drs_rule_facts - The deprecated module ``vmware_drs_rule_facts`` has been removed, use ``vmware_drs_rule_info`` instead." msgstr "vmware_drs_rule_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_drs_rule_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_drs_rule_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:723 +#: ../../rst/porting_guides/porting_guide_6.rst:859 msgid "vmware_dvs_portgroup - The deprecated parameter ``portgroup_type`` has been removed, use ``port_binding`` instead." msgstr "vmware_dvs_portgroup - éžæŽ¨å¥¨ã®ãƒ‘ラメーター ``portgroup_type`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``port_binding`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:724 +#: ../../rst/porting_guides/porting_guide_6.rst:860 msgid "vmware_dvs_portgroup_facts - The deprecated module ``vmware_dvs_portgroup_facts`` has been removed, use ``vmware_dvs_portgroup_info`` instead." msgstr "vmware_dvs_portgroup_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_dvs_portgroup_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_dvs_portgroup_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:725 +#: ../../rst/porting_guides/porting_guide_6.rst:861 msgid "vmware_guest_boot_facts - The deprecated module ``vmware_guest_boot_facts`` has been removed, use ``vmware_guest_boot_info`` instead." msgstr "vmware_guest_boot_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_boot_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_guest_boot_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:726 +#: ../../rst/porting_guides/porting_guide_6.rst:862 msgid "vmware_guest_customization_facts - The deprecated module ``vmware_guest_customization_facts`` has been removed, use ``vmware_guest_customization_info`` instead." msgstr "vmware_guest_customization_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_customization_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_guest_customization_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:727 +#: ../../rst/porting_guides/porting_guide_6.rst:863 msgid "vmware_guest_disk_facts - The deprecated module ``vmware_guest_disk_facts`` has been removed, use ``vmware_guest_disk_info`` instead." msgstr "vmware_guest_disk_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_disk_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_guest_disk_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:728 +#: ../../rst/porting_guides/porting_guide_6.rst:864 msgid "vmware_guest_facts - The deprecated module ``vmware_guest_facts`` has been removed, use ``vmware_guest_info`` instead." msgstr "vmware_guest_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_guest_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:729 +#: ../../rst/porting_guides/porting_guide_6.rst:865 msgid "vmware_guest_snapshot_facts - The deprecated module ``vmware_guest_snapshot_facts`` has been removed, use ``vmware_guest_snapshot_info`` instead." msgstr "vmware_guest_snapshot_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_snapshot_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_guest_snapshot_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:730 +#: ../../rst/porting_guides/porting_guide_6.rst:866 msgid "vmware_host_capability_facts - The deprecated module ``vmware_host_capability_facts`` has been removed, use ``vmware_host_capability_info`` instead." msgstr "vmware_host_capability_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_capability_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_capability_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:731 +#: ../../rst/porting_guides/porting_guide_6.rst:867 msgid "vmware_host_config_facts - The deprecated module ``vmware_host_config_facts`` has been removed, use ``vmware_host_config_info`` instead." msgstr "vmware_host_config_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_config_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_config_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:732 +#: ../../rst/porting_guides/porting_guide_6.rst:868 msgid "vmware_host_dns_facts - The deprecated module ``vmware_host_dns_facts`` has been removed, use ``vmware_host_dns_info`` instead." msgstr "vmware_host_dns_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_dns_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_dns_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:733 +#: ../../rst/porting_guides/porting_guide_6.rst:869 msgid "vmware_host_feature_facts - The deprecated module ``vmware_host_feature_facts`` has been removed, use ``vmware_host_feature_info`` instead." msgstr "vmware_host_feature_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_feature_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_feature_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:734 +#: ../../rst/porting_guides/porting_guide_6.rst:870 msgid "vmware_host_firewall_facts - The deprecated module ``vmware_host_firewall_facts`` has been removed, use ``vmware_host_firewall_info`` instead." msgstr "vmware_host_firewall_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_firewall_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_firewall_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:735 +#: ../../rst/porting_guides/porting_guide_6.rst:871 msgid "vmware_host_ntp_facts - The deprecated module ``vmware_host_ntp_facts`` has been removed, use ``vmware_host_ntp_info`` instead." msgstr "vmware_host_ntp_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_ntp_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_ntp_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:736 +#: ../../rst/porting_guides/porting_guide_6.rst:872 msgid "vmware_host_package_facts - The deprecated module ``vmware_host_package_facts`` has been removed, use ``vmware_host_package_info`` instead." msgstr "vmware_host_package_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_package_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_package_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:737 +#: ../../rst/porting_guides/porting_guide_6.rst:873 msgid "vmware_host_service_facts - The deprecated module ``vmware_host_service_facts`` has been removed, use ``vmware_host_service_info`` instead." msgstr "vmware_host_service_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_service_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_service_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:738 +#: ../../rst/porting_guides/porting_guide_6.rst:874 msgid "vmware_host_ssl_facts - The deprecated module ``vmware_host_ssl_facts`` has been removed, use ``vmware_host_ssl_info`` instead." msgstr "vmware_host_ssl_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_ssl_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_ssl_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:739 +#: ../../rst/porting_guides/porting_guide_6.rst:875 msgid "vmware_host_vmhba_facts - The deprecated module ``vmware_host_vmhba_facts`` has been removed, use ``vmware_host_vmhba_info`` instead." msgstr "vmware_host_vmhba_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_vmhba_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_vmhba_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:740 +#: ../../rst/porting_guides/porting_guide_6.rst:876 msgid "vmware_host_vmnic_facts - The deprecated module ``vmware_host_vmnic_facts`` has been removed, use ``vmware_host_vmnic_info`` instead." msgstr "vmware_host_vmnic_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_host_vmnic_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_vmnic_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:741 +#: ../../rst/porting_guides/porting_guide_6.rst:877 msgid "vmware_local_role_facts - The deprecated module ``vmware_local_role_facts`` has been removed, use ``vmware_local_role_info`` instead." msgstr "vmware_local_role_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_local_role_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_local_role_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:742 +#: ../../rst/porting_guides/porting_guide_6.rst:878 msgid "vmware_local_user_facts - The deprecated module ``vmware_local_user_facts`` has been removed, use ``vmware_local_user_info`` instead." msgstr "vmware_local_user_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_local_user_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_local_user_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:743 +#: ../../rst/porting_guides/porting_guide_6.rst:879 msgid "vmware_portgroup_facts - The deprecated module ``vmware_portgroup_facts`` has been removed, use ``vmware_portgroup_info`` instead." msgstr "vmware_portgroup_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_portgroup_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_portgroup_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:744 +#: ../../rst/porting_guides/porting_guide_6.rst:880 msgid "vmware_resource_pool_facts - The deprecated module ``vmware_resource_pool_facts`` has been removed, use ``vmware_resource_pool_info`` instead." msgstr "vmware_resource_pool_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_resource_pool_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_resource_pool_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:745 +#: ../../rst/porting_guides/porting_guide_6.rst:881 msgid "vmware_tag_facts - The deprecated module ``vmware_tag_facts`` has been removed, use ``vmware_tag_info`` instead." msgstr "vmware_tag_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_tag_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_tag_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:746 +#: ../../rst/porting_guides/porting_guide_6.rst:882 msgid "vmware_target_canonical_facts - The deprecated module ``vmware_target_canonical_facts`` has been removed, use ``vmware_target_canonical_info`` instead." msgstr "vmware_target_canonical_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_target_canonical_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_target_canonical_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:747 +#: ../../rst/porting_guides/porting_guide_6.rst:883 msgid "vmware_vm_facts - The deprecated module ``vmware_vm_facts`` has been removed, use ``vmware_vm_info`` instead." msgstr "vmware_vm_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_vm_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_vm_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:748 +#: ../../rst/porting_guides/porting_guide_6.rst:884 msgid "vmware_vmkernel_facts - The deprecated module ``vmware_vmkernel_facts`` has been removed, use ``vmware_vmkernel_info`` instead." msgstr "vmware_vmkernel_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_vmkernel_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_vmkernel_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:749 +#: ../../rst/porting_guides/porting_guide_6.rst:885 msgid "vmware_vmkernel_ip_config - The deprecated module ``vmware_vmkernel_ip_config`` has been removed, use ``vmware_vmkernel`` instead." msgstr "vmware_vmkernel_ip_config - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_vmkernel_ip_config`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_vmkernel`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:750 +#: ../../rst/porting_guides/porting_guide_6.rst:886 msgid "vmware_vswitch_facts - The deprecated module ``vmware_vswitch_facts`` has been removed, use ``vmware_vswitch_info`` instead." msgstr "vmware_vswitch_facts - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_vswitch_facts`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_vswitch_info`` を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_6.rst:760 +#: ../../rst/porting_guides/porting_guide_6.rst:896 msgid "ansible-core - Remove support for Python 2.6." msgstr "ansible-core - Python2.6 ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:761 +#: ../../rst/porting_guides/porting_guide_6.rst:897 msgid "ansible-test - Remove support for Python 2.6." msgstr "ansible-test - Python 2.6 ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:762 +#: ../../rst/porting_guides/porting_guide_6.rst:898 msgid "ssh connection plugin option scp_if_ssh in favor of ssh_transfer_method." msgstr "ssh 接続プラグインオプション scp_if_ssh 㧠ssh_transfer_method を優先ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_6.rst:767 -#: ../../rst/porting_guides/porting_guide_7.rst:454 +#: ../../rst/porting_guides/porting_guide_6.rst:903 +#: ../../rst/porting_guides/porting_guide_7.rst:975 msgid "ec2_instance - The default value for ```instance_type``` has been deprecated, in the future release you must set an instance_type or a launch_template (https://github.com/ansible-collections/amazon.aws/pull/587)." msgstr "ec2_instance - '``instance_type``' ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ä»Šå¾Œã®ãƒªãƒªãƒ¼ã‚¹ã§ instance_type ã¾ãŸã¯ launch_template ã‚’è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/587)。" -#: ../../rst/porting_guides/porting_guide_6.rst:768 +#: ../../rst/porting_guides/porting_guide_6.rst:904 msgid "module_utils - support for the original AWS SDK `boto` has been deprecated in favour of the `boto3`/`botocore` SDK. All `boto` based modules have either been deprecated or migrated to `botocore`, and the remaining support code in module_utils will be removed in release 4.0.0 of the amazon.aws collection. Any modules outside of the amazon.aws and community.aws collections based on the `boto` library will need to be migrated to the `boto3`/`botocore` libraries (https://github.com/ansible-collections/amazon.aws/pull/575)." msgstr "module_utils - 元㮠AWS SDK `boto` ã®ã‚µãƒãƒ¼ãƒˆãŒéžæŽ¨å¥¨ã¨ãªã‚Šã€`boto3`/`botocore` SDK ãŒæŽ¡ç”¨ã•ã‚Œã¾ã—ãŸã€‚`boto` ベースã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã™ã¹ã¦éžæŽ¨å¥¨ã«ãªã‚‹ã‹ã€`botocore` ã«ç§»è¡Œã•ã‚Œã¦ãŠã‚Šã€module_utils ã®æ®‹ã‚Šã®ã‚µãƒãƒ¼ãƒˆã‚³ãƒ¼ãƒ‰ã¯ amazon.aws コレクションã®ãƒªãƒªãƒ¼ã‚¹ 4.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`boto` ライブラリーã«åŸºã¥ã„㟠amazon.aws コレクションãŠã‚ˆã³ community.aws コレクション以外ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€`boto3`/`botocore` ライブラリーã«ç§»è¡Œã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/575)。" -#: ../../rst/porting_guides/porting_guide_6.rst:797 +#: ../../rst/porting_guides/porting_guide_6.rst:910 +msgid "ios_acls - Deprecated fragment attribute added boolean alternate as enable_fragment." +msgstr "ios_acls - éžæŽ¨å¥¨ã®ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆå±žæ€§ã«ã‚ˆã‚Šã€enable_fragment ã¨ã—ã¦ãƒ–ール値代替ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_6.rst:933 msgid "ansible_galaxy_install - deprecated support for ``ansible`` 2.9 and ``ansible-base`` 2.10 (https://github.com/ansible-collections/community.general/pull/4601)." msgstr "ansible_galaxy_install - ``ansible`` 2.9 ãŠã‚ˆã³ ``ansible-base`` 2.10 ã®ã‚µãƒãƒ¼ãƒˆãŒéžæŽ¨å¥¨ã«ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/4601)。" -#: ../../rst/porting_guides/porting_guide_6.rst:798 +#: ../../rst/porting_guides/porting_guide_6.rst:934 msgid "dig lookup plugin - the ``DLV`` record type has been decommissioned in 2017 and support for it will be removed from community.general 6.0.0 (https://github.com/ansible-collections/community.general/pull/4618)." msgstr "dig lookup プラグイン - 2017 å¹´ã«éžæŽ¨å¥¨ã¨ãªã£ãŸ ``DLV`` レコードタイプã®ã‚µãƒãƒ¼ãƒˆãŒ community.general 6.0.0 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/4618)。" -#: ../../rst/porting_guides/porting_guide_6.rst:799 +#: ../../rst/porting_guides/porting_guide_6.rst:935 msgid "gem - the default of the ``norc`` option has been deprecated and will change to ``true`` in community.general 6.0.0. Explicitly specify a value to avoid a deprecation warning (https://github.com/ansible-collections/community.general/pull/4517)." msgstr "gem - ``norc``オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯å»ƒæ¢ã•ã‚Œã€community.general6.0.0 㧠``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚éžæŽ¨å¥¨ã®è¦å‘Šã‚’防ããŸã‚ã«ã€å€¤ã‚’明示的ã«æŒ‡å®šã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/4517)。" -#: ../../rst/porting_guides/porting_guide_6.rst:805 +#: ../../rst/porting_guides/porting_guide_6.rst:941 msgid "vmadm - deprecated module parameter ``debug`` that was not used anywhere (https://github.com/ansible-collections/community.general/pull/4580)." msgstr "vmadm - ã©ã“ã«ã‚‚使用ã•ã‚Œã¦ã„ãªã„éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãƒ‘ラメーター ``debug`` (https://github.com/ansible-collections/community.general/pull/4580)。" -#: ../../rst/porting_guides/porting_guide_6.rst:813 +#: ../../rst/porting_guides/porting_guide_6.rst:949 msgid "token_validate options - the shared auth option ``token_validate`` will change its default from ``true`` to ``false`` in community.hashi_vault version 4.0.0. The ``vault_login`` lookup and module will keep the default value of ``true`` (https://github.com/ansible-collections/community.hashi_vault/issues/248)." msgstr "token_validate オプション - 共有èªè¨¼ã‚ªãƒ—ション ``token_validate`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€community.hashi_vault ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 4.0.0 㧠``true`` ã‹ã‚‰ ``false`` ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚``vault_login`` ルックアップãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã® ``true`` ã‚’ä¿æŒã—ã¾ã™ (https://github.com/ansible-collections/community.hashi_vault/issues/248)。" @@ -11425,7 +11736,7 @@ msgstr "Ansible 7 㯠Ansible-core 2.14 をベースã«ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_7.rst:18 msgid "We suggest you read this page along with the `Ansible 7 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/7/CHANGELOG-v7.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ `Ansible 7 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/7/CHANGELOG-v7.rst>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ `Ansible 7 Changelog <https://github.com/ansible-community/ansible-build-data/blob/main/7/CHANGELOG-v7.rst>`_ ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_7.rst:24 #: ../../rst/porting_guides/porting_guide_core_2.14.rst:22 @@ -11443,904 +11754,1966 @@ msgid "At startup the filesystem encoding and locale are checked to verify they msgstr "起動時ã«ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã®ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã¨ãƒã‚±ãƒ¼ãƒ«ãŒãƒã‚§ãƒƒã‚¯ã•ã‚Œã€UTF-8 ã§ã‚ã‚‹ã“ã¨ãŒç¢ºèªã•ã‚Œã¾ã™ã€‚確èªã—ãªã„å ´åˆã€ãƒ—ãƒã‚»ã‚¹ã¯èª¤ã£ãŸã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã‚’å ±å‘Šã™ã‚‹ã‚¨ãƒ©ãƒ¼ã§çµ‚了ã—ã¾ã™ã€‚以å‰ã« ``C`` ã¾ãŸ ``POSIX`` ãƒã‚±ãƒ¼ãƒ«ã‚’使用ã—ã¦ã„ãŸå ´åˆã¯ã€``C.UTF-8`` を使用ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚以å‰ã« ``en_US.ISO-8859-1`` ã®ã‚ˆã†ãªãƒã‚±ãƒ¼ãƒ«ã‚’使用ã—ã¦ã„ãŸå ´åˆã¯ã€``en_US.UTF-8`` を使用ã§ãã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ç°¡å˜ã«ã™ã‚‹ãŸã‚ã«ã€``LC_ALL`` 環境変数をã—よã†ã—ã¦ã€é©åˆ‡ãªãƒã‚±ãƒ¼ãƒ«ã‚’エクスãƒãƒ¼ãƒˆã™ã‚‹ã“ã¨ãŒæœ€ã‚‚ç°¡å˜ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。システムãƒã‚±ãƒ¼ãƒ«ã‚’変更ã™ã‚‹ä»£ã‚ã‚Šã«ã€Python ã‚’ UTF-8 モードã§å®Ÿè¡Œã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚詳細ã¯ã€`Python documentation <https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUTF8>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/porting_guides/porting_guide_7.rst:96 -msgid "Porting Guide for v7.0.0a1" -msgstr "v7.0.0a1 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" +msgid "Porting Guide for v7.2.0" +msgstr "v7.2.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_7.rst:101 +msgid "dellemc.powerflex (version 1.5.0)" +msgstr "dellemc.powerflex (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.5.0)" + +#: ../../rst/porting_guides/porting_guide_7.rst:102 +msgid "dellemc.unity (version 1.5.0)" +msgstr "dellemc.unity (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.5.0)" + +#: ../../rst/porting_guides/porting_guide_7.rst:110 +msgid "ansible-test - Additional configuration may be required for certain container host and container combinations. Further details are available in the testing documentation." +msgstr "ansible-test - 特定ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ãƒ›ã‚¹ãƒˆã¨ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®çµ„ã¿åˆã‚ã›ã§ã¯ã€è¿½åŠ ã®è¨å®šãŒå¿…è¦ã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚詳細ã«ã¤ã„ã¦ã¯ã€ãƒ†ã‚¹ãƒˆãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_7.rst:111 +msgid "ansible-test - Custom containers with ``VOLUME`` instructions may be unable to start, when previously the containers started correctly. Remove the ``VOLUME`` instructions to resolve the issue. Containers with this condition will cause ``ansible-test`` to emit a warning." +msgstr "ansible-test - ``VOLUME`` 指示ã®ã‚るカスタムコンテナーã¯ã€ä»¥å‰ã¯ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ãŒæ£ã—ãèµ·å‹•ã—ã¦ã„ãŸå ´åˆã€é–‹å§‹ã§ããªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚``VOLUME`` 指示をå–り外ã—ã€å•é¡Œã‚’解決ã—ã¦ãã ã•ã„。ã“ã®çŠ¶æ…‹ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã¯ ``ansible-test`` ã®åŽŸå› ã¨ãªã‚Šã€è¦å‘Šã‚’発ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:112 +msgid "ansible-test - Systems with Podman networking issues may be unable to run containers, when previously the issue went unreported. Correct the networking issues to continue using ``ansible-test`` with Podman." +msgstr "ansible-test - 以å‰ã¯å•é¡ŒãŒå ±å‘Šã•ã‚Œã¦ã„ãªã‹ã£ãŸå ´åˆã€Podman ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã®å•é¡ŒãŒã‚るシステムã¯ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã‚’実行ã§ããªã„å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚Podman 㧠``ansible-test`` を引ã続ã使用ã™ã‚‹ã«ã¯ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã®å•é¡Œã‚’ä¿®æ£ã—ã¦ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_7.rst:113 +msgid "ansible-test - Using Docker on systems with SELinux may require setting SELinux to permissive mode. Podman should work with SELinux in enforcing mode." +msgstr "ansible-test - SELinux ã‚’æ載ã—ãŸã‚·ã‚¹ãƒ†ãƒ 㧠Docker を使用ã™ã‚‹ã«ã¯ã€SELinux ã‚’ Permissive モードã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚Podman ã¯ã€Enforcing モード㧠SELinux ã¨é€£æºã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:118 +msgid "meraki_network - Updated documentation for `local_status_page_enabled` and `remote_status_page_enabled` as these no longer work." +msgstr "meraki_network - `local_status_page_enabled` ãŠã‚ˆã³ `remote_status_page_enabled` ã¯æ©Ÿèƒ½ã—ãªããªã£ãŸã®ã§ã€ã“れらã«é–¢ã™ã‚‹ãƒ‰ã‚ュメントを更新ã—ã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:126 +msgid "ModuleHelper module utils - when the module sets output variables named ``msg``, ``exception``, ``output``, ``vars``, or ``changed``, the actual output will prefix those names with ``_`` (underscore symbol) only when they clash with output variables generated by ModuleHelper itself, which only occurs when handling exceptions. Please note that this breaking change does not require a new major release since before this release, it was not possible to add such variables to the output `due to a bug <https://github.com/ansible-collections/community.general/pull/5755>`__ (https://github.com/ansible-collections/community.general/pull/5765)." +msgstr "ModuleHelper module utils - モジュールセットãŒã€``msg``ã€``exception``ã€``output``ã€``vars``ã€ã¾ãŸã¯ ``changed`` ã¨ã„ã†åå‰ã®å¤‰æ•°ã‚’出力ã™ã‚‹ã¨ã€å®Ÿéš›ã®å‡ºåŠ›ã§ã¯ã€ã“れらã®åå‰ã®å‰ã« ``_`` (アンダースコア記å·) ãŒä»˜ã‘られã¾ã™ã€‚ã“ã‚Œã¯ã€ModuleHelper ãã®ã‚‚ã®ã«ã‚ˆã£ã¦ç”Ÿæˆã•ã‚ŒãŸå‡ºåŠ›å¤‰æ•°ã¨ã‚¯ãƒ©ãƒƒã‚·ãƒ¥ã™ã‚‹æ™‚ã®ã¿ã«ä»˜ã‘られã€ä¾‹å¤–を処ç†ã™ã‚‹ã¨ãã«ã®ã¿ç™ºç”Ÿã—ã¾ã™ã€‚ã“ã®é‡å¤§ãªå¤‰æ›´ã«ã¯æ–°ã—ã„メジャーリリースã¯å¿…è¦ãªã„ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。ã“ã®ãƒªãƒªãƒ¼ã‚¹ã‚ˆã‚Šå‰ã¯ã€`due to a bug <https://github.com/ansible-collections/community.general/pull/5755>`__ ã«ã‚ˆã‚Šã€ãã®ã‚ˆã†ãªå¤‰æ•°ã‚’出力ã«è¿½åŠ ã™ã‚‹ã“ã¨ãŒã§ããªã‹ã£ãŸã‹ã‚‰ã§ã™ (https://github.com/ansible-collections/community.general/pull/5765)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:134 +msgid "ansible-test - Docker Desktop on WSL2 is now supported (additional configuration required)." +msgstr "ansible-test - Docker Desktop on WSL2 ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—㟠(è¿½åŠ ã®è¨å®šãŒå¿…è¦ã§ã™)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:135 +msgid "ansible-test - Docker and Podman are now supported on hosts with cgroup v2 unified. Previously only cgroup v1 and cgroup v2 hybrid were supported." +msgstr "ansible-test - cgroup v2 ãŒçµ±åˆã•ã‚ŒãŸãƒ›ã‚¹ãƒˆã§ Docker 㨠Podman ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã¯ã€cgroup v1 ãŠã‚ˆã³ cgroup v2 ãƒã‚¤ãƒ–リッドã®ã¿ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:136 +msgid "ansible-test - Podman now works on container hosts without systemd. Previously only some containers worked, while others required rootfull or rootless Podman, but would not work with both. Some containers did not work at all." +msgstr "ansible-test - Podman ㌠systemd ã®ãªã„コンテナーホストã§å‹•ä½œã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã¯ã€ä¸€éƒ¨ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã®ã¿ãŒå‹•ä½œã—ã€ä»–ã®ã‚³ãƒ³ãƒ†ãƒŠãƒ¼ã¯ rootfull ã¾ãŸã¯ rootless Podman ã‚’å¿…è¦ã¨ã—ã¦ã„ã¾ã—ãŸãŒã€ä¸¡æ–¹ã§ã¯å‹•ä½œã—ã¾ã›ã‚“ã§ã—ãŸã€‚ã¾ã£ãŸã動作ã—ãªã„コンテナーもã‚ã‚Šã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:137 +msgid "ansible-test - Podman on WSL2 is now supported." +msgstr "ansible-test - WSL2 ã® Podman ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:138 +msgid "ansible-test - When additional cgroup setup is required on the container host, this will be automatically detected. Instructions on how to configure the host will be provided in the error message shown." +msgstr "ansible-test - コンテナーホストã§è¿½åŠ ã® cgroup セットアップãŒå¿…è¦ãªå ´åˆã€ã“ã‚Œã¯è‡ªå‹•çš„ã«æ¤œå‡ºã•ã‚Œã¾ã™ã€‚ホストã®è¨å®šæ–¹æ³•ã«ã¤ã„ã¦ã¯ã€è¡¨ç¤ºã•ã‚Œã‚‹ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã«è¨˜è¼‰ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:143 +msgid "Set the minimum Ansible version supported by this collection to Ansible 2.12" +msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ Ansible ã®æœ€å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ Ansible 2.12 ã«è¨å®šã—ã¾ã™" + +#: ../../rst/porting_guides/porting_guide_7.rst:148 +msgid "win_chocolatey - Allow users to select the TLS versions used for bootstrapping Chocolatey installation." +msgstr "win_chocolatey - Chocolatey インストールã®ãƒ–ートストラップã«ä½¿ç”¨ã™ã‚‹ TLS ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’ユーザーãŒé¸æŠžã§ãるよã†ã«ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:153 +msgid "The cisco.nso collection is considered unmaintained and will be removed from Ansible 9 if no one starts maintaining it again before Ansible 9. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/155)." +msgstr "cisco.nso コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 9 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã¯ã€Ansible 9 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-community/community-topics/issues/155)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:154 +msgid "The community.fortios collection is considered unmaintained and will be removed from Ansible 9 if no one starts maintaining it again before Ansible 9. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/162)." +msgstr "community.fortios コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 9 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 9 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-community/community-topics/issues/162)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:155 +msgid "The community.google collection is considered unmaintained and will be removed from Ansible 9 if no one starts maintaining it again before Ansible 9. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/160)." +msgstr "community.google コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 9 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 9 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-community/community-topics/issues/160)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:156 +msgid "The community.skydive collection is considered unmaintained and will be removed from Ansible 9 if no one starts maintaining it again before Ansible 9. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/171)." +msgstr "community.skydive コレクションã¯ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„ã¨è¦‹ãªã•ã‚Œã€Ansible 9 より先ã«å†ã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’開始ã™ã‚‹äººãŒã„ãªã„å ´åˆã€Ansible 9 ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã™ã€‚`the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-community/community-topics/issues/171)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:161 +msgid "win_chocolatey - Deprecate side-by-side installs." +msgstr "win_chocolatey - サイドãƒã‚¤ã‚µã‚¤ãƒ‰æ–¹å¼ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’廃æ¢ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:166 +msgid "ios_bgp_address_family - deprecate neighbors.address/tag/ipv6_adddress with neighbor_address which enables common attributes for facts rendering" +msgstr "ios_bgp_address_family - neighbors.address/tag/ipv6_addaddress ã‚’éžæŽ¨å¥¨ã«ã—ã€ãƒ•ã‚¡ã‚¯ãƒˆãƒ¬ãƒ³ãƒ€ãƒªãƒ³ã‚°ã®å…±é€šå±žæ€§ã‚’有効ã«ã™ã‚‹ neighbor_address を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:167 +msgid "ios_bgp_address_family - deprecate neighbors.password with password_options which allows encryption and password" +msgstr "ios_bgp_address_family - æš—å·åŒ–ã¨ãƒ‘スワードを許å¯ã™ã‚‹ password_options を使用ã—ã¦ã€neighbors.password ã‚’éžæŽ¨å¥¨ã«ã—ã¾ã™" + +#: ../../rst/porting_guides/porting_guide_7.rst:168 +msgid "ios_bgp_address_family - deprecate slow_peer with slow_peer_options which supports a dict attribute" +msgstr "ios_bgp_address_family - dict 属性をサãƒãƒ¼ãƒˆã™ã‚‹ slow_peer_options ã‚’æŒã¤ slow_peer ã‚’éžæŽ¨å¥¨ã«ã—ã¾ã™" + +#: ../../rst/porting_guides/porting_guide_7.rst:173 +msgid "The default of the newly added option ``txt_character_encoding`` will change from ``octal`` to ``decimal`` in community.dns 3.0.0. The new default will be compatible with `RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__ (https://github.com/ansible-collections/community.dns/pull/134)." +msgstr "æ–°ã—ãè¿½åŠ ã•ã‚ŒãŸã‚ªãƒ—ション ``txt_character_encoding``ã¯ã€community.dns 3.0.0 㧠``octal`` ã‹ã‚‰ ``decimal`` ã¸å¤‰æ›´ã—ã¾ã™ã€‚æ–°ã—ã„デフォルト㯠`RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__ ã¨äº’æ›æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.dns/pull/134)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:178 +msgid "consul - deprecate using parameters unused for ``state=absent`` (https://github.com/ansible-collections/community.general/pull/5772)." +msgstr "consul - ``state=absent`` ã®æœªä½¿ç”¨ã§ã‚るパラメーターã®ä½¿ç”¨ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/5772)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:179 +msgid "gitlab_runner - the default of the new option ``access_level_on_creation`` will change from ``false`` to ``true`` in community.general 7.0.0. This will cause ``access_level`` to be used during runner registration as well, and not only during updates (https://github.com/ansible-collections/community.general/pull/5908)." +msgstr "gitlab_runner - æ–°ã—ã„オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ ``access_level_on_creation`` ã¯ã€community.general 7.0.0 㧠``false`` ã‹ã‚‰ ``true`` ã¸å¤‰æ›´ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€``access_level`` ã¯æ›´æ–°æ™‚ã ã‘ã§ãªãã€ãƒ©ãƒ³ãƒŠãƒ¼ç™»éŒ²æ™‚ã«ã‚‚使用ã•ã‚Œã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/5908)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:180 +msgid "manageiq_policies - deprecate ``state=list`` in favour of using ``community.general.manageiq_policies_info`` (https://github.com/ansible-collections/community.general/pull/5721)." +msgstr "manageiq_policies - ``state=list`` ã‚’éžæŽ¨å¥¨ã¨ã—ã€``community.general.manageiq_policies_info`` を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/5721)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:181 +msgid "rax - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:182 +msgid "rax_cbs - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_cbs - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:183 +msgid "rax_cbs_attachments - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_cbs_attachments - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:184 +msgid "rax_cdb - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_cdb - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" -#: ../../rst/porting_guides/porting_guide_7.rst:103 +#: ../../rst/porting_guides/porting_guide_7.rst:185 +msgid "rax_cdb_database - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_cdb_database - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:186 +msgid "rax_cdb_user - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_cdb_user - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:187 +msgid "rax_clb - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_clb - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:188 +msgid "rax_clb_nodes - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_clb_nodes - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:189 +msgid "rax_clb_ssl - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_clb_ssl - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:190 +msgid "rax_dns - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_dns - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:191 +msgid "rax_dns_record - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_dns_record - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:192 +msgid "rax_facts - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_facts - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:193 +msgid "rax_files - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_files - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:194 +msgid "rax_files_objects - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_files_objects - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:195 +msgid "rax_identity - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_identity - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:196 +msgid "rax_keypair - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_keypair - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:197 +msgid "rax_meta - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_meta - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:198 +msgid "rax_mon_alarm - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_mon_alarm - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:199 +msgid "rax_mon_check - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_mon_check - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:200 +msgid "rax_mon_entity - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_mon_entity - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:201 +msgid "rax_mon_notification - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_mon_notification - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:202 +msgid "rax_mon_notification_plan - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_mon_notification_plan - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:203 +msgid "rax_network - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_network - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:204 +msgid "rax_queue - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_queue - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:205 +msgid "rax_scaling_group - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_scaling_group - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:206 +msgid "rax_scaling_policy - module relies on deprecates library ``pyrax``. Unless maintainers step up to work on the module, it will be marked as deprecated in community.general 7.0.0 and removed in version 9.0.0 (https://github.com/ansible-collections/community.general/pull/5733)." +msgstr "rax_scaling_policy - モジュールã¯ã€éžæŽ¨å¥¨ã®ãƒ©ã‚¤ãƒ–ラリー ``pyrax`` ã«ä¾å˜ã—ã¦ã„ã¾ã™ã€‚メンテナーãŒã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«å–り組むãŸã‚ã®å¯¾ç–ã‚’ã¨ã‚‰ãªã„é™ã‚Šã€ã“れ㯠community.general 7.0.0 ã§éžæŽ¨å¥¨ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã•ã‚Œã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 9.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.general/pull/5733)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:211 +msgid "ansible-core - support for ``ansible-core`` versions ``2.11`` and ``2.12`` will be dropped in collection version ``5.0.0``, making ``2.13`` the minimum supported version of ``ansible-core`` (https://github.com/ansible-collections/community.hashi_vault/issues/340)." +msgstr "ansible-core - ã®ã‚µãƒãƒ¼ãƒˆ``ansible-core`` ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``2.11`` 㨠``2.12`` ã®ã‚µãƒãƒ¼ãƒˆã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``5.0.0`` ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€``2.13`` ㌠``ansible-core`` ã®ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„る最å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ãªã‚Šã¾ã™ (https://github.com/ansible-collections/community.hashi_vault/issues/340)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:212 +msgid "hvac - the minimum version of ``hvac`` to be supported in collection version ``5.0.0`` will be at least ``1.0.2``; this minimum may be raised before ``5.0.0`` is released, so please subscribe to the linked issue and look out for new notices in the changelog (https://github.com/ansible-collections/community.hashi_vault/issues/324)." +msgstr "hvac - コレクションãƒãƒ¼ã‚¸ãƒ§ãƒ³ ``5.0.0`` ã§ã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹äºˆå®šã® ``hvac`` ã®æœ€å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€å°‘ãªãã¨ã‚‚ ``1.0.2`` ã§ã™ã€‚ã“ã®æœ€å°ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€``5.0.0`` ãŒãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹å‰ã«å¼•ã上ã’られるå¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã®ã§ã€ãƒªãƒ³ã‚¯ã•ã‚Œã¦ã„ã‚‹å•é¡Œã«ã‚µãƒ–スクライブã—ã€changelog ã§æ–°ã—ã„通知ã«æ³¨æ„ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.hashi_vault/issues/324)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:215 +msgid "Porting Guide for v7.1.0" +msgstr "v7.1.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_7.rst:220 +msgid "grafana.grafana (version 1.1.0)" +msgstr "grafana.grafana (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.1.0)" + +#: ../../rst/porting_guides/porting_guide_7.rst:263 +msgid "The ``sap`` modules ``sapcar_extract``, ``sap_task_list_execute``, and ``hana_query``, will be removed from this collection in community.general 7.0.0 and replaced with redirects to ``community.sap_libs``. If you want to continue using these modules, make sure to also install ``community.sap_libs`` (it is part of the Ansible package) (https://github.com/ansible-collections/community.general/pull/5614)." +msgstr "``sap`` モジュール㮠``sapcar_extract``ã€``sap_task_list_execute``ã€ãŠã‚ˆã³ ``hana_query`` ã¯ã€community.general 7.0.0 ã§ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‹ã‚‰å‰Šé™¤ã•ã‚Œã€``community.sap_libs`` ã¸ã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚ã“れらã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’引ã続ã使用ã™ã‚‹å ´åˆã¯ã€å¿…ãš ``community.sap_libs`` もインストールã—ã¦ãã ã•ã„ (ã“れ㯠Ansible パッケージã®ä¸€éƒ¨ã§ã™) (https://github.com/ansible-collections/community.general/pull/5614)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:266 +msgid "Porting Guide for v7.0.0" +msgstr "v7.0.0 ã®ç§»æ¤ã‚¬ã‚¤ãƒ‰" + +#: ../../rst/porting_guides/porting_guide_7.rst:271 +msgid "ibm.spectrum_virtualize (version 1.10.0)" +msgstr "ibm.spectrum_virtualize (version 1.10.0)" + +#: ../../rst/porting_guides/porting_guide_7.rst:272 +msgid "inspur.ispim (version 1.2.0)" +msgstr "inspur.ispim (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.2.0)" + +#: ../../rst/porting_guides/porting_guide_7.rst:274 msgid "purestorage.fusion (version 1.1.1)" msgstr "purestorage.fusion (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.1.1)" -#: ../../rst/porting_guides/porting_guide_7.rst:133 +#: ../../rst/porting_guides/porting_guide_7.rst:275 +msgid "vultr.cloud (version 1.3.1)" +msgstr "vultr.cloud (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.3.1)" + +#: ../../rst/porting_guides/porting_guide_7.rst:306 +msgid "Ansible 7 requires Python 3.9 on the controller, same as ansible-core 2.14." +msgstr "Ansible 7 ã¯ã€ansible-core 2.14 ã¨åŒã˜ã‚ˆã†ã«ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ä¸Šã« Python 3.9 ã‚’å¿…è¦ã¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:311 msgid "Allow for lazy evaluation of Jinja2 expressions (https://github.com/ansible/ansible/issues/56017)" msgstr "Jinja2 å¼ã®é…延評価を許å¯ã—ã¾ã™ (https://github.com/ansible/ansible/issues/56017)" -#: ../../rst/porting_guides/porting_guide_7.rst:134 +#: ../../rst/porting_guides/porting_guide_7.rst:312 msgid "The default ansible-galaxy role skeletons no longer contain .travis.yml files. You can configure ansible-galaxy to use a custom role skeleton that contains a .travis.yml file to continue using Galaxy's integration with Travis CI." msgstr "デフォルト㮠ansible-galaxy ãƒãƒ¼ãƒ«ã‚¹ã‚±ãƒ«ãƒˆãƒ³ã«ã¯ã€.travis.yml ファイルãŒå«ã¾ã‚Œãªããªã‚Šã¾ã—ãŸã€‚.travis.yml ファイルをå«ã‚€ã‚«ã‚¹ã‚¿ãƒ ãƒãƒ¼ãƒ«ã®ã‚¹ã‚±ãƒ«ãƒˆãƒ³ã‚’使用ã™ã‚‹ã‚ˆã†ã« ansible-galaxy ã‚’è¨å®šã—ã¦ã€Galaxy 㨠Travis CI ã®çµ±åˆã‚’引ã続ã使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:135 -#: ../../rst/porting_guides/porting_guide_7.rst:201 +#: ../../rst/porting_guides/porting_guide_7.rst:313 +#: ../../rst/porting_guides/porting_guide_7.rst:476 msgid "ansible - At startup the filesystem encoding and locale are checked to verify they are UTF-8. If not, the process exits with an error reporting the errant encoding." msgstr "ansible - 起動時ã«ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã®ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã¨ãƒã‚±ãƒ¼ãƒ«ãŒãƒã‚§ãƒƒã‚¯ã•ã‚Œã€UTF-8 ã§ã‚ã‚‹ã“ã¨ãŒç¢ºèªã•ã‚Œã¾ã™ã€‚確èªã—ãªã„å ´åˆã€ãƒ—ãƒã‚»ã‚¹ã¯èª¤ã£ãŸã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã‚’å ±å‘Šã™ã‚‹ã‚¨ãƒ©ãƒ¼ã§çµ‚了ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:136 -#: ../../rst/porting_guides/porting_guide_7.rst:202 +#: ../../rst/porting_guides/porting_guide_7.rst:314 +#: ../../rst/porting_guides/porting_guide_7.rst:477 msgid "ansible - Increase minimum Python requirement to Python 3.9 for CLI utilities and controller code" msgstr "ansible - CLI ユーティリティーã¨ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã® Python ã®æœ€å°è¦ä»¶ã‚’ Python 3.9 ã«å¢—ã‚„ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:137 -#: ../../rst/porting_guides/porting_guide_7.rst:203 +#: ../../rst/porting_guides/porting_guide_7.rst:315 +#: ../../rst/porting_guides/porting_guide_7.rst:478 msgid "ansible-test - At startup the filesystem encoding is checked to verify it is UTF-8. If not, the process exits with an error reporting the errant encoding." msgstr "ansible-test - 起動時ã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚·ã‚¹ãƒ†ãƒ ã®ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ãŒãƒã‚§ãƒƒã‚¯ã•ã‚Œã€UTF-8 ã§ã‚ã‚‹ã“ã¨ãŒç¢ºèªã•ã‚Œã¾ã™ã€‚確èªã—ãªã„å ´åˆã€ãƒ—ãƒã‚»ã‚¹ã¯èª¤ã£ãŸã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã‚’å ±å‘Šã™ã‚‹ã‚¨ãƒ©ãƒ¼ã§çµ‚了ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:138 -#: ../../rst/porting_guides/porting_guide_7.rst:204 +#: ../../rst/porting_guides/porting_guide_7.rst:316 +#: ../../rst/porting_guides/porting_guide_7.rst:479 msgid "ansible-test - At startup the locale is configured as ``en_US.UTF-8``, with a fallback to ``C.UTF-8``. If neither encoding is available the process exits with an error. If the fallback is used, a warning is displayed. In previous versions the ``en_US.UTF-8`` locale was always requested. However, no startup checking was performed to verify the locale was successfully configured." msgstr "ansible-test - 起動時ã«ãƒã‚±ãƒ¼ãƒ«ã¯ã€``C.UTF-8`` ã¸ã®ãƒ•ã‚©ãƒ¼ãƒ«ãƒãƒƒã‚¯ã®ã‚ã‚‹ ``en_US.UTF-8`` ã¨ã—ã¦è¨å®šã•ã‚Œã¾ã™ã€‚ã©ã¡ã‚‰ã®ã‚¨ãƒ³ã‚³ãƒ¼ãƒ‡ã‚£ãƒ³ã‚°ã‚‚利用ã§ããªã„å ´åˆã€ãƒ—ãƒã‚»ã‚¹ã¯ã‚¨ãƒ©ãƒ¼ã§çµ‚了ã—ã¾ã™ã€‚フォールãƒãƒƒã‚¯ãŒä½¿ç”¨ã•ã‚Œã‚‹å ´åˆã€è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€``en_US.UTF-8`` ãƒã‚±ãƒ¼ãƒ«ã¯å¸¸ã«è¦æ±‚ã•ã‚Œã¾ã—ãŸã€‚ãŸã ã—ã€ãƒã‚±ãƒ¼ãƒ«ãŒæ£å¸¸ã«è¨å®šã•ã‚ŒãŸã“ã¨ã‚’確èªã™ã‚‹ãŸã‚ã®èµ·å‹•æ™‚ã®ãƒã‚§ãƒƒã‚¯ã¯å®Ÿè¡Œã•ã‚Œã¾ã›ã‚“ã§ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:139 +#: ../../rst/porting_guides/porting_guide_7.rst:317 +msgid "ansible-test validate-modules - Removed the ``missing-python-doc`` error code in validate modules, ``missing-documentation`` is used instead for missing PowerShell module documentation." +msgstr "ansible-test validate-modules - モジュールã®æ¤œè¨¼ã§ ``missing-python-doc`` エラーコードを削除ã—ã¾ã—ãŸã€‚``missing-documentation`` ã¯ã€PowerShell モジュールã®ãƒ‰ã‚ュメントãŒãªã„å ´åˆã«ä»£ã‚ã‚Šã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:318 msgid "strategy plugins - Make ``ignore_unreachable`` to increase ``ignored`` and ``ok`` and counter, not ``skipped`` and ``unreachable``. (https://github.com/ansible/ansible/issues/77690)" msgstr "ストラテジープラグイン - ``ignore_unreachable`` ãŒã€``skipped`` ãŠã‚ˆã³ ``unreachable`` ã§ã¯ãªãã€``ignored``ã€``ok``ã€ãŠã‚ˆã³ã‚«ã‚¦ãƒ³ã‚¿ãƒ¼ã‚’増やã™ã‚ˆã†ã«ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77690)。" -#: ../../rst/porting_guides/porting_guide_7.rst:144 -#: ../../rst/porting_guides/porting_guide_7.rst:165 +#: ../../rst/porting_guides/porting_guide_7.rst:323 +#: ../../rst/porting_guides/porting_guide_7.rst:359 msgid "Tags beginning with ``aws:`` will not be removed when purging tags, these tags are reserved by Amazon and may not be updated or deleted (https://github.com/ansible-collections/amazon.aws/issues/817)." msgstr "``aws:`` ã§å§‹ã¾ã‚‹ã‚¿ã‚°ã¯ã€ã‚¿ã‚°ã‚’パージã—ã¦ã‚‚削除ã•ã‚Œã¾ã›ã‚“。ã“れらã®ã‚¿ã‚°ã¯ Amazon ã«ã‚ˆã£ã¦äºˆç´„ã•ã‚Œã¦ãŠã‚Šã€æ›´æ–°ã¾ãŸã¯å‰Šé™¤ã§ãã¾ã›ã‚“ (https://github.com/ansible-collections/amazon.aws/issues/817)。" -#: ../../rst/porting_guides/porting_guide_7.rst:145 +#: ../../rst/porting_guides/porting_guide_7.rst:324 +msgid "amazon.aws collection - Support for ansible-core < 2.11 has been dropped (https://github.com/ansible-collections/amazon.aws/pull/1087)." +msgstr "amazon.aws コレクション - ansible-core < 2.11 ã®ã‚µãƒãƒ¼ãƒˆã¯çµ‚了ã—ã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/1087)." + +#: ../../rst/porting_guides/porting_guide_7.rst:325 +msgid "amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/934)." +msgstr "amazon.aws コレクション - amazon.aws コレクションã§ã¯ ``botocore<1.21.0`` ãŠã‚ˆã³ ``boto3<1.18.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® SDK を使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/934)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:326 msgid "amazon.aws collection - the ``profile`` parameter is now mutually exclusive with the ``aws_access_key``, ``aws_secret_key`` and ``security_token`` parameters (https://github.com/ansible-collections/amazon.aws/pull/834)." msgstr "amazon.aws コレクション - ``profile``パラメーターã¯ç¾åœ¨ã€``aws_access_key``ã€``aws_secret_key``ã€ãŠã‚ˆã³ ``security_token`` ã§ãƒ‘ラメーターã«ã‚ˆã‚Šç›¸äº’ã«æŽ’ä»–çš„ã§ã™ (https://github.com/ansible-collections/amazon.aws/pull/834)。" -#: ../../rst/porting_guides/porting_guide_7.rst:146 +#: ../../rst/porting_guides/porting_guide_7.rst:327 msgid "aws_az_info - the module alias ``aws_az_facts`` was deprecated in Ansible 2.9 and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/832)." msgstr "aws_az_info - モジュールã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``aws_az_facts`` 㯠Ansible 2.9 ã§éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾åœ¨ã¯å‰Šé™¤ã•ã‚Œã¦ã„ã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/832)。" -#: ../../rst/porting_guides/porting_guide_7.rst:147 +#: ../../rst/porting_guides/porting_guide_7.rst:328 msgid "aws_s3 - the default value for ``ensure overwrite`` has been changed to ``different`` instead of ``always`` so that the module is idempotent by default (https://github.com/ansible-collections/amazon.aws/issues/811)." msgstr "aws_s3 - モジュールãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¹ãç‰ã§ã‚るよã†ã«ã€``ensure overwrite`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ ``always`` ã®ä»£ã‚ã‚Šã« ``different`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/issues/811)。" -#: ../../rst/porting_guides/porting_guide_7.rst:148 +#: ../../rst/porting_guides/porting_guide_7.rst:329 msgid "aws_ssm - on_denied and on_missing now both default to error, for consistency with both aws_secret and the base Lookup class (https://github.com/ansible-collections/amazon.aws/issues/617)." msgstr "aws_ssm - aws_secret ã¨ãƒ™ãƒ¼ã‚¹ Lookup クラスã®ä¸¡æ–¹ã¨ã®ä¸€è²«æ€§ã‚’ä¿ã¤ãŸã‚ã«ã€on_denied ãŠã‚ˆã³ on_missing ã®ä¸¡æ–¹ãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã‚¨ãƒ©ãƒ¼ã¨ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/issues/617)。" -#: ../../rst/porting_guides/porting_guide_7.rst:149 +#: ../../rst/porting_guides/porting_guide_7.rst:330 +msgid "doc_fragments - remove minimum collection requirements from doc_fragments/aws.py and allow pulling those from doc_fragments/aws_boto3.py instead (https://github.com/ansible-collections/amazon.aws/pull/985)." +msgstr "doc_fragments - doc_fragments/aws.py ã‹ã‚‰æœ€å°é™ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³è¦ä»¶ã‚’削除ã—ã€ä»£ã‚ã‚Šã« doc_fragments/aws_boto3.py ã‹ã‚‰ãれらをプルã§ãるよã†ã«ã—ã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/985)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:331 msgid "ec2 - The ``ec2`` module has been removed in release 4.0.0 and replaced by the ``ec2_instance`` module (https://github.com/ansible-collections/amazon.aws/pull/630)." msgstr "ec2 - ``ec2`` モジュールã¯ãƒªãƒªãƒ¼ã‚¹ 4.0.0 ã§å‰Šé™¤ã•ã‚Œã€``ec2_instance`` モジュールã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/630)。" -#: ../../rst/porting_guides/porting_guide_7.rst:150 +#: ../../rst/porting_guides/porting_guide_7.rst:332 +msgid "ec2_ami - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_ami -``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:333 +msgid "ec2_ami - the parameter aliases ``DeviceName``, ``VirtualName`` and ``NoDevice`` were previously deprecated and have been removed, please use ``device_name``, ``virtual_name`` and ``no_device`` instead (https://github.com/ansible-collections/amazon.aws/pull/913)." +msgstr "ec2_ami - パラメーターã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``DeviceName``ã€``VirtualName``ã€ãŠã‚ˆã³ ``NoDevice`` ã¯ä»¥å‰éžæŽ¨å¥¨ã¨ãªã‚Šã€å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``device_name``ã€``virtual_name``ã€ãŠã‚ˆã³ ``no_device`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/913)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:334 +msgid "ec2_eni_info - the mutual exclusivity of the ``eni_id`` and ``filters`` parameters is now enforced, previously ``filters`` would be ignored if ``eni_id`` was set (https://github.com/ansible-collections/amazon.aws/pull/954)." +msgstr "ec2_eni_info - ``eni_id`` ã¨``filters`` パラメーターã®ç›¸äº’排他性ãŒå¼·åˆ¶ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã¯``eni_id`` ãŒè¨å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ ``filters`` ã¯ç„¡è¦–ã•ã‚Œã¦ã„ã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/954)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:335 +msgid "ec2_instance - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_instance - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:336 +msgid "ec2_key - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_key - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:337 +msgid "ec2_vol - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_vol - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:338 +msgid "ec2_vpc_dhcp_option_info - the parameter aliases ``DhcpOptionIds`` and ``DryRun`` were previously deprecated and have been removed, please use ``dhcp_options_ids`` and ``no_device`` instead (https://github.com/ansible-collections/amazon.aws/pull/913)." +msgstr "ec2_vpc_dhcp_option_info - パラメーターã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``DhcpOptionIds`` ãŠã‚ˆã³ ``DryRun`` ã¯ä»¥å‰éžæŽ¨å¥¨ã¨ãªã‚Šã€å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``dhcp_options_ids`` ãŠã‚ˆã³ ``no_device`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/913)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:339 +msgid "ec2_vpc_endpoint - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_vpc_endpoint - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:340 msgid "ec2_vpc_igw_info - The default value for ``convert_tags`` has been changed to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/835)." msgstr "ec2_vpc_igw_info - ``convert_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/835)。" -#: ../../rst/porting_guides/porting_guide_7.rst:151 +#: ../../rst/porting_guides/porting_guide_7.rst:341 +msgid "ec2_vpc_net - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_vpc_net - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:342 +msgid "ec2_vpc_route_table - the default value for ``purge_tags`` has been changed from ``False`` to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/916)." +msgstr "ec2_vpc_route_table - ``purge_tags`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒã€``False`` ã‹ã‚‰ ``True`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/916)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:343 msgid "elb_classic_lb - the ``ec2_elb`` fact has been removed (https://github.com/ansible-collections/amazon.aws/pull/827)." msgstr "elb_classic_lb - ``ec2_elb`` ファクトã¯å‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/827)。" -#: ../../rst/porting_guides/porting_guide_7.rst:152 +#: ../../rst/porting_guides/porting_guide_7.rst:344 msgid "module_utils - Support for the original AWS SDK aka ``boto`` has been removed, including all relevant helper functions. All modules should now use the ``boto3``/``botocore`` AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/630)" msgstr "module_utils - 関連ã™ã‚‹ã™ã¹ã¦ã®ãƒ˜ãƒ«ãƒ‘ー関数をå«ã‚€ã€å…ƒã® AWS SDK (別å ``boto``) ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ä»Šå¾Œã€``boto3``/``botocore`` AWS SDK を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/630)。" -#: ../../rst/porting_guides/porting_guide_7.rst:155 -#: ../../rst/porting_guides/porting_guide_7.rst:212 +#: ../../rst/porting_guides/porting_guide_7.rst:345 +msgid "s3_bucket - the previously deprecated alias ``S3_URL`` for the ``s3_url`` parameter has been removed. Playbooks shuold be updated to use ``s3_url`` (https://github.com/ansible-collections/amazon.aws/pull/908)." +msgstr "s3_bucket - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸ ``s3_url`` パラメーターã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``S3_URL`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Playbook 㯠``s3_url`` を使ã†ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/908)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:346 +msgid "s3_object - the previously deprecated alias ``S3_URL`` for the ``s3_url`` parameter has been removed. Playbooks should be updated to use ``s3_url`` (https://github.com/ansible-collections/amazon.aws/pull/908)." +msgstr "s3_object - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸ ``s3_url`` パラメーターã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``S3_URL`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Playbook 㯠``s3_url`` を使ã†ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/908)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:349 +#: ../../rst/porting_guides/porting_guide_7.rst:539 msgid "check_point.mgmt" msgstr "check_point.mgmt" -#: ../../rst/porting_guides/porting_guide_7.rst:157 +#: ../../rst/porting_guides/porting_guide_7.rst:351 msgid "cp_mgmt_access_role - the 'machines' parameter now accepts a single str and a new parameter 'machines_list' of type dict has been added. the 'users' parameter now accepts a single str and a new parameter 'users_list' of type dict has been added." msgstr "cp_mgmt_access_role - 'machines' パラメーターãŒå˜ä¸€ã® str ã‚’å—ã‘入れるよã†ã«ãªã‚Šã€ã‚¿ã‚¤ãƒ— dict ã®æ–°ã—ã„パラメーター 'machines_list' ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚'users' パラメーターã¯å˜ä¸€ã® str ã‚’å—ã‘入れるよã†ã«ãªã‚Šã€ã‚¿ã‚¤ãƒ— dict ã®æ–°ã—ã„パラメーター 'users_list' ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:158 +#: ../../rst/porting_guides/porting_guide_7.rst:352 msgid "cp_mgmt_access_rule - the 'vpn' parameter now accepts a single str and a new parameter 'vpn_list' of type dict has been added. the 'position_by_rule' parameter has been changed to 'relative_position' with support of positioning above/below a section (and not just a rule). the 'relative_position' parameter has also 'top' and 'bottom' suboptions which allows positioning a rule at the top and bottom of a section respectively. a new parameter 'search_entire_rulebase' has been added to allow the relative positioning to be unlimited (was previously limited to 50 rules)" msgstr "cp_mgmt_access_rule - 'vpn' パラメーターã¯å˜ä¸€ã® str ã‚’å—ã‘入れるよã†ã«ãªã‚Šã€ã‚¿ã‚¤ãƒ— dict ã®æ–°ã—ã„パラメーター 'vpn_list' ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚'position_by_rule' パラメーター㌠'relative_position' ã«å¤‰æ›´ã•ã‚Œã€ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸Š/下ã®é…ç½®ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã—㟠(ルールã ã‘ã§ã¯ã‚ã‚Šã¾ã›ã‚“)。'relative_position' パラメーターã«ã¯ 'top' ãŠã‚ˆã³ 'bottom' ã®ã‚µãƒ–オプションもã‚ã‚Šã€ãã‚Œãžã‚Œã‚»ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸Šéƒ¨ã¨ä¸‹éƒ¨ã«ãƒ«ãƒ¼ãƒ«ã‚’é…ç½®ã§ãã¾ã™ã€‚æ–°ã—ã„パラメーター 'search_entire_rulebase' ãŒè¿½åŠ ã•ã‚Œã€ç›¸å¯¾ä½ç½®ã‚’無制é™ã¨ã™ã‚‹ã“ã¨ãŒã§ãるよã†ã«ãªã‚Šã¾ã—㟠(以å‰ã¯ 50 ルールã«åˆ¶é™ã•ã‚Œã¦ã„ã¾ã—ãŸ)。" -#: ../../rst/porting_guides/porting_guide_7.rst:159 +#: ../../rst/porting_guides/porting_guide_7.rst:353 msgid "cp_mgmt_administrator - the 'permissions_profile' parameter now accepts a single str and a new parameter 'permissions_profile_list' of type dict has been added." msgstr "cp_mgmt_administrator - 'permissions_profile' パラメーターã¯å˜ä¸€ã® str ã‚’å—ã‘入れるよã†ã«ãªã‚Šã€ã‚¿ã‚¤ãƒ— dict ã®æ–°ã—ã„パラメーター 'permissions_profile_list' ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:160 +#: ../../rst/porting_guides/porting_guide_7.rst:354 msgid "cp_mgmt_publish - the 'uid' parameter has been removed." msgstr "cp_mgmt_publish - 'uid' パラメーターãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:166 +#: ../../rst/porting_guides/porting_guide_7.rst:360 +msgid "acm_certificate - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "acm_certificate - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ã¯ã€``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:361 +#: ../../rst/porting_guides/porting_guide_7.rst:485 +msgid "autoscaling_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_group``." +msgstr "autoscaling_group - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.autoscaling_group`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:362 +#: ../../rst/porting_guides/porting_guide_7.rst:486 +msgid "autoscaling_group_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_group_info``." +msgstr "autoscaling_group_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.autoscaling_group_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:363 msgid "aws_secret - tags are no longer removed when the ``tags`` parameter is not set. To remove all tags set ``tags={}`` (https://github.com/ansible-collections/community.aws/issues/1146)." msgstr "aws_secret - ``tags`` パラメーターãŒè¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã€ã‚¿ã‚°ãŒå‰Šé™¤ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚ã™ã¹ã¦ã®ã‚¿ã‚°ã‚’削除ã™ã‚‹ã«ã¯ ``tags={}`` ã‚’è¨å®šã—ã¾ã™ (https://github.com/ansible-collections/community.aws/issues/1146)。" -#: ../../rst/porting_guides/porting_guide_7.rst:167 +#: ../../rst/porting_guides/porting_guide_7.rst:364 +msgid "cloudfront_distribution - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "cloudfront_distribution - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ã¯ã€``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:365 +msgid "cloudtrail - The module has been migrated to the ``amazon.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudtrail``." +msgstr "cloudtrail - モジュール㯠``amazon.aws`` コレクションã«ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.cloudtrail`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:366 +#: ../../rst/porting_guides/porting_guide_7.rst:488 +msgid "cloudwatch_metric_alarm - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatch_metric_alarm``." +msgstr "cloudwatch_metric_alarm - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.cloudwatch_metric_alarm`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:367 +#: ../../rst/porting_guides/porting_guide_7.rst:489 +msgid "cloudwatchevent_rule - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatchevent_rule``." +msgstr "cloudwatchevent_rule - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.cloudwatchevent_rule`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:368 +#: ../../rst/porting_guides/porting_guide_7.rst:490 +msgid "cloudwatchlogs_log_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatchlogs_log_group``." +msgstr "cloudwatchlogs_log_group - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.cloudwatchlogs_log_group`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:369 +#: ../../rst/porting_guides/porting_guide_7.rst:491 +msgid "cloudwatchlogs_log_group_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatchlogs_log_group_info``." +msgstr "cloudwatchlogs_log_group_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.cloudwatchlogs_log_group_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:370 +#: ../../rst/porting_guides/porting_guide_7.rst:492 +msgid "cloudwatchlogs_log_group_metric_filter - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatchlogs_log_group_metric_filter``." +msgstr "cloudwatchlogs_log_group_metric_filter - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.cloudwatchlogs_log_group_metric_filter`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:371 +msgid "community.aws collection - Support for ansible-core < 2.11 has been dropped (https://github.com/ansible-collections/community.aws/pull/1541)." +msgstr "community.aws コレクション - ansible-core < 2.11 ã®ã‚µãƒãƒ¼ãƒˆã¯çµ‚了ã—ã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1541)." + +#: ../../rst/porting_guides/porting_guide_7.rst:372 msgid "community.aws collection - The ``community.aws`` collection has now dropped support for and any requirements upon the original ``boto`` AWS SDK, and now uses the ``boto3``/``botocore`` AWS SDK (https://github.com/ansible-collections/community.aws/pull/898)." msgstr "community.aws コレクション - ``community.aws`` コレクションã¯ç¾åœ¨ã€å…ƒã® ``boto`` AWS SDK ã¸ã®ã‚µãƒãƒ¼ãƒˆã¨è¦ä»¶ã‚’ã™ã¹ã¦å‰Šé™¤ã—ã€``boto3``/``botocore`` AWS SDK を使用ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/898)。" -#: ../../rst/porting_guides/porting_guide_7.rst:168 +#: ../../rst/porting_guides/porting_guide_7.rst:373 +msgid "community.aws collection - The community.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/1362)." +msgstr "community.aws コレクション - community.aws コレクションã§ã¯ ``botocore<1.21.0`` ãŠã‚ˆã³ ``boto3<1.18.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1362)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:374 msgid "community.aws collection - the ``profile`` parameter is now mutually exclusive with the ``aws_access_key``, ``aws_secret_key`` and ``security_token`` parameters (https://github.com/ansible-collections/amazon.aws/pull/834)." msgstr "community.aws コレクション - ``profile`` パラメーターã¯ç¾åœ¨ã€``aws_access_key``ã€``aws_secret_key``ã€ãŠã‚ˆã³ ``security_token`` パラメーターã¨ç›¸äº’ã«æŽ’ä»–çš„ã§ã™ (https://github.com/ansible-collections/amazon.aws/pull/834)。" -#: ../../rst/porting_guides/porting_guide_7.rst:171 +#: ../../rst/porting_guides/porting_guide_7.rst:375 +#: ../../rst/porting_guides/porting_guide_7.rst:493 +msgid "ec2_eip - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_eip``." +msgstr "ec2_eip - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_eip`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:376 +#: ../../rst/porting_guides/porting_guide_7.rst:494 +msgid "ec2_eip_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_eip_info``." +msgstr "ec2_eip_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.ec2_eip_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:379 +msgid "ec2_vpc_vpn - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "ec2_vpc_vpn - ã“ã‚Œã¾ã§éžæŽ¨å¥¨ã ã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤``purge_tags=False`` ã¯ã€``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:380 +#: ../../rst/porting_guides/porting_guide_7.rst:495 +msgid "elb_application_lb - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.elb_application_lb``." +msgstr "elb_application_lb - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.elb_application_lb`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:381 +#: ../../rst/porting_guides/porting_guide_7.rst:496 +msgid "elb_application_lb_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.elb_application_lb_info``." +msgstr "elb_application_lb_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.elb_application_lb_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:382 msgid "elb_instance - the ``ec2_elbs`` fact has been removed, ``updated_elbs`` has been added the return values and includes the same information (https://github.com/ansible-collections/community.aws/pull/1173)." msgstr "elb_instance - ``ec2_elbs`` ファクトãŒå‰Šé™¤ã•ã‚Œã€``updated_elbs`` ã«ã¯æˆ»ã‚Šå€¤ãŒè¿½åŠ ã•ã‚Œã€åŒã˜æƒ…å ±ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1173)。" -#: ../../rst/porting_guides/porting_guide_7.rst:172 +#: ../../rst/porting_guides/porting_guide_7.rst:383 msgid "elb_network_lb - the default value of ``state`` has changed from ``absent`` to ``present`` (https://github.com/ansible-collections/community.aws/pull/1167)." msgstr "elb_network_lb - ``state`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ãŒ``absent`` ã‹ã‚‰ ``present`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1167)。" -#: ../../rst/porting_guides/porting_guide_7.rst:173 +#: ../../rst/porting_guides/porting_guide_7.rst:384 +#: ../../rst/porting_guides/porting_guide_7.rst:497 +msgid "execute_lambda - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.execute_lambda``." +msgstr "execute_lambda - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.execute_lambda`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:385 +#: ../../rst/porting_guides/porting_guide_7.rst:498 +msgid "iam_policy - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.iam_policy``." +msgstr "iam_policy - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.iam_policy`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:386 +#: ../../rst/porting_guides/porting_guide_7.rst:499 +msgid "iam_policy_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.iam_policy_info``." +msgstr "iam_policy_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.iam_policy_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:387 +msgid "iam_server_certificate - Passing file names to the ``cert``, ``chain_cert`` and ``key`` parameters has been removed. We recommend using a lookup plugin to read the files instead, see the documentation for an example (https://github.com/ansible-collections/community.aws/pull/1265)." +msgstr "iam_server_certificate - ファイルåã‚’ ``cert``ã€``chain_cert``ã€ãŠã‚ˆã³ ``key`` パラメーターã«æ¸¡ã™ã“ã¨ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã«lookup プラグインを使用ã—ã¦ãƒ•ã‚¡ã‚¤ãƒ«ã‚’èªã¿å–ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚例ã«ã¤ã„ã¦ã¯ã€ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.aws/pull/1265)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:388 +msgid "iam_server_certificate - the default value for the ``dup_ok`` parameter has been changed to ``true``. To preserve the original behaviour explicitly set the ``dup_ok`` parameter to ``false`` (https://github.com/ansible-collections/community.aws/pull/1265)." +msgstr "iam_server_certificate - ``dup_ok`` パラメーターã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚å…ƒã®å‹•ä½œã‚’ä¿æŒã™ã‚‹ã«ã¯ã€æ˜Žç¤ºçš„ã« ``dup_ok`` パラメーターを ``false`` ã«è¨å®šã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.aws/pull/1265)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:389 +#: ../../rst/porting_guides/porting_guide_7.rst:500 +msgid "iam_user - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.iam_user``." +msgstr "iam_user - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.iam_user`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:390 +#: ../../rst/porting_guides/porting_guide_7.rst:501 +msgid "iam_user_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.iam_user_info``." +msgstr "iam_user_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.iam_user_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:391 +#: ../../rst/porting_guides/porting_guide_7.rst:502 +msgid "kms_key - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.kms_key``." +msgstr "kms_key - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.kms_key`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:392 +msgid "kms_key - managing the KMS IAM Policy via ``policy_mode`` and ``policy_grant_types`` was previously deprecated and has been removed in favor of the ``policy`` option (https://github.com/ansible-collections/community.aws/pull/1344)." +msgstr "kms_key - KMS IAM Policy ã‚’``policy_mode`` ã¨``policy_grant_types`` ã§ç®¡ç†ã—ã¦ã„ã¾ã—ãŸãŒã€``policy`` ã®ã‚ªãƒ—ションを優先ã—ã¦ã€éžæŽ¨å¥¨ã¨ãªã‚Šã€å‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1344)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:393 +msgid "kms_key - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "kms_key - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ㌠``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:394 +#: ../../rst/porting_guides/porting_guide_7.rst:503 +msgid "kms_key_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.kms_key_info``." +msgstr "kms_key_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.kms_key_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:395 +#: ../../rst/porting_guides/porting_guide_7.rst:504 +msgid "lambda - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda``." +msgstr "lambda - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.lambda`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:396 +#: ../../rst/porting_guides/porting_guide_7.rst:505 +msgid "lambda_alias - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda_alias``." +msgstr "lambda_alias - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.lambda_alias`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:397 +#: ../../rst/porting_guides/porting_guide_7.rst:506 +msgid "lambda_event - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda_event``." +msgstr "lambda_event - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.lambda_event`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:398 +#: ../../rst/porting_guides/porting_guide_7.rst:507 +msgid "lambda_execute - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda_execute``." +msgstr "lambda_execute - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.lambda_execute`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:399 +#: ../../rst/porting_guides/porting_guide_7.rst:508 +msgid "lambda_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda_info``." +msgstr "lambda_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.lambda_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:400 +#: ../../rst/porting_guides/porting_guide_7.rst:509 +msgid "lambda_policy - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.lambda_policy``." +msgstr "lambda_policy - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.lambda_policy`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:401 +#: ../../rst/porting_guides/porting_guide_7.rst:510 +msgid "rds_cluster - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_cluster``." +msgstr "rds_cluster - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.rds_cluster`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:402 +#: ../../rst/porting_guides/porting_guide_7.rst:511 +msgid "rds_cluster_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_cluster_info``." +msgstr "rds_cluster_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.rds_cluster_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:403 +#: ../../rst/porting_guides/porting_guide_7.rst:512 +msgid "rds_cluster_snapshot - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_cluster_snapshot``." +msgstr "rds_cluster_snapshot - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.rds_cluster_snapshot`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:404 +#: ../../rst/porting_guides/porting_guide_7.rst:513 +msgid "rds_instance - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_instance``." +msgstr "rds_instance - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_instance`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:405 +#: ../../rst/porting_guides/porting_guide_7.rst:514 +msgid "rds_instance_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_instance_info``." +msgstr "rds_instance_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_instance_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:406 +#: ../../rst/porting_guides/porting_guide_7.rst:515 +msgid "rds_instance_snapshot - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_instance_snapshot``." +msgstr "rds_instance_snapshot - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.rds_instance_snapshot`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:407 +#: ../../rst/porting_guides/porting_guide_7.rst:516 +msgid "rds_option_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_option_group``." +msgstr "rds_option_group - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_option_group`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:408 +#: ../../rst/porting_guides/porting_guide_7.rst:517 +msgid "rds_option_group_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_option_group_info``." +msgstr "rds_option_group_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_option_group_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:409 +#: ../../rst/porting_guides/porting_guide_7.rst:518 +msgid "rds_param_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_param_group``." +msgstr "rds_param_group - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_param_group`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:410 +msgid "rds_param_group - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "rds_param_group - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ㌠``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:411 +#: ../../rst/porting_guides/porting_guide_7.rst:519 +msgid "rds_snapshot_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_snapshot_info``." +msgstr "rds_snapshot_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_snapshot_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:412 +#: ../../rst/porting_guides/porting_guide_7.rst:520 +msgid "rds_subnet_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.rds_subnet_group``." +msgstr "rds_subnet_group - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã•ã‚Œã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã¯ã€``amazon.aws.rds_subnet_group`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:413 +#: ../../rst/porting_guides/porting_guide_7.rst:521 +msgid "route53 - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.route53``." +msgstr "route53 - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.route53`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:414 +#: ../../rst/porting_guides/porting_guide_7.rst:522 +msgid "route53_health_check - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.route53_health_check``." +msgstr "route53_health_check - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.route53_health_check`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:415 +msgid "route53_health_check - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "route53_health_check - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ㌠``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:416 +#: ../../rst/porting_guides/porting_guide_7.rst:523 +msgid "route53_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.route53_info``." +msgstr "route53_info - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.route53_info`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:417 +#: ../../rst/porting_guides/porting_guide_7.rst:524 +msgid "route53_zone - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.route53_zone``." +msgstr "route53_zone - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.route53_zone`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:418 +msgid "route53_zone - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "route53_zone - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ㌠``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:419 msgid "script_inventory_ec2 - The ec2.py inventory script has been moved to a new repository. The script can now be downloaded from https://github.com/ansible-community/contrib-scripts/blob/main/inventory/ec2.py and has been removed from this collection. We recommend migrating from the script to the amazon.aws.ec2 inventory plugin. (https://github.com/ansible-collections/community.aws/pull/898)" msgstr "script_inventory_ec2 - ec2.py インベントリースクリプトãŒæ–°ã—ã„リãƒã‚¸ãƒˆãƒªãƒ¼ã«ç§»å‹•ã•ã‚Œã¾ã—ãŸã€‚スクリプトã¯https://github.com/ansible-community/contrib-scripts/blob/main/inventory/ec2.py ã‹ã‚‰ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰ã§ãã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‹ã‚‰å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚スクリプトã‹ã‚‰ amazon.aws.ec2 インベントリープラグインã«ç§»è¡Œã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚(https://github.com/ansible-collections/community.aws/pull/898)" -#: ../../rst/porting_guides/porting_guide_7.rst:178 +#: ../../rst/porting_guides/porting_guide_7.rst:420 +msgid "sqs_queue - the previously deprecated default value of ``purge_tags=False`` has been updated to ``purge_tags=True`` (https://github.com/ansible-collections/community.aws/pull/1343)." +msgstr "sqs_queue - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``purge_tags=False`` ㌠``purge_tags=True`` ã«æ›´æ–°ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1343)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:425 msgid "This collection does not work with ansible-core 2.11 on Python 3.12+. Please either upgrade to ansible-core 2.12+, or use Python 3.11 or earlier (https://github.com/ansible-collections/community.docker/pull/271)." msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¯ã€Python 3.12 以é™ã® ansible-core 2.11 ã§ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。ansible-core 2.12+ ã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã‹ã€Python 3.11 以å‰ã‚’使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/271)。" -#: ../../rst/porting_guides/porting_guide_7.rst:179 +#: ../../rst/porting_guides/porting_guide_7.rst:426 msgid "docker_container - ``exposed_ports`` is no longer ignored in ``comparisons``. Before, its value was assumed to be identical with the value of ``published_ports`` (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - ``exposed_ports`` ã¯ã€``comparisons`` ã§ç„¡è¦–ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚以å‰ã¯ã€ãã®å€¤ã¯ ``published_ports`` ã®å€¤ã¨åŒã˜ã§ã‚ã‚‹ã¨æƒ³å®šã•ã‚Œã¦ã„ã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:180 +#: ../../rst/porting_guides/porting_guide_7.rst:427 msgid "docker_container - ``log_options`` can no longer be specified when ``log_driver`` is not specified (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - ``log_driver`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ãªã„å ´åˆã€``log_options`` ã¯æŒ‡å®šã§ããªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:181 +#: ../../rst/porting_guides/porting_guide_7.rst:428 msgid "docker_container - ``publish_all_ports`` is no longer ignored in ``comparisons`` (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container -``publish_all_ports`` 㯠``comparisons`` ã§ç„¡è¦–ã•ã‚Œãªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:182 +#: ../../rst/porting_guides/porting_guide_7.rst:429 msgid "docker_container - ``restart_retries`` can no longer be specified when ``restart_policy`` is not specified (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - ``restart_policy`` ãŒæŒ‡å®šã•ã‚Œã¦ã„ãªã„å ´åˆã€``restart_retries`` を指定ã§ããªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:183 +#: ../../rst/porting_guides/porting_guide_7.rst:430 msgid "docker_container - ``stop_timeout`` is no longer ignored for idempotency if told to be not ignored in ``comparisons``. So far it defaulted to ``ignore`` there, and setting it to ``strict`` had no effect (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - ``comparisons`` ã§ç„¡è¦–ã—ãªã„よã†ã«æŒ‡ç¤ºã•ã‚ŒãŸå ´åˆã€``stop_timeout`` ã¯ã¹ãç‰æ€§ã®ãŸã‚ã«ç„¡è¦–ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¾ã§ã®ã¨ã“ã‚ã€ãã“ã§ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``ignore`` ã¨ãªã‚Šã€ãれを ``strict`` ã«è¨å®šã—ã¦ã‚‚効果ã¯ã‚ã‚Šã¾ã›ã‚“ã§ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:184 +#: ../../rst/porting_guides/porting_guide_7.rst:431 msgid "modules and plugins communicating directly with the Docker daemon - when connecting by SSH and not using ``use_ssh_client=true``, reject unknown host keys instead of accepting them. This is only a breaking change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python < 6.0.0. Docker SDK for Python 6.0.0 will also include this change (https://github.com/ansible-collections/community.docker/pull/434)." msgstr "Docker デーモンã¨ç›´æŽ¥é€šä¿¡ã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ãƒ—ラグイン - SSH ã§æŽ¥ç¶šã—ã€``use_ssh_client=true`` を使用ã—ãªã„å ´åˆã€ä¸æ˜Žãªãƒ›ã‚¹ãƒˆã‚ーをå—ã‘入れる代ã‚ã‚Šã«æ‹’å¦ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€å¤ã„ community.docker 3.0.0 プレリリースã€ã¾ãŸã¯ Docker SDK for Python < 6.0.0 ã«é–¢é€£ã™ã‚‹äº’æ›æ€§ã‚’失ã‚ã›ã‚‹å¤‰æ›´ã«ã™ãŽã¾ã›ã‚“。Docker SDK for Python 6.0.0 ã«ã‚‚ã“ã®å¤‰æ›´ãŒå«ã¾ã‚Œã¾ã™ (https://github.com/ansible-collections/community.docker/pull/434)。" -#: ../../rst/porting_guides/porting_guide_7.rst:187 -#: ../../rst/porting_guides/porting_guide_7.rst:260 +#: ../../rst/porting_guides/porting_guide_7.rst:437 +msgid "scaleway_container_registry_info - no longer replace ``secret_environment_variables`` in the output by ``SENSITIVE_VALUE`` (https://github.com/ansible-collections/community.general/pull/5497)." +msgstr "scaleway_container_registry_info - ``SENSITIVE_VALUE`` ã«ã‚ˆã‚‹å‡ºåŠ›ã§ã€``secret_environment_variables`` ã«ç½®ãæ›ã‚ã‚‹ã“ã¨ã¯ãªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5497)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:442 +msgid "auth - the default value for ``token_validate`` has changed from ``true`` to ``false``, as previously announced (https://github.com/ansible-collections/community.hashi_vault/issues/248)." +msgstr "auth - 以å‰ç™ºè¡¨ã—ãŸã‚ˆã†ã«ã€``token_validate`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€``true`` ã‹ã‚‰ ``false`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.hashi_vault/issues/248)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:443 +msgid "vault_kv2_get lookup - as previously announced, the default value for ``engine_mount_point`` in the ``vault_kv2_get`` lookup has changed from ``kv`` to ``secret`` (https://github.com/ansible-collections/community.hashi_vault/issues/279)." +msgstr "vault_kv2_get lookup - 以å‰ç™ºè¡¨ã—ãŸã‚ˆã†ã«ã€``vault_kv2_get`` lookup ã® ``engine_mount_point`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯ã€``kv`` ã‹ã‚‰ ``secret`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.hashi_vault/issues/279)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:448 +msgid "Removed support for ansible-core version < 2.13.0." +msgstr "ansible-core ãƒãƒ¼ã‚¸ãƒ§ãƒ³ < 2.13.0 ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:449 +msgid "vmware_dvs_portgroup - Add a new sub-option `inherited` to the `in_traffic_shaping` parameter. This means you can keep the setting as-is by not defining the parameter, but also that you have to define the setting as not `inherited` if you want to override it at the PG level (https://github.com/ansible-collections/community.vmware/pull/1483)." +msgstr "vmware_dvs_portgroup - `in_traffic_shaping` パラメーターã«æ–°ã—ã„サブオプション `inherited` ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ラメーターを定義ã—ãªã„ã“ã¨ã§è¨å®šã‚’ãã®ã¾ã¾ç¶æŒã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ãŒã€PG レベルã§è¨å®šã‚’上書ãã™ã‚‹å ´åˆã¯ã€è¨å®šã‚’ `inherited` ã§ãªã„ã‚‚ã®ã¨ã—ã¦å®šç¾©ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚‚æ„味ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1483)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:450 +msgid "vmware_dvs_portgroup - Add a new sub-option `inherited` to the `out_traffic_shaping` parameter. This means you can keep the setting as-is by not defining the parameter, but also that you have to define the setting as not `inherited` if you want to override it at the PG level (https://github.com/ansible-collections/community.vmware/pull/1483)." +msgstr "vmware_dvs_portgroup - `out_traffic_shaping` パラメーターã«æ–°ã—ã„サブオプション `inherited` ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ラメーターを定義ã—ãªã„ã“ã¨ã§è¨å®šã‚’ãã®ã¾ã¾ç¶æŒã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ãŒã€PG レベルã§è¨å®šã‚’上書ãã™ã‚‹å ´åˆã¯ã€è¨å®šã‚’ `inherited` ã§ãªã„ã‚‚ã®ã¨ã—ã¦å®šç¾©ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚‚æ„味ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1483)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:451 +msgid "vmware_dvs_portgroup - Change the type of `net_flow` to string to allow setting it implicitly to inherited or to keep the value as-is. This means you can keep the setting as-is by not defining the parameter, but also that while `true` or `no` still work, `True` or `Off` (uppercase) won't (https://github.com/ansible-collections/community.vmware/pull/1483)." +msgstr "vmware_dvs_portgroup - `net_flow` ã®ã‚¿ã‚¤ãƒ—ã‚’æ–‡å—列ã«å¤‰æ›´ã—ã€ç¶™æ‰¿æ¸ˆã¿ã¨æš—黙的ã«è¨å®šã™ã‚‹ã‹ã€ã¾ãŸã¯å€¤ã‚’ãã®ã¾ã¾ç¶æŒã™ã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ラメーターを定義ã—ãªã„ã“ã¨ã§è¨å®šã‚’ãã®ã¾ã¾ç¶æŒã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ãŒã€`true` ã‚„ `no` ã¯ã¾ã 機能ã—ã¾ã™ãŒã€`True` ã‚„ `Off` (大文å—) ã¯æ©Ÿèƒ½ã—ãªã„ã“ã¨ã‚’æ„味ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1483)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:452 +msgid "vmware_dvs_portgroup - Remove support for vSphere API less than 6.7." +msgstr "vmware_dvs_portgroup - 6.7 未満㮠vSphere API ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:453 +msgid "vmware_dvs_portgroup - Remove the default for `network_policy` and add a new sub-option `inherited`. This means you can keep the setting as-is by not defining the parameter, but also that you have to define the setting as not `inherited` if you want to override it at the PG level (https://github.com/ansible-collections/community.vmware/pull/1483)." +msgstr "vmware_dvs_portgroup - `network_policy` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’削除ã—ã€æ–°ã—ã„サブオプション `inherited` ã‚’è¿½åŠ ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ラメーターを定義ã—ãªã„ã“ã¨ã§è¨å®šã‚’ãã®ã¾ã¾ç¶æŒã§ãã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ãŒã€PG レベルã§è¨å®šã‚’上書ãã™ã‚‹å ´åˆã¯ã€è¨å®šã‚’ `inherited` ã§ãªã„ã‚‚ã®ã¨ã—ã¦å®šç¾©ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã‚‚æ„味ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1483)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:454 +msgid "vmware_dvs_portgroup_info - Remove support for vSphere API less than 6.7." +msgstr "vmware_dvs_portgroup_info - 6.7 未満㮠vSphere API ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:455 +msgid "vmware_dvswitch - Remove support for vSphere API less than 6.7." +msgstr "vmware_dvswitch - 6.7 未満㮠vSphere API ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:456 +msgid "vmware_dvswitch_uplink_pg - Remove support for vSphere API less than 6.7." +msgstr "vmware_dvswitch_uplink_pg - 6.7 未満㮠vSphere API ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:457 +msgid "vmware_guest_boot_manager - Remove default for ``secure_boot_enabled`` parameter (https://github.com/ansible-collections/community.vmware/issues/1461)." +msgstr "vmware_guest_boot_manager - ``secure_boot_enabled`` パラメーターã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã‚’削除ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/issues/1461)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:458 +msgid "vmware_vm_config_option - Dict item names in result are changed from strings joined with spaces to strings joined with underlines, e.g. `Guest fullname` is changed to `guest_fullname` (https://github.com/ansible-collections/community.vmware/issues/1268)." +msgstr "vmware_vm_config_option - çµæžœã® Dict アイテムåã¯ã€ã‚¹ãƒšãƒ¼ã‚¹ã§çµåˆã•ã‚ŒãŸæ–‡å—列ã‹ã‚‰ã‚¢ãƒ³ãƒ€ãƒ¼ãƒ©ã‚¤ãƒ³ã§çµåˆã•ã‚ŒãŸæ–‡å—列ã«å¤‰æ›´ã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€`Guest fullname` 㯠`guest_fullname` ã«å¤‰æ›´ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.vmware/issues/1268)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:459 +msgid "vmware_vspan_session - Remove support for vSphere API less than 6.7." +msgstr "vmware_vspan_session - 6.7 未満㮠vSphere API ã®ã‚µãƒãƒ¼ãƒˆã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:462 +#: ../../rst/porting_guides/porting_guide_7.rst:628 msgid "dellemc.enterprise_sonic" msgstr "dellemc.enterprise_sonic" -#: ../../rst/porting_guides/porting_guide_7.rst:189 +#: ../../rst/porting_guides/porting_guide_7.rst:464 msgid "bgp_af - Add the route_advertise_list dictionary to the argspec to replace the deleted, obsolete advertise_prefix attribute used for SONiC 3.x images on the 1.x branch of this collection. This change corresponds to a SONiC 4.0 OC YANG REST compliance change for the BGP AF REST API. It enables specification of a route map in conjunction with each route advertisement prefix (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/63)." msgstr "bgp_af - route_advertise_list ディクショナリーを argspec ã«è¿½åŠ ã—ã¦ã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã® 1.x ブランãƒã® SONiC 3.x イメージã«ä½¿ç”¨ã•ã‚Œã‚‹ã€å‰Šé™¤ã•ã‚Œã€å»ƒæ¢ã•ã‚ŒãŸ advertise_prefix 属性を置ãæ›ãˆã¾ã™ã€‚ã“ã®å¤‰æ›´ã¯ã€BGP AF REST API ã® SONiC 4.0 OC YANG REST コンプライアンスã®å¤‰æ›´ã«å¯¾å¿œã—ã¦ã„ã¾ã™ã€‚ å„ルートアドãƒã‚¿ã‚¤ã‚ºãƒ¡ãƒ³ãƒˆã®ãƒ—レフィックスã¨é€£å‹•ã—ãŸãƒ«ãƒ¼ãƒˆãƒžãƒƒãƒ—ã®æŒ‡å®šãŒå¯èƒ½ã«ãªã‚Šã¾ã™ (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/63)。" -#: ../../rst/porting_guides/porting_guide_7.rst:190 +#: ../../rst/porting_guides/porting_guide_7.rst:465 msgid "bgp_af - remove the obsolete 'advertise_prefix' attribute from argspec and config code. This and subsequent co-req replacement with the new route advertise list argument structure require corresponding changes in playbooks previoulsly used for configuring route advertise prefixes for SONiC 3.x images. (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/60)" msgstr "bgp_af - å¤ã„ 'advertise_prefix' 属性を argspec ã¨è¨å®šã‚³ãƒ¼ãƒ‰ã‹ã‚‰å‰Šé™¤ã—ã¾ã™ã€‚ã“ã®æ–°ã—ã„ルートアドãƒã‚¿ã‚¤ã‚ºãƒªã‚¹ãƒˆå¼•æ•°æ§‹é€ ã«ã‚ˆã‚‹ã“ã‚Œã¨å¾Œç¶šã® co-req ç½®æ›ã«ã¯ã€SONiC 3.x イメージã®ãƒ«ãƒ¼ãƒˆã‚¢ãƒ‰ãƒã‚¿ã‚¤ã‚ºã®ãƒ—レフィックスをè¨å®šã™ã‚‹ãŸã‚ã«ä»¥å‰ã«ä½¿ç”¨ã•ã‚ŒãŸ Playbook ã§ã‚‚対応ã™ã‚‹å¤‰æ›´ãŒå¿…è¦ã§ã™ (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/60)。" -#: ../../rst/porting_guides/porting_guide_7.rst:191 +#: ../../rst/porting_guides/porting_guide_7.rst:466 msgid "bgp_neighbors - Replace the previously defined standalone \"bfd\" attribute with a bfd dictionary containing multiple attributes. This change corresponds to the revised SONiC 4.x implementation of OC YANG compatible REST APIs. Playbooks previously using the bfd attributes for SONiC 3.x images must be modified for useon SONiC 4.0 images to use the new definition for the bfd attribute argspec structure (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/72)." msgstr "bgp_neighbors - 以å‰ã«å®šç¾©ã•ã‚ŒãŸã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã® \"bfd\" 属性をã€è¤‡æ•°ã®å±žæ€§ã‚’å«ã‚€ bfd ディクショナリーã«ç½®ãæ›ãˆã¾ã™ã€‚ã“ã®å¤‰æ›´ã¯ã€OC YANG äº’æ› REST API ã®æ”¹è¨‚ã•ã‚ŒãŸ SONiC 4.x 実装ã«å¯¾å¿œã—ã¦ã„ã¾ã™ã€‚以å‰ã« SONiC 3.x イメージ㮠bfd 属性を使用ã—ã¦ã„㟠Playbook ã¯ã€SONiC 4.0 イメージã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«å¤‰æ›´ã—ã¦ã€bfd 属性 argspec æ§‹é€ ã®æ–°ã—ã„定義を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/72)。" -#: ../../rst/porting_guides/porting_guide_7.rst:192 +#: ../../rst/porting_guides/porting_guide_7.rst:467 msgid "bgp_neighbors - Replace, for BGP peer groups, the previously defined standalone \"bfd\" attribute with a bfd dictionary containing multiple attributes. This change corresponds to the revised SONiC 4.x implementation of OC YANG compatible REST APIs. Playbooks previously using the bfd attributes for SONiC 3.x images must be modified for useon SONiC 4.0 images to use the new definition for the bfd attribute argspec structure (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/81)." msgstr "bgp_neighbors - BGP ピアグループã®å ´åˆã€ä»¥å‰ã«å®šç¾©ã•ã‚ŒãŸã‚¹ã‚¿ãƒ³ãƒ‰ã‚¢ãƒãƒ³ã® \"bfd\" 属性をã€è¤‡æ•°ã®å±žæ€§ã‚’å«ã‚€ bfd ディクショナリーã«ç½®ãæ›ãˆã¾ã™ã€‚ã“ã®å¤‰æ›´ã¯ã€OC YANG äº’æ› REST API ã®æ”¹è¨‚ã•ã‚ŒãŸ SONiC 4.x 実装ã«å¯¾å¿œã—ã¦ã„ã¾ã™ã€‚以å‰ã« SONiC 3.x イメージ㮠bfd 属性を使用ã—ã¦ã„㟠Playbook ã¯ã€SONiC 4.0 イメージã§ä½¿ç”¨ã™ã‚‹ãŸã‚ã«å¤‰æ›´ã—ã¦ã€bfd 属性 argspec æ§‹é€ ã®æ–°ã—ã„定義を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/81)。" -#: ../../rst/porting_guides/porting_guide_7.rst:200 +#: ../../rst/porting_guides/porting_guide_7.rst:475 msgid "Move handler processing into new ``PlayIterator`` phase to use the configured strategy (https://github.com/ansible/ansible/issues/65067)" msgstr "ãƒãƒ³ãƒ‰ãƒ©ãƒ¼å‡¦ç†ã‚’æ–°ã—ã„ ``PlayIterator`` フェーズã«ç§»å‹•ã—ã€è¨å®šã•ã‚ŒãŸã‚¹ãƒˆãƒ©ãƒ†ã‚¸ãƒ¼ã‚’使用ã—ã¾ã™ (https://github.com/ansible/ansible/issues/65067)" -#: ../../rst/porting_guides/porting_guide_7.rst:209 +#: ../../rst/porting_guides/porting_guide_7.rst:484 msgid "amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574)." msgstr "amazon.aws コレクション - amazon.aws コレクションã§ã¯ ``botocore<1.20.0`` ãŠã‚ˆã³ ``boto3<1.17.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® SDK を使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/574)。" -#: ../../rst/porting_guides/porting_guide_7.rst:214 +#: ../../rst/porting_guides/porting_guide_7.rst:487 +msgid "cloudtrail - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudtrail``." +msgstr "cloudtrail - モジュール㯠``community.aws`` コレクションã‹ã‚‰ç§»è¡Œã—ã¾ã—ãŸã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å®Œå…¨ä¿®é£¾ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³åを使用ã™ã‚‹ Playbook ã‚’ ``amazon.aws.cloudtrail`` を使用ã™ã‚‹ã‚ˆã†ã«æ›´æ–°ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:529 +msgid "Remove following EOS dprecated modules" +msgstr "以下㮠EOS ã®éžæŽ¨å¥¨ã¨ãªã£ãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:530 +#: ../../rst/porting_guides/porting_guide_7.rst:556 +#: ../../rst/porting_guides/porting_guide_7.rst:673 +#: ../../rst/porting_guides/porting_guide_7.rst:678 +msgid "Use of connection: local and the provider option are no longer valid on any modules in this collection." +msgstr "connection: local 㨠provider オプションã®ä½¿ç”¨ã¯ã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³å†…ã®ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã‚‚有効ã§ã¯ãªããªã‚Šã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:531 +msgid "eos_interface" +msgstr "eos_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:532 +msgid "eos_l2_interface" +msgstr "eos_l2_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:533 +msgid "eos_l3_interface" +msgstr "eos_l3_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:534 +msgid "eos_linkagg" +msgstr "eos_linkagg" + +#: ../../rst/porting_guides/porting_guide_7.rst:535 +msgid "eos_static_route" +msgstr "eos_static_route" + +#: ../../rst/porting_guides/porting_guide_7.rst:536 +msgid "eos_vlan" +msgstr "eos_vlan" + +#: ../../rst/porting_guides/porting_guide_7.rst:541 msgid "plugins/httpapi/checkpoint - Support for Smart-1 Cloud with new variable 'ansible_cloud_mgmt_id'" msgstr "plugins/httpapi/checkpoint - æ–°ã—ã„変数 'ansible_cloud_mgmt_id' ã«ã‚ˆã‚‹ Smart-1 Cloud ã®ã‚µãƒãƒ¼ãƒˆ" -#: ../../rst/porting_guides/porting_guide_7.rst:225 +#: ../../rst/porting_guides/porting_guide_7.rst:552 +#: ../../rst/porting_guides/porting_guide_7.rst:575 +msgid "Please use either of the following connection types - network_cli, httpapi or netconf." +msgstr "接続形態ã¯ã€network_cliã€httpapiã€netconf ã®ã„ãšã‚Œã‹ã‚’ã”利用ãã ã•ã„。" + +#: ../../rst/porting_guides/porting_guide_7.rst:553 +msgid "This includes the following modules:" +msgstr "ã“ã‚Œã«ã¯ä»¥ä¸‹ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå«ã¾ã‚Œã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:554 +#: ../../rst/porting_guides/porting_guide_7.rst:564 +#: ../../rst/porting_guides/porting_guide_7.rst:570 +#: ../../rst/porting_guides/porting_guide_7.rst:576 +msgid "This release drops support for `connection: local` and provider dictionary." +msgstr "ã“ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€`connection: local` ã¨ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ã‚µãƒãƒ¼ãƒˆã‚’åœæ¢ã—ã¦ã„ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:555 +msgid "This release removes all deprecated plugins that have reached their end-of-life." +msgstr "ã“ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€æœ‰åŠ¹æœŸé™ã®åˆ‡ã‚ŒãŸã™ã¹ã¦ã®éžæŽ¨å¥¨ãƒ—ラグインを削除ã—ã¦ã„ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:557 +msgid "asa_acl" +msgstr "asa_acl" + +#: ../../rst/porting_guides/porting_guide_7.rst:558 +msgid "asa_og" +msgstr "asa_og" + +#: ../../rst/porting_guides/porting_guide_7.rst:563 +msgid "Only valid connection types for this collection is network_cli." +msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§æœ‰åŠ¹ãªæŽ¥ç¶šã‚¿ã‚¤ãƒ—㯠network_cli ã®ã¿ã§ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:569 +msgid "Only valid connection types for this collection are network_cli and netconf." +msgstr "ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§æœ‰åŠ¹ãªæŽ¥ç¶šã‚¿ã‚¤ãƒ—ã¯ã€network_cli 㨠netconf ã®ã¿ã§ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:581 msgid "community.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/956)." msgstr "community.aws コレクション - amazon.aws コレクションã§ã¯ ``botocore<1.20.0`` ãŠã‚ˆã³ ``boto3<1.17.0`` ã®ã‚µãƒãƒ¼ãƒˆã‚’廃æ¢ã—ã¾ã—ãŸã€‚ã»ã¨ã‚“ã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AWS SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å¼•ã続ã機能ã—ã¾ã™ãŒã€SDK ã®å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¨ã®äº’æ›æ€§ã¯ä¿è¨¼ã•ã‚Œãšã€ãƒ†ã‚¹ãƒˆã•ã‚Œã¾ã›ã‚“。å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® SDK を使用ã™ã‚‹å ´åˆã¯ã€Ansible ã«ã‚ˆã£ã¦è¦å‘ŠãŒå‡ºåŠ›ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/956)。" -#: ../../rst/porting_guides/porting_guide_7.rst:230 +#: ../../rst/porting_guides/porting_guide_7.rst:586 msgid "The collection now contains vendored code from the Docker SDK for Python to talk to the Docker daemon. Modules and plugins using this code no longer need the Docker SDK for Python installed on the machine the module or plugin is running on (https://github.com/ansible-collections/community.docker/pull/398)." msgstr "コレクションã«ã¯ã€Docker デーモンã¨é€šä¿¡ã™ã‚‹ãŸã‚ã® Docker SDK for Python ã‹ã‚‰ã®ãƒ™ãƒ³ãƒ€ãƒ¼ã‚³ãƒ¼ãƒ‰ãŒå«ã¾ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®ã‚³ãƒ¼ãƒ‰ã‚’使用ã™ã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¨ãƒ—ラグインã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¾ãŸã¯ãƒ—ラグインãŒå®Ÿè¡Œã•ã‚Œã¦ã„るマシン㫠Docker SDK for Python をインストールã™ã‚‹å¿…è¦ãŒãªããªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/398)。" -#: ../../rst/porting_guides/porting_guide_7.rst:231 +#: ../../rst/porting_guides/porting_guide_7.rst:587 msgid "docker_api connection plugin - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/414)." msgstr "docker_api 接続プラグイン - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/414)。" -#: ../../rst/porting_guides/porting_guide_7.rst:232 +#: ../../rst/porting_guides/porting_guide_7.rst:588 msgid "docker_container - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:233 +#: ../../rst/porting_guides/porting_guide_7.rst:589 msgid "docker_container - the module was completely rewritten from scratch (https://github.com/ansible-collections/community.docker/pull/422)." msgstr "docker_container - モジュールã¯ã‚¼ãƒã‹ã‚‰å®Œå…¨ã«æ›¸ãç›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/422)。" -#: ../../rst/porting_guides/porting_guide_7.rst:234 +#: ../../rst/porting_guides/porting_guide_7.rst:590 msgid "docker_container_exec - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/401)." msgstr "docker_container_exec - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/401)。" -#: ../../rst/porting_guides/porting_guide_7.rst:235 +#: ../../rst/porting_guides/porting_guide_7.rst:591 msgid "docker_container_info - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/402)." msgstr "docker_container_info - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/402)。" -#: ../../rst/porting_guides/porting_guide_7.rst:236 +#: ../../rst/porting_guides/porting_guide_7.rst:592 msgid "docker_containers inventory plugin - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/413)." msgstr "docker_containers インベントリープラグイン - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/413)。" -#: ../../rst/porting_guides/porting_guide_7.rst:237 +#: ../../rst/porting_guides/porting_guide_7.rst:593 msgid "docker_host_info - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/403)." msgstr "docker_host_info - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/403)。" -#: ../../rst/porting_guides/porting_guide_7.rst:238 +#: ../../rst/porting_guides/porting_guide_7.rst:594 msgid "docker_image - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/404)." msgstr "docker_image - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/404)。" -#: ../../rst/porting_guides/porting_guide_7.rst:239 +#: ../../rst/porting_guides/porting_guide_7.rst:595 msgid "docker_image_info - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/405)." msgstr "docker_image_info - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/405)。" -#: ../../rst/porting_guides/porting_guide_7.rst:240 +#: ../../rst/porting_guides/porting_guide_7.rst:596 msgid "docker_image_load - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/406)." msgstr "docker_image_load - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/406)。" -#: ../../rst/porting_guides/porting_guide_7.rst:241 +#: ../../rst/porting_guides/porting_guide_7.rst:597 msgid "docker_login - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/407)." msgstr "docker_login - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/407)。" -#: ../../rst/porting_guides/porting_guide_7.rst:242 +#: ../../rst/porting_guides/porting_guide_7.rst:598 msgid "docker_network - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/408)." msgstr "docker_network - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/408)。" -#: ../../rst/porting_guides/porting_guide_7.rst:243 +#: ../../rst/porting_guides/porting_guide_7.rst:599 msgid "docker_network_info - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/409)." msgstr "docker_network_info - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/409)。" -#: ../../rst/porting_guides/porting_guide_7.rst:244 +#: ../../rst/porting_guides/porting_guide_7.rst:600 msgid "docker_plugin - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/429)." msgstr "docker_plugin - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/429)。" -#: ../../rst/porting_guides/porting_guide_7.rst:245 +#: ../../rst/porting_guides/porting_guide_7.rst:601 msgid "docker_prune - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/410)." msgstr "docker_prune - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/410)。" -#: ../../rst/porting_guides/porting_guide_7.rst:246 +#: ../../rst/porting_guides/porting_guide_7.rst:602 msgid "docker_volume - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/411)." msgstr "docker_volume - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/411)。" -#: ../../rst/porting_guides/porting_guide_7.rst:247 +#: ../../rst/porting_guides/porting_guide_7.rst:603 msgid "docker_volume_info - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/412)." msgstr "docker_volume_info - Docker SDK for Python を使用ã—ãªããªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã«ã¯ã€``requests`` をインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ä½¿ç”¨ã™ã‚‹æ©Ÿèƒ½ã«ã‚ˆã£ã¦ã¯ã€ã•ã‚‰ã«è¦ä»¶ãŒã‚ã‚Šã¾ã™ã€‚Docker SDK for Python ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã“れらã®è¦ä»¶ãŒæº€ãŸã•ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/412)。" -#: ../../rst/porting_guides/porting_guide_7.rst:262 +#: ../../rst/porting_guides/porting_guide_7.rst:608 +msgid "The internal structure of the collection was changed for modules and action plugins. These no longer live in a directory hierarchy ordered by topic, but instead are now all in a single (flat) directory. This has no impact on users *assuming they did not use internal FQCNs*. These will still work, but result in deprecation warnings. They were never officially supported and thus the redirects are kept as a courtsey, and this is not labelled as a breaking change. Note that for example the Ansible VScode plugin started recommending these internal names. If you followed its recommendation, you will now have to change back to the short names to avoid deprecation warnings, and potential errors in the future as these redirects will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5461)." +msgstr "モジュールã¨ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ—ラグインã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®å†…éƒ¨æ§‹é€ ãŒå¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚ã“れらã¯ã€ãƒˆãƒ”ックã”ã¨ã«ä¸¦ã¹ã‚‰ã‚ŒãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼éšŽå±¤ã«å˜åœ¨ã—ãªããªã‚Šã¾ã—ãŸãŒã€ä»£ã‚ã‚Šã«ã™ã¹ã¦ãŒå˜ä¸€ã® (フラットãª) ディレクトリーã«ã‚ã‚Šã¾ã™ã€‚*ユーザーãŒå†…部 FQCN を使用ã—ã¦ã„ãªã„ã¨ä»®å®šã™ã‚‹ã¨*ã€ã“ã‚ŒãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã«å½±éŸ¿ã‚’åŠã¼ã™ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“。ã“れらã¯å¼•ã続ã機能ã—ã¾ã™ãŒã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã‚‹çµæžœã¨ãªã‚Šã¾ã™ã€‚ã“れらã¯å…¬å¼ã«ã‚µãƒãƒ¼ãƒˆã•ã‚ŒãŸã“ã¨ãŒãªã„ãŸã‚ã€ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯å¿µã®ãŸã‚ä¿æŒã•ã‚Œã¦ãŠã‚Šã€ã“ã‚Œã¯é‡å¤§ãªå¤‰æ›´ã¨ã—ã¦åˆ†é¡žã•ã‚Œã¦ã„ã¾ã›ã‚“。ãŸã¨ãˆã°ã€Ansible VScode プラグインã¯ã“れらã®å†…部åã®æŽ¨å¥¨ã‚’開始ã—ãŸã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。ãã®æŽ¨å¥¨äº‹é …ã«å¾“ã£ãŸå ´åˆã¯ã€ã“れらã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯ community.general 9.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã®è¦å‘Šã¨å°†æ¥çš„ã«ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€çŸã„åå‰ã«æˆ»ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/5461)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:620 +msgid "The internal structure of the collection was changed for modules and action plugins. These no longer live in a directory hierarchy ordered by topic, but instead are now all in a single (flat) directory. This has no impact on users *assuming they did not use internal FQCNs*. These will still work, but result in deprecation warnings. They were never officially supported and thus the redirects are kept as a courtsey, and this is not labelled as a breaking change. Note that for example the Ansible VScode plugin started recommending these internal names. If you followed its recommendation, you will now have to change back to the short names to avoid deprecation warnings, and potential errors in the future as these redirects will be removed in community.network 8.0.0 (https://github.com/ansible-collections/community.network/pull/482)." +msgstr "モジュールã¨ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ—ラグインã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®å†…éƒ¨æ§‹é€ ãŒå¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚ã“れらã¯ã€ãƒˆãƒ”ックã”ã¨ã«ä¸¦ã¹ã‚‰ã‚ŒãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼éšŽå±¤ã«å˜åœ¨ã—ãªããªã‚Šã¾ã—ãŸãŒã€ä»£ã‚ã‚Šã«ã™ã¹ã¦ãŒå˜ä¸€ã® (フラットãª) ディレクトリーã«ã‚ã‚Šã¾ã™ã€‚*ユーザーãŒå†…部 FQCN を使用ã—ã¦ã„ãªã„ã¨ä»®å®šã™ã‚‹ã¨*ã€ã“ã‚ŒãŒãƒ¦ãƒ¼ã‚¶ãƒ¼ã«å½±éŸ¿ã‚’åŠã¼ã™ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“。ã“れらã¯å¼•ã続ã機能ã—ã¾ã™ãŒã€éžæŽ¨å¥¨ã®è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã‚‹çµæžœã¨ãªã‚Šã¾ã™ã€‚ã“れらã¯å…¬å¼ã«ã‚µãƒãƒ¼ãƒˆã•ã‚ŒãŸã“ã¨ãŒãªã„ãŸã‚ã€ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯å¿µã®ãŸã‚ä¿æŒã•ã‚Œã¦ãŠã‚Šã€ã“ã‚Œã¯é‡å¤§ãªå¤‰æ›´ã¨ã—ã¦åˆ†é¡žã•ã‚Œã¦ã„ã¾ã›ã‚“。ãŸã¨ãˆã°ã€Ansible VScode プラグインã¯ã“れらã®å†…部åã®æŽ¨å¥¨ã‚’開始ã—ãŸã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。ãã®æŽ¨å¥¨äº‹é …ã«å¾“ã£ãŸå ´åˆã¯ã€ã“れらã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã¯ community.general 9.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã®è¦å‘Šã¨å°†æ¥çš„ã«ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ã‚’回é¿ã™ã‚‹ãŸã‚ã«ã€çŸã„åå‰ã«æˆ»ã™å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.network/pull/482)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:630 msgid "Added 'static_routes' module to collection (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/82)." msgstr "コレクション㫠'static_routes' ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’è¿½åŠ ã—ã¾ã—㟠(https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/82)。" -#: ../../rst/porting_guides/porting_guide_7.rst:263 +#: ../../rst/porting_guides/porting_guide_7.rst:631 msgid "Added a resource module for NTP support (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/99)." msgstr "NTP サãƒãƒ¼ãƒˆç”¨ã®ãƒªã‚½ãƒ¼ã‚¹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’è¿½åŠ ã—ã¾ã—㟠(https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/99)。" -#: ../../rst/porting_guides/porting_guide_7.rst:264 +#: ../../rst/porting_guides/porting_guide_7.rst:632 msgid "Added a resource module for support of prefix lists (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/100)." msgstr "プレフィックスã®ãƒªã‚¹ãƒˆã‚’サãƒãƒ¼ãƒˆã™ã‚‹ãŸã‚ã®ãƒªã‚½ãƒ¼ã‚¹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’è¿½åŠ ã—ã¾ã—㟠(https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/100)。" -#: ../../rst/porting_guides/porting_guide_7.rst:265 +#: ../../rst/porting_guides/porting_guide_7.rst:633 msgid "Updated backend REST API request formats in all applicable modules for compatibility with SONiC 4.x openconfig YANG compliant REST APIs. (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/53)" msgstr "SONiC 4.x openconfig YANG æº–æ‹ ã® REST API ã¨ã®äº’æ›æ€§ã®ãŸã‚ã«ã€é©ç”¨å¯èƒ½ãªã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ REST API è¦æ±‚å½¢å¼ã‚’æ›´æ–°ã—ã¾ã—ãŸã€‚(https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/53)" -#: ../../rst/porting_guides/porting_guide_7.rst:270 +#: ../../rst/porting_guides/porting_guide_7.rst:638 msgid "Added collection metadata for creating execution environments." msgstr "実行環境を作æˆã™ã‚‹ãŸã‚ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ãŒè¿½åŠ ã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:271 +#: ../../rst/porting_guides/porting_guide_7.rst:639 msgid "Refactored the Markdown (MD) files and content for better readability." msgstr "èªã¿ã‚„ã™ãã™ã‚‹ãŸã‚ã«ã€Markdown (MD) ファイルã¨ã‚³ãƒ³ãƒ†ãƒ³ãƒ„をリファクタリングã—ã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:272 +#: ../../rst/porting_guides/porting_guide_7.rst:640 msgid "The share parameters are deprecated from the following modules - idrac_network, idrac_timezone_ntp, dellemc_configure_idrac_eventing, dellemc_configure_idrac_services, dellemc_idrac_lc_attributes, dellemc_system_lockdown_mode." msgstr "共有パラメーターã¯ã€idrac_networkã€idrac_timezone_ntpã€dellemc_configure_idrac_eventingã€dellemc_configure_idrac_servicesã€dellemc_idrac_lc_attributesã€dellemc_system_lockdown_mode ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:273 +#: ../../rst/porting_guides/porting_guide_7.rst:641 +msgid "idrac_bios - The module is enhanced to support clear pending BIOS attributes, reset BIOS to default settings, and configure BIOS attribute using Redfish." +msgstr "idrac_bios - ä¿ç•™ä¸ã® BIOS 属性ã®ã‚¯ãƒªã‚¢ã€BIOS ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆè¨å®šã¸ã®ãƒªã‚»ãƒƒãƒˆã€ãŠã‚ˆã³ Redfish を使用ã—㟠BIOS 属性ã®è¨å®šã‚’サãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå¼·åŒ–ã•ã‚Œã¦ã„ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:642 msgid "idrac_boot - Support for configuring the boot settings on iDRAC." msgstr "idrac_boot - iDRAC ã§ã®èµ·å‹•è¨å®šã®æ§‹æˆã®ã‚µãƒãƒ¼ãƒˆã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:274 +#: ../../rst/porting_guides/porting_guide_7.rst:643 +msgid "idrac_redfish_storage_controller - This module is enhanced to support LockVirtualDisk operation." +msgstr "idrac_redfish_storage_controller - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€LockVirtualDisk æ“作をサãƒãƒ¼ãƒˆã™ã‚‹ã‚ˆã†ã«æ‹¡å¼µã•ã‚Œã¦ã„ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:644 +msgid "idrac_virtual_media - This module allows to configure Remote File Share settings." +msgstr "idrac_virtual_media - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã¨ã€Remote File Share ã‚’è¨å®šã§ãã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:645 msgid "ome_device_group - The module is enhanced to support the removal of devices from a static device group." msgstr "ome_device_group - モジュールãŒæ‹¡å¼µã•ã‚Œã€é™çš„デãƒã‚¤ã‚¹ã‚°ãƒ«ãƒ¼ãƒ—ã‹ã‚‰ã®ãƒ‡ãƒã‚¤ã‚¹ã®å‰Šé™¤ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:275 +#: ../../rst/porting_guides/porting_guide_7.rst:646 msgid "ome_devices - Support for performing device-specific operations on OpenManage Enterprise." msgstr "ome_devices - OpenManage Enterprise ã§ãƒ‡ãƒã‚¤ã‚¹å›ºæœ‰ã®æ“作を実行ã™ã‚‹ãŸã‚ã®ã‚µãƒãƒ¼ãƒˆã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:292 +#: ../../rst/porting_guides/porting_guide_7.rst:683 msgid "servicenow.servicenow (previously included version: 1.0.6)" msgstr "servicenow.servicenow (以å‰å«ã¾ã‚Œã¦ã„ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³: 1.0.6)" -#: ../../rst/porting_guides/porting_guide_7.rst:300 +#: ../../rst/porting_guides/porting_guide_7.rst:691 msgid "PlayIterator - remove deprecated ``PlayIterator.ITERATING_*`` and ``PlayIterator.FAILED_*``" -msgstr "PlayIterator - éžæŽ¨å¥¨ã¨ãªã£ãŸ ``PlayIterator.ITERATING_*`` ãŠã‚ˆã³ ``PlayIterator.FAILED_*`` を削除ã—ã¾ã™ã€‚" +msgstr "PlayIterator - éžæŽ¨å¥¨ã¨ãªã£ãŸ ``PlayIterator.ITERATING_*`` ãŠã‚ˆã³ ``PlayIterator.FAILED_*`` を削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:301 +#: ../../rst/porting_guides/porting_guide_7.rst:692 msgid "Remove deprecated ``ALLOW_WORLD_READABLE_TMPFILES`` configuration option (https://github.com/ansible/ansible/issues/77393)" -msgstr "éžæŽ¨å¥¨ã® ``ALLOW_WORLD_READABLE_TMPFILES`` è¨å®šã‚ªãƒ—ション (https://github.com/ansible/ansible/issues/77393) を削除" +msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``ALLOW_WORLD_READABLE_TMPFILES`` è¨å®šã‚ªãƒ—ションを削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77393)" -#: ../../rst/porting_guides/porting_guide_7.rst:302 +#: ../../rst/porting_guides/porting_guide_7.rst:693 msgid "Remove deprecated ``COMMAND_WARNINGS`` configuration option (https://github.com/ansible/ansible/issues/77394)" -msgstr "éžæŽ¨å¥¨ã® ``COMMAND_WARNINGS`` è¨å®šã‚ªãƒ—ション (https://github.com/ansible/ansible/issues/77394)" +msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``COMMAND_WARNINGS`` è¨å®šã‚ªãƒ—ションを削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77394)" -#: ../../rst/porting_guides/porting_guide_7.rst:303 +#: ../../rst/porting_guides/porting_guide_7.rst:694 msgid "Remove deprecated ``DISPLAY_SKIPPED_HOSTS`` environment variable (https://github.com/ansible/ansible/issues/77396)" -msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``DISPLAY_SKIPPED_HOSTS`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77396)。" +msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``DISPLAY_SKIPPED_HOSTS`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77396)" -#: ../../rst/porting_guides/porting_guide_7.rst:304 +#: ../../rst/porting_guides/porting_guide_7.rst:695 msgid "Remove deprecated ``LIBVIRT_LXC_NOSECLABEL`` environment variable (https://github.com/ansible/ansible/issues/77395)" -msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``LIBVIRT_LXC_NOSECLABEL`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77395)。" +msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``LIBVIRT_LXC_NOSECLABEL`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77395)" -#: ../../rst/porting_guides/porting_guide_7.rst:305 +#: ../../rst/porting_guides/porting_guide_7.rst:696 msgid "Remove deprecated ``NETWORK_GROUP_MODULES`` environment variable (https://github.com/ansible/ansible/issues/77397)" -msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``NETWORK_GROUP_MODULES`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77397)。" +msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``NETWORK_GROUP_MODULES`` 環境変数を削除ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77397" -#: ../../rst/porting_guides/porting_guide_7.rst:306 +#: ../../rst/porting_guides/porting_guide_7.rst:697 msgid "Remove deprecated ``UnsafeProxy``" msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``UnsafeProxy`` を削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:307 +#: ../../rst/porting_guides/porting_guide_7.rst:698 msgid "Remove deprecated ``plugin_filters_cfg`` config option from ``default`` section (https://github.com/ansible/ansible/issues/77398)" msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ ``plugin_filters_cfg`` è¨å®šã‚ªãƒ—ションを ``default`` セクションã‹ã‚‰å‰Šé™¤ã—ã¾ã™ (https://github.com/ansible/ansible/issues/77398)" -#: ../../rst/porting_guides/porting_guide_7.rst:308 +#: ../../rst/porting_guides/porting_guide_7.rst:699 msgid "Remove deprecated functionality that allows loading cache plugins directly without using ``cache_loader``." -msgstr "``cache_loader`` を使用ã›ãšã«ã€ã‚ャッシュプラグインを直接ãƒãƒ¼ãƒ‰ã§ãã‚‹éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™ã€‚" +msgstr "``cache_loader`` を使用ã›ãšã«ã€ã‚ャッシュプラグインを直接ãƒãƒ¼ãƒ‰ã§ãã‚‹éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:309 +#: ../../rst/porting_guides/porting_guide_7.rst:700 msgid "Remove deprecated functionality that allows subclassing ``DefaultCallback`` without the corresponding ``doc_fragment``." msgstr "対応ã™ã‚‹ ``doc_fragment`` ãªã—ã« ``DefaultCallback`` ã®ã‚µãƒ–クラス化をå¯èƒ½ã«ã™ã‚‹éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:310 +#: ../../rst/porting_guides/porting_guide_7.rst:701 msgid "Remove deprecated powershell functions ``Load-CommandUtils`` and ``Import-PrivilegeUtil``" msgstr "éžæŽ¨å¥¨ã¨ãªã£ãŸ powershell 関数 ``Load-CommandUtils`` ãŠã‚ˆã³ ``Import-PrivilegeUtil`` を削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:311 +#: ../../rst/porting_guides/porting_guide_7.rst:702 msgid "apt_key - remove deprecated ``key`` module param" msgstr "apt_key - éžæŽ¨å¥¨ã¨ãªã£ãŸ ``key`` モジュールパラメーターを削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:312 +#: ../../rst/porting_guides/porting_guide_7.rst:703 msgid "command/shell - remove deprecated ``warn`` module param" msgstr "コマンド/シェル - éžæŽ¨å¥¨ã¨ãªã£ãŸ ``warn``モジュールパラメーターを削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:313 +#: ../../rst/porting_guides/porting_guide_7.rst:704 msgid "get_url - remove deprecated ``sha256sum`` module param" msgstr "get_url - éžæŽ¨å¥¨ã¨ãªã£ãŸ ``sha256sum`` モジュールパラメーターを削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:314 +#: ../../rst/porting_guides/porting_guide_7.rst:705 msgid "import_playbook - remove deprecated functionality that allows providing additional parameters in free form" msgstr "import_playbook - 自由形å¼ã§è¿½åŠ ã®ãƒ‘ラメーターをæä¾›ã§ãã‚‹éžæŽ¨å¥¨ã®æ©Ÿèƒ½ã‚’削除ã—ã¾ã™" -#: ../../rst/porting_guides/porting_guide_7.rst:319 +#: ../../rst/porting_guides/porting_guide_7.rst:710 msgid "cloudformation - the ``template_format`` option has been removed. It has been ignored by the module since Ansible 2.3 (https://github.com/ansible-collections/amazon.aws/pull/833)." msgstr "cloudformation - ``template_format`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“れ㯠Ansible 2.3 以é™ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦ç„¡è¦–ã•ã‚Œã¦ã„ã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/833)。" -#: ../../rst/porting_guides/porting_guide_7.rst:320 +#: ../../rst/porting_guides/porting_guide_7.rst:711 msgid "ec2_key - the ``wait_timeout`` option had no effect, was deprecated in release 1.0.0, and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/830)." msgstr "ec2_key - ``wait_timeout`` オプションã¯åŠ¹æžœãŒãªãã€ãƒªãƒªãƒ¼ã‚¹ 1.0.0 ã§éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾åœ¨ã¯å‰Šé™¤ã•ã‚Œã¦ã„ã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/830)。" -#: ../../rst/porting_guides/porting_guide_7.rst:321 +#: ../../rst/porting_guides/porting_guide_7.rst:712 msgid "ec2_key - the ``wait`` option had no effect, was deprecated in release 1.0.0, and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/830)." msgstr "ec2_key - ``wait`` オプションã¯åŠ¹æžœãŒãªãã€ãƒªãƒªãƒ¼ã‚¹ 1.0.0 ã§éžæŽ¨å¥¨ã¨ãªã‚Šã€ç¾åœ¨ã¯å‰Šé™¤ã•ã‚Œã¦ã„ã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/830)。" -#: ../../rst/porting_guides/porting_guide_7.rst:322 +#: ../../rst/porting_guides/porting_guide_7.rst:713 msgid "ec2_tag - the previously deprecated state ``list`` has been removed. To list tags on an EC2 resource the ``ec2_tag_info`` module can be used (https://github.com/ansible-collections/amazon.aws/pull/829)." msgstr "ec2_tag - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸçŠ¶æ…‹ ``list`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚EC2 リソースã®ã‚¿ã‚°ã‚’一覧表示ã™ã‚‹ã«ã¯ã€``ec2_tag_info`` モジュールを使用ã§ãã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/829)。" -#: ../../rst/porting_guides/porting_guide_7.rst:323 +#: ../../rst/porting_guides/porting_guide_7.rst:714 msgid "ec2_vol - the previously deprecated state ``list`` has been removed. To list volumes the ``ec2_vol_info`` module can be used (https://github.com/ansible-collections/amazon.aws/pull/828)." msgstr "ec2_vol - 以å‰ã«éžæŽ¨å¥¨ã¨ãªã£ãŸçŠ¶æ…‹ ``list`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ボリュームを一覧表示ã™ã‚‹ã«ã¯ ``ec2_vol_info`` モジュールを使用ã§ãã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/828)。" -#: ../../rst/porting_guides/porting_guide_7.rst:324 +#: ../../rst/porting_guides/porting_guide_7.rst:715 msgid "module_utils.batch - the class ``ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnection`` has been removed. Please use ``AnsibleAWSModule.client()`` instead (https://github.com/ansible-collections/amazon.aws/pull/831)." msgstr "module_utils.batch - クラス ``ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnection`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``AnsibleAWSModule.client()`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/831)。" -#: ../../rst/porting_guides/porting_guide_7.rst:329 +#: ../../rst/porting_guides/porting_guide_7.rst:720 +msgid "napalm - Removed unused connection plugin." +msgstr "napalm - 未使用ã®æŽ¥ç¶šãƒ—ラグインを削除ã—ã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:721 +msgid "net_banner - Use <network_os>_banner instead." +msgstr "net_banner - 代ã‚ã‚Šã« <network_os>_banner を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:722 +msgid "net_interface - Use <network_os>_interfaces instead." +msgstr "net_interface - <network_os>_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:723 +msgid "net_l2_interface - Use <network_os>_l2_interfaces instead." +msgstr "net_l2_interface - <network_os>_l2_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:724 +msgid "net_l3_interface - Use <network_os>_l3_interfaces instead." +msgstr "net_l3_interface - <network_os>_l3_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:725 +msgid "net_linkagg - Use <network_os>_lag_interfaces instead." +msgstr "net_linkagg - <network_os>_lag_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:726 +msgid "net_lldp - Use <network_os>_lldp_global instead." +msgstr "net_lldp - <network_os>_lldp_global を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:727 +msgid "net_lldp_interface - Use <network_os>_lldp_interfaces instead." +msgstr "net_lldp_interface - <network_os>_lldp_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:728 +msgid "net_logging - Use <network_os>_logging_global instead." +msgstr "net_logging - <network_os>_logging_global を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:729 +msgid "net_static_route - Use <network_os>_static_routes instead." +msgstr "net_static_route - <network_os>_static_routes を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:730 +msgid "net_system - Use <network_os>_system instead." +msgstr "net_system - <network_os>_system を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:731 +msgid "net_user - Use <network_os>_user instead." +msgstr "net_user - <network_os>_user を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:732 +msgid "net_vlan - Use <network_os>_vlans instead." +msgstr "net_vlan - <network_os>_vlans を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:733 +msgid "net_vrf - Use <network_os>_vrf instead." +msgstr "net_vrf - <network_os>_vrf を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:738 +msgid "ios_interface - use ios_interfaces instead." +msgstr "ios_interface - ios_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:739 +msgid "ios_l2_interface - use ios_l2_interfaces instead." +msgstr "ios_l2_interface - ios_l2_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:740 +msgid "ios_l3_interface - use ios_l3_interfaces instead." +msgstr "ios_l3_interface - ios_l3_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:741 +msgid "ios_static_route - use ios_static_routes instead." +msgstr "ios_static_route - ios_static_routes を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:742 +msgid "ios_vlan - use ios_vlans instead." +msgstr "ios_vlan - ios_vlans を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:747 +msgid "iosxr_interface - use iosxr_interfaces instead." +msgstr "iosxr_interface - iosxr_interfaces を代ã‚ã‚Šã«ä½¿ç”¨ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:752 +msgid "This release removes the following deprecated plugins that have reached their end-of-life." +msgstr "ã“ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€æœ‰åŠ¹æœŸé™ã®åˆ‡ã‚ŒãŸä»¥ä¸‹ã®éžæŽ¨å¥¨ãƒ—ラグインを削除ã—ã¦ã„ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:753 +msgid "nxos_acl" +msgstr "nxos_acl" + +#: ../../rst/porting_guides/porting_guide_7.rst:754 +msgid "nxos_acl_interface" +msgstr "nxos_acl_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:755 +msgid "nxos_interface" +msgstr "nxos_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:756 +msgid "nxos_interface_ospf" +msgstr "nxos_interface_ospf" + +#: ../../rst/porting_guides/porting_guide_7.rst:757 +msgid "nxos_l2_interface" +msgstr "nxos_l2_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:758 +msgid "nxos_l3_interface" +msgstr "nxos_l3_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:759 +msgid "nxos_linkagg" +msgstr "nxos_linkagg" + +#: ../../rst/porting_guides/porting_guide_7.rst:760 +msgid "nxos_lldp" +msgstr "nxos_lldp" + +#: ../../rst/porting_guides/porting_guide_7.rst:761 +msgid "nxos_ospf" +msgstr "nxos_ospf" + +#: ../../rst/porting_guides/porting_guide_7.rst:762 +msgid "nxos_ospf_vrf" +msgstr "nxos_ospf_vrf" + +#: ../../rst/porting_guides/porting_guide_7.rst:763 +msgid "nxos_smu" +msgstr "nxos_smu" + +#: ../../rst/porting_guides/porting_guide_7.rst:764 +msgid "nxos_static_route" +msgstr "nxos_static_route" + +#: ../../rst/porting_guides/porting_guide_7.rst:765 +msgid "nxos_vlan" +msgstr "nxos_vlan" + +#: ../../rst/porting_guides/porting_guide_7.rst:770 msgid "aws_kms_info - the unused and deprecated ``keys_attr`` parameter has been removed (https://github.com/ansible-collections/amazon.aws/pull/1172)." msgstr "aws_kms_info - 未使用ãŠã‚ˆã³éžæŽ¨å¥¨ã® ``keys_attr`` パラメーターãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/amazon.aws/pull/1172)。" -#: ../../rst/porting_guides/porting_guide_7.rst:330 +#: ../../rst/porting_guides/porting_guide_7.rst:771 msgid "data_pipeline - the ``version`` option has always been ignored and has been removed (https://github.com/ansible-collections/community.aws/pull/1160\"" msgstr "data_pipeline - ``version`` オプションã¯å¸¸ã«ç„¡è¦–ã•ã‚Œã€å‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1160\"" -#: ../../rst/porting_guides/porting_guide_7.rst:331 +#: ../../rst/porting_guides/porting_guide_7.rst:772 msgid "ec2_eip - The ``wait_timeout`` option has been removed. It has always been ignored by the module (https://github.com/ansible-collections/community.aws/pull/1159)." msgstr "ec2_eip - ``wait_timeout`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦å¸¸ã«ç„¡è¦–ã•ã‚Œã¦ã„ã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1159)。" -#: ../../rst/porting_guides/porting_guide_7.rst:332 +#: ../../rst/porting_guides/porting_guide_7.rst:773 msgid "ec2_lc - the ``associate_public_ip_address`` option has been removed. It has always been ignored by the module (https://github.com/ansible-collections/community.aws/pull/1158)." msgstr "ec2_lc - ``associate_public_ip_address`` オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«ã‚ˆã£ã¦å¸¸ã«ç„¡è¦–ã•ã‚Œã¦ã„ã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1158)。" -#: ../../rst/porting_guides/porting_guide_7.rst:333 +#: ../../rst/porting_guides/porting_guide_7.rst:774 msgid "ec2_metric_alarm - support for using the ``<=``, ``<``, ``>`` and ``>=`` operators for comparison has been dropped. Please use ``LessThanOrEqualToThreshold``, ``LessThanThreshold``, ``GreaterThanThreshold`` or ``GreaterThanOrEqualToThreshold`` instead (https://github.com/ansible-collections/amazon.aws/pull/1164)." msgstr "ec2_metric_alarm - 比較用㮠``<=``ã€``<``ã€``>`` ãŠã‚ˆã³ ``>=`` Operator ã®ä½¿ç”¨ã¸ã®ã‚µãƒãƒ¼ãƒˆã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã«ã€``LessThanOrEqualToThreshold``ã€``LessThanThreshold``ã€``GreaterThanThreshold`` ã¾ãŸã¯ ``GreaterThanOrEqualToThreshold`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1164)。" -#: ../../rst/porting_guides/porting_guide_7.rst:334 +#: ../../rst/porting_guides/porting_guide_7.rst:775 msgid "ecs_ecr - The deprecated alias ``delete_policy`` has been removed. Please use ``purge_policy`` instead (https://github.com/ansible-collections/community.aws/pull/1161)." msgstr "ecs_ecr - éžæŽ¨å¥¨ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ``delete_policy`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``purge_policy`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.aws/pull/1161)。" -#: ../../rst/porting_guides/porting_guide_7.rst:335 +#: ../../rst/porting_guides/porting_guide_7.rst:776 msgid "iam_managed_policy - the unused ``fail_on_delete`` parameter has been removed (https://github.com/ansible-collections/community.aws/pull/1168)" msgstr "iam_managed_policy - 未使用㮠``fail_on_delete`` パラメーターãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1168)" -#: ../../rst/porting_guides/porting_guide_7.rst:336 +#: ../../rst/porting_guides/porting_guide_7.rst:777 msgid "s3_lifecycle - the unused parameter ``requester_pays`` has been removed (https://github.com/ansible-collections/community.aws/pull/1165)." msgstr "s3_lifecycle - 未使用ã®ãƒ‘ラメーター ``requester_pays`` ãŒå‰Šé™¤ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.aws/pull/1165)。" -#: ../../rst/porting_guides/porting_guide_7.rst:337 +#: ../../rst/porting_guides/porting_guide_7.rst:778 msgid "s3_sync - remove unused ``retries`` parameter (https://github.com/ansible-collections/community.aws/pull/1166)." msgstr "s3_sync - 未使用㮠``retries`` パラメーターを削除ã—ã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1166)。" -#: ../../rst/porting_guides/porting_guide_7.rst:342 +#: ../../rst/porting_guides/porting_guide_7.rst:783 msgid "azure_rm_aks_facts, azure_rm_aks_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_aks_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_aks_factsã€azure_rm_aks_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_aks_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:343 +#: ../../rst/porting_guides/porting_guide_7.rst:784 msgid "azure_rm_aksversion_facts, azure_rm_aksversion_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_aksversion_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_aksversion_factsã€azure_rm_aksversion_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_aksversion_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:344 +#: ../../rst/porting_guides/porting_guide_7.rst:785 msgid "azure_rm_applicationsecuritygroup_facts, azure_rm_applicationsecuritygroup_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_applicationsecuritygroup_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_applicationsecuritygroup_factsã€azure_rm_applicationsecuritygroup_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_applicationsecuritygroup_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:345 +#: ../../rst/porting_guides/porting_guide_7.rst:786 msgid "azure_rm_appserviceplan_facts, azure_rm_appserviceplan_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_appserviceplan_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_appserviceplan_factsã€azure_rm_appserviceplan_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_appserviceplan_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:346 +#: ../../rst/porting_guides/porting_guide_7.rst:787 msgid "azure_rm_automationaccount_facts, azure_rm_automationaccount_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_automationaccount_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_automationaccount_factsã€azure_rm_automationaccount_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_automationaccount_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:347 +#: ../../rst/porting_guides/porting_guide_7.rst:788 msgid "azure_rm_autoscale_facts, azure_rm_autoscale_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_autoscale_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_autoscale_factsã€azure_rm_autoscale_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_autoscale_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:348 +#: ../../rst/porting_guides/porting_guide_7.rst:789 msgid "azure_rm_availabilityset_facts, azure_rm_availabilityset_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_availabilityset_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_availabilityset_factsã€azure_rm_availabilityset_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_availabilityset_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:349 +#: ../../rst/porting_guides/porting_guide_7.rst:790 msgid "azure_rm_cdnendpoint_facts, azure_rm_cdnendpoint_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_cdnendpoint_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_cdnendpoint_factsã€azure_rm_cdnendpoint_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_cdnendpoint_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:350 +#: ../../rst/porting_guides/porting_guide_7.rst:791 msgid "azure_rm_cdnprofile_facts, azure_rm_cdnprofile_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_cdnprofile_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_cdnprofile_factsã€azure_rm_cdnprofile_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_cdnprofile_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:351 +#: ../../rst/porting_guides/porting_guide_7.rst:792 msgid "azure_rm_containerinstance_facts, azure_rm_containerinstance_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_containerinstance_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_containerinstance_factsã€azure_rm_containerinstance_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_containerinstance_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:352 +#: ../../rst/porting_guides/porting_guide_7.rst:793 msgid "azure_rm_containerregistry_facts, azure_rm_containerregistry_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_containerregistry_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_containerregistry_factsã€azure_rm_containerregistry_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_containerregistry_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:353 +#: ../../rst/porting_guides/porting_guide_7.rst:794 msgid "azure_rm_cosmosdbaccount_facts, azure_rm_cosmosdbaccount_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_cosmosdbaccount_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_cosmosdbaccount_factsã€azure_rm_cosmosdbaccount_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_cosmosdbaccount_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:354 +#: ../../rst/porting_guides/porting_guide_7.rst:795 msgid "azure_rm_deployment_facts, azure_rm_deployment_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_deployment_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_deployment_factsã€azure_rm_deployment_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_deployment_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:355 +#: ../../rst/porting_guides/porting_guide_7.rst:796 msgid "azure_rm_devtestlab_facts, azure_rm_devtestlab_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlab_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlab_factsã€azure_rm_devtestlab_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlab_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:356 +#: ../../rst/porting_guides/porting_guide_7.rst:797 msgid "azure_rm_devtestlabarmtemplate_facts, azure_rm_devtestlabarmtemplate_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabarmtemplate_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabarmtemplate_factsã€azure_rm_devtestlabarmtemplate_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabarmtemplate_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:357 +#: ../../rst/porting_guides/porting_guide_7.rst:798 msgid "azure_rm_devtestlabartifact_facts, azure_rm_devtestlabartifact_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabartifact_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabartifact_factsã€azure_rm_devtestlabartifact_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabartifact_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:358 +#: ../../rst/porting_guides/porting_guide_7.rst:799 msgid "azure_rm_devtestlabartifactsource_facts, azure_rm_devtestlabartifactsource_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabartifactsource_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabartifactsource_factsã€azure_rm_devtestlabartifactsource_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabartifactsource_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:359 +#: ../../rst/porting_guides/porting_guide_7.rst:800 msgid "azure_rm_devtestlabcustomimage_facts, azure_rm_devtestlabcustomimage_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabcustomimage_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabcustomimage_factsã€azure_rm_devtestlabcustomimage_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabcustomimage_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:360 +#: ../../rst/porting_guides/porting_guide_7.rst:801 msgid "azure_rm_devtestlabenvironment_facts, azure_rm_devtestlabenvironment_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabenvironment_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabenvironment_factsã€azure_rm_devtestlabenvironment_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabenvironment_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:361 +#: ../../rst/porting_guides/porting_guide_7.rst:802 msgid "azure_rm_devtestlabpolicy_facts, azure_rm_devtestlabpolicy_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabpolicy_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabpolicy_factsã€azure_rm_devtestlabpolicy_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabpolicy_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:362 +#: ../../rst/porting_guides/porting_guide_7.rst:803 msgid "azure_rm_devtestlabschedule_facts, azure_rm_devtestlabschedule_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabschedule_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabschedule_factsã€azure_rm_devtestlabschedule_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabschedule_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:363 +#: ../../rst/porting_guides/porting_guide_7.rst:804 msgid "azure_rm_devtestlabvirtualmachine_facts, azure_rm_devtestlabvirtualmachine_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabvirtualmachine_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabvirtualmachine_factsã€azure_rm_devtestlabvirtualmachine_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabvirtualmachine_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:364 +#: ../../rst/porting_guides/porting_guide_7.rst:805 msgid "azure_rm_devtestlabvirtualnetwork_facts, azure_rm_devtestlabvirtualnetwork_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_devtestlabvirtualnetwork_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_devtestlabvirtualnetwork_factsã€azure_rm_devtestlabvirtualnetwork_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_devtestlabvirtualnetwork_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:365 +#: ../../rst/porting_guides/porting_guide_7.rst:806 msgid "azure_rm_dnsrecordset_facts, azure_rm_dnsrecordset_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_dnsrecordset_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_dnsrecordset_factsã€azure_rm_dnsrecordset_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_dnsrecordset_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:366 +#: ../../rst/porting_guides/porting_guide_7.rst:807 msgid "azure_rm_dnszone_facts, azure_rm_dnszone_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_dnszone_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_dnszone_factsã€azure_rm_dnszone_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_dnszone_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:367 +#: ../../rst/porting_guides/porting_guide_7.rst:808 msgid "azure_rm_functionapp_facts, azure_rm_functionapp_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_functionapp_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_functionapp_factsã€azure_rm_functionapp_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_functionapp_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:368 +#: ../../rst/porting_guides/porting_guide_7.rst:809 msgid "azure_rm_hdinsightcluster_facts, azure_rm_hdinsightcluster_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_hdinsightcluster_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_hdinsightcluster_factsã€azure_rm_hdinsightcluster_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_hdinsightcluster_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:369 +#: ../../rst/porting_guides/porting_guide_7.rst:810 msgid "azure_rm_image_facts, azure_rm_image_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_image_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_image_factsã€azure_rm_image_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_image_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:370 +#: ../../rst/porting_guides/porting_guide_7.rst:811 msgid "azure_rm_loadbalancer_facts, azure_rm_loadbalancer_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_loadbalancer_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_loadbalancer_factsã€azure_rm_loadbalancer_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_loadbalancer_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:371 +#: ../../rst/porting_guides/porting_guide_7.rst:812 msgid "azure_rm_lock_facts, azure_rm_lock_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_lock_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_lock_factsã€azure_rm_lock_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_lock_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:372 +#: ../../rst/porting_guides/porting_guide_7.rst:813 msgid "azure_rm_loganalyticsworkspace_facts, azure_rm_loganalyticsworkspace_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_loganalyticsworkspace_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_loganalyticsworkspace_factsã€azure_rm_loganalyticsworkspace_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_loganalyticsworkspace_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:373 +#: ../../rst/porting_guides/porting_guide_7.rst:814 msgid "azure_rm_managed_disk, azure_rm_manageddisk - the deprecated modules have been removed. Use azure.azcollection.azure_rm_manageddisk instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_managed_diskã€azure_rm_manageddisk - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_manageddisk を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:374 +#: ../../rst/porting_guides/porting_guide_7.rst:815 msgid "azure_rm_managed_disk_facts, azure_rm_manageddisk_facts, azure_rm_manageddisk_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_manageddisk_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_managed_disk_factsã€azure_rm_manageddisk_factsã€azure_rm_manageddisk_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_manageddisk_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:375 +#: ../../rst/porting_guides/porting_guide_7.rst:816 msgid "azure_rm_mariadbconfiguration_facts, azure_rm_mariadbconfiguration_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mariadbconfiguration_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mariadbconfiguration_factsã€azure_rm_mariadbconfiguration_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mariadbconfiguration_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:376 +#: ../../rst/porting_guides/porting_guide_7.rst:817 msgid "azure_rm_mariadbdatabase_facts, azure_rm_mariadbdatabase_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mariadbdatabase_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mariadbdatabase_factsã€azure_rm_mariadbdatabase_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mariadbdatabase_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:377 +#: ../../rst/porting_guides/porting_guide_7.rst:818 msgid "azure_rm_mariadbfirewallrule_facts, azure_rm_mariadbfirewallrule_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mariadbfirewallrule_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mariadbfirewallrule_factsã€azure_rm_mariadbfirewallrule_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mariadbfirewallrule_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:378 +#: ../../rst/porting_guides/porting_guide_7.rst:819 msgid "azure_rm_mariadbserver_facts, azure_rm_mariadbserver_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mariadbserver_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mariadbserver_factsã€azure_rm_mariadbserver_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mariadbserver_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:379 +#: ../../rst/porting_guides/porting_guide_7.rst:820 msgid "azure_rm_mysqlconfiguration_facts, azure_rm_mysqlconfiguration_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mysqlconfiguration_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mysqlconfiguration_factsã€azure_rm_mysqlconfiguration_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mysqlconfiguration_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:380 +#: ../../rst/porting_guides/porting_guide_7.rst:821 msgid "azure_rm_mysqldatabase_facts, azure_rm_mysqldatabase_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mysqldatabase_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mysqldatabase_factsã€azure_rm_mysqldatabase_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mysqldatabase_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:381 +#: ../../rst/porting_guides/porting_guide_7.rst:822 msgid "azure_rm_mysqlfirewallrule_facts, azure_rm_mysqlfirewallrule_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mysqlfirewallrule_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mysqlfirewallrule_factsã€azure_rm_mysqlfirewallrule_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mysqlfirewallrule_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:382 +#: ../../rst/porting_guides/porting_guide_7.rst:823 msgid "azure_rm_mysqlserver_facts, azure_rm_mysqlserver_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_mysqlserver_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_mysqlserver_factsã€azure_rm_mysqlserver_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_mysqlserver_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:383 +#: ../../rst/porting_guides/porting_guide_7.rst:824 msgid "azure_rm_networkinterface_facts, azure_rm_networkinterface_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_networkinterface_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_networkinterface_factsã€azure_rm_networkinterface_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_networkinterface_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:384 +#: ../../rst/porting_guides/porting_guide_7.rst:825 msgid "azure_rm_postgresqlconfiguration_facts, azure_rm_postgresqlconfiguration_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_postgresqlconfiguration_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_postgresqlconfiguration_factsã€azure_rm_postgresqlconfiguration_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_postgresqlconfiguration_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:385 +#: ../../rst/porting_guides/porting_guide_7.rst:826 msgid "azure_rm_postgresqldatabase_facts, azure_rm_postgresqldatabase_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_postgresqldatabase_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_postgresqldatabase_factsã€azure_rm_postgresqldatabase_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_postgresqldatabase_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:386 +#: ../../rst/porting_guides/porting_guide_7.rst:827 msgid "azure_rm_postgresqlfirewallrule_facts, azure_rm_postgresqlfirewallrule_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_postgresqlfirewallrule_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_postgresqlfirewallrule_factsã€azure_rm_postgresqlfirewallrule_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_postgresqlfirewallrule_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:387 +#: ../../rst/porting_guides/porting_guide_7.rst:828 msgid "azure_rm_postgresqlserver_facts, azure_rm_postgresqlserver_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_postgresqlserver_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_postgresqlserver_factsã€azure_rm_postgresqlserver_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_postgresqlserver_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:388 +#: ../../rst/porting_guides/porting_guide_7.rst:829 msgid "azure_rm_publicipaddress_facts, azure_rm_publicipaddress_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_publicipaddress_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_publicipaddress_factsã€azure_rm_publicipaddress_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_publicipaddress_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:389 +#: ../../rst/porting_guides/porting_guide_7.rst:830 msgid "azure_rm_rediscache_facts, azure_rm_rediscache_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_rediscache_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_rediscache_factsã€azure_rm_rediscache_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_rediscache_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:390 +#: ../../rst/porting_guides/porting_guide_7.rst:831 msgid "azure_rm_resource_facts, azure_rm_resource_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_resource_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_resource_factsã€azure_rm_resource_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_resource_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:391 +#: ../../rst/porting_guides/porting_guide_7.rst:832 msgid "azure_rm_resourcegroup_facts, azure_rm_resourcegroup_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_resourcegroup_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_resourcegroup_factsã€azure_rm_resourcegroup_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_resourcegroup_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:392 +#: ../../rst/porting_guides/porting_guide_7.rst:833 msgid "azure_rm_roleassignment_facts, azure_rm_roleassignment_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_roleassignment_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_roleassignment_factsã€azure_rm_roleassignment_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_roleassignment_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:393 +#: ../../rst/porting_guides/porting_guide_7.rst:834 msgid "azure_rm_roledefinition_facts, azure_rm_roledefinition_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_roledefinition_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_roledefinition_factsã€azure_rm_roledefinition_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_roledefinition_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:394 +#: ../../rst/porting_guides/porting_guide_7.rst:835 msgid "azure_rm_routetable_facts, azure_rm_routetable_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_routetable_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_routetable_factsã€azure_rm_routetable_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_routetable_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:395 +#: ../../rst/porting_guides/porting_guide_7.rst:836 msgid "azure_rm_securitygroup_facts, azure_rm_securitygroup_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_securitygroup_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_securitygroup_factsã€azure_rm_securitygroup_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_securitygroup_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:396 +#: ../../rst/porting_guides/porting_guide_7.rst:837 msgid "azure_rm_servicebus_facts, azure_rm_servicebus_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_servicebus_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_servicebus_factsã€azure_rm_servicebus_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_servicebus_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:397 +#: ../../rst/porting_guides/porting_guide_7.rst:838 msgid "azure_rm_sqldatabase_facts, azure_rm_sqldatabase_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_sqldatabase_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_sqldatabase_factsã€azure_rm_sqldatabase_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_sqldatabase_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:398 +#: ../../rst/porting_guides/porting_guide_7.rst:839 msgid "azure_rm_sqlfirewallrule_facts, azure_rm_sqlfirewallrule_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_sqlfirewallrule_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_sqlfirewallrule_factsã€azure_rm_sqlfirewallrule_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_sqlfirewallrule_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:399 +#: ../../rst/porting_guides/porting_guide_7.rst:840 msgid "azure_rm_sqlserver_facts, azure_rm_sqlserver_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_sqlserver_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_sqlserver_factsã€azure_rm_sqlserver_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_sqlserver_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:400 +#: ../../rst/porting_guides/porting_guide_7.rst:841 msgid "azure_rm_storageaccount_facts, azure_rm_storageaccount_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_storageaccount_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_storageaccount_factsã€azure_rm_storageaccount_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_storageaccount_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:401 +#: ../../rst/porting_guides/porting_guide_7.rst:842 msgid "azure_rm_subnet_facts, azure_rm_subnet_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_subnet_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_subnet_factsã€azure_rm_subnet_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_subnet_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:402 +#: ../../rst/porting_guides/porting_guide_7.rst:843 msgid "azure_rm_trafficmanagerendpoint_facts, azure_rm_trafficmanagerendpoint_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_trafficmanagerendpoint_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_trafficmanagerendpoint_factsã€azure_rm_trafficmanagerendpoint_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_trafficmanagerendpoint_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:403 +#: ../../rst/porting_guides/porting_guide_7.rst:844 msgid "azure_rm_trafficmanagerprofile_facts, azure_rm_trafficmanagerprofile_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_trafficmanagerprofile_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_trafficmanagerprofile_factsã€azure_rm_trafficmanagerprofile_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_trafficmanagerprofile_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:404 +#: ../../rst/porting_guides/porting_guide_7.rst:845 msgid "azure_rm_virtualmachine_extension, azure_rm_virtualmachineextension - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachineextension instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachine_extensionã€azure_rm_virtualmachineextension - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachineextension を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:405 +#: ../../rst/porting_guides/porting_guide_7.rst:846 msgid "azure_rm_virtualmachine_facts, azure_rm_virtualmachine_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachine_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachine_factsã€azure_rm_virtualmachine_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachine_info を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:406 +#: ../../rst/porting_guides/porting_guide_7.rst:847 msgid "azure_rm_virtualmachine_scaleset, azure_rm_virtualmachinescaleset - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachinescaleset instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachine_scalesetã€azure_rm_virtualmachinescaleset - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachinescaleset を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:407 +#: ../../rst/porting_guides/porting_guide_7.rst:848 msgid "azure_rm_virtualmachine_scaleset_facts, azure_rm_virtualmachinescaleset_facts, azure_rm_virtualmachinescaleset_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachinescaleset_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachine_scaleset_factsã€azure_rm_virtualmachinescaleset_factsã€azure_rm_virtualmachinescaleset_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachinescaleset_info instead を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:408 +#: ../../rst/porting_guides/porting_guide_7.rst:849 msgid "azure_rm_virtualmachineextension_facts, azure_rm_virtualmachineextension_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachineextension_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachineextension_factsã€azure_rm_virtualmachineextension_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachineextension_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:409 +#: ../../rst/porting_guides/porting_guide_7.rst:850 msgid "azure_rm_virtualmachineimage_facts, azure_rm_virtualmachineimage_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachineimage_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachineimage_factsã€azure_rm_virtualmachineimage_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachineimage_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:410 +#: ../../rst/porting_guides/porting_guide_7.rst:851 msgid "azure_rm_virtualmachinescalesetextension_facts, azure_rm_virtualmachinescalesetextension_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachinescalesetextension_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachinescalesetextension_factsã€azure_rm_virtualmachinescalesetextension_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachinescalesetextension_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:411 +#: ../../rst/porting_guides/porting_guide_7.rst:852 msgid "azure_rm_virtualmachinescalesetinstance_facts, azure_rm_virtualmachinescalesetinstance_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualmachinescalesetinstance_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualmachinescalesetinstance_factsã€azure_rm_virtualmachinescalesetinstance_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualmachinescalesetinstance_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:412 +#: ../../rst/porting_guides/porting_guide_7.rst:853 msgid "azure_rm_virtualnetwork_facts, azure_rm_virtualnetwork_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualnetwork_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualnetwork_factsã€azure_rm_virtualnetwork_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualnetwork_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:413 +#: ../../rst/porting_guides/porting_guide_7.rst:854 msgid "azure_rm_virtualnetworkpeering_facts, azure_rm_virtualnetworkpeering_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_virtualnetworkpeering_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_virtualnetworkpeering_facts, azure_rm_virtualnetworkpeering_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_virtualnetworkpeering_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:414 +#: ../../rst/porting_guides/porting_guide_7.rst:855 msgid "azure_rm_webapp_facts, azure_rm_webapp_info - the deprecated modules have been removed. Use azure.azcollection.azure_rm_webapp_info instead (https://github.com/ansible-collections/community.azure/pull/31)." msgstr "azure_rm_webapp_facts, azure_rm_webapp_info - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« azure.azcollection.azure_rm_webapp_info を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.azure/pull/31)。" -#: ../../rst/porting_guides/porting_guide_7.rst:419 +#: ../../rst/porting_guides/porting_guide_7.rst:860 msgid "Execution Environments built with community.docker no longer include docker-compose < 2.0.0. If you need to use it with the ``docker_compose`` module, please install that requirement manually (https://github.com/ansible-collections/community.docker/pull/400)." msgstr "community.docker ã§ãƒ“ルドã•ã‚ŒãŸå®Ÿè¡Œç’°å¢ƒã«ã¯ã€docker-compose < 2.0.0 ãŒå«ã¾ã‚Œãªããªã‚Šã¾ã—ãŸã€‚``docker_compose`` モジュールã§ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€ãã®è¦ä»¶ã‚’手動ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/400)。" -#: ../../rst/porting_guides/porting_guide_7.rst:420 +#: ../../rst/porting_guides/porting_guide_7.rst:861 msgid "Support for Ansible 2.9 and ansible-base 2.10 has been removed. If you need support for Ansible 2.9 or ansible-base 2.10, please use community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400)." msgstr "Ansible 2.9 ãŠã‚ˆã³ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Ansible 2.9 ã¾ãŸã¯ ansible-base 2.10 ã®ã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ãªå ´åˆã¯ã€community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400) を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_7.rst:421 +#: ../../rst/porting_guides/porting_guide_7.rst:862 msgid "Support for Docker API versions 1.20 to 1.24 has been removed. If you need support for these API versions, please use community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400)." msgstr "Docker API ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.20 ã‹ã‚‰ 1.24 ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“れら㮠API ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ãªå ´åˆã¯ã€community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400) を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_7.rst:422 +#: ../../rst/porting_guides/porting_guide_7.rst:863 msgid "Support for Python 2.6 has been removed. If you need support for Python 2.6, please use community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400)." msgstr "Python 2.6 ã®ã‚µãƒãƒ¼ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚Python 2.6 ã®ã‚µãƒãƒ¼ãƒˆãŒå¿…è¦ãªå ´åˆã¯ã€community.docker 2.x.y (https://github.com/ansible-collections/community.docker/pull/400) を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_7.rst:423 +#: ../../rst/porting_guides/porting_guide_7.rst:864 msgid "Various modules - the default of ``tls_hostname`` (``localhost``) has been removed. If you want to continue using ``localhost``, you need to specify it explicitly (https://github.com/ansible-collections/community.docker/pull/363)." msgstr "ã•ã¾ã–ã¾ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« - ``tls_hostname`` (``localhost``) ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚``localhost`` を引ã続ã使用ã™ã‚‹å ´åˆã¯ã€æ˜Žç¤ºçš„ã«æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.docker/pull/363)。" -#: ../../rst/porting_guides/porting_guide_7.rst:424 +#: ../../rst/porting_guides/porting_guide_7.rst:865 msgid "docker_container - the ``all`` value is no longer allowed in ``published_ports``. Use ``publish_all_ports=true`` instead (https://github.com/ansible-collections/community.docker/pull/399)." msgstr "docker_container - ``all`` ã®å€¤ã¯ ``published_ports`` ã§è¨±å¯ã•ã‚Œãªããªã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« ``publish_all_ports=true`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/399)。" -#: ../../rst/porting_guides/porting_guide_7.rst:425 +#: ../../rst/porting_guides/porting_guide_7.rst:866 msgid "docker_container - the default of ``command_handling`` was changed from ``compatibility`` to ``correct``. Older versions were warning for every invocation of the module when this would result in a change of behavior (https://github.com/ansible-collections/community.docker/pull/399)." msgstr "docker_container - ``command_handling`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆãŒ ``compatibility`` ã‹ã‚‰ ``correct`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚å¤ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€å‹•ä½œã®å¤‰æ›´ã«ã¤ãªãŒã‚‹å ´åˆã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å‘¼ã³å‡ºã—ã”ã¨ã«è¦å‘ŠãŒè¡¨ç¤ºã•ã‚Œã¦ã„ã¾ã—㟠(https://github.com/ansible-collections/community.docker/pull/399)。" -#: ../../rst/porting_guides/porting_guide_7.rst:426 +#: ../../rst/porting_guides/porting_guide_7.rst:867 msgid "docker_stack - the return values ``out`` and ``err`` have been removed. Use ``stdout`` and ``stderr`` instead (https://github.com/ansible-collections/community.docker/pull/363)." msgstr "docker_stack - ``out`` ã¨``err`` ã®æˆ»ã‚Šå€¤ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``stdout`` 㨠``stderr`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/363)。" -#: ../../rst/porting_guides/porting_guide_7.rst:436 +#: ../../rst/porting_guides/porting_guide_7.rst:872 +msgid "bitbucket* modules - ``username`` is no longer an alias of ``workspace``, but of ``user`` (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "bitbucket* modules - ``username`` ã¯ã€``workspace`` ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã¯ãªããªã‚Šã€``user`` ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã¨ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:873 +msgid "gem - the default of the ``norc`` option changed from ``false`` to ``true`` (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "gem - ``norc`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€``false`` ã‹ã‚‰ ``true`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:874 +msgid "gitlab_group_members - ``gitlab_group`` must now always contain the full path, and no longer just the name or path (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "gitlab_group_members - ``gitlab_group`` ã¯ã€å˜ã«åå‰ã¨ãƒ‘スã ã‘ã§ãªãã€ä»Šå¾Œã¯å¸¸ã«ãƒ•ãƒ«ãƒ‘スをå«ã‚€å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:875 +msgid "keycloak_authentication - the return value ``flow`` has been removed. Use ``end_state`` instead (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "keycloak_authentication - 戻り値 ``flow`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``end_state`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:876 +msgid "keycloak_group - the return value ``group`` has been removed. Use ``end_state`` instead (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "keycloak_group - 戻り値 ``group`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``end_state`` を使用ã—ã¦ãã ã•ã„(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:877 +msgid "lxd_container - the default of the ``ignore_volatile_options`` option changed from ``true`` to ``false`` (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "lxd_container - ``ignore_volatile_options`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€``true`` ã‹ã‚‰ ``false`` ã«å¤‰æ›´ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:878 +msgid "mail callback plugin - the ``sender`` option is now required (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "mail callback plugin - ``sender`` オプションãŒå¿…è¦ã«ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:879 +msgid "module_helper module utils - remove the ``VarDict`` attribute from ``ModuleHelper``. Import ``VarDict`` from ``ansible_collections.community.general.plugins.module_utils.mh.mixins.vars`` instead (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "module_helper module utils - ``ModuleHelper`` ã‹ã‚‰ ``VarDict`` 属性を削除ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ansible_collections.community.general.plugins.module_utils.mh.mixins.vars`` ã‹ã‚‰ ``VarDict`` をインãƒãƒ¼ãƒˆã—ã¾ã™ (https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:880 +msgid "proxmox inventory plugin - the default of the ``want_proxmox_nodes_ansible_host`` option changed from ``true`` to ``false`` (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "proxmox inventory plugin - ``want_proxmox_nodes_ansible_host`` オプションã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ã€``true`` ã‹ã‚‰ ``false`` ã«å¤‰æ›´ã•ã‚ŒãŸã¾ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:881 +msgid "vmadm - the ``debug`` option has been removed. It was not used anyway (https://github.com/ansible-collections/community.general/pull/5326)." +msgstr "vmadm - ``debug``オプションãŒå‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚ã“ã‚Œã¯ä½¿ç”¨ã•ã‚Œã¦ã„ã¾ã›ã‚“ã§ã—㟠(https://github.com/ansible-collections/community.general/pull/5326)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:902 +msgid "vca_fw - The deprecated module ``vca_fw`` has been removed." +msgstr "vca_fw - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vca_fw`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:903 +msgid "vca_nat - The deprecated module ``vca_nat`` has been removed." +msgstr "vca_nat - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«``vca_nat`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:904 +msgid "vca_vapp - The deprecated module ``vca_vapp`` has been removed." +msgstr "vca_vapp - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«``vca_vapp`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:905 +msgid "vmware_dns_config - The deprecated module ``vmware_dns_config`` has been removed, you can use ``vmware_host_dns`` instead." +msgstr "vmware_dns_config - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_dns_config`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``vmware_host_dns`` を使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:906 +msgid "vmware_guest_network - The deprecated parameter ``networks`` has been removed, use loops to handle multiple interfaces (https://github.com/ansible-collections/community.vmware/pull/1459)." +msgstr "vmware_guest_network - éžæŽ¨å¥¨ã®ãƒ‘ラメーター ``networks`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚複数ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ã‚¤ã‚¹ã‚’処ç†ã™ã‚‹å ´åˆã¯ãƒ«ãƒ¼ãƒ—を使用ã—ã¾ã™ (https://github.com/ansible-collections/community.vmware/pull/1459)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:907 +msgid "vmware_guest_vnc - The deprecated module ``vmware_guest_vnc`` has been removed. The VNC support has been dropped with vSphere 7 and later (https://github.com/ansible-collections/community.vmware/pull/1454)." +msgstr "vmware_guest_vnc - éžæŽ¨å¥¨ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ« ``vmware_guest_vnc`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚VNC ã®ã‚µãƒãƒ¼ãƒˆã¯ vSphere 7 以é™ã§åœæ¢ã•ã‚Œã¾ã—㟠(https://github.com/ansible-collections/community.vmware/pull/1454)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:908 +msgid "vmware_host_firewall_manager - The module doesn't accept a list for ``allowed_hosts`` anymore, use a dict instead. Additionally, ``all_ip`` is now a required sub-option of ``allowed_hosts`` (https://github.com/ansible-collections/community.vmware/pull/1463)." +msgstr "vmware_host_firewall_manager - ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ ``allowed_hosts`` ã®ãƒªã‚¹ãƒˆã‚’å—ã‘付ã‘ãªããªã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« dict を使ã£ã¦ãã ã•ã„。ã•ã‚‰ã«ã€``all_ip`` 㯠``allowed_hosts`` ã®å¿…é ˆã‚µãƒ–ã‚ªãƒ—ã‚·ãƒ§ãƒ³ã¨ãªã‚Šã¾ã—㟠(https://github.com/ansible-collections/community.vmware/pull/1463)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:909 +msgid "vsphere_copy - The deprecated parameters ``host`` and ``login`` have been removed. Use ``hostname`` and ``username`` instead (https://github.com/ansible-collections/community.vmware/pull/1456)." +msgstr "vsphere_copy - éžæŽ¨å¥¨ã®ãƒ‘ラメーター ``host`` ãŠã‚ˆã³ ``login`` ã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚代ã‚ã‚Šã« ``hostname`` 㨠``username`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.vmware/pull/1456)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:914 +msgid "Remove following deprecated Junos Modules." +msgstr "以下ã®éžæŽ¨å¥¨ã® Junos モジュールを削除ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:915 +msgid "junos_interface" +msgstr "junos_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:916 +msgid "junos_l2_interface" +msgstr "junos_l2_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:917 +msgid "junos_l3_interface" +msgstr "junos_l3_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:918 +msgid "junos_linkagg" +msgstr "junos_linkagg" + +#: ../../rst/porting_guides/porting_guide_7.rst:919 +msgid "junos_lldp" +msgstr "junos_lldp" + +#: ../../rst/porting_guides/porting_guide_7.rst:920 +msgid "junos_lldp_interface" +msgstr "junos_lldp_interface" + +#: ../../rst/porting_guides/porting_guide_7.rst:921 +msgid "junos_static_route" +msgstr "junos_static_route" + +#: ../../rst/porting_guides/porting_guide_7.rst:922 +msgid "junos_vlan" +msgstr "junos_vlan" + +#: ../../rst/porting_guides/porting_guide_7.rst:927 +msgid "vyos_interface - use vyos_interfaces instead." +msgstr "vyos_interface - 代ã‚ã‚Šã« vyos_interfaces を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:928 +msgid "vyos_l3_interface - use vyos_l3_interfaces instead." +msgstr "vyos_l3_interface - 代ã‚ã‚Šã« vyos_l3_interfaces を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:929 +msgid "vyos_linkagg - use vyos_lag_interfaces instead." +msgstr "vyos_linkagg - 代ã‚ã‚Šã« vyos_lag_interfaces を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:930 +msgid "vyos_lldp - use vyos_lldp_global instead." +msgstr "vyos_lldp - 代ã‚ã‚Šã« vyos_lldp_global を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:931 +msgid "vyos_lldp_interface - use vyos_lldp_interfaces instead." +msgstr "vyos_lldp_interface - 代ã‚ã‚Šã« vyos_lldp_interfaces を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:932 +msgid "vyos_static_route - use vyos_static_routes instead." +msgstr "vyos_static_route - 代ã‚ã‚Šã« vyos_static_routes を使用ã—ã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:946 msgid "Deprecate ability of lookup plugins to return arbitrary data. Lookup plugins must return lists, failing to do so will be an error in 2.18. (https://github.com/ansible/ansible/issues/77788)" msgstr "ルックアッププラグインãŒä»»æ„ã®ãƒ‡ãƒ¼ã‚¿ã‚’è¿”ã™æ©Ÿèƒ½ã‚’éžæŽ¨å¥¨ã«ã—ã¾ã™ã€‚ルックアッププラグインã¯ãƒªã‚¹ãƒˆã‚’è¿”ã™å¿…è¦ãŒã‚ã‚Šã€å¤±æ•—ã™ã‚‹ã¨ 2.18 ã§ã¯ã‚¨ãƒ©ãƒ¼ã«ãªã‚Šã¾ã™ (https://github.com/ansible/ansible/issues/77788)。" -#: ../../rst/porting_guides/porting_guide_7.rst:437 +#: ../../rst/porting_guides/porting_guide_7.rst:947 msgid "Encryption - Deprecate use of the Python crypt module due to it's impending removal from Python 3.13" msgstr "encryption - Python crypt モジュール㌠Python 3.13 ã‹ã‚‰é–“ã‚‚ãªã削除ã•ã‚Œã‚‹ãŸã‚ã€ä½¿ç”¨ã‚’éžæŽ¨å¥¨ã¨ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:438 +#: ../../rst/porting_guides/porting_guide_7.rst:948 msgid "PlayContext.verbosity is deprecated and will be removed in 2.18. Use ansible.utils.display.Display().verbosity as the single source of truth." msgstr "PlayContext.verbosity ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2.18 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚ä¿¡é ¼ã§ãる唯一ã®ã‚½ãƒ¼ã‚¹ã¨ã—㦠ansible.utils.display.Display().verbosity を使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_7.rst:439 +#: ../../rst/porting_guides/porting_guide_7.rst:949 msgid "``DEFAULT_FACT_PATH``, ``DEFAULT_GATHER_SUBSET`` and ``DEFAULT_GATHER_TIMEOUT`` are deprecated and will be removed in 2.18. Use ``module_defaults`` keyword instead." msgstr "``DEFAULT_FACT_PATH``ã€``DEFAULT_GATHER_SUBSET``ã€ãŠã‚ˆã³ ``DEFAULT_GATHER_TIMEOUT`` ã¯éžæŽ¨å¥¨ã§ã‚ã‚Šã€2.18 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚代ã‚ã‚Šã« ``module_defaults`` ã‚ーワードを使用ã—ã¦ãã ã•ã„。" -#: ../../rst/porting_guides/porting_guide_7.rst:440 +#: ../../rst/porting_guides/porting_guide_7.rst:950 msgid "``PlayIterator`` - deprecate ``cache_block_tasks`` and ``get_original_task`` which are noop and unused." msgstr "``PlayIterator`` - noop ãŠã‚ˆã³æœªä½¿ç”¨ã® ``cache_block_tasks`` ãŠã‚ˆã³ ``get_original_task`` ã‚’éžæŽ¨å¥¨ã«ã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:441 +#: ../../rst/porting_guides/porting_guide_7.rst:951 msgid "``Templar`` - deprecate ``shared_loader_obj`` option which is unused. ``ansible.plugins.loader`` is used directly instead." msgstr "``Templar`` - 未使用㮠``shared_loader_obj`` オプションをéžæŽ¨å¥¨ã«ã—ã¾ã™ã€‚代ã‚ã‚Šã« ``ansible.plugins.loader`` ãŒç›´æŽ¥ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:442 +#: ../../rst/porting_guides/porting_guide_7.rst:952 msgid "listify_lookup_plugin_terms, deprecate 'loader/dataloader' parameter as it not used." msgstr "listify_lookup_plugin_termsã€loader/dataloader パラメーターã¯ä½¿ç”¨ã•ã‚Œã¦ã„ãªã„ãŸã‚ã€éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:443 +#: ../../rst/porting_guides/porting_guide_7.rst:953 msgid "vars plugins - determining whether or not to run ansible.legacy vars plugins with the class attribute REQUIRES_WHITELIST is deprecated, set REQUIRES_ENABLED instead." msgstr "vars プラグイン - クラス属性 REQUIRES_WHITELIST を使用ã—㦠ansible.legacy vars プラグインを実行ã™ã‚‹ã‹ã©ã†ã‹ã‚’判別ã—ã¾ã™ã€‚ã“ã®å±žæ€§ãŒéžæŽ¨å¥¨ã¨ãªã£ã¦ã„ã‚‹å ´åˆã¯ã€ä»£ã‚ã‚Šã« REQUIRES_ENABLED ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:448 +#: ../../rst/porting_guides/porting_guide_7.rst:958 +msgid "amazon.aws collection - Support for the ``EC2_ACCESS_KEY`` environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use the ``access_key`` parameter or ``AWS_ACCESS_KEY_ID`` environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``EC2_ACCESS_KEY`` 環境変数ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024-12-01 より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``access_key`` パラメーターã¾ãŸã¯ ``AWS_ACCESS_KEY_ID`` 環境変数をã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:959 +msgid "amazon.aws collection - Support for the ``EC2_REGION`` environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use the ``region`` parameter or ``AWS_REGION`` environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``EC2_REGION`` 環境変数ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024-12-01 より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``region`` パラメーターã¾ãŸã¯ ``AWS_REGION`` 環境変数をã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:960 +msgid "amazon.aws collection - Support for the ``EC2_SECRET_KEY`` environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use the ``secret_key`` parameter or ``AWS_SECRET_ACCESS_KEY`` environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``EC2_SECRET_KEY`` 環境変数ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024-12-01 より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``secret_key`` パラメーターã¾ãŸã¯ ``AWS_SECRET_ACCESS_KEY`` 環境変数をã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:961 +msgid "amazon.aws collection - Support for the ``EC2_SECURITY_TOKEN`` environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use the ``session_token`` parameter or ``AWS_SESSION_TOKEN`` environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``EC2_SECURITY_TOKEN`` 環境変数ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024-12-01 より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``session_token`` パラメーターã¾ãŸã¯ ``AWS_SESSION_TOKEN`` 環境変数をã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:962 +msgid "amazon.aws collection - Support for the ``EC2_URL`` and ``S3_URL`` environment variables has been deprecated and will be removed in a release after 2024-12-01. Please use the ``endpoint_url`` parameter or ``AWS_ENDPOINT_URL`` environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``EC2_URL`` ãŠã‚ˆã³ ``S3_URL`` 環境変数ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024-12-01 より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``endpoint_url`` パラメーターã¾ãŸã¯ ``AWS_ENDPOINT_URL`` 環境変数をã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:963 +msgid "amazon.aws collection - The ``access_token`` alias for the ``session_token`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``session_token`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``session_token`` パラメーター㮠``access_token`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``session_token`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:964 +msgid "amazon.aws collection - The ``aws_security_token`` alias for the ``session_token`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``session_token`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``session_token`` パラメーター㮠``aws_security_token`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``session_token`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:965 +msgid "amazon.aws collection - The ``ec2_access_key`` alias for the ``access_key`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``access_key`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``access_key`` パラメーター㮠``ec2_access_key`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``access_key`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:966 +msgid "amazon.aws collection - The ``ec2_region`` alias for the ``region`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``region`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``region`` パラメーター㮠``ec2_region`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``region`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:967 +msgid "amazon.aws collection - The ``ec2_secret_key`` alias for the ``secret_key`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``secret_key`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``secret_key`` パラメーター㮠``ec2_secret_key`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``secret_key`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:968 +msgid "amazon.aws collection - The ``security_token`` alias for the ``session_token`` parameter has been deprecated and will be removed in a release after 2024-12-01. Please use the ``session_token`` name instead (https://github.com/ansible-collections/amazon.aws/pull/1172)." +msgstr "amazon.aws コレクション - ``session_token`` パラメーター㮠``security_token`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 12 月 1 日より後ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚代ã‚ã‚Šã« ``session_token`` åã‚’ã”利用ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/1172)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:969 msgid "amazon.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection has been deprecated and will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/amazon.aws/pull/935)." msgstr "amazon.aws コレクション - Python ã® ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.7 未満ã®ã‚µãƒãƒ¼ãƒˆçµ‚了を通知ã™ã‚‹ AWS SDK ã«ã‚ˆã‚Š (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)ã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ã‚ˆã‚‹ Python ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.7 未満ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2023 å¹´ 6 月 1 日以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ (https://github.com/ansible-collections/amazon.aws/pull/935)。" -#: ../../rst/porting_guides/porting_guide_7.rst:449 +#: ../../rst/porting_guides/porting_guide_7.rst:970 msgid "aws_s3 - The ``S3_URL`` alias for the s3_url option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "aws_s3 - s3_url オプション㮠``S3_URL`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:450 +#: ../../rst/porting_guides/porting_guide_7.rst:971 msgid "ec2_ami - The ``DeviceName`` alias for the device_name option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "ec2_ami - device_name オプション㮠``DeviceName`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:451 +#: ../../rst/porting_guides/porting_guide_7.rst:972 msgid "ec2_ami - The ``NoDevice`` alias for the no_device option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "ec2_ami - no_device オプション㮠``NoDevice`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:452 +#: ../../rst/porting_guides/porting_guide_7.rst:973 msgid "ec2_ami - The ``VirtualName`` alias for the virtual_name option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "ec2_ami - virtual_name オプション㮠``VirtualName`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:453 +#: ../../rst/porting_guides/porting_guide_7.rst:974 msgid "ec2_ami - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/846)." msgstr "ec2_ami - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/846)。" -#: ../../rst/porting_guides/porting_guide_7.rst:455 +#: ../../rst/porting_guides/porting_guide_7.rst:976 msgid "ec2_instance - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/849)." msgstr "ec2_instance - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/849)。" -#: ../../rst/porting_guides/porting_guide_7.rst:456 +#: ../../rst/porting_guides/porting_guide_7.rst:977 msgid "ec2_key - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/846)." msgstr "ec2_key - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/846)。" -#: ../../rst/porting_guides/porting_guide_7.rst:457 +#: ../../rst/porting_guides/porting_guide_7.rst:978 +msgid "ec2_security_group - support for passing nested lists to ``cidr_ip`` and ``cidr_ipv6`` has been deprecated. Nested lists can be passed through the ``flatten`` filter instead ``cidr_ip: '{{ my_cidrs | flatten }}'`` (https://github.com/ansible-collections/amazon.aws/pull/1213)." +msgstr "ec2_security_group - ãƒã‚¹ãƒˆã•ã‚ŒãŸãƒªã‚¹ãƒˆã‚’ ``cidr_ip`` ãŠã‚ˆã³ ``cidr_ipv6`` ã¸æ¸¡ã™ãŸã‚ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚ãƒã‚¹ãƒˆã•ã‚ŒãŸãƒªã‚¹ãƒˆã¯ã€ä»£ã‚ã‚Šã« ``flatten`` フィルターを通ã˜ã¦æ¸¡ã™ã“ã¨ãŒã§ãã¾ã™ ``cidr_ip: '{{ my_cidrs | flatten }}'`` (https://github.com/ansible-collections/amazon.aws/pull/1213)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:979 msgid "ec2_vol - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/846)." msgstr "ec2_vol - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/846)。" -#: ../../rst/porting_guides/porting_guide_7.rst:458 +#: ../../rst/porting_guides/porting_guide_7.rst:980 msgid "ec2_vpc_dhcp_option_info - The ``DhcpOptionIds`` alias for the dhcp_option_ids option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "ec2_vpc_dhcp_option_info - dhcp_option_ids オプション㮠``DhcpOptionIds`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:459 +#: ../../rst/porting_guides/porting_guide_7.rst:981 msgid "ec2_vpc_dhcp_option_info - The ``DryRun`` alias for the dry_run option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "ec2_vpc_dhcp_option_info - dry_run オプション㮠``DryRun`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:460 +#: ../../rst/porting_guides/porting_guide_7.rst:982 msgid "ec2_vpc_endpoint - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/846)." msgstr "ec2_vpc_endpoint - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/846)。" -#: ../../rst/porting_guides/porting_guide_7.rst:461 +#: ../../rst/porting_guides/porting_guide_7.rst:983 msgid "ec2_vpc_net - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/848)." msgstr "ec2_vpc_net - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/848)。" -#: ../../rst/porting_guides/porting_guide_7.rst:462 +#: ../../rst/porting_guides/porting_guide_7.rst:984 msgid "ec2_vpc_route_table - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True`` (https://github.com/ansible-collections/amazon.aws/pull/846)." msgstr "ec2_vpc_route_table - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/846)。" -#: ../../rst/porting_guides/porting_guide_7.rst:463 +#: ../../rst/porting_guides/porting_guide_7.rst:985 +msgid "inventory/aws_ec2 - the ``include_extra_api_calls`` is now deprecated, its value is silently ignored (https://github.com/ansible-collections/amazon.aws/pull/1097)." +msgstr "inventory/aws_ec2 - ``include_extra_api_calls`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚ãã®å€¤ã¯ã‚µã‚¤ãƒ¬ãƒ³ãƒˆã«ç„¡è¦–ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/1097)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:986 msgid "module_utils.cloud - removal of the ``CloudRetry.backoff`` has been delayed until release 6.0.0. It is recommended to update custom modules to use ``jittered_backoff`` or ``exponential_backoff`` instead (https://github.com/ansible-collections/amazon.aws/pull/951)." msgstr "module_utils.cloud - ``CloudRetry.backoff`` ã®å‰Šé™¤ã¯ã€ãƒªãƒªãƒ¼ã‚¹ 6.0.0 ã¾ã§å»¶æœŸã¨ãªã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« ``jittered_backoff`` ã¾ãŸã¯ ``exponential_backoff`` を使用ã™ã‚‹ã‚ˆã†ã«ã‚«ã‚¹ã‚¿ãƒ モジュールを更新ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/amazon.aws/pull/951)。" -#: ../../rst/porting_guides/porting_guide_7.rst:464 +#: ../../rst/porting_guides/porting_guide_7.rst:987 +msgid "module_utils.url - ``ansible_collections.amazon.aws.module_utils.urls`` is believed to be unused and has been deprecated and will be removed in release 7.0.0." +msgstr "module_utils.url - ``ansible_collections.amazon.aws.module_utils.urls`` ã¯ã€ä½¿ç”¨ã•ã‚Œã¦ã„ãªã„ã¨è€ƒãˆã‚‰ã‚Œã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 7.0.0 ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:988 msgid "s3_bucket - The ``S3_URL`` alias for the s3_url option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795)." msgstr "s3_bucket - s3_url オプション㮠``S3_URL`` エイリアスã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/795)。" -#: ../../rst/porting_guides/porting_guide_7.rst:465 +#: ../../rst/porting_guides/porting_guide_7.rst:989 msgid "s3_object - Support for creation and deletion of S3 buckets has been deprecated. Please use the ``amazon.aws.s3_bucket`` module to create and delete buckets (https://github.com/ansible-collections/amazon.aws/pull/869)." msgstr "s3_object - S3 ãƒã‚±ãƒƒãƒˆã®ä½œæˆãŠã‚ˆã³å‰Šé™¤ã®ã‚µãƒãƒ¼ãƒˆãŒéžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚ãƒã‚±ãƒƒãƒˆã®ä½œæˆã¨å‰Šé™¤ã«ã¯ã€``amazon.aws.s3_bucket`` モジュールを使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/amazon.aws/pull/869)。" -#: ../../rst/porting_guides/porting_guide_7.rst:475 +#: ../../rst/porting_guides/porting_guide_7.rst:1004 msgid "aws_acm - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "aws_acm - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:477 +#: ../../rst/porting_guides/porting_guide_7.rst:1006 msgid "aws_glue_connection - the ``connection_parameters`` return key has been deprecated and will be removed in a release after 2024-06-01, it is being replaced by the ``raw_connection_parameters`` key (https://github.com/ansible-collections/community.aws/pull/518)." msgstr "aws_glue_connection - ``connection_parameters`` ã®æˆ»ã‚Šã‚ーã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2024 å¹´ 06 月 01 以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã€``raw_connection_parameters`` ã‚ーã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/518)。" -#: ../../rst/porting_guides/porting_guide_7.rst:478 +#: ../../rst/porting_guides/porting_guide_7.rst:1007 msgid "aws_kms - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "aws_kms - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:479 +#: ../../rst/porting_guides/porting_guide_7.rst:1008 msgid "cloudfront_distribution - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "cloudfront_distribution - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:480 +#: ../../rst/porting_guides/porting_guide_7.rst:1009 msgid "community.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection has been deprecated and will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/community.aws/pull/1361)." msgstr "community.aws コレクション - Python ã® ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.7 未満ã®ã‚µãƒãƒ¼ãƒˆçµ‚了を通知ã™ã‚‹ AWS SDK ã«ã‚ˆã‚Š (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)ã€ã“ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«ã‚ˆã‚‹ Python ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.7 未満ã®ã‚µãƒãƒ¼ãƒˆã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€2023 å¹´ 6 月 1 日以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹äºˆå®šã§ã™ (https://github.com/ansible-collections/community.aws/pull/1361)。" -#: ../../rst/porting_guides/porting_guide_7.rst:481 +#: ../../rst/porting_guides/porting_guide_7.rst:1010 msgid "ec2_vpc_vpn - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "ec2_vpc_vpn - ``purge_tags`` ã®ç¾åœ¨ã® ``False`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:482 +#: ../../rst/porting_guides/porting_guide_7.rst:1011 msgid "iam_policy - the ``policies`` return value has been renamed ``policy_names`` and will be removed in a release after 2024-08-01, both values are currently returned (https://github.com/ansible-collections/community.aws/pull/1375)." msgstr "iam_policy - ``policies`` ã®æˆ»ã‚Šå€¤ã®åå‰ãŒ ``policy_names`` ã«å¤‰æ›´ã•ã‚Œã¾ã—ãŸã€‚2024 å¹´ 8 月 2 日以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã‚‹ãŸã‚ã€ç¾åœ¨ã¯ä¸¡æ–¹ã®å€¤ãŒè¿”ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1375)。" -#: ../../rst/porting_guides/porting_guide_7.rst:483 +#: ../../rst/porting_guides/porting_guide_7.rst:1012 msgid "lambda_info - The ``function`` return key returns a dictionary of dictionaries and has been deprecated. In a release after 2025-01-01, this key will be removed in favor of ``functions``, which returns a list of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239)." msgstr "lambda_info - ã®``function`` リターンã‚ーã¯è¤‡æ•°ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ã†ã¡ã® 1 ã¤ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã‚’è¿”ã—ã¾ã™ãŒã€éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚2025 å¹´ 1 月 2 日以é™ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒªã‚¹ãƒˆã‚’返㙠``functions`` を優先ã—ã¦ã€ã“ã®ã‚ーã¯å‰Šé™¤ã•ã‚Œã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1239)。" -#: ../../rst/porting_guides/porting_guide_7.rst:484 +#: ../../rst/porting_guides/porting_guide_7.rst:1013 msgid "rds_param_group - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "rds_param_group - ``purge_tags`` ã®ç¾åœ¨ã® ``False`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:485 +#: ../../rst/porting_guides/porting_guide_7.rst:1014 msgid "route53_health_check - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "route53_health_check - ``purge_tags`` ã®ç¾åœ¨ã® ``False`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:486 +#: ../../rst/porting_guides/porting_guide_7.rst:1015 msgid "route53_info - The CamelCase return values for ``DelegationSets``, ``CheckerIpRanges``, and ``HealthCheck`` have been deprecated, in the future release you must use snake_case return values ``delegation_sets``, ``checker_ip_ranges``, and ``health_check`` instead respectively\" (https://github.com/ansible-collections/community.aws/pull/1322)." msgstr "route53_info - ``DelegationSets``ã€``CheckerIpRanges`` ã® CamelCase ã®æˆ»ã‚Šå€¤ãŠã‚ˆã³ ``HealthCheck`` ãŒéžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚今後ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€ä»£ã‚ã‚Šã« ``delegation_sets``ã€``checker_ip_ranges`` ã® snake_case ã®æˆ»ã‚Šå€¤ãŠã‚ˆã³ ``health_check`` ã‚’ãã‚Œãžã‚Œä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ (https://github.com/ansible-collections/community.aws/pull/1322)。" -#: ../../rst/porting_guides/porting_guide_7.rst:488 +#: ../../rst/porting_guides/porting_guide_7.rst:1017 msgid "route53_zone - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "route53_zone - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/porting_guides/porting_guide_7.rst:489 +#: ../../rst/porting_guides/porting_guide_7.rst:1018 msgid "sqs_queue - the current default value of ``False`` for ``purge_tags`` has been deprecated and will be updated in release 5.0.0 to ``True``." msgstr "sqs_queue - ``purge_tags`` ã®ç¾åœ¨ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆå€¤ ``False`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€ãƒªãƒªãƒ¼ã‚¹ 5.0.0 㧠``True`` ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚" +#: ../../rst/porting_guides/porting_guide_7.rst:1030 +msgid "docker_container - the ``ignore_image`` option is deprecated and will be removed in community.docker 4.0.0. Use ``image: ignore`` in ``comparisons`` instead (https://github.com/ansible-collections/community.docker/pull/487)." +msgstr "docker_container -``ignore_image`` オプションã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.docker 4.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚代ã‚ã‚Šã« ``comparisons`` ã§ã¯ ``image: ignore`` を使用ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/487)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:1031 +msgid "docker_container - the ``purge_networks`` option is deprecated and will be removed in community.docker 4.0.0. Use ``networks: strict`` in ``comparisons`` instead, and make sure to provide ``networks``, with value ``[]`` if all networks should be removed (https://github.com/ansible-collections/community.docker/pull/487)." +msgstr "docker_container -``purge_networks`` オプションã¯éžæŽ¨å¥¨ã¨ãªã‚Šã€community.docker 4.0.0 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚代ã‚ã‚Šã« ``comparisons`` ã§ã¯ ``networks: strict`` を使用ã—ã¦ãã ã•ã„。ã¾ãŸã€ã™ã¹ã¦ã®ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯ã‚’削除ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ ``[]`` ã®å€¤ã§ ``networks`` ã‚’å¿…ãšæä¾›ã—ã¦ãã ã•ã„ (https://github.com/ansible-collections/community.docker/pull/487)。" + +#: ../../rst/porting_guides/porting_guide_7.rst:1044 +msgid "gconftool2 - deprecates ``state=get`` in favor of using the module ``gconftool2_info`` (https://github.com/ansible-collections/community.general/pull/4778)." +msgstr "gconftool2 - モジュール ``gconftool2_info`` (https://github.com/ansible-collections/community.general/pull/4778) を使用ã™ã‚‹ãŸã‚ã€``state=get`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã™ã€‚" + +#: ../../rst/porting_guides/porting_guide_7.rst:1048 +msgid "xfconf - deprecated parameter ``disable_facts``, as since version 4.0.0 it only allows value ``true`` (https://github.com/ansible-collections/community.general/pull/4520)." +msgstr "xfconf - ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 4.0.0 以é™ã€å€¤ ``true`` (https://github.com/ansible-collections/community.general/pull/4520) ã—ã‹è¨±å¯ã•ã‚Œãªã„ãŸã‚ã€ãƒ‘ラメーター ``disable_facts`` ã¯éžæŽ¨å¥¨ã¨ãªã‚Šã¾ã—ãŸã€‚" + #: ../../rst/porting_guides/porting_guide_base_2.10.rst:6 msgid "Ansible-base 2.10 Porting Guide" msgstr "Ansible-base 2.10 移æ¤ã‚¬ã‚¤ãƒ‰" @@ -12359,7 +13732,7 @@ msgstr "本ガイドã¯ã€ã“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® Ansible-base ã§å‹•ä½œã™ã‚‹ã #: ../../rst/porting_guides/porting_guide_base_2.10.rst:16 msgid "We suggest you read this page along with the `Ansible-base Changelog for 2.10 <https://github.com/ansible/ansible/blob/stable-2.10/changelogs/CHANGELOG-v2.10.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible-base Changelog for 2.10 <https://github.com/ansible/ansible/blob/stable-2.10/changelogs/CHANGELOG-v2.10.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`Ansible-base Changelog for 2.10 <https://github.com/ansible/ansible/blob/stable-2.10/changelogs/CHANGELOG-v2.10.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_base_2.10.rst:18 msgid "Ansible-base is mainly of interest for developers and users who only want to use a small, controlled subset of the available collections. Regular users should install ansible." @@ -12373,7 +13746,7 @@ msgstr "移æ¤ã‚¬ã‚¤ãƒ‰ã®å®Œå…¨ãªãƒªã‚¹ãƒˆã¯ã€ã€Œ:ref:`porting guides <porti #: ../../rst/porting_guides/porting_guide_base_2.10.rst:23 #: ../../rst/porting_guides/porting_guide_core_2.11.rst:18 msgid "Contents" -msgstr "内容" +msgstr "コンテンツ" #: ../../rst/porting_guides/porting_guide_core_2.11.rst:6 msgid "Ansible-core 2.11 Porting Guide" @@ -12407,6 +13780,10 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€``ansible-core`` 2.11 ã‹ã‚‰ ``ansible-cor msgid "We suggest you read this page along with `ansible-core Changelog for 2.12 <https://github.com/ansible/ansible/blob/stable-2.12/changelogs/CHANGELOG-v2.12.rst>`_ to understand what updates you may need to make." msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`ansible-core Changelog for 2.12 <https://github.com/ansible/ansible/blob/stable-2.12/changelogs/CHANGELOG-v2.12.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +#: ../../rst/porting_guides/porting_guide_core_2.12.rst:115 +msgid "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, for example ``bcrypt_sha256`` now default to the \"2b\" format and if the \"2a\" format is required it must be specified." +msgstr "``password_hash``` now uses ``passlib`` defaults when an option is unspecified, for example ``bcrypt_sha256`` ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€Œ2bã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã«ãªã‚Šã€ã€Œ2aã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆãŒå¿…è¦ãªå ´åˆã¯æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" + #: ../../rst/porting_guides/porting_guide_core_2.13.rst:6 msgid "Ansible-core 2.13 Porting Guide" msgstr "Ansible-core 2.13 移æ¤ã‚¬ã‚¤ãƒ‰" @@ -12417,7 +13794,7 @@ msgstr "ã“ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€``ansible-core`` 2.12 㨠``ansible-core`` #: ../../rst/porting_guides/porting_guide_core_2.13.rst:12 msgid "We suggest you read this page along with `ansible-core Changelog for 2.13 <https://github.com/ansible/ansible/blob/stable-2.13/changelogs/CHANGELOG-v2.13.rst>`_ to understand what updates you may need to make." -msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`ansible-core Changelog for 2.13 <https://github.com/ansible/ansible/blob/stable-2.13/changelogs/CHANGELOG-v2.13.rst>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" +msgstr "å¿…è¦ãªæ›´æ–°ã«ã¤ã„ã¦ç†è§£ã™ã‚‹ã«ã¯ã€ã“ã®ãƒšãƒ¼ã‚¸ã¨ä½µã›ã¦ã€Œ`ansible-core Changelog for 2.13 <https://github.com/ansible/ansible/blob/stable-2.13/changelogs/CHANGELOG-v2.13.rst>`_ã€ã‚’å‚ç…§ã™ã‚‹ã“ã¨ã‚’ãŠå‹§ã‚ã—ã¾ã™ã€‚" #: ../../rst/porting_guides/porting_guide_core_2.14.rst:6 msgid "Ansible-core 2.14 Porting Guide" @@ -12454,4 +13831,7 @@ msgstr "本セクションã§ã¯ã€Ansible ã®ã‚ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‹ã‚‰æ¬¡ã®ã #~ msgid "The configuration system now validates the ``choices`` field, so any settings that currently violate it and are currently ignored will now cause an error. For example, `ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH=0` will now cause an error (valid choices are 'ignore', 'warn' or 'error')." #~ msgstr "è¨å®šã‚·ã‚¹ãƒ†ãƒ 㯠``choices`` フィールドを検証ã™ã‚‹ãŸã‚ã€ç¾åœ¨ãã‚Œã«é•åã—ã¦ã„ã‚‹è¨å®šãŒã‚ã‚‹ã¨ã‚¨ãƒ©ãƒ¼ãŒç”Ÿã˜ã¾ã™ã€‚ãŸã¨ãˆã°ã€`ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH=0` ã‚’é¸æŠžã™ã‚‹ã¨ã€ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã—ã¾ã™ (有効ãªé¸æŠžè‚¢ã¯ã€Œignoreã€ã€ã€Œwarnã€ã€ã¾ãŸã¯ã€Œerrorã€ã§ã™)。" +#~ msgid "delegate_to vs ProxyCommand" +#~ msgstr "delegate_to 対 ProxyCommand" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/reference_appendices.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/reference_appendices.po index 5d706d0e..d06d1e91 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/reference_appendices.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/reference_appendices.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/reference_appendices/YAMLSyntax.rst:5 msgid "YAML Syntax" @@ -45,194 +45,194 @@ msgid "There's another small quirk to YAML. All YAML files (regardless of their msgstr "YAML ã«ã¯ã€ä»–ã«ã‚‚ã‚ãšã‹ãªç‰¹å¾´ãŒã‚ã‚Šã¾ã™ã€‚YAML ファイルã¯ã™ã¹ã¦ (Ansible ã¨ã®é–¢ä¿‚ã®æœ‰ç„¡ã«é–¢ä¿‚ãªã)ã€å¿…è¦ã«å¿œã˜ã¦ ``---`` ã§é–‹å§‹ã—㦠``...`` ã§çµ‚ã‚らã›ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€YAML å½¢å¼ã®ä¸€éƒ¨ã§ã€ãƒ‰ã‚ュメントã®æœ€åˆã¨æœ€å¾Œã‚’示ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/YAMLSyntax.rst:29 -msgid "All members of a list are lines beginning at the same indentation level starting with a ``\"- \"`` (a dash and a space)::" -msgstr "リストã®ãƒ¡ãƒ³ãƒãƒ¼ã¯ã™ã¹ã¦åŒã˜ã‚¤ãƒ³ãƒ‡ãƒ³ãƒˆãƒ¬ãƒ™ãƒ«ã§ã€``\"- \"`` (ダッシュã¨ã‚¹ãƒšãƒ¼ã‚¹) ã§é–‹å§‹ã™ã‚‹è¡Œã«ãªã‚Šã¾ã™::" +msgid "All members of a list are lines beginning at the same indentation level starting with a ``\"- \"`` (a dash and a space):" +msgstr "リストã®ãƒ¡ãƒ³ãƒãƒ¼ã¯ã™ã¹ã¦åŒã˜ã‚¤ãƒ³ãƒ‡ãƒ³ãƒˆãƒ¬ãƒ™ãƒ«ã§ã€``\"- \"`` (ダッシュã¨ã‚¹ãƒšãƒ¼ã‚¹) ã§é–‹å§‹ã™ã‚‹è¡Œã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:39 -msgid "A dictionary is represented in a simple ``key: value`` form (the colon must be followed by a space)::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:41 +msgid "A dictionary is represented in a simple ``key: value`` form (the colon must be followed by a space):" msgstr "ディクショナリーã¯ã€ã‚·ãƒ³ãƒ—ル㪠``key: value`` ã®å½¢å¼ã§è¡¨ç¾ã—ã¾ã™ (コãƒãƒ³ã®å¾Œã«ã¯ã‚¹ãƒšãƒ¼ã‚¹ã‚’挿入ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™)。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:47 -msgid "More complicated data structures are possible, such as lists of dictionaries, dictionaries whose values are lists or a mix of both::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:51 +msgid "More complicated data structures are possible, such as lists of dictionaries, dictionaries whose values are lists or a mix of both:" msgstr "リストãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã‚„ãã®å€¤ã®å ´åˆã‚„ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã¨å€¤ãŒæ··åˆã—ã¦ã„ã‚‹å ´åˆãªã©ã€ã‚ˆã‚Šè¤‡é›‘ãªãƒ‡ãƒ¼ã‚¿æ§‹é€ ã‚‚å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:65 -msgid "Dictionaries and lists can also be represented in an abbreviated form if you really want to::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:71 +msgid "Dictionaries and lists can also be represented in an abbreviated form if you really want to:" msgstr "ディクショナリーã¨ãƒªã‚¹ãƒˆã¯ã€å¿…è¦ã§ã‚ã‚Œã°ã€ç•¥èªžå½¢å¼ã§è¡¨ç¾ã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:71 +#: ../../rst/reference_appendices/YAMLSyntax.rst:79 msgid "These are called \"Flow collections\"." msgstr "以下ã¯ã€Œãƒ•ãƒãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã€ã¨å‘¼ã°ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:75 -msgid "Ansible doesn't really use these too much, but you can also specify a :ref:`boolean value <playbooks_variables>` (true/false) in several forms::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:83 +msgid "Ansible doesn't really use these too much, but you can also specify a :ref:`boolean value <playbooks_variables>` (true/false) in several forms:" msgstr "Ansible ã§ã¯ä»¥ä¸‹ã®å½¢å¼ã¯ã‚ã¾ã‚Šä½¿ç”¨ã•ã‚Œã¾ã›ã‚“ãŒã€:ref:`boolean value <playbooks_variables>` を複数ã®å½¢å¼ã§æŒ‡å®šã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:83 +#: ../../rst/reference_appendices/YAMLSyntax.rst:93 msgid "Use lowercase 'true' or 'false' for boolean values in dictionaries if you want to be compatible with default yamllint options." msgstr "デフォルト㮠yamllint オプションã¨äº’æ›æ€§ã‚’æŒãŸã›ã‚‹å ´åˆã¯ã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®ãƒ–ール値ã«å°æ–‡å—ã®ã€Œtrueã€ã¾ãŸã¯ã€Œfalseã€ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:85 -msgid "Values can span multiple lines using ``|`` or ``>``. Spanning multiple lines using a \"Literal Block Scalar\" ``|`` will include the newlines and any trailing spaces. Using a \"Folded Block Scalar\" ``>`` will fold newlines to spaces; it's used to make what would otherwise be a very long line easier to read and edit. In either case the indentation will be ignored. Examples are::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:95 +msgid "Values can span multiple lines using ``|`` or ``>``. Spanning multiple lines using a \"Literal Block Scalar\" ``|`` will include the newlines and any trailing spaces. Using a \"Folded Block Scalar\" ``>`` will fold newlines to spaces; it's used to make what would otherwise be a very long line easier to read and edit. In either case the indentation will be ignored. Examples are:" msgstr "値ã¯ã€``|`` ã¾ãŸã¯ ``>`` を使用ã™ã‚‹ã“ã¨ã§è¤‡æ•°ã®è¡Œã«ã¾ãŸãŒã£ã¦æŒ‡å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚「リテラル形å¼ã®ãƒ–ãƒãƒƒã‚¯ã‚¹ã‚«ãƒ©ãƒ¼ã€ ``|`` を使用ã—ã¦è¤‡æ•°è¡Œã«ã¾ãŸãŒã‚‹å ´åˆã¯ã€æ”¹è¡Œã¨æœ«å°¾ã®ã‚¹ãƒšãƒ¼ã‚¹ãŒå«ã¾ã‚Œã¾ã™ã€‚「折り畳ã¿å½¢å¼ã®ãƒ–ãƒãƒƒã‚¯ã‚¹ã‚«ãƒ©ãƒ¼ã€ ``>`` を使用ã™ã‚‹ã¨ã€æŠ˜ã‚Šè¿”ã—ã«ä½¿ç”¨ã•ã‚Œã‚‹æ”¹è¡Œã¯ã™ã¹ã¦ã‚¹ãƒšãƒ¼ã‚¹ã«å¤‰æ›ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã¯ã€éžå¸¸ã«é•·ã„行をèªã¿ã‚„ã™ãã€ç·¨é›†ã—ã‚„ã™ãã™ã‚‹ãŸã‚ã«ä½¿ã‚ã‚Œã¾ã™ã€‚ã„ãšã‚Œã®å ´åˆã‚‚ã€ã‚¤ãƒ³ãƒ‡ãƒ³ãƒˆã¯ç„¡è¦–ã•ã‚Œã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:100 -msgid "While in the above ``>`` example all newlines are folded into spaces, there are two ways to enforce a newline to be kept::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:112 +msgid "While in the above ``>`` example all newlines are folded into spaces, there are two ways to enforce a newline to be kept:" msgstr "上記㮠``>`` ã®ä¾‹ã§ã¯ã€æ”¹è¡Œã¯ã™ã¹ã¦ã‚¹ãƒšãƒ¼ã‚¹ã«å¤‰æ›ã•ã‚Œã¾ã™ãŒã€å¼·åˆ¶çš„ã«æ”¹è¡Œã‚’è¡Œã†æ–¹æ³•ãŒ 2 種類ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:111 -msgid "Alternatively, it can be enforced by including newline ``\\n`` characters::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:125 +msgid "Alternatively, it can be enforced by including newline ``\\n`` characters:" msgstr "ã‚ã‚‹ã„ã¯ã€æ”¹è¡Œ ``\\n" "`` æ–‡å—ã‚’å«ã‚ã‚‹ã“ã¨ã§å¼·åˆ¶ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:115 -msgid "Let's combine what we learned so far in an arbitrary YAML example. This really has nothing to do with Ansible, but will give you a feel for the format::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:131 +msgid "Let's combine what we learned so far in an arbitrary YAML example. This really has nothing to do with Ansible, but will give you a feel for the format:" msgstr "ã“ã‚Œã¾ã§ã«èª¬æ˜Žã—ãŸå†…容をã€ä»»æ„ã® YAML ã®ä¾‹ã«ã¾ã¨ã‚ã¦ã¿ã¾ã—ょã†ã€‚以下ã¯ã€Ansible ã¨ã¯é–¢ä¿‚ã‚ã‚Šã¾ã›ã‚“ãŒã€ã©ã®ã‚ˆã†ãªå½¢å¼ã«ãªã‚‹ã‹ã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:138 +#: ../../rst/reference_appendices/YAMLSyntax.rst:156 msgid "That's all you really need to know about YAML to start writing `Ansible` playbooks." msgstr "`Ansible` Playbook ã®è¨˜è¿°ã‚’開始ã™ã‚‹ã«ã‚ãŸã‚Šã€ä»¥ä¸ŠãŒ YAML ã«ã¤ã„ã¦ç†è§£ã—ã¦ãŠãå¿…è¦ã®ã‚る内容ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:141 +#: ../../rst/reference_appendices/YAMLSyntax.rst:159 msgid "Gotchas" msgstr "Gotchas" -#: ../../rst/reference_appendices/YAMLSyntax.rst:143 +#: ../../rst/reference_appendices/YAMLSyntax.rst:161 msgid "While you can put just about anything into an unquoted scalar, there are some exceptions. A colon followed by a space (or newline) ``\": \"`` is an indicator for a mapping. A space followed by the pound sign ``\" #\"`` starts a comment." msgstr "引用符ã§å›²ã¾ã‚Œã¦ã„ãªã„スカラーã«ã¯ä½•ã§ã‚‚挿入ã§ãã¾ã™ãŒã€ä¸€éƒ¨ä¾‹å¤–ãŒã‚ã‚Šã¾ã™ã€‚コãƒãƒ³ã®å¾Œã«ã‚¹ãƒšãƒ¼ã‚¹ (ã¾ãŸã¯æ”¹è¡Œ) を続ã‘ã¦è¨˜è¿° (``\": \"``) ã—ãŸå ´åˆã¯ã€ãƒžãƒƒãƒ”ングを示ã™ã‚¤ãƒ³ã‚¸ã‚±ãƒ¼ã‚¿ãƒ¼ã«ãªã‚Šã¾ã™ã€‚スペースã«ç¶šã‘ã¦ãƒãƒ³ãƒ‰è¨˜å·ã‚’記述 (``\" #\"``) ã—ãŸå ´åˆã¯ã€ã‚³ãƒ¡ãƒ³ãƒˆã®é–‹å§‹ã‚’表ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:147 -msgid "Because of this, the following is going to result in a YAML syntax error::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:165 +msgid "Because of this, the following is going to result in a YAML syntax error:" msgstr "ã“ã®ãŸã‚ã€ä»¥ä¸‹ã®ã‚ˆã†ãªå ´åˆã«ã¯ã€YAML 構文ãŒã‚¨ãƒ©ãƒ¼ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:153 -msgid "...but this will work::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:173 +msgid "...but this will work:" msgstr "...ãŸã ã—ã€ä»¥ä¸‹ã¯æœ‰åŠ¹ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:157 -msgid "You will want to quote hash values using colons followed by a space or the end of the line::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:179 +msgid "You will want to quote hash values using colons followed by a space or the end of the line:" msgstr "コãƒãƒ³ã‚’使用ã—ã¦ãƒãƒƒã‚·ãƒ¥è¨˜å·ã‚’引用ã—ã€ãã®å¾Œã‚ã«ã‚¹ãƒšãƒ¼ã‚¹ã‚’指定ã™ã‚‹ã‹ã€è¡Œæœ«ã«ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:163 +#: ../../rst/reference_appendices/YAMLSyntax.rst:187 msgid "...and then the colon will be preserved." msgstr "...ãã—ã¦ã‚³ãƒãƒ³ãŒä¿å˜ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:165 -msgid "Alternatively, you can use double quotes::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:189 +msgid "Alternatively, you can use double quotes:" msgstr "ã¾ãŸã¯ã€äºŒé‡å¼•ç”¨ç¬¦ã‚’使用ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:171 -msgid "The difference between single quotes and double quotes is that in double quotes you can use escapes::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:197 +msgid "The difference between single quotes and double quotes is that in double quotes you can use escapes:" msgstr "二é‡å¼•ç”¨ç¬¦ã§ã¯ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—を使用ã§ãる点ãŒã€ä¸€é‡å¼•ç”¨ç¬¦ã¨äºŒé‡å¼•ç”¨ç¬¦ã¨ã®ç›¸é•ç‚¹ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:176 +#: ../../rst/reference_appendices/YAMLSyntax.rst:204 msgid "The list of allowed escapes can be found in the YAML Specification under \"Escape Sequences\" (YAML 1.1) or \"Escape Characters\" (YAML 1.2)." msgstr "使用å¯èƒ½ãªã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã®ä¸€è¦§ã¯ã€YAML 仕様ã®ã€ŒEscape Sequencesã€(YAML 1.1) ã¾ãŸã¯ã€ŒEscape Charactersã€(YAML 1.2) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:178 +#: ../../rst/reference_appendices/YAMLSyntax.rst:206 msgid "The following is invalid YAML:" msgstr "以下ã¯ç„¡åŠ¹ãª YAML ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:185 -msgid "Further, Ansible uses \"{{ var }}\" for variables. If a value after a colon starts with a \"{\", YAML will think it is a dictionary, so you must quote it, like so::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:213 +msgid "Further, Ansible uses \"{{ var }}\" for variables. If a value after a colon starts with a \"{\", YAML will think it is a dictionary, so you must quote it, like so:" msgstr "ã•ã‚‰ã«ã€Ansible ã¯å¤‰æ•°ã« \"{{ var }}\" を使用ã—ã¾ã™ã€‚コãƒãƒ³ã®å¾Œã« \"{\" ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ãã®å€¤ãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã‚る㨠YAML ãŒèªè˜ã™ã‚‹ãŸã‚ã€ä»¥ä¸‹ã®ã‚ˆã†ã«å¼•ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™::" -#: ../../rst/reference_appendices/YAMLSyntax.rst:190 -msgid "If your value starts with a quote the entire value must be quoted, not just part of it. Here are some additional examples of how to properly quote things::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:220 +msgid "If your value starts with a quote the entire value must be quoted, not just part of it. Here are some additional examples of how to properly quote things:" msgstr "値を引用符ã§ã™ã‚‹å ´åˆã¯ã€å€¤ã®ä¸€éƒ¨ã ã‘ã§ãªãã€å€¤å…¨ä½“を引用符ã§å›²ã‚€å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚値を引用ã™ã‚‹æ–¹æ³•ã«ã¤ã„ã¦æ£ã—ã„例を以下ã«ç¤ºã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:196 -msgid "Not valid::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:228 +msgid "Not valid:" msgstr "以下ã¯æœ‰åŠ¹ã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:200 +#: ../../rst/reference_appendices/YAMLSyntax.rst:234 msgid "In addition to ``'`` and ``\"`` there are a number of characters that are special (or reserved) and cannot be used as the first character of an unquoted scalar: ``[] {} > | * & ! % # ` @ ,``." msgstr "``'`` ãŠã‚ˆã³ ``\"`` 以外ã«ã€å¼•ç”¨ç¬¦ã§å›²ã¾ã‚Œã¦ã„ãªã„スカラーã®æœ€åˆã®æ–‡å—ã¨ã—ã¦ä½¿ç”¨ã§ããªã„ç‰¹æ®Šæ–‡å— (予約文å—) ãŒã„ãã¤ã‹ã‚ã‚Šã¾ã™ (``[] {} > | * & ! % # ` @ ,`` ãªã©)。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:203 +#: ../../rst/reference_appendices/YAMLSyntax.rst:237 msgid "You should also be aware of ``? : -``. In YAML, they are allowed at the beginning of a string if a non-space character follows, but YAML processor implementations differ, so it's better to use quotes." msgstr "ã¾ãŸã€``? : -`` ã«ã¯å¸¸ã«æ³¨æ„ã—ã¦ãã ã•ã„。YAML ã§ã¯ã€ã‚¹ãƒšãƒ¼ã‚¹ä»¥å¤–ã®æ–‡å—ãŒç¶šãå ´åˆã¯ã€æ–‡å—列ã®å…ˆé ã§è¨±å¯ã•ã‚Œã¾ã™ãŒã€YAML プãƒã‚»ãƒƒã‚µãƒ¼ã®å®Ÿè£…ã¯ç•°ãªã‚‹ãŸã‚ã€å¼•ç”¨ç¬¦ã‚’使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:206 -msgid "In Flow Collections, the rules are a bit more strict::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:240 +msgid "In Flow Collections, the rules are a bit more strict:" msgstr "フãƒãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã€ãƒ«ãƒ¼ãƒ«ã¯ã‚‚ã†å°‘ã—厳密ã§ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:212 -msgid "Boolean conversion is helpful, but this can be a problem when you want a literal `yes` or other boolean values as a string. In these cases just use quotes::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:248 +msgid "Boolean conversion is helpful, but this can be a problem when you want a literal `yes` or other boolean values as a string. In these cases just use quotes:" msgstr "ブール値ã®å¤‰æ›ã¯ä¾¿åˆ©ã§ã™ãŒã€ãƒªãƒ†ãƒ©ãƒ«ã® `yes` ã‚„ã€æ–‡å—列ã¨ã—ã¦ä»–ã®ãƒ–ール値を指定ã™ã‚‹å ´åˆãªã©å•é¡Œã«ãªã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ã“ã®å ´åˆã¯ã€å¼•ç”¨ç¬¦ã ã‘を使用ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:219 -msgid "YAML converts certain strings into floating-point values, such as the string `1.0`. If you need to specify a version number (in a requirements.yml file, for example), you will need to quote the value if it looks like a floating-point value::" +#: ../../rst/reference_appendices/YAMLSyntax.rst:257 +msgid "YAML converts certain strings into floating-point values, such as the string `1.0`. If you need to specify a version number (in a requirements.yml file, for example), you will need to quote the value if it looks like a floating-point value:" msgstr "YAML ã¯ã€ç‰¹å®šã®æ–‡å—列を文å—列 `1.0` ãªã©ã®æµ®å‹•å°æ•°ç‚¹å€¤ã«å¤‰æ›ã—ã¾ã™ã€‚(ãŸã¨ãˆã° requirements.yml ファイルã§) ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã‚’指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ãã‚ŒãŒæµ®å‹•å°æ•°ç‚¹ã®å€¤ã®ã‚ˆã†ã«è¦‹ãˆã‚‹å ´åˆã¯ã€ãã®å€¤ã‚’引用符ã§å›²ã‚€å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:229 -#: ../../rst/reference_appendices/faq.rst:886 +#: ../../rst/reference_appendices/YAMLSyntax.rst:269 +#: ../../rst/reference_appendices/faq.rst:925 #: ../../rst/reference_appendices/glossary.rst:536 -#: ../../rst/reference_appendices/test_strategies.rst:267 +#: ../../rst/reference_appendices/test_strategies.rst:296 msgid ":ref:`working_with_playbooks`" msgstr ":ref:`working_with_playbooks`" -#: ../../rst/reference_appendices/YAMLSyntax.rst:230 +#: ../../rst/reference_appendices/YAMLSyntax.rst:270 msgid "Learn what playbooks can do and how to write/run them." msgstr "Playbook ã§ã§ãã‚‹ã“ã¨ã¨ã€Playbook を記述ãŠã‚ˆã³å®Ÿè¡Œã™ã‚‹æ–¹æ³•ã‚’å¦ã³ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:231 +#: ../../rst/reference_appendices/YAMLSyntax.rst:271 msgid "`YAMLLint <http://yamllint.com/>`_" msgstr "`YAMLLint <http://yamllint.com/>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:232 +#: ../../rst/reference_appendices/YAMLSyntax.rst:272 msgid "YAML Lint (online) helps you debug YAML syntax if you are having problems" msgstr "YAML ヒント (オンライン) ã¯ã€å•é¡ŒãŒç™ºç”Ÿã—ãŸå ´åˆã« YAML 構文ã®ãƒ‡ãƒãƒƒã‚°ã«å½¹ç«‹ã¡ã¾ã™ã€‚" -#: ../../rst/reference_appendices/YAMLSyntax.rst:233 +#: ../../rst/reference_appendices/YAMLSyntax.rst:273 msgid "`GitHub examples directory <https://github.com/ansible/ansible-examples>`_" -msgstr "`GitHub examples ディレクトリー <https://github.com/ansible/ansible-examples>`_" +msgstr "`GitHub examples directory <https://github.com/ansible/ansible-examples>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:234 +#: ../../rst/reference_appendices/YAMLSyntax.rst:274 msgid "Complete playbook files from the github project source" msgstr "Github プãƒã‚¸ã‚§ã‚¯ãƒˆã‚½ãƒ¼ã‚¹ã®å®Œå…¨ãª Playbook ファイル" -#: ../../rst/reference_appendices/YAMLSyntax.rst:235 +#: ../../rst/reference_appendices/YAMLSyntax.rst:275 msgid "`Wikipedia YAML syntax reference <https://en.wikipedia.org/wiki/YAML>`_" -msgstr "`Wikipedia YAML 構文リファレンス <https://en.wikipedia.org/wiki/YAML>`_" +msgstr "`Wikipedia YAML syntax reference <https://en.wikipedia.org/wiki/YAML>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:236 +#: ../../rst/reference_appendices/YAMLSyntax.rst:276 msgid "A good guide to YAML syntax" msgstr "YAML 構文ã®é©åˆ‡ãªã‚¬ã‚¤ãƒ‰" -#: ../../rst/reference_appendices/YAMLSyntax.rst:237 +#: ../../rst/reference_appendices/YAMLSyntax.rst:277 msgid "`Mailing List <https://groups.google.com/group/ansible-project>`_" -msgstr "`メーリングリスト <https://groups.google.com/group/ansible-project>`_" +msgstr "`Mailing List <https://groups.google.com/group/ansible-project>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:238 +#: ../../rst/reference_appendices/YAMLSyntax.rst:278 msgid "Questions? Help? Ideas? Stop by the list on Google Groups" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚サãƒãƒ¼ãƒˆãŒå¿…è¦ã§ã™ã‹ã€‚ã”æ案ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google グループã®ä¸€è¦§ã‚’ã”覧ãã ã•ã„。" -#: ../../rst/reference_appendices/YAMLSyntax.rst:239 +#: ../../rst/reference_appendices/YAMLSyntax.rst:279 #: ../../rst/reference_appendices/common_return_values.rst:250 #: ../../rst/reference_appendices/glossary.rst:542 -#: ../../rst/reference_appendices/release_and_maintenance.rst:260 -#: ../../rst/reference_appendices/test_strategies.rst:273 +#: ../../rst/reference_appendices/release_and_maintenance.rst:394 +#: ../../rst/reference_appendices/test_strategies.rst:302 msgid ":ref:`communication_irc`" msgstr ":ref:`communication_irc`" -#: ../../rst/reference_appendices/YAMLSyntax.rst:240 +#: ../../rst/reference_appendices/YAMLSyntax.rst:280 msgid "How to join Ansible chat channels (join #yaml for yaml-specific questions)" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã«å‚åŠ ã™ã‚‹æ–¹æ³• (yaml 固有ã®è³ªå•ã¯ #yaml ã«å‚åŠ ã—ã¦ãã ã•ã„)" -#: ../../rst/reference_appendices/YAMLSyntax.rst:242 +#: ../../rst/reference_appendices/YAMLSyntax.rst:282 msgid "`YAML 1.1 Specification <https://yaml.org/spec/1.1/>`_" msgstr "`YAML 1.1 Specification <https://yaml.org/spec/1.1/>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:242 +#: ../../rst/reference_appendices/YAMLSyntax.rst:282 msgid "The Specification for YAML 1.1, which PyYAML and libyaml are currently implementing" msgstr "PyYAML ãŠã‚ˆã³ libyaml ãŒç¾åœ¨å®Ÿè£…ã•ã‚Œã¦ã„ã‚‹ YAML 1.1 ã®ä»•æ§˜" -#: ../../rst/reference_appendices/YAMLSyntax.rst:244 +#: ../../rst/reference_appendices/YAMLSyntax.rst:284 msgid "`YAML 1.2 Specification <https://yaml.org/spec/1.2/spec.html>`_" -msgstr "`YAML 1.2 仕様 <https://yaml.org/spec/1.2/spec.html>`_" +msgstr "`YAML 1.2 Specification <https://yaml.org/spec/1.2/spec.html>`_" -#: ../../rst/reference_appendices/YAMLSyntax.rst:245 +#: ../../rst/reference_appendices/YAMLSyntax.rst:285 msgid "For completeness, YAML 1.2 is the successor of 1.1" msgstr "完全を期ã™ãŸã‚ã€YAML 1.2 㯠1.1 ã®å¾Œç¶™ã¨ãªã‚Šã¾ã™ã€‚" @@ -241,7 +241,6 @@ msgid "Ansible Automation Hub" msgstr "Ansible Automation Hub" #: ../../rst/reference_appendices/automationhub.rst:8 -#: ../../rst/reference_appendices/tower.rst:8 msgid "Red Hat Ansible Automation Platform will soon be available on Microsoft Azure. `Sign up to preview the experience <https://www.redhat.com/en/engage/ansible-microsoft-azure-e-202110220735>`_." msgstr "Red Hat Ansible Automation Platform ã¯ã€ã¾ã‚‚ãªã Microsoft Azure ã§ã‚‚使用ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚`Sign up to preview the experience <https://www.redhat.com/en/engage/ansible-microsoft-azure-e-202110220735>`_。" @@ -312,7 +311,7 @@ msgstr "ç›´å‰ã¨ç¾åœ¨ã®çŠ¶æ…‹ã®ç›¸é•ç‚¹ã«é–¢ã™ã‚‹æƒ…å ±ã€‚é€šå¸¸ã€``befo #: ../../rst/reference_appendices/common_return_values.rst:55 msgid "failed" -msgstr "failed" +msgstr "失敗" #: ../../rst/reference_appendices/common_return_values.rst:56 msgid "A boolean that indicates if the task was failed or not." @@ -352,7 +351,7 @@ msgstr "ã“ã®ã‚ーãŒå˜åœ¨ã™ã‚‹å ´åˆã«ã¯ã€ã‚¿ã‚¹ã‚¯ã«å¯¾ã—ã¦ãƒ«ãƒ¼ãƒ— #: ../../rst/reference_appendices/common_return_values.rst:175 msgid "skipped" -msgstr "skipped" +msgstr "スã‚ップ済" #: ../../rst/reference_appendices/common_return_values.rst:176 msgid "A boolean that indicates if the task was skipped or not" @@ -432,12 +431,12 @@ msgid "This key contains a list of dictionaries that will be presented to the us msgstr "ã“ã®ã‚ーã«ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã«è¡¨ç¤ºã•ã‚Œã‚‹ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ä¸€è¦§ãŒå«ã¾ã‚Œã¾ã™ã€‚ディクショナリーã®ã‚ー㯠`msg` 㨠`version` ã§ã€å€¤ã¯æ–‡å—列ã§ã™ã€‚`version` ã‚ーã®å€¤ã¯ç©ºç™½ã®æ–‡å—列ã«ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/reference_appendices/common_return_values.rst:244 -#: ../../rst/reference_appendices/test_strategies.rst:265 +#: ../../rst/reference_appendices/test_strategies.rst:294 msgid ":ref:`list_of_collections`" msgstr ":ref:`list_of_collections`" #: ../../rst/reference_appendices/common_return_values.rst:245 -#: ../../rst/reference_appendices/test_strategies.rst:266 +#: ../../rst/reference_appendices/test_strategies.rst:295 msgid "Browse existing collections, modules, and plugins" msgstr "æ—¢å˜ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã€ãŠã‚ˆã³ãƒ—ラグインã®é–²è¦§" @@ -451,7 +450,7 @@ msgstr "コアモジュールãŠã‚ˆã³è¿½åŠ モジュールã®ã‚½ãƒ¼ã‚¹ã®å‚ç…§ #: ../../rst/reference_appendices/common_return_values.rst:248 msgid "`Mailing List <https://groups.google.com/group/ansible-devel>`_" -msgstr "`メーリングリスト <https://groups.google.com/group/ansible-devel>`_" +msgstr "`Mailing List <https://groups.google.com/group/ansible-devel>`_" #: ../../rst/reference_appendices/common_return_values.rst:249 msgid "Development mailing list" @@ -459,8 +458,8 @@ msgstr "開発メーリングリスト" #: ../../rst/reference_appendices/common_return_values.rst:251 #: ../../rst/reference_appendices/glossary.rst:543 -#: ../../rst/reference_appendices/release_and_maintenance.rst:261 -#: ../../rst/reference_appendices/test_strategies.rst:274 +#: ../../rst/reference_appendices/release_and_maintenance.rst:395 +#: ../../rst/reference_appendices/test_strategies.rst:303 msgid "How to join Ansible chat channels" msgstr "Ansible ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•" @@ -991,6 +990,7 @@ msgstr "éžæŽ¨å¥¨ã«ãªã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³" #: ../../rst/reference_appendices/config.rst:411 #: ../../rst/reference_appendices/config.rst:3211 #: ../../rst/reference_appendices/config.rst:3641 +#: ../../rst/reference_appendices/release_and_maintenance.rst:83 msgid "2.15" msgstr "2.15" @@ -1025,7 +1025,7 @@ msgstr "cowsay_enabled_stencils" #: ../../rst/reference_appendices/config.rst:3221 #: ../../rst/reference_appendices/config.rst:3245 #: ../../rst/reference_appendices/config.rst:3651 -#: ../../rst/reference_appendices/release_and_maintenance.rst:86 +#: ../../rst/reference_appendices/release_and_maintenance.rst:87 msgid "2.11" msgstr "2.11" @@ -1157,7 +1157,7 @@ msgstr "``~/.ansible``" #: ../../rst/reference_appendices/config.rst:227 #: ../../rst/reference_appendices/config.rst:2609 -#: ../../rst/reference_appendices/release_and_maintenance.rst:83 +#: ../../rst/reference_appendices/release_and_maintenance.rst:84 msgid "2.14" msgstr "2.14" @@ -1282,7 +1282,7 @@ msgstr "become プラグインã«ä½¿ç”¨ã™ã‚‹ãƒ‘スワードファイル。--bec #: ../../rst/reference_appendices/config.rst:317 #: ../../rst/reference_appendices/config.rst:948 #: ../../rst/reference_appendices/config.rst:3064 -#: ../../rst/reference_appendices/release_and_maintenance.rst:85 +#: ../../rst/reference_appendices/release_and_maintenance.rst:86 msgid "2.12" msgstr "2.12" @@ -1565,8 +1565,8 @@ msgstr "collections_path" #: ../../rst/reference_appendices/config.rst:3141 #: ../../rst/reference_appendices/config.rst:3153 #: ../../rst/reference_appendices/config.rst:3359 -#: ../../rst/reference_appendices/release_and_maintenance.rst:87 #: ../../rst/reference_appendices/release_and_maintenance.rst:88 +#: ../../rst/reference_appendices/release_and_maintenance.rst:89 msgid "2.10" msgstr "2.10" @@ -2284,7 +2284,7 @@ msgstr ":envvar:`_ANSIBLE_COVERAGE_REMOTE_OUTPUT`" #: ../../rst/reference_appendices/config.rst #: ../../rst/reference_appendices/general_precedence.rst:23 -#: ../../rst/reference_appendices/general_precedence.rst:92 +#: ../../rst/reference_appendices/general_precedence.rst:98 msgid "Variables" msgstr "変数" @@ -2294,7 +2294,7 @@ msgstr "変数" #: ../../rst/reference_appendices/playbooks_keywords.rst:311 #: ../../rst/reference_appendices/playbooks_keywords.rst:434 msgid "name" -msgstr "name" +msgstr "åå‰" #: ../../rst/reference_appendices/config.rst:966 msgid "`_ansible_coverage_remote_output`" @@ -2881,7 +2881,7 @@ msgstr "``/etc/ansible/hosts``" #: ../../rst/reference_appendices/config.rst:1335 msgid "inventory" -msgstr "inventory" +msgstr "インベントリー" #: ../../rst/reference_appendices/config.rst:1337 msgid ":envvar:`ANSIBLE_INVENTORY`" @@ -3281,7 +3281,7 @@ msgstr "DEFAULT_NO_TARGET_SYSLOG" #: ../../rst/reference_appendices/config.rst:1615 #: ../../rst/reference_appendices/config.rst:3892 -msgid "Toggle Ansible logging to syslog on the target when it executes tasks. On Windows hosts this will disable a newer style PowerShell modules from writting to the event log." +msgid "Toggle Ansible logging to syslog on the target when it executes tasks. On Windows hosts this will disable a newer style PowerShell modules from writing to the event log." msgstr "タスクã®å®Ÿè¡Œæ™‚ã«ã€Ansible ãƒã‚°ã‚’ターゲット㮠syslog ã¸åˆ‡ã‚Šæ›¿ãˆã¾ã™ã€‚Windows ホストã§ã¯ã€ã“ã‚Œã«ã‚ˆã‚Šã€æ–°ã—ã„スタイル㮠PowerShell モジュールãŒã‚¤ãƒ™ãƒ³ãƒˆãƒã‚°ã«æ›¸ã込むã“ã¨ãŒã§ããªããªã‚Šã¾ã™ã€‚" #: ../../rst/reference_appendices/config.rst:1620 @@ -4115,7 +4115,7 @@ msgstr "コレクションã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ä¸ã« GPG ç½²åã®æ¤œè¨¼ã‚’ç„¡å #: ../../rst/reference_appendices/config.rst:2195 #: ../../rst/reference_appendices/config.rst:2224 -#: ../../rst/reference_appendices/release_and_maintenance.rst:84 +#: ../../rst/reference_appendices/release_and_maintenance.rst:85 msgid "2.13" msgstr "2.13" @@ -4182,7 +4182,7 @@ msgid "GALAXY_IGNORE_INVALID_SIGNATURE_STATUS_CODES" msgstr "GALAXY_IGNORE_INVALID_SIGNATURE_STATUS_CODES" #: ../../rst/reference_appendices/config.rst:2249 -msgid "A list of GPG status codes to ignore during GPG signature verfication. See L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) for status code descriptions. If fewer signatures successfully verify the collection than `GALAXY_REQUIRED_VALID_SIGNATURE_COUNT`, signature verification will fail even if all error codes are ignored." +msgid "A list of GPG status codes to ignore during GPG signature verification. See L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) for status code descriptions. If fewer signatures successfully verify the collection than `GALAXY_REQUIRED_VALID_SIGNATURE_COUNT`, signature verification will fail even if all error codes are ignored." msgstr "GPG ç½²åã®æ¤œè¨¼ä¸ã«ç„¡è¦–ã™ã‚‹ GPG ステータスコードã®ãƒªã‚¹ãƒˆã€‚ステータスコードã®èª¬æ˜Žã¯ã€L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。コレクションã®æ¤œè¨¼ã§æ£å¸¸ãªç½²å数㌠`GALAXY_REQUIRED_VALID_SIGNATURE_COUNT` よりも少ãªã„å ´åˆã«ã¯ã€ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ãŒç„¡è¦–ã•ã‚Œã¦ã„ã‚‹å ´åˆã§ã‚‚ç½²åã®æ¤œè¨¼ã«å¤±æ•—ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/config.rst:2252 @@ -6139,7 +6139,7 @@ msgid "See also :ref:`GALAXY_GPG_KEYRING <GALAXY_GPG_KEYRING>`" msgstr "「:ref:`GALAXY_GPG_KEYRING <GALAXY_GPG_KEYRING>`ã€ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/reference_appendices/config.rst:4287 -msgid "A list of GPG status codes to ignore during GPG signature verfication. See L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) for status code descriptions.If fewer signatures successfully verify the collection than `GALAXY_REQUIRED_VALID_SIGNATURE_COUNT`, signature verification will fail even if all error codes are ignored." +msgid "A list of GPG status codes to ignore during GPG signature verification. See L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) for status code descriptions.If fewer signatures successfully verify the collection than `GALAXY_REQUIRED_VALID_SIGNATURE_COUNT`, signature verification will fail even if all error codes are ignored." msgstr "GPG ç½²åã®æ¤œè¨¼ä¸ã«ç„¡è¦–ã™ã‚‹ GPG ステータスコードã®ãƒªã‚¹ãƒˆã€‚ステータスコードã®èª¬æ˜Žã¯ã€L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes) ã‚’å‚ç…§ã—ã¦ãã ã•ã„。コレクションã®æ¤œè¨¼ã§æ£å¸¸ãªç½²å数㌠`GALAXY_REQUIRED_VALID_SIGNATURE_COUNT` よりも少ãªã„å ´åˆã«ã¯ã€ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ãŒç„¡è¦–ã•ã‚Œã¦ã„ã‚‹å ´åˆã§ã‚‚ç½²åã®æ¤œè¨¼ã«å¤±æ•—ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/config.rst:4289 @@ -6531,705 +6531,726 @@ msgid "You can set a ``ProxyCommand`` in the ``ansible_ssh_common_args`` invento msgstr "``ansible_ssh_common_args`` インベントリー変数㫠``ProxyCommand`` ã‚’è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚該当ã®ãƒ›ã‚¹ãƒˆã«æŽ¥ç¶šã—ãŸã¨ãã«ã€ã“ã®å¤‰æ•°ã«æŒ‡å®šã—ãŸå¼•æ•°ã¯ã€sftp/scp/ssh コマンドラインã«è¿½åŠ ã•ã‚Œã¾ã™ã€‚次ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚°ãƒ«ãƒ¼ãƒ—ã«ã¤ã„ã¦è€ƒãˆã¦ã¿ã¾ã™ã€‚" #: ../../rst/reference_appendices/faq.rst:117 -msgid "You can create `group_vars/gatewayed.yml` with the following contents::" +msgid "You can create `group_vars/gatewayed.yml` with the following contents:" msgstr "以下ã®å†…容㧠`group_vars/gatewayed.yml` を作æˆã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:121 +#: ../../rst/reference_appendices/faq.rst:123 msgid "Ansible will append these arguments to the command line when trying to connect to any hosts in the group ``gatewayed``. (These arguments are used in addition to any ``ssh_args`` from ``ansible.cfg``, so you do not need to repeat global ``ControlPersist`` settings in ``ansible_ssh_common_args``.)" msgstr "Ansible ã¯ã€``gatewayed`` グループã®ãƒ›ã‚¹ãƒˆã«æŽ¥ç¶šã—よã†ã¨ã™ã‚‹ã¨ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã« 3 ã¤ã®å¼•æ•°ã‚’è¿½åŠ ã—ã¾ã™ã€‚(``ansible.cfg`` ã‹ã‚‰ã® ``ssh_args`` ã«åŠ ãˆã¦ã€ä¸Šè¨˜ã®å¼•æ•°ãŒä½¿ç”¨ã•ã‚Œã‚‹ãŸã‚ã€``ansible_ssh_common_args`` ã®ã‚°ãƒãƒ¼ãƒãƒ« ``ControlPersist`` è¨å®šã‚’ç¹°ã‚Šè¿”ã™å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“)。" -#: ../../rst/reference_appendices/faq.rst:126 +#: ../../rst/reference_appendices/faq.rst:128 msgid "Note that ``ssh -W`` is available only with OpenSSH 5.4 or later. With older versions, it's necessary to execute ``nc %h:%p`` or some equivalent command on the bastion host." msgstr "``ssh -W`` ã¯ã€OpenSSH 5.4 以é™ã§ã®ã¿åˆ©ç”¨ã§ãã¾ã™ã€‚以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€bastion ホスト㧠``nc %h:%p`` を実行ã™ã‚‹ã‹ã€åŒç‰ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:130 +#: ../../rst/reference_appendices/faq.rst:132 msgid "With earlier versions of Ansible, it was necessary to configure a suitable ``ProxyCommand`` for one or more hosts in ``~/.ssh/config``, or globally by setting ``ssh_args`` in ``ansible.cfg``." msgstr "Ansible ã®ä»¥å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã¯ã€``~/.ssh/config`` ã®ãƒ›ã‚¹ãƒˆ 1 å°ã¾ãŸã¯è¤‡æ•°å°ã«é©åˆ‡ãª ``ProxyCommand`` ã‚’è¨å®šã™ã‚‹ã‹ã€``ansible.cfg`` ã« ``ssh_args`` ã‚’ã‚°ãƒãƒ¼ãƒãƒ«ã«è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã—ãŸã€‚" -#: ../../rst/reference_appendices/faq.rst:137 +#: ../../rst/reference_appendices/faq.rst:139 msgid "How do I get Ansible to notice a dead target in a timely manner?" msgstr "Ansible ãŒãƒ€ã‚¦ãƒ³ã—ã¦ã„るターゲットをé©å®œæ¤œå‡ºã§ãるよã†ã«ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:139 -msgid "You can add ``-o ServerAliveInterval=NumberOfSeconds`` in ``ssh_args`` from ``ansible.cfg``. Without this option, SSH and therefore Ansible will wait until the TCP connection times out. Another solution is to add ``ServerAliveInterval`` into your global SSH configuration. A good value for ``ServerAliveInterval`` is up to you to decide; keep in mind that ``ServerAliveCountMax=3`` is the SSH default so any value you set will be tripled before terminating the SSH session." -msgstr "``ansible.cfg`` ã‹ã‚‰ã€``ssh_args`` ã« ``-o ServerAliveInterval=NumberOfSeconds`` ã‚’è¿½åŠ ã§ãã¾ã™ã€‚ã“ã®ã‚ªãƒ—ションãŒãªã„ã¨ã€SSH 㨠Ansible 㯠TCP 接続ãŒã‚¿ã‚¤ãƒ アウトã«ãªã‚‹ã¾ã§å¾…æ©Ÿã—ã¾ã™ã€‚別ã®è§£æ±ºæ–¹æ³•ã¯ã€``ServerAliveInterval`` ã‚’ã‚°ãƒãƒ¼ãƒãƒ«ã® SSH è¨å®šã«è¿½åŠ ã™ã‚‹ã“ã¨ã§ã™ã€‚``ServerAliveInterval`` ã«é©ã—ãŸå€¤ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæ±ºå®šã—ã¾ã™ã€‚ãŸã ã—ã€SSH ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``ServerAliveCountMax=3`` ã§ã‚ã‚‹ãŸã‚ã€SSH セッションã®çµ‚了å‰ã«è¨å®šã—ãŸå€¤ãŒ 3 å€ã«ãªã‚‹ç‚¹ã«æ³¨æ„ã—ã¦ãã ã•ã„。" +#: ../../rst/reference_appendices/faq.rst:141 +msgid "You can add ``-o ServerAliveInterval=NumberOfSeconds`` with the ``ssh_args`` parameter in `SSH connection plugin <https://docs.ansible.com/ansible-core/devel/collections/ansible/builtin/ssh_connection.html#parameter-ssh_args>`_. Without this option, SSH and therefore Ansible will wait until the TCP connection times out. Another solution is to add ``ServerAliveInterval`` into your global SSH configuration. A good value for ``ServerAliveInterval`` is up to you to decide; keep in mind that ``ServerAliveCountMax=3`` is the SSH default so any value you set will be tripled before terminating the SSH session." +msgstr "`SSH connection plugin <https://docs.ansible.com/ansible-core/devel/collections/ansible/builtin/ssh_connection.html#parameter-ssh_args>` ã‹ã‚‰ã€``ssh_args`` パラメーターã«æŒ‡å®šã—㦠``-o ServerAliveInterval=NumberOfSeconds`` ã‚’è¿½åŠ ã§ãã¾ã™ã€‚ã“ã®ã‚ªãƒ—ションãŒãªã„ã¨ã€SSH 㨠Ansible 㯠TCP 接続ãŒã‚¿ã‚¤ãƒ アウトã«ãªã‚‹ã¾ã§å¾…æ©Ÿã—ã¾ã™ã€‚別ã®è§£æ±ºæ–¹æ³•ã¯ã€``ServerAliveInterval`` ã‚’ã‚°ãƒãƒ¼ãƒãƒ«ã® SSH è¨å®šã«è¿½åŠ ã™ã‚‹ã“ã¨ã§ã™ã€‚``ServerAliveInterval`` ã«é©ã—ãŸå€¤ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæ±ºå®šã—ã¾ã™ã€‚ãŸã ã—ã€SSH ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``ServerAliveCountMax=3`` ã§ã‚ã‚‹ãŸã‚ã€SSH セッションã®çµ‚了å‰ã«è¨å®šã—ãŸå€¤ãŒ 3 å€ã«ãªã‚‹ç‚¹ã«æ³¨æ„ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:147 +#: ../../rst/reference_appendices/faq.rst:149 msgid "How do I speed up run of ansible for servers from cloud providers (EC2, openstack,.. )?" msgstr "クラウドプãƒãƒã‚¤ãƒ€ãƒ¼ (EC2ã€openstack ãªã©) ã‹ã‚‰ã®ã‚µãƒ¼ãƒãƒ¼ã§ Ansible ã®å®Ÿè¡Œã‚’高速化ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:149 +#: ../../rst/reference_appendices/faq.rst:151 msgid "Don't try to manage a fleet of machines of a cloud provider from your laptop. Rather connect to a management node inside this cloud provider first and run Ansible from there." msgstr "ラップトップã‹ã‚‰ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ã®ãƒžã‚·ãƒ³ã®ãƒ•ãƒªãƒ¼ãƒˆã‚’管ç†ã—よã†ã¨ã—ãªã„ã§ãã ã•ã„。代ã‚ã‚Šã«ã€æœ€åˆã«ã“ã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼å†…ã®ç®¡ç†ãƒŽãƒ¼ãƒ‰ã«æŽ¥ç¶šã—ã€ãã“ã‹ã‚‰ Ansible を実行ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:155 +#: ../../rst/reference_appendices/faq.rst:157 msgid "How do I handle not having a Python interpreter at /usr/bin/python on a remote machine?" msgstr "リモートマシン㮠/usr/bin/python ã« Python インタープリターをé…ç½®ã›ãšã«å¯¾å¿œã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:157 +#: ../../rst/reference_appendices/faq.rst:159 msgid "While you can write Ansible modules in any language, most Ansible modules are written in Python, including the ones central to letting Ansible work." msgstr "Ansible モジュールã¯ã©ã®è¨€èªžã§ã‚‚記述ã§ãã¾ã™ãŒã€Ansible ã®æ©Ÿèƒ½ã‚’å¸ã‚‹ã‚³ã‚¢ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãªã©ã€Ansible モジュールã®å¤šã㯠Python ã§è¨˜è¿°ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:160 +#: ../../rst/reference_appendices/faq.rst:162 msgid "By default, Ansible assumes it can find a :command:`/usr/bin/python` on your remote system that is either Python2, version 2.6 or higher or Python3, 3.5 or higher." msgstr "デフォルトã§ã¯ã€Ansible ã¯ã€Python2 ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.6 以é™ã¾ãŸã¯ Python3 ã® 3.5 以é™ã®ãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ã® :command:`/usr/bin/python` を検出ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:163 +#: ../../rst/reference_appendices/faq.rst:165 msgid "Setting the inventory variable ``ansible_python_interpreter`` on any host will tell Ansible to auto-replace the Python interpreter with that value instead. Thus, you can point to any Python you want on the system if :command:`/usr/bin/python` on your system does not point to a compatible Python interpreter." msgstr "ホストã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•° ``ansible_python_interpreter`` ã‚’è¨å®šã™ã‚‹ã¨ã€Ansible ã«å¯¾ã—ã¦ã€ä»£ã‚ã‚Šã« Python インタープリターをã“ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã®å€¤ã«è‡ªå‹•ã§ç½®ãæ›ãˆã‚‹ã‚ˆã†ã«æŒ‡ç¤ºã‚’出ã—ã¾ã™ã€‚ã“ã®ã‚ˆã†ã«ã€ãŠä½¿ã„ã®ã‚·ã‚¹ãƒ†ãƒ ã® :command:`/usr/bin/python` ãŒäº’æ›æ€§ã®ã‚ã‚‹ Python インタープリターを指定ã—ã¦ã„ãªã„å ´åˆã¯ã€ä½¿ç”¨ã™ã‚‹ Python を指定ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:168 -msgid "Some platforms may only have Python 3 installed by default. If it is not installed as :command:`/usr/bin/python`, you will need to configure the path to the interpreter via ``ansible_python_interpreter``. Although most core modules will work with Python 3, there may be some special purpose ones which do not or you may encounter a bug in an edge case. As a temporary workaround you can install Python 2 on the managed host and configure Ansible to use that Python via ``ansible_python_interpreter``. If there's no mention in the module's documentation that the module requires Python 2, you can also report a bug on our `bug tracker <https://github.com/ansible/ansible/issues>`_ so that the incompatibility can be fixed in a future release." -msgstr "プラットフォームã«ã‚ˆã£ã¦ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ Python3 ã®ã¿ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚:command:`/usr/bin/python` ã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€``ansible_python_interpreter`` を介ã—ã¦ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã¸ã®ãƒ‘スをè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚コアモジュールã®å¤šã㌠Python 3 ã¨é€£æºã—ã¾ã™ãŒã€ã„ãã¤ã‹ã®ç‰¹æ®Šç”¨é€”ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å‹•ä½œã—ãªã„ã‹ã‚‚ã—ã‚Œãªã„ã—ã€ç‰¹æ®Šãªã‚±ãƒ¼ã‚¹ã§ãƒã‚°ãŒç™ºç”Ÿã™ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。一時的ãªå›žé¿ç–ã¨ã—ã¦ã€ç®¡ç†å¯¾è±¡ãƒ›ã‚¹ãƒˆã« Python 2をインストールã—ã€``ansible_python_interpreter`` ã‹ã‚‰ãã® Python を使用ã™ã‚‹ã‚ˆã†ã« Ansible を構æˆã§ãã¾ã™ã€‚モジュールã®ãƒ‰ã‚ュメント㫠Python 2 ãŒå¿…è¦ã‚ã‚‹ã¨ã®è¨˜è¼‰ãŒãªã„å ´åˆã¯ã€ä»Šå¾Œã“ã®ãƒªãƒªãƒ¼ã‚¹ã§éžäº’æ›æ€§ã®å•é¡ŒãŒè§£æ±ºã•ã‚Œã‚‹ã‚ˆã†ã«ã€`ãƒã‚°ãƒˆãƒ©ãƒƒã‚«ãƒ¼ <https://github.com/ansible/ansible/issues>`_ ã§ã€ãƒã‚°ã‚’å ±å‘Šã§ãã¾ã™ã€‚" +#: ../../rst/reference_appendices/faq.rst:170 +msgid "Some platforms may only have Python 3 installed by default. If it is not installed as :command:`/usr/bin/python`, you will need to configure the path to the interpreter through ``ansible_python_interpreter``. Although most core modules will work with Python 3, there may be some special purpose ones which do not or you may encounter a bug in an edge case. As a temporary workaround you can install Python 2 on the managed host and configure Ansible to use that Python through ``ansible_python_interpreter``. If there's no mention in the module's documentation that the module requires Python 2, you can also report a bug on our `bug tracker <https://github.com/ansible/ansible/issues>`_ so that the incompatibility can be fixed in a future release." +msgstr "プラットフォームã«ã‚ˆã£ã¦ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ Python3 ã®ã¿ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚:command:`/usr/bin/python` ã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ãªã„å ´åˆã¯ã€``ansible_python_interpreter`` を介ã—ã¦ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã¸ã®ãƒ‘スをè¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚コアモジュールã®å¤šã㌠Python 3 ã¨é€£æºã—ã¾ã™ãŒã€ã„ãã¤ã‹ã®ç‰¹æ®Šç”¨é€”ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯å‹•ä½œã—ãªã„ã‹ã‚‚ã—ã‚Œãªã„ã—ã€ç‰¹æ®Šãªã‚±ãƒ¼ã‚¹ã§ãƒã‚°ãŒç™ºç”Ÿã™ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。一時的ãªå›žé¿ç–ã¨ã—ã¦ã€ç®¡ç†å¯¾è±¡ãƒ›ã‚¹ãƒˆã« Python 2をインストールã—ã€``ansible_python_interpreter`` ã‹ã‚‰ãã® Python を使用ã™ã‚‹ã‚ˆã†ã« Ansible を構æˆã§ãã¾ã™ã€‚モジュールã®ãƒ‰ã‚ュメント㫠Python 2 ãŒå¿…è¦ã‚ã‚‹ã¨ã®è¨˜è¼‰ãŒãªã„å ´åˆã¯ã€ä»Šå¾Œã“ã®ãƒªãƒªãƒ¼ã‚¹ã§éžäº’æ›æ€§ã®å•é¡ŒãŒè§£æ±ºã•ã‚Œã‚‹ã‚ˆã†ã«ã€`bug tracker <https://github.com/ansible/ansible/issues>`_ ã§ã€ãƒã‚°ã‚’å ±å‘Šã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:177 +#: ../../rst/reference_appendices/faq.rst:179 msgid "Do not replace the shebang lines of your python modules. Ansible will do this for you automatically at deploy time." msgstr "Python モジュールã®ã‚·ãƒãƒ³è¡Œã¯ç½®ãæ›ãˆãªã„ã§ãã ã•ã„。デプãƒã‚¤æ™‚ã« Ansible ãŒè‡ªå‹•ã§ã“れを行ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:179 +#: ../../rst/reference_appendices/faq.rst:181 msgid "Also, this works for ANY interpreter, for example ruby: ``ansible_ruby_interpreter``, perl: ``ansible_perl_interpreter``, and so on, so you can use this for custom modules written in any scripting language and control the interpreter location." msgstr "ã¾ãŸã€ã“ã‚Œã¯ã€ruby ãªã©ã®ã™ã¹ã¦ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リター (ruby: ``ansible_ruby_interpreter``ã€perl: ``ansible_perl_interpreter`` ãªã©) ã§æ©Ÿèƒ½ã™ã‚‹ãŸã‚ã€ä»»æ„ã®ã‚¹ã‚¯ãƒªãƒ—ト言語ã§è¨˜è¿°ã—ãŸã‚«ã‚¹ã‚¿ãƒ モジュールã«ã“れを使用ã—ã¦ã€ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã®å ´æ‰€ã‚’管ç†ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:182 +#: ../../rst/reference_appendices/faq.rst:184 msgid "Keep in mind that if you put ``env`` in your module shebang line (``#!/usr/bin/env <other>``), this facility will be ignored so you will be at the mercy of the remote `$PATH`." msgstr "モジュールã®ã‚·ãƒãƒ³ã®è¡Œ (``#!/usr/bin/env <other>``) ã« ``env`` を挿入ã™ã‚‹ã¨ã€ã“ã®æ©Ÿèƒ½ã¯ç„¡è¦–ã•ã‚Œã€ãƒªãƒ¢ãƒ¼ãƒˆã® `$PATH` ã®è¨å®šãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:188 +#: ../../rst/reference_appendices/faq.rst:190 msgid "How do I handle the package dependencies required by Ansible package dependencies during Ansible installation ?" msgstr "Ansible インストールä¸ã« Ansible パッケージã«å¿…è¦ãªä¾å˜é–¢ä¿‚ã«ã©ã®ã‚ˆã†ã«å¯¾å¿œã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:190 +#: ../../rst/reference_appendices/faq.rst:192 msgid "While installing Ansible, sometimes you may encounter errors such as `No package 'libffi' found` or `fatal error: Python.h: No such file or directory` These errors are generally caused by the missing packages, which are dependencies of the packages required by Ansible. For example, `libffi` package is dependency of `pynacl` and `paramiko` (Ansible -> paramiko -> pynacl -> libffi)." msgstr "Ansible ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ä¸ã«ã€`No package 'libffi' found` ã¾ãŸã¯ `fatal error: Python.h: No such file or directory` ãªã©ã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ã‚ˆã†ãªã‚¨ãƒ©ãƒ¼ã¯é€šå¸¸ã€Ansible ã§å¿…è¦ãªãƒ‘ッケージã®ä¾å˜é–¢ä¿‚パッケージãŒä¸è¶³ã—ã¦ã„ã‚‹å ´åˆã«ç™ºç”Ÿã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€`libffi` パッケージ㯠`pynacl` ãŠã‚ˆã³ `paramiko` ã®ä¾å˜é–¢ä¿‚ã§ã™ (Ansible -> paramiko -> pynacl -> libffi)。" -#: ../../rst/reference_appendices/faq.rst:194 +#: ../../rst/reference_appendices/faq.rst:196 msgid "In order to solve these kinds of dependency issues, you might need to install required packages using the OS native package managers, such as `yum`, `dnf`, or `apt`, or as mentioned in the package installation guide." msgstr "ã“ã®ã‚ˆã†ãªä¾å˜é–¢ä¿‚ã®å•é¡Œã‚’解決ã™ã‚‹ã«ã¯ã€OS ãƒã‚¤ãƒ†ã‚£ãƒ–ã®ãƒ‘ッケージマãƒãƒ¼ã‚¸ãƒ£ãƒ¼ (`yum`ã€`dnf`ã€`apt`ã€ã¾ãŸã¯ãƒ‘ッケージã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚¬ã‚¤ãƒ‰ã«è¨˜è¼‰ã®ã‚‚ã®) を使用ã—ã¦å¿…è¦ãªãƒ‘ッケージをインストールã—ãªã„ã¨ã„ã‘ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:197 +#: ../../rst/reference_appendices/faq.rst:199 msgid "Refer to the documentation of the respective package for such dependencies and their installation methods." msgstr "ã“ã®ã‚ˆã†ãªä¾å˜é–¢ä¿‚ã¨ãã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ–¹æ³•ã«ã¤ã„ã¦ã¯ã€å„パッケージã®ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:200 +#: ../../rst/reference_appendices/faq.rst:202 msgid "Common Platform Issues" msgstr "一般的ãªãƒ—ラットフォームã®å•é¡Œ" -#: ../../rst/reference_appendices/faq.rst:203 +#: ../../rst/reference_appendices/faq.rst:205 msgid "What customer platforms does Red Hat support?" msgstr "Red Hat ã§ã¯ã€ã©ã®ã‚ˆã†ãªé¡§å®¢ã®ãƒ—ラットフォームをサãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:205 +#: ../../rst/reference_appendices/faq.rst:207 msgid "A number of them! For a definitive list please see this `Knowledge Base article <https://access.redhat.com/articles/3168091>`_." msgstr "ãã®æ•°ã¯å¤šæ•°ã§ã™ã€‚具体的ãªä¸€è¦§ã¯ã€`ナレッジベースã®è¨˜äº‹ <https://access.redhat.com/articles/3168091>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:208 +#: ../../rst/reference_appendices/faq.rst:210 msgid "Running in a virtualenv" msgstr "virtualenv ã§ã®å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:210 +#: ../../rst/reference_appendices/faq.rst:212 msgid "You can install Ansible into a virtualenv on the controller quite simply:" msgstr "コントãƒãƒ¼ãƒ©ãƒ¼ã® virtualenv ã« Ansible ã‚’ç°¡å˜ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:218 +#: ../../rst/reference_appendices/faq.rst:220 msgid "If you want to run under Python 3 instead of Python 2 you may want to change that slightly:" msgstr "Python 2 ã§ã¯ãªã Python 3 ã§å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«å¤‰æ›´ã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:226 -msgid "If you need to use any libraries which are not available via pip (for instance, SELinux Python bindings on systems such as Red Hat Enterprise Linux or Fedora that have SELinux enabled), then you need to install them into the virtualenv. There are two methods:" +#: ../../rst/reference_appendices/faq.rst:228 +msgid "If you need to use any libraries which are not available through pip (for instance, SELinux Python bindings on systems such as Red Hat Enterprise Linux or Fedora that have SELinux enabled), then you need to install them into the virtualenv. There are two methods:" msgstr "pip ã§å…¥æ‰‹ã§ããªã„ライブラリーを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ (例: SELinux ãŒæœ‰åŠ¹ãª Red Hat Enterprise Linux ã¾ãŸã¯ Fedora ãªã©ã®ã‚·ã‚¹ãƒ†ãƒ ã«ã‚ã‚‹ SELinux Python ã®ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°)ã€virtualenv ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚2 ã¤ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:230 +#: ../../rst/reference_appendices/faq.rst:232 msgid "When you create the virtualenv, specify ``--system-site-packages`` to make use of any libraries installed in the system's Python:" msgstr "virtualenv ã®ä½œæˆæ™‚ã«ã€``--system-site-packages`` を指定ã—ã¦ã€ãŠä½¿ã„ã®ã‚·ã‚¹ãƒ†ãƒ ã® Python ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„るライブラリーを使用ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:237 +#: ../../rst/reference_appendices/faq.rst:239 msgid "Copy those files in manually from the system. For instance, for SELinux bindings you might do:" msgstr "システムã‹ã‚‰æ‰‹å‹•ã§ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’コピーã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€SELinux ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã§ã¯ã€ä»¥ä¸‹ã‚’è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:247 +#: ../../rst/reference_appendices/faq.rst:249 msgid "Running on macOS" msgstr "macOS ã§ã®å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:249 +#: ../../rst/reference_appendices/faq.rst:251 msgid "When executing Ansible on a system with macOS as a controller machine one might encounter the following error:" msgstr "コントãƒãƒ¼ãƒ©ãƒ¼ãƒžã‚·ãƒ³ã¨ã—㦠macOS を使用ã—ã¦ã„るシステム㧠Ansible を実行ã™ã‚‹ã¨ã€æ¬¡ã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:252 +#: ../../rst/reference_appendices/faq.rst:254 msgid "+[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug. ERROR! A worker was found in a dead state" msgstr "+[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug. ERROR! A worker was found in a dead state" -#: ../../rst/reference_appendices/faq.rst:255 +#: ../../rst/reference_appendices/faq.rst:257 msgid "In general the recommended workaround is to set the following environment variable in your shell:" msgstr "一般的ã«æŽ¨å¥¨ã•ã‚Œã‚‹å›žé¿ç–ã¯ã€ã‚·ã‚§ãƒ«ã«æ¬¡ã®ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã™ã‚‹ã“ã¨ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:263 +#: ../../rst/reference_appendices/faq.rst:265 msgid "Running on BSD" msgstr "BSD ã§ã®å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:265 +#: ../../rst/reference_appendices/faq.rst:267 msgid ":ref:`working_with_bsd`" msgstr ":ref:`working_with_bsd`" -#: ../../rst/reference_appendices/faq.rst:269 +#: ../../rst/reference_appendices/faq.rst:271 msgid "Running on Solaris" msgstr "Solaris ã§ã®å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:271 +#: ../../rst/reference_appendices/faq.rst:273 msgid "By default, Solaris 10 and earlier run a non-POSIX shell which does not correctly expand the default tmp directory Ansible uses ( :file:`~/.ansible/tmp`). If you see module failures on Solaris machines, this is likely the problem. There are several workarounds:" msgstr "デフォルトã§ã¯ Solaris 10 以å‰ã§ã¯ POSIX 以外ã®ã‚·ã‚§ãƒ«ã‚’実行ã—ã¾ã™ãŒã€Ansible ãŒä½¿ç”¨ã™ã‚‹ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® tmp ディレクトリー (:file:`~/.ansible/tmp`) ã‚’æ£ã—ã展開ã—ã¾ã›ã‚“。Solaris マシンã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å ´åˆã«ã¯ã€ä¸Šè¨˜ãŒå•é¡Œã®å¯èƒ½æ€§ãŒé«˜ã„ã§ã™ã€‚回é¿ç–ã¯ã„ãã¤ã‹ã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:275 -msgid "You can set ``remote_tmp`` to a path that will expand correctly with the shell you are using (see the plugin documentation for :ref:`C shell<csh_shell>`, :ref:`fish shell<fish_shell>`, and :ref:`Powershell<powershell_shell>`). For example, in the ansible config file you can set::" +#: ../../rst/reference_appendices/faq.rst:277 +msgid "You can set ``remote_tmp`` to a path that will expand correctly with the shell you are using (see the plugin documentation for :ref:`C shell<csh_shell>`, :ref:`fish shell<fish_shell>`, and :ref:`Powershell<powershell_shell>`). For example, in the ansible config file you can set:" msgstr "使用ã™ã‚‹ã‚·ã‚§ãƒ« (:ref:`C shell<csh_shell>`ã€:ref:`fish shell<fish_shell>`ã€ãŠã‚ˆã³ :ref:`Powershell<powershell_shell>` ã®ãƒ—ラグインã®ãƒ‰ã‚ュメントをå‚ç…§) ã§æ£ã—ã展開ã•ã‚Œã‚‹ãƒ‘ス㫠``remote_tmp`` ã‚’è¨å®šã—ã¾ã™ã€‚è¨å®šã™ã‚‹ ansible è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ã€ä»¥ä¸‹ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:281 -msgid "In Ansible 2.5 and later, you can also set it per-host in inventory like this::" +#: ../../rst/reference_appendices/faq.rst:285 +msgid "In Ansible 2.5 and later, you can also set it per-host in inventory like this:" msgstr "Ansible 2.5 以é™ã§ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§ãƒ›ã‚¹ãƒˆã”ã¨ã«è¨å®šã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:285 -msgid "You can set :ref:`ansible_shell_executable<ansible_shell_executable>` to the path to a POSIX compatible shell. For instance, many Solaris hosts have a POSIX shell located at :file:`/usr/xpg4/bin/sh` so you can set this in inventory like so::" +#: ../../rst/reference_appendices/faq.rst:291 +msgid "You can set :ref:`ansible_shell_executable<ansible_shell_executable>` to the path to a POSIX compatible shell. For instance, many Solaris hosts have a POSIX shell located at :file:`/usr/xpg4/bin/sh` so you can set this in inventory like so:" msgstr ":ref:`ansible_shell_executable<ansible_shell_executable>` ã‚’ã€POSIX ã®äº’æ›æ€§ã®ã‚るパスã«è¨å®šã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€å¤šæ•°ã® Solaris ホストã§ã¯ POSIX シェルãŒã€:file:`/usr/xpg4/bin/sh` ã«é…ç½®ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã«ã“ã®å€¤ã‚’以下ã®ã‚ˆã†ã«è¨å®šã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:291 +#: ../../rst/reference_appendices/faq.rst:299 msgid "(bash, ksh, and zsh should also be POSIX compatible if you have any of those installed)." msgstr "(bashã€kshã€ã¾ãŸã¯ zsh ã®ã„ãšã‚Œã‹ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã«ã¯ã€ã“れも POSIX ã®äº’æ›æ€§ãŒå¿…è¦ã§ã™)。" -#: ../../rst/reference_appendices/faq.rst:294 +#: ../../rst/reference_appendices/faq.rst:302 msgid "Running on z/OS" msgstr "z/OS ã§ã®å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:296 +#: ../../rst/reference_appendices/faq.rst:304 msgid "There are a few common errors that one might run into when trying to execute Ansible on z/OS as a target." msgstr "z/OS ã§ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã¨ã—㦠Ansible を実行ã—よã†ã¨ã™ã‚‹ã¨ã€è¤‡æ•°ã®å…±é€šã®ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:298 +#: ../../rst/reference_appendices/faq.rst:306 msgid "Version 2.7.6 of python for z/OS will not work with Ansible because it represents strings internally as EBCDIC." msgstr "z/OS å‘ã‘ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.7.6 ã¯ã€å†…部ã§æ–‡å—列を EBCDIC ã¨ã—ã¦è¡¨ç¾ã™ã‚‹ãŸã‚ã€Ansible ã§ã¯æ©Ÿèƒ½ã—ãªã„。" -#: ../../rst/reference_appendices/faq.rst:300 +#: ../../rst/reference_appendices/faq.rst:308 msgid "To get around this limitation, download and install a later version of `python for z/OS <https://www.rocketsoftware.com/zos-open-source>`_ (2.7.13 or 3.6.1) that represents strings internally as ASCII. Version 2.7.13 is verified to work." msgstr "ã“ã®åˆ¶é™ã‚’回é¿ã™ã‚‹ã«ã¯ã€æ–‡å—列を ASCII ã§è¡¨ç¾ã™ã‚‹ `python for z/OS <https://www.rocketsoftware.com/zos-open-source>`_ (2.7.13 ã¾ãŸã¯ 3.6.1) をダウンãƒãƒ¼ãƒ‰ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¦ãã ã•ã„。ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.7.13 ã§ã¯æ©Ÿèƒ½ã™ã‚‹ã“ã¨ãŒç¢ºèªã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:302 -msgid "When ``pipelining = False`` in `/etc/ansible/ansible.cfg` then Ansible modules are transferred in binary mode via sftp however execution of python fails with" +#: ../../rst/reference_appendices/faq.rst:310 +msgid "When ``pipelining = False`` in `/etc/ansible/ansible.cfg` then Ansible modules are transferred in binary mode through sftp however execution of python fails with" msgstr "`/etc/ansible/ansible.cfg` 㧠``pipelining = False`` ã¨æŒ‡å®šã•ã‚Œã¦ã„ã‚‹å ´åˆã€ä»¥ä¸‹ã«ã‚ˆã‚Šã€Ansible モジュール㯠Python ã®å®Ÿè¡Œã‚¨ãƒ©ãƒ¼ãŒä½•ã§ã‚ã£ã¦ã‚‚ã€sftp 経由ã§ãƒã‚¤ãƒŠãƒªãƒ¼ãƒ¢ãƒ¼ãƒ‰ã§è»¢é€ã•ã‚Œã‚‹ã€‚" -#: ../../rst/reference_appendices/faq.rst:305 +#: ../../rst/reference_appendices/faq.rst:313 msgid "SyntaxError: Non-UTF-8 code starting with \\'\\\\x83\\' in file /a/user1/.ansible/tmp/ansible-tmp-1548232945.35-274513842609025/AnsiballZ_stat.py on line 1, but no encoding declared; see https://python.org/dev/peps/pep-0263/ for details" msgstr "SyntaxError: Non-UTF-8 code starting with \\'\\\\x83\\' in file /a/user1/.ansible/tmp/ansible-tmp-1548232945.35-274513842609025/AnsiballZ_stat.py on line 1, but no encoding declared; see https://python.org/dev/peps/pep-0263/ for details" -#: ../../rst/reference_appendices/faq.rst:307 +#: ../../rst/reference_appendices/faq.rst:315 msgid "To fix it set ``pipelining = True`` in `/etc/ansible/ansible.cfg`." msgstr "ã“れを修æ£ã™ã‚‹ã«ã¯ã€`/etc/ansible/ansible.cfg` ã« ``pipelining = True`` ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:309 +#: ../../rst/reference_appendices/faq.rst:317 msgid "Python interpret cannot be found in default location ``/usr/bin/python`` on target host." msgstr "Python インタープリターãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒ›ã‚¹ãƒˆã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®å ´æ‰€ ``/usr/bin/python`` ã§æ¤œå‡ºã§ããªã„。" -#: ../../rst/reference_appendices/faq.rst:312 +#: ../../rst/reference_appendices/faq.rst:320 msgid "/usr/bin/python: EDC5129I No such file or directory" msgstr "/usr/bin/python: EDC5129I No such file or directory" -#: ../../rst/reference_appendices/faq.rst:314 +#: ../../rst/reference_appendices/faq.rst:322 msgid "To fix this set the path to the python installation in your inventory like so::" msgstr "ã“れを解決ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§ãƒ‘スを Python インストールã«è¨å®šã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:318 +#: ../../rst/reference_appendices/faq.rst:326 +msgid "zos1 ansible_python_interpreter=/usr/lpp/python/python-2017-04-12-py27/python27/bin/python" +msgstr "zos1 ansible_python_interpreter=/usr/lpp/python/python-2017-04-12-py27/python27/bin/python" + +#: ../../rst/reference_appendices/faq.rst:328 msgid "Start of python fails with ``The module libpython2.7.so was not found.``" msgstr "python ã®èµ·å‹•ã«å¤±æ•—ã—ã€``The module libpython2.7.so was not found.`` ãŒè¡¨ç¤ºã•ã‚Œã‚‹ã€‚" -#: ../../rst/reference_appendices/faq.rst:321 +#: ../../rst/reference_appendices/faq.rst:331 msgid "EE3501S The module libpython2.7.so was not found." msgstr "EE3501S The module libpython2.7.so was not found." -#: ../../rst/reference_appendices/faq.rst:323 -msgid "On z/OS, you must execute python from gnu bash. If gnu bash is installed at ``/usr/lpp/bash``, you can fix this in your inventory by specifying an ``ansible_shell_executable``::" +#: ../../rst/reference_appendices/faq.rst:333 +msgid "On z/OS, you must execute python from gnu bash. If gnu bash is installed at ``/usr/lpp/bash``, you can fix this in your inventory by specifying an ``ansible_shell_executable``:" msgstr "z/OS ã§ã¯ã€gnu bash ã‹ã‚‰ python を実行ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚gnu bash ㌠``/usr/lpp/bash`` ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã§ ``ansible_shell_executable`` を指定ã—ã¦ä¿®æ£ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:329 +#: ../../rst/reference_appendices/faq.rst:341 msgid "Running under fakeroot" msgstr "fakeroot 下ã§å®Ÿè¡Œ" -#: ../../rst/reference_appendices/faq.rst:331 +#: ../../rst/reference_appendices/faq.rst:343 msgid "Some issues arise as ``fakeroot`` does not create a full nor POSIX compliant system by default. It is known that it will not correctly expand the default tmp directory Ansible uses (:file:`~/.ansible/tmp`). If you see module failures, this is likely the problem. The simple workaround is to set ``remote_tmp`` to a path that will expand correctly (see documentation of the shell plugin you are using for specifics)." msgstr "``fakeroot`` ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯å®Œå…¨ãªã‚·ã‚¹ãƒ†ãƒ ã‚‚ POSIX æº–æ‹ ã®ã‚·ã‚¹ãƒ†ãƒ も作æˆã—ãªã„ãŸã‚ã€ã„ãã¤ã‹ã®å•é¡ŒãŒç™ºç”Ÿã—ã¾ã™ã€‚Ansible ãŒä½¿ç”¨ã™ã‚‹ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã® tmp ディレクトリー (:file:`~/.ansible/tmp`) ã‚’æ£ã—ã展開ã—ãªã„ã“ã¨ãŒã‚ã‹ã£ã¦ã„ã¾ã™ã€‚モジュール障害ãŒç™ºç”Ÿã—ã¦ã„ã‚‹å ´åˆã¯ã€ã“ã‚ŒãŒå•é¡Œã§ã‚ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ç°¡å˜ãªå›žé¿ç–ã¯ã€æ£ã—ã展開ã•ã‚Œã‚‹ãƒ‘ス㫠``remote_tmp`` ã‚’è¨å®šã™ã‚‹ã“ã¨ã§ã™ (詳細ã«ã¤ã„ã¦ã¯ã€ä½¿ç”¨ã—ã¦ã„ã‚‹ shell プラグインã®ãƒ‰ã‚ュメントをå‚ç…§ã—ã¦ãã ã•ã„)。" -#: ../../rst/reference_appendices/faq.rst:336 -msgid "For example, in the ansible config file (or via environment variable) you can set::" +#: ../../rst/reference_appendices/faq.rst:348 +msgid "For example, in the ansible config file (or through environment variable) you can set:" msgstr "è¨å®šã™ã‚‹ ansible è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ (ã¾ãŸã¯ç’°å¢ƒå¤‰æ•°ã‚’介ã—ã¦)ã€ä»¥ä¸‹ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:345 +#: ../../rst/reference_appendices/faq.rst:359 msgid "What is the best way to make content reusable/redistributable?" msgstr "コンテンツをå†åˆ©ç”¨/å†é…ä¿¡ã§ãるよã†ã«ã™ã‚‹æœ€é©ãªæ–¹æ³•ã«ã¯ã©ã‚“ãªã‚‚ã®ãŒã‚ã‚Šã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:347 +#: ../../rst/reference_appendices/faq.rst:361 msgid "If you have not done so already, read all about \"Roles\" in the playbooks documentation. This helps you make playbook content self-contained, and works well with things like git submodules for sharing content with others." msgstr "Playbook ドã‚ュメントã®ã€Œãƒãƒ¼ãƒ«ã€ã®æƒ…å ±ã‚’ã¾ã 確èªã—ã¦ã„ãªã„å ´åˆã¯ã€ä¸€èªã—ã¦ãã ã•ã„。Playbook ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„を自己完çµåž‹ã«ã—ã€git submodules ãªã©ã¨é€£æºã•ã›ã¦ã€ä»–ã¨ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„共有ãŒå®¹æ˜“ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:350 +#: ../../rst/reference_appendices/faq.rst:364 msgid "If some of these plugin types look strange to you, see the API documentation for more details about ways Ansible can be extended." msgstr "ã“ã®ã‚ˆã†ãªãƒ—ラグインタイプã®è©³ç´°ã¯ã€Ansible ã®æ‹¡å¼µæ–¹æ³•ã«é–¢ã™ã‚‹è©³ç´°ã‚’ API ドã‚ュメントã§ç¢ºèªã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:355 +#: ../../rst/reference_appendices/faq.rst:369 msgid "Where does the configuration file live and what can I configure in it?" msgstr "è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã®é…ç½®å ´æ‰€ã¯ã©ã“ã§ã™ã‹ã€‚ã¾ãŸã¯ã€ã©ã®ã‚ˆã†ã«è¨å®šã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:358 +#: ../../rst/reference_appendices/faq.rst:372 msgid "See :ref:`intro_configuration`." msgstr "「:ref:`intro_configuration`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:363 +#: ../../rst/reference_appendices/faq.rst:377 msgid "How do I disable cowsay?" msgstr "cowsay ã¯ã©ã®ã‚ˆã†ã«ç„¡åŠ¹åŒ–ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:365 +#: ../../rst/reference_appendices/faq.rst:379 msgid "If cowsay is installed, Ansible takes it upon itself to make your day happier when running playbooks. If you decide that you would like to work in a professional cow-free environment, you can either uninstall cowsay, set ``nocows=1`` in ``ansible.cfg``, or set the :envvar:`ANSIBLE_NOCOWS` environment variable:" msgstr "cowsay ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€Playbook を実行ã™ã‚‹ã¨ã€Ansible ãŒã™ã¹ã¦ã‚’引ãå—ã‘ã¦å‡¦ç†ã—ã¾ã™ã€‚プãƒãƒ•ã‚§ãƒƒã‚·ãƒ§ãƒŠãƒ«ãª cowsay ã®ãªã„環境ã§ä½œæ¥ã™ã‚‹å ´åˆã¯ã€cowsay をアンインストールã™ã‚‹ã‹ã€``ansible.cfg`` ã« ``nocows=1`` ã‚’è¨å®šã™ã‚‹ã‹ã€:envvar:`ANSIBLE_NOCOWS` ã®ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:376 +#: ../../rst/reference_appendices/faq.rst:390 msgid "How do I see a list of all of the ansible\\_ variables?" msgstr "ansible\\_ 変数一覧を確èªã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:378 +#: ../../rst/reference_appendices/faq.rst:392 msgid "Ansible by default gathers \"facts\" about the machines under management, and these facts can be accessed in playbooks and in templates. To see a list of all of the facts that are available about a machine, you can run the ``setup`` module as an ad hoc action:" msgstr "Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€ç®¡ç†å¯¾è±¡ã®ãƒžã‚·ãƒ³ã®ã€Œãƒ•ã‚¡ã‚¯ãƒˆã€ã‚’åŽé›†ã—ã€ã“ã®ãƒ•ã‚¡ã‚¯ãƒˆã«ã¯ Playbook ã¾ãŸã¯ãƒ†ãƒ³ãƒ—レートã§ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚ã‚るマシンã§åˆ©ç”¨å¯èƒ½ãªãƒ•ã‚¡ã‚¯ãƒˆã®ä¸€è¦§ã‚’表示ã™ã‚‹ã«ã¯ã€``setup`` モジュールを ad-hoc アクションã¨ã—ã¦å®Ÿè¡Œã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:386 +#: ../../rst/reference_appendices/faq.rst:400 msgid "This will print out a dictionary of all of the facts that are available for that particular host. You might want to pipe the output to a pager.This does NOT include inventory variables or internal 'magic' variables. See the next question if you need more than just 'facts'." msgstr "ã“ã‚Œã«ã‚ˆã‚Šã€ç‰¹å®šã®ãƒ›ã‚¹ãƒˆã§åˆ©ç”¨å¯èƒ½ãªå…¨ãƒ•ã‚¡ã‚¯ãƒˆã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ãŒå‡ºåŠ›ã•ã‚Œã¾ã™ã€‚ページャーã®å‡ºåŠ›ã‚’パイプã™ã‚‹å ´åˆã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã‚„内部ã®ã€Œmagicã€å¤‰æ•°ã¯å«ã¾ã‚Œã¾ã›ã‚“。「ファクトã€ä»¥å¤–ã®æƒ…å ±ãŒå¿…è¦ãªå ´åˆã¯ã€æ¬¡ã®è³ªå•ã‚’確èªã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:394 +#: ../../rst/reference_appendices/faq.rst:408 msgid "How do I see all the inventory variables defined for my host?" msgstr "ホストã«å®šç¾©ã•ã‚ŒãŸã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã‚’ã™ã¹ã¦ç¢ºèªã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:396 +#: ../../rst/reference_appendices/faq.rst:410 msgid "By running the following command, you can see inventory variables for a host:" msgstr "以下ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã™ã‚‹ã¨ã€ãƒ›ã‚¹ãƒˆã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã‚’確èªã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:406 +#: ../../rst/reference_appendices/faq.rst:420 msgid "How do I see all the variables specific to my host?" msgstr "ホスト固有ã®å…¨å¤‰æ•°ã‚’確èªã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:408 +#: ../../rst/reference_appendices/faq.rst:422 msgid "To see all host specific variables, which might include facts and other sources:" msgstr "ホスト固有ã®å¤‰æ•°ã‚’ã™ã¹ã¦ç¢ºèªã™ã‚‹ã«ã¯ä»¥ä¸‹ã‚’実行ã—ã¾ã™ (ファクトや他ã®ã‚½ãƒ¼ã‚¹ãŒå«ã¾ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™)。" -#: ../../rst/reference_appendices/faq.rst:414 +#: ../../rst/reference_appendices/faq.rst:428 msgid "Unless you are using a fact cache, you normally need to use a play that gathers facts first, for facts included in the task above." msgstr "ファクトã‚ャッシュを使用ã—ã¦ã„ãªã„é™ã‚Šã€ä¸Šè¨˜ã®ã‚¿ã‚¹ã‚¯ã«å«ã¾ã‚Œã‚‹ãƒ•ã‚¡ã‚¯ãƒˆã«ã¤ã„ã¦ã¯ã€é€šå¸¸ã€å…ˆã«ãƒ•ã‚¡ã‚¯ãƒˆã‚’åŽé›†ã™ã‚‹ãƒ—レイを使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:420 +#: ../../rst/reference_appendices/faq.rst:434 msgid "How do I loop over a list of hosts in a group, inside of a template?" msgstr "テンプレート内ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«å«ã¾ã‚Œã‚‹ãƒ›ã‚¹ãƒˆã®ä¸€è¦§ã‚’ループã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:422 +#: ../../rst/reference_appendices/faq.rst:436 msgid "A pretty common pattern is to iterate over a list of hosts inside of a host group, perhaps to populate a template configuration file with a list of servers. To do this, you can just access the \"$groups\" dictionary in your template, like this:" msgstr "éžå¸¸ã«ä¸€èˆ¬çš„ãªãƒ‘ターンã§ã¯ã€ãƒ›ã‚¹ãƒˆã‚°ãƒ«ãƒ¼ãƒ—内ã§ãƒ›ã‚¹ãƒˆã®ãƒªã‚¹ãƒˆã‚’å復処ç†ã™ã‚‹ã“ã¨ã§ã™ã€‚ãŠãらãã€ãƒ†ãƒ³ãƒ—レートè¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚µãƒ¼ãƒãƒ¼ã®ä¸€è¦§ã‚’入力ã—ã¾ã™ã€‚ã“れを行ã†ã«ã¯ã€æ¬¡ã®ã‚ˆã†ã«ã€ãƒ†ãƒ³ãƒ—レートã§ã€Œ$ groupsã€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã ã‘ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:431 -msgid "If you need to access facts about these hosts, for instance, the IP address of each hostname, you need to make sure that the facts have been populated. For example, make sure you have a play that talks to db_servers::" +#: ../../rst/reference_appendices/faq.rst:445 +msgid "If you need to access facts about these hosts, for instance, the IP address of each hostname, you need to make sure that the facts have been populated. For example, make sure you have a play that talks to db_servers:" msgstr "ã“ã®ã‚ˆã†ãªãƒ›ã‚¹ãƒˆã«é–¢ã™ã‚‹ãƒ•ã‚¡ã‚¯ãƒˆ (å„ホストåã® IP アドレスãªã©) ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã«ã¯ã€ãƒ•ã‚¡ã‚¯ãƒˆãŒç”Ÿæˆã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ãŸã¨ãˆã°ã€db_servers ã¨å¯¾è©±ã™ã‚‹ãƒ—レイãŒã‚ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™::" -#: ../../rst/reference_appendices/faq.rst:438 +#: ../../rst/reference_appendices/faq.rst:454 msgid "Then you can use the facts inside your template, like this:" msgstr "次ã«ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ã€ãƒ†ãƒ³ãƒ—レート内ã®ãƒ•ã‚¡ã‚¯ãƒˆã‚’使用ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:449 +#: ../../rst/reference_appendices/faq.rst:465 msgid "How do I access a variable name programmatically?" msgstr "プãƒã‚°ãƒ©ãƒ ã§å¤‰æ•°åã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:451 -msgid "An example may come up where we need to get the ipv4 address of an arbitrary interface, where the interface to be used may be supplied via a role parameter or other input. Variable names can be built by adding strings together using \"~\", like so:" +#: ../../rst/reference_appendices/faq.rst:467 +msgid "An example may come up where we need to get the ipv4 address of an arbitrary interface, where the interface to be used may be supplied through a role parameter or other input. Variable names can be built by adding strings together using \"~\", like so:" msgstr "ãŸã¨ãˆã°ã€ä»»æ„ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã® ipv4 アドレスをå–å¾—ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。ãã“ã§ã¯ã€ä½¿ç”¨ã•ã‚Œã‚‹ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ãŒãƒãƒ¼ãƒ«ãƒ‘ラメーターã¾ãŸã¯ä»–ã®å…¥åŠ›ã‚’介ã—ã¦æä¾›ã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚変数åã¯ã€æ¬¡ã®ã‚ˆã†ã«ã€Œ~ã€ã‚’使用ã—ã¦æ–‡å—列を一緒ã«è¿½åŠ ã™ã‚‹ã“ã¨ã§ä½œæˆã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:458 +#: ../../rst/reference_appendices/faq.rst:474 msgid "The trick about going through hostvars is necessary because it's a dictionary of the entire namespace of variables. ``inventory_hostname`` is a magic variable that indicates the current host you are looping over in the host loop." msgstr "ãã‚Œã¯ã€å¤‰æ•°ã®åå‰ç©ºé–“全体ã®ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã§ã‚ã‚‹ãŸã‚ã€hostvars 全体をãƒã‚§ãƒƒã‚¯ã™ã‚‹ã«ã¯ã‚³ãƒ„ãŒå¿…è¦ã§ã™ã€‚``inventory_hostname`` ã¯ãƒžã‚¸ãƒƒã‚¯å¤‰æ•°ã§ã€ãƒ›ã‚¹ãƒˆãƒ«ãƒ¼ãƒ—ã§ãƒ«ãƒ¼ãƒ—ã‚’è¡Œã†ç¾åœ¨ã®ãƒ›ã‚¹ãƒˆã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:461 +#: ../../rst/reference_appendices/faq.rst:477 msgid "In the example above, if your interface names have dashes, you must replace them with underscores:" msgstr "上記ã®ä¾‹ã§ã¯ã€ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹åã«ãƒ€ãƒƒã‚·ãƒ¥ãŒå«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ã‚¢ãƒ³ãƒ€ãƒ¼ã‚¹ã‚³ã‚¢ã«ç½®ãæ›ãˆã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:467 +#: ../../rst/reference_appendices/faq.rst:483 msgid "Also see dynamic_variables_." msgstr "「dynamic_variables_ã€ã‚‚å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:473 +#: ../../rst/reference_appendices/faq.rst:489 msgid "How do I access a group variable?" msgstr "グループ変数ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:475 +#: ../../rst/reference_appendices/faq.rst:491 msgid "Technically, you don't, Ansible does not really use groups directly. Groups are labels for host selection and a way to bulk assign variables, they are not a first class entity, Ansible only cares about Hosts and Tasks." msgstr "技術的ã«ã¯ã€Ansible ã¯å®Ÿéš›ã«ã¯ã‚°ãƒ«ãƒ¼ãƒ—を直接使用ã—ã¾ã›ã‚“。グループã¯ãƒ›ã‚¹ãƒˆé¸æŠžã®ãƒ©ãƒ™ãƒ«ã§ã‚ã‚Šã€å¤‰æ•°ã‚’一括ã§å‰²ã‚Šå½“ã¦ã‚‹æ‰‹æ®µã‚’æä¾›ã—ã¾ã™ã€‚グループã¯ç¬¬ä¸€ç´šã®ã‚¨ãƒ³ãƒ†ã‚£ãƒ†ã‚£ãƒ¼ã§ã¯ãªãã€Ansible ã¯ãƒ›ã‚¹ãƒˆã¨ã‚¿ã‚¹ã‚¯ã®ã¿ã‚’考慮ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:478 +#: ../../rst/reference_appendices/faq.rst:494 msgid "That said, you could just access the variable by selecting a host that is part of that group, see first_host_in_a_group_ below for an example." msgstr "ãŸã ã—ã€å¯¾è±¡ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«å«ã¾ã‚Œã‚‹ãƒ›ã‚¹ãƒˆã‚’é¸æŠžã™ã‚‹ã¨ã€å¤‰æ•°ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚例ã«ã¤ã„ã¦ã¯ã€ä»¥ä¸‹ã®ã€Œfirst_host_in_a_group_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:484 +#: ../../rst/reference_appendices/faq.rst:500 msgid "How do I access a variable of the first host in a group?" msgstr "グループ内ã®æœ€åˆã®ãƒ›ã‚¹ãƒˆã®å¤‰æ•°ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:486 +#: ../../rst/reference_appendices/faq.rst:502 msgid "What happens if we want the ip address of the first webserver in the webservers group? Well, we can do that too. Note that if we are using dynamic inventory, which host is the 'first' may not be consistent, so you wouldn't want to do this unless your inventory is static and predictable. (If you are using AWX or the :ref:`Red Hat Ansible Automation Platform <ansible_platform>`, it will use database order, so this isn't a problem even if you are using cloud based inventory scripts)." msgstr "webservers グループã®æœ€åˆã® webserver ã® IP アドレスãŒå¿…è¦ãªå ´åˆã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹ã€‚ãれも行ã†ã“ã¨ãŒã§ãã¾ã™ã€‚動的インベントリーを使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã©ã®ãƒ›ã‚¹ãƒˆãŒã€Œæœ€åˆã€ã§ã‚ã‚‹ã‹ãŒä¸€è²«ã—ã¦ã„ãªã„å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãŒé™çš„ã§äºˆæ¸¬å¯èƒ½ã§ãªã„é™ã‚Šã€å®Ÿè¡Œã—ãªã„よã†ã«ã—ã¦ãã ã•ã„ (AWX ã¾ãŸã¯ :ref:`Red Hat Ansible Automation Platform <ansible_platform>` を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ãƒ‡ãƒ¼ã‚¿ãƒ™ãƒ¼ã‚¹ã®é †åºã‚’使用ã™ã‚‹ãŸã‚ã€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ™ãƒ¼ã‚¹ã®ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã—ã¦ã„ã‚‹å ´åˆã§ã‚‚ã€ã“ã‚Œã¯å•é¡Œã«ãªã‚Šã¾ã›ã‚“)。" -#: ../../rst/reference_appendices/faq.rst:491 +#: ../../rst/reference_appendices/faq.rst:507 msgid "Anyway, here's the trick:" msgstr "以下ã«æ–¹æ³•ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:497 -msgid "Notice how we're pulling out the hostname of the first machine of the webservers group. If you are doing this in a template, you could use the Jinja2 '#set' directive to simplify this, or in a playbook, you could also use set_fact::" +#: ../../rst/reference_appendices/faq.rst:513 +msgid "Notice how we're pulling out the hostname of the first machine of the webservers group. If you are doing this in a template, you could use the Jinja2 '#set' directive to simplify this, or in a playbook, you could also use set_fact:" msgstr "webserver グループã®æœ€åˆã®ãƒžã‚·ãƒ³ã®ãƒ›ã‚¹ãƒˆåã‚’å–å¾—ã—ã¦ã„る点ã«æ³¨æ„ã—ã¦ãã ã•ã„。テンプレートã§ã“れを実行ã™ã‚‹å ´åˆã¯ã€Jinja2 '#set' ディレクティブを使用ã—ã¦ç°¡ç´ 化ã™ã‚‹ã‹ã€Playbook ã®å ´åˆã¯ set_fact を使用ã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:504 +#: ../../rst/reference_appendices/faq.rst:522 msgid "Notice how we interchanged the bracket syntax for dots -- that can be done anywhere." msgstr "ドットã®ä»£ã‚ã‚Šã«æ‹¬å¼§ã®æ§‹æ–‡ã‚’使用ã—ã¦ã„る点ã«æ³¨æ„ã—ã¦ãã ã•ã„。ã“ã‚Œã¯ã©ã“ã§ã‚‚使用ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:509 +#: ../../rst/reference_appendices/faq.rst:527 msgid "How do I copy files recursively onto a target host?" msgstr "ターゲットホストã«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’å†å¸°çš„ã«ã‚³ãƒ”ーã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:511 +#: ../../rst/reference_appendices/faq.rst:529 msgid "The ``copy`` module has a recursive parameter. However, take a look at the ``synchronize`` module if you want to do something more efficient for a large number of files. The ``synchronize`` module wraps rsync. See the module index for info on both of these modules." msgstr "``copy`` モジュールã«ã¯å†å¸°çš„ãªãƒ‘ラメーターãŒã‚ã‚Šã¾ã™ãŒã€å¤šæ•°ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«ã‚ˆã‚ŠåŠ¹çŽ‡çš„ãªå ´åˆã¯ã€``synchronize`` モジュールをå‚ç…§ã—ã¦ãã ã•ã„。``synchronize`` モジュール㯠rsync をラップã—ã¾ã™ã€‚ã“れらã®ä¸¡æ–¹ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®æƒ…å ±ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚¤ãƒ³ãƒ‡ãƒƒã‚¯ã‚¹ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:517 +#: ../../rst/reference_appendices/faq.rst:535 msgid "How do I access shell environment variables?" msgstr "shell 環境変数ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:520 -msgid "**On controller machine :** Access existing variables from controller use the ``env`` lookup plugin. For example, to access the value of the HOME environment variable on the management machine::" +#: ../../rst/reference_appendices/faq.rst:538 +msgid "**On controller machine :** Access existing variables from controller use the ``env`` lookup plugin. For example, to access the value of the HOME environment variable on the management machine:" msgstr "**コントãƒãƒ¼ãƒ©ãƒ¼ãƒžã‚·ãƒ³ã®å ´åˆ:** コントãƒãƒ¼ãƒ©ãƒ¼ã‹ã‚‰æ—¢å˜ã®å¤‰æ•°ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€``env`` lookup プラグインを使用ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ç®¡ç†ãƒžã‚·ãƒ³ã§ HOME 環境変数ã®å€¤ã«ã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’指定ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:529 -msgid "**On target machines :** Environment variables are available via facts in the ``ansible_env`` variable:" +#: ../../rst/reference_appendices/faq.rst:549 +msgid "**On target machines :** Environment variables are available through facts in the ``ansible_env`` variable:" msgstr "**ターゲットマシン:** 環境変数ã®å ´åˆã«ã¯ã€``ansible_env`` 変数ã®ãƒ•ã‚¡ã‚¯ãƒˆã‚’使用ã—ã¦å…¥æ‰‹ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:535 +#: ../../rst/reference_appendices/faq.rst:555 msgid "If you need to set environment variables for TASK execution, see :ref:`playbooks_environment` in the :ref:`Advanced Playbooks <playbooks_special_topics>` section. There are several ways to set environment variables on your target machines. You can use the :ref:`template <template_module>`, :ref:`replace <replace_module>`, or :ref:`lineinfile <lineinfile_module>` modules to introduce environment variables into files. The exact files to edit vary depending on your OS and distribution and local configuration." msgstr "タスクを実行ã™ã‚‹ãŸã‚ã«ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€:ref:`詳細㪠Playbook <playbooks_special_topics>` セクションã®ã€Œ:ref:`playbooks_environment`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ターゲットマシンã§ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã™ã‚‹ã«ã¯ã€ã„ãã¤ã‹ã®æ–¹æ³•ãŒã‚ã‚Šã¾ã™ã€‚:ref:`template <template_module>` モジュールã€:ref:`replace <replace_module>` モジュールã€ã¾ãŸã¯ :ref:`lineinfile <lineinfile_module>` モジュールを使用ã—ã¦ã€ç’°å¢ƒå¤‰æ•°ã‚’ファイルã«å–り込むã“ã¨ãŒã§ãã¾ã™ã€‚編集ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€OSã€ãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã€ãŠã‚ˆã³ãƒãƒ¼ã‚«ãƒ«è¨å®šã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:545 +#: ../../rst/reference_appendices/faq.rst:565 msgid "How do I generate encrypted passwords for the user module?" msgstr "ユーザーモジュールã®æš—å·åŒ–パスワードを生æˆã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:547 +#: ../../rst/reference_appendices/faq.rst:567 msgid "Ansible ad hoc command is the easiest option:" msgstr "Ansible ad-hoc コマンドを使用ã™ã‚‹ã®ãŒæœ€ã‚‚ç°¡å˜ãªã‚ªãƒ—ションã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:553 +#: ../../rst/reference_appendices/faq.rst:573 msgid "The ``mkpasswd`` utility that is available on most Linux systems is also a great option:" msgstr "ã»ã¨ã‚“ã©ã® Linux システムã§åˆ©ç”¨ã§ãã‚‹ ``mkpasswd`` ユーティリティーも優れãŸã‚ªãƒ—ションã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:560 +#: ../../rst/reference_appendices/faq.rst:580 msgid "If this utility is not installed on your system (for example, you are using macOS) then you can still easily generate these passwords using Python. First, ensure that the `Passlib <https://foss.heptapod.net/python-libs/passlib/-/wikis/home>`_ password hashing library is installed:" msgstr "ãŠä½¿ã„ã®ã‚·ã‚¹ãƒ†ãƒ ã«ã“ã®ãƒ¦ãƒ¼ãƒ†ã‚£ãƒªãƒ†ã‚£ãƒ¼ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ãªã„å ´åˆ (例: MacOS を使用ã—ã¦ã„ã‚‹å ´åˆãªã©) ã«ã¯ã€Python を使用ã—ã¦ã“ã®ã‚ˆã†ãªãƒ‘スワードを簡å˜ã«ç”Ÿæˆã§ãã¾ã™ã€‚ã¾ãšã€`Passlib <https://foss.heptapod.net/python-libs/passlib/-/wikis/home>`_ パスワードãƒãƒƒã‚·ãƒ¥ãƒ©ã‚¤ãƒ–ラリーãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:568 +#: ../../rst/reference_appendices/faq.rst:588 msgid "Once the library is ready, SHA512 password values can then be generated as follows:" msgstr "ライブラリーã®æº–å‚™ãŒã§ããŸã‚‰ã€ä»¥ä¸‹ã®ã‚ˆã†ã« SHA512 パスワードã®å€¤ã‚’生æˆã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:574 +#: ../../rst/reference_appendices/faq.rst:594 msgid "Use the integrated :ref:`hash_filters` to generate a hashed version of a password. You shouldn't put plaintext passwords in your playbook or host_vars; instead, use :ref:`playbooks_vault` to encrypt sensitive data." msgstr "çµ±åˆã•ã‚ŒãŸ :ref:`hash_filters` を使用ã—ã¦ã€ãƒãƒƒã‚·ãƒ¥åŒ–ã•ã‚ŒãŸãƒ‘スワードを生æˆã—ã¾ã™ã€‚Playbook ã‚„ host_vars ã«ãƒ—レーンテã‚ストã®ãƒ‘スワードã¯ä½¿ç”¨ã—ãªã„ã§ãã ã•ã„。代ã‚ã‚Šã«ã€:ref:`playbooks_vault` を使用ã—ã¦ã€æ©Ÿå¯†ãƒ‡ãƒ¼ã‚¿ã‚’æš—å·åŒ–ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:577 +#: ../../rst/reference_appendices/faq.rst:597 msgid "In OpenBSD, a similar option is available in the base system called ``encrypt (1)``" msgstr "OpenBSDã§ã¯ã€``encrypt (1)`` ã¨å‘¼ã°ã‚Œã‚‹ãƒ™ãƒ¼ã‚¹ã‚·ã‚¹ãƒ†ãƒ ã§åŒæ§˜ã®ã‚ªãƒ—ションãŒåˆ©ç”¨å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:582 +#: ../../rst/reference_appendices/faq.rst:602 msgid "Ansible allows dot notation and array notation for variables. Which notation should I use?" msgstr "Ansible ã§ã¯ã€å¤‰æ•°ã®ãƒ‰ãƒƒãƒˆè¡¨è¨˜ã¨ã‚¢ãƒ¬ã‚¤è¡¨è¨˜ãŒå¯èƒ½ã§ã™ã€‚ã©ã®è¡¨è¨˜ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:584 +#: ../../rst/reference_appendices/faq.rst:604 msgid "The dot notation comes from Jinja and works fine for variables without special characters. If your variable contains dots (.), colons (:), or dashes (-), if a key begins and ends with two underscores, or if a key uses any of the known public attributes, it is safer to use the array notation. See :ref:`playbooks_variables` for a list of the known public attributes." msgstr "ドット表記㯠Jinja ã‹ã‚‰ã®ã‚‚ã®ã§ã€ç‰¹æ®Šæ–‡å—ãªã—ã«å¤‰æ•°ã¨åˆã‚ã›ã¦ä½¿ç”¨ã§ãã¾ã™ã€‚変数ã«ãƒ‰ãƒƒãƒˆ (.)ã€ã‚³ãƒãƒ³ (:)ã€ã¾ãŸã¯ãƒã‚¤ãƒ•ãƒ³ (-) ãŒå«ã¾ã‚Œã¦ã„ã¦ã€ã‚ー㌠2 ã¤ã®ã‚¢ãƒ³ãƒ€ãƒ¼ã‚¹ã‚³ã‚¢ã§é–‹å§‹ãŠã‚ˆã³çµ‚了ã™ã‚‹å ´åˆã€ã¾ãŸã¯ã‚ーãŒæ—¢çŸ¥ã®ãƒ‘ブリック属性ã®ã„ãšã‚Œã‹ã‚’使用ã™ã‚‹å ´åˆã¯ã€é…列表記を使用ã™ã‚‹æ–¹ãŒå®‰å…¨ã§ã™ã€‚既知ã®ãƒ‘ブリック属性ã®ä¸€è¦§ã¯ã€ã€Œ:ref:`playbooks_variables`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:597 +#: ../../rst/reference_appendices/faq.rst:617 msgid "Also array notation allows for dynamic variable composition, see dynamic_variables_." msgstr "ã¾ãŸã€ã‚¢ãƒ¬ã‚¤è¡¨è¨˜ã¯ã€å‹•çš„ãªå¤‰æ•°ã®æ§‹æˆãŒå¯èƒ½ã§ã™ã€‚詳細ã¯ã€ã€Œdynamic_variables_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:599 +#: ../../rst/reference_appendices/faq.rst:619 msgid "Another problem with 'dot notation' is that some keys can cause problems because they collide with attributes and methods of python dictionaries." msgstr "「ドット表記ã€ã®ä»–ã®å•é¡Œã¨ã—ã¦ã€ãƒ‰ãƒƒãƒˆè¡¨è¨˜ã®ã‚ーã«ã‚ˆã£ã¦ã¯ã€Python ディクショナリーã®å±žæ€§ã¨ãƒ¡ã‚½ãƒƒãƒ‰ã¨ç«¶åˆã™ã‚‹ãŸã‚ã€å•é¡ŒãŒç™ºç”Ÿã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:610 +#: ../../rst/reference_appendices/faq.rst:621 +msgid "Example of incorrect syntax when ``item`` is a dictionary:" +msgstr "``item`` ãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ã®å ´åˆã®èª¤ã£ãŸæ§‹æ–‡ã®ä¾‹:" + +#: ../../rst/reference_appendices/faq.rst:627 +msgid "This variant causes a syntax error because ``update()`` is a Python method for dictionaries." +msgstr "``update()`` ãŒãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼ç”¨ã® Python メソッドã§ã‚ã‚‹ãŸã‚ã€ã“ã®ãƒãƒªã‚¢ãƒ³ãƒˆã¯æ§‹æ–‡ã‚¨ãƒ©ãƒ¼ã‚’引ãèµ·ã“ã—ã¾ã™ã€‚" + +#: ../../rst/reference_appendices/faq.rst:629 +msgid "Example of correct syntax:" +msgstr "æ£ã—ã„構文ã®ä¾‹:" + +#: ../../rst/reference_appendices/faq.rst:639 msgid "When is it unsafe to bulk-set task arguments from a variable?" msgstr "変数ã‹ã‚‰ã‚¿ã‚¹ã‚¯å¼•æ•°ã®ä¸€æ‹¬è¨å®šã‚’ã™ã‚‹ã¨å®‰å…¨ã§ãªã„ã®ã¯ã©ã®ã‚ˆã†ãªå ´åˆã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:613 -msgid "You can set all of a task's arguments from a dictionary-typed variable. This technique can be useful in some dynamic execution scenarios. However, it introduces a security risk. We do not recommend it, so Ansible issues a warning when you do something like this::" +#: ../../rst/reference_appendices/faq.rst:642 +msgid "You can set all of a task's arguments from a dictionary-typed variable. This technique can be useful in some dynamic execution scenarios. However, it introduces a security risk. We do not recommend it, so Ansible issues a warning when you do something like this:" msgstr "ディクショナリー型ã®å¤‰æ•°ã‹ã‚‰ã‚¿ã‚¹ã‚¯ã®å¼•æ•°ã‚’ã™ã¹ã¦è¨å®šã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã®æ‰‹æ³•ã¯ã€å‹•çš„ãªå®Ÿè¡Œã‚·ãƒŠãƒªã‚ªã§ä¾¿åˆ©ãªå ´åˆãŒã‚ã‚Šã¾ã™ã€‚ãŸã ã—ã€ã‚»ã‚ュリティーリスクãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯æŽ¨å¥¨ã•ã‚Œãªã„ãŸã‚ã€ã“ã®ã‚ˆã†ãªæ“作を行ã†ã¨ã€Ansible ã§ã¯è¦å‘Šã‚’発行ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:627 +#: ../../rst/reference_appendices/faq.rst:658 msgid "This particular example is safe. However, constructing tasks like this is risky because the parameters and values passed to ``usermod_args`` could be overwritten by malicious values in the ``host facts`` on a compromised target machine. To mitigate this risk:" msgstr "ã“ã®ç‰¹å®šã®ä¾‹ã¯ã€å®‰å…¨ã§ã™ã€‚ãŸã ã—ã€``usermod_args`` ã«æ¸¡ã•ã‚Œã‚‹ãƒ‘ラメーターや値ãŒã€ã‚»ã‚ュリティー侵害をå—ã‘ãŸã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒžã‚·ãƒ³ã® ``host facts`` ã«å«ã¾ã‚Œã‚‹æ‚ªæ„ã®ã‚る値ã§ç½®ãæ›ãˆã‚‰ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚ã€ã“ã®ã‚ˆã†ãªã‚¿ã‚¹ã‚¯ã®æ§‹ç¯‰ã«ã¯ãƒªã‚¹ã‚¯ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®ãƒªã‚¹ã‚¯ã‚’軽減ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:632 +#: ../../rst/reference_appendices/faq.rst:663 msgid "set bulk variables at a level of precedence greater than ``host facts`` in the order of precedence found in :ref:`ansible_variable_precedence` (the example above is safe because play vars take precedence over facts)" msgstr ":ref:`ansible_variable_precedence` ã«ã‚ã‚‹å„ªå…ˆé †ä½ã§ã€``host facts`` ã‚ˆã‚Šå„ªå…ˆé †ä½ã®é«˜ã„レベルã§ä¸€æ‹¬å¤‰æ•°ã‚’è¨å®šã—ã¾ã™ (プレイ変数ã¯ãƒ•ã‚¡ã‚¯ãƒˆã‚ˆã‚Šå„ªå…ˆåº¦ãŒé«˜ã„ãŸã‚ã€ä¸Šè¨˜ã®ä¾‹ã¯å®‰å…¨ã§ã™)。" -#: ../../rst/reference_appendices/faq.rst:635 +#: ../../rst/reference_appendices/faq.rst:666 msgid "disable the :ref:`inject_facts_as_vars` configuration setting to prevent fact values from colliding with variables (this will also disable the original warning)" msgstr "ファクトã®å€¤ãŒå¤‰æ•°ã¨ç«¶åˆã—ãªã„よã†ã« :ref:`inject_facts_as_vars` è¨å®šã‚ªãƒ—ションを無効ã«ã—ã¾ã™ (å…ƒã®è¦å‘Šã‚‚無効ã«ãªã‚Šã¾ã™)。" -#: ../../rst/reference_appendices/faq.rst:642 +#: ../../rst/reference_appendices/faq.rst:673 msgid "Can I get training on Ansible?" msgstr "Ansible ã®ãƒˆãƒ¬ãƒ¼ãƒ‹ãƒ³ã‚°ã¯ã‚ã‚Šã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:644 +#: ../../rst/reference_appendices/faq.rst:675 msgid "Yes! See our `services page <https://www.ansible.com/products/consulting>`_ for information on our services and training offerings. Email `info@ansible.com <mailto:info@ansible.com>`_ for further details." msgstr "サービスãŠã‚ˆã³ãƒˆãƒ¬ãƒ¼ãƒ‹ãƒ³ã‚°ã‚µãƒ¼ãƒ“スã«é–¢ã™ã‚‹æƒ…å ±ã¯ã€ã€Œ`サービスページ <https://www.ansible.com/products/consulting>`_ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。詳細ã¯ã€`info@ansible.com <mailto:info@ansible.com>`_ ã«ãŠå•ã„åˆã‚ã›ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:647 +#: ../../rst/reference_appendices/faq.rst:678 msgid "We also offer free web-based training classes on a regular basis. See our `webinar page <https://www.ansible.com/resources/webinars-training>`_ for more info on upcoming webinars." msgstr "ã¾ãŸã€å®šæœŸçš„ã«ã€Web ベースã®ãƒˆãƒ¬ãƒ¼ãƒ‹ãƒ³ã‚°ã‚‚ç„¡æ–™ã§æä¾›ã—ã¦ã„ã¾ã™ã€‚今後予定ã•ã‚Œã¦ã„るウェビナーã®è©³ç´°ã¯ã€`ウェビナーページ <https://www.ansible.com/resources/webinars-training>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:654 +#: ../../rst/reference_appendices/faq.rst:685 msgid "Is there a web interface / REST API / GUI?" msgstr "Web インターフェースã€REST APIã€GUI ã¯ã‚ã‚Šã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:656 +#: ../../rst/reference_appendices/faq.rst:687 msgid "Yes! The open-source web interface is Ansible AWX. The supported Red Hat product that makes Ansible even more powerful and easy to use is :ref:`Red Hat Ansible Automation Platform <ansible_platform>`." msgstr "ã¯ã„。オープンソース Web インターフェース㯠Ansible AWX ã§ã™ã€‚Ansible ãŒã‚ˆã‚Šå¼·åŠ›ã§ã€ä½¿ã„ã‚„ã™ã„ã€Red Hat ã®ã‚µãƒãƒ¼ãƒˆå¯¾è±¡è£½å“ã¯ã€ :ref:`Red Hat Ansible Automation Platform <ansible_platform>` ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:662 +#: ../../rst/reference_appendices/faq.rst:693 msgid "How do I keep secret data in my playbook?" msgstr "Playbook ã«æ©Ÿå¯†ãƒ‡ãƒ¼ã‚¿ã‚’ä¿å˜ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:664 +#: ../../rst/reference_appendices/faq.rst:695 msgid "If you would like to keep secret data in your Ansible content and still share it publicly or keep things in source control, see :ref:`playbooks_vault`." msgstr "Ansible ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã«æ©Ÿå¯†ãƒ‡ãƒ¼ã‚¿ã‚’ä¿å˜ã—ã¦ãã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„を公開ã™ã‚‹ã‹ã€ã‚½ãƒ¼ã‚¹ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ã«ä¿æŒã™ã‚‹å ´åˆã¯ã€ã€Œ:ref:`playbooks_vault`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:666 -msgid "If you have a task that you don't want to show the results or command given to it when using -v (verbose) mode, the following task or playbook attribute can be useful::" +#: ../../rst/reference_appendices/faq.rst:697 +msgid "If you have a task that you don't want to show the results or command given to it when using -v (verbose) mode, the following task or playbook attribute can be useful:" msgstr "-v (詳細) モードã®ä½¿ç”¨æ™‚ã«ã€çµæžœã‚„指定ã—ãŸã‚³ãƒžãƒ³ãƒ‰ã‚’表示ã—ãŸããªã„タスクãŒã‚ã‚‹å ´åˆã¯ã€æ¬¡ã®ã‚ˆã†ãªã‚¿ã‚¹ã‚¯ã‚„ Playbook 属性ãŒä¾¿åˆ©ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:672 +#: ../../rst/reference_appendices/faq.rst:705 msgid "This can be used to keep verbose output but hide sensitive information from others who would otherwise like to be able to see the output." msgstr "ã“ã‚Œã¯ã€è©³ç´°ãªå‡ºåŠ›ã‚’ç¶æŒã—ã¤ã¤ã€å‡ºåŠ›ã‚’見ãŸã„ã¨æ€ã£ã¦ã„る人ã‹ã‚‰æ©Ÿå¯†æƒ…å ±ã‚’éš ã™ãŸã‚ã«ä½¿ã†ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:674 -msgid "The ``no_log`` attribute can also apply to an entire play::" +#: ../../rst/reference_appendices/faq.rst:707 +msgid "The ``no_log`` attribute can also apply to an entire play:" msgstr "``no_log`` 属性ã¯ã€ãƒ—レイ全体ã«ã‚‚é©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:679 -msgid "Though this will make the play somewhat difficult to debug. It's recommended that this be applied to single tasks only, once a playbook is completed. Note that the use of the ``no_log`` attribute does not prevent data from being shown when debugging Ansible itself via the :envvar:`ANSIBLE_DEBUG` environment variable." +#: ../../rst/reference_appendices/faq.rst:714 +msgid "Though this will make the play somewhat difficult to debug. It's recommended that this be applied to single tasks only, once a playbook is completed. Note that the use of the ``no_log`` attribute does not prevent data from being shown when debugging Ansible itself through the :envvar:`ANSIBLE_DEBUG` environment variable." msgstr "ãŸã ã—ã€ã“れを使用ã™ã‚‹ã¨ã€ãƒ—レイã®ãƒ‡ãƒãƒƒã‚°ãŒå›°é›£ã«ãªã‚Šã¾ã™ã€‚Playbook ãŒå®Œäº†ã™ã‚‹ã¨ã€ã“ã®å±žæ€§ã¯å˜ä¸€ã®ã‚¿ã‚¹ã‚¯ã«ã®ã¿é©ç”¨ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚``no_log`` 属性を使用ã—ã¦ã‚‚ã€:envvar:`ANSIBLE_DEBUG` 環境変数㧠Ansible 自体をデãƒãƒƒã‚°ã™ã‚‹ã¨ãã«ã€ãƒ‡ãƒ¼ã‚¿ãŒè¡¨ç¤ºã•ã‚Œã¦ã—ã¾ã†ç‚¹ã«æ³¨æ„ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:690 +#: ../../rst/reference_appendices/faq.rst:725 msgid "When should I use {{ }}? Also, how to interpolate variables or dynamic variable names" msgstr "{{ }} ã¯ã„ã¤ä½¿ç”¨ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã‹ã€‚ã¾ãŸã€å¤‰æ•°ã¾ãŸã¯å‹•çš„ãªå¤‰æ•°åを補間ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:692 +#: ../../rst/reference_appendices/faq.rst:727 msgid "A steadfast rule is 'always use ``{{ }}`` except when ``when:``'. Conditionals are always run through Jinja2 as to resolve the expression, so ``when:``, ``failed_when:`` and ``changed_when:`` are always templated and you should avoid adding ``{{ }}``." msgstr "ä¸å‹•ã®ãƒ«ãƒ¼ãƒ«ã¯ã€Œ``when:`` ã®å ´åˆã‚’除ã„ã¦å¸¸ã« ``{{ }}`` を使用ã™ã‚‹ã€ã§ã™ã€‚ã“ã®æ¡ä»¶ã¯ã€å¼ã®è§£æ±ºã¨ã—㦠Jinja2 を介ã—ã¦å®Ÿè¡Œã™ã‚‹ãŸã‚ã€``when:``ã€``failed_when:``ã€ãŠã‚ˆã³ ``changed_when:`` ã¯å¸¸ã«ãƒ†ãƒ³ãƒ—レート化ã•ã‚Œã€``{{ }}`` ã®è¿½åŠ ã¯å›žé¿ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:696 +#: ../../rst/reference_appendices/faq.rst:731 msgid "In most other cases you should always use the brackets, even if previously you could use variables without specifying (like ``loop`` or ``with_`` clauses), as this made it hard to distinguish between an undefined variable and a string." msgstr "ãれ以外ã®ã‚±ãƒ¼ã‚¹ã§ã¯ã€ä»¥å‰ã¯ ``loop`` å¥ã¾ãŸã¯ ``with_`` å¥ãªã©ã‚’指定ã—ãªãã¦ã‚‚変数を使用ã§ãã¦ã„ãŸå ´åˆã§ã‚‚ã€å¸¸ã«æ‹¬å¼§ã‚’使用ã™ã‚‹ã‚ˆã†ã«ã—ã¦ãã ã•ã„。ç†ç”±ã¯ã€æœªå®šç¾©ã®å¤‰æ•°ã¨æ–‡å—列を区別ã—ã«ãã„ãŸã‚ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:699 +#: ../../rst/reference_appendices/faq.rst:734 msgid "Another rule is 'moustaches don't stack'. We often see this:" msgstr "ä»–ã«ã¯ã€Œæ³¢æ‹¬å¼§ã¯ä¸¦ã¹ã¦ä½¿ç”¨ã§ããªã„ã€ã¨ã„ã†ãƒ«ãƒ¼ãƒ«ãŒã‚ã‚Šã¾ã™ãŒã€ã“ã‚Œã¯é »ç¹ã«è¦‹å—ã‘られã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:705 +#: ../../rst/reference_appendices/faq.rst:740 msgid "The above DOES NOT WORK as you expect, if you need to use a dynamic variable use the following as appropriate:" msgstr "上記ã®ä¾‹ã¯æƒ³å®šé€šã‚Šã€æ©Ÿèƒ½ã—ã¾ã›ã‚“。動的変数を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã«ã¯ã€éšæ™‚ã€ä»¥ä¸‹ã‚’使用ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:711 +#: ../../rst/reference_appendices/faq.rst:746 msgid "For 'non host vars' you can use the :ref:`vars lookup<vars_lookup>` plugin:" msgstr "「non host varsã€ã®å ´åˆã«ã¯ã€:ref:`vars lookup<vars_lookup>` プラグインを使用ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:717 +#: ../../rst/reference_appendices/faq.rst:752 msgid "To determine if a keyword requires ``{{ }}`` or even supports templating, use ``ansible-doc -t keyword <name>``, this will return documentation on the keyword including a ``template`` field with the values ``explicit`` (requires ``{{ }}``), ``implicit`` (assumes ``{{ }}``, so no needed) or ``static`` (no templating supported, all characters will be interpreted literally)" msgstr "ã‚ーワード㫠``{{ }}`` ãŒå¿…è¦ã‹ã€ãƒ†ãƒ³ãƒ—レートをサãƒãƒ¼ãƒˆã™ã‚‹ã‹ã‚’判æ–ã™ã‚‹ã«ã¯ã€``ansible-doc -t keyword <name>`` を使用ã—ã¾ã™ã€‚ã“ã‚Œã«ã‚ˆã‚Šã€å€¤ ``explicit`` (``{{ }}`` ãŒå¿…è¦)ã€``implicit`` (``{{ }}`` ã‚’å‰æã€å¿…è¦ãªã—)ã€ã¾ãŸã¯ ``static`` (テンプレートã®ã‚µãƒãƒ¼ãƒˆãªã—ã€æ–‡å—ã¯ã™ã¹ã¦ãã®ã¾ã¾æ–‡å—通り解釈ã•ã‚Œã‚‹) ã®å€¤ãŒå«ã¾ã‚Œã‚‹ ``template`` フィールドをå«ã‚€ã‚ーワードã®ãƒ‰ã‚ュメントを返ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:724 +#: ../../rst/reference_appendices/faq.rst:759 msgid "How do I get the original ansible_host when I delegate a task?" msgstr "タスクを委è²ã—ãŸå ´åˆã«å…ƒã® ansible_host ã‚’ã©ã®ã‚ˆã†ã«å–å¾—ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:726 -msgid "As the documentation states, connection variables are taken from the ``delegate_to`` host so ``ansible_host`` is overwritten, but you can still access the original via ``hostvars``::" +#: ../../rst/reference_appendices/faq.rst:761 +msgid "As the documentation states, connection variables are taken from the ``delegate_to`` host so ``ansible_host`` is overwritten, but you can still access the original through ``hostvars``:" msgstr "ドã‚ュメントã«è¨˜è¼‰ã•ã‚Œã¦ã„るよã†ã«ã€æŽ¥ç¶šå¤‰æ•°ã¯ ``delegate_to`` ホストã‹ã‚‰å–å¾—ã•ã‚Œã‚‹ãŸã‚ã€``ansible_host`` ã¯ä¸Šæ›¸ãã•ã‚Œã¾ã™ãŒã€``hostvars`` を使用ã—ã¦å…ƒã® ansible_host ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:731 +#: ../../rst/reference_appendices/faq.rst:768 msgid "This works for all overridden connection variables, like ``ansible_user``, ``ansible_port``, and so on." msgstr "ã“ã‚Œã¯ã€``ansible_user``ã€``ansible_port`` ãªã©ã®ã‚ˆã†ã«ã€ã™ã¹ã¦ã®ä¸Šæ›¸ãã•ã‚ŒãŸæŽ¥ç¶šå¤‰æ•°ã«æœ‰åŠ¹ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:737 +#: ../../rst/reference_appendices/faq.rst:774 msgid "How do I fix 'protocol error: filename does not match request' when fetching a file?" msgstr "ファイルã®å–得時ã®ã€Œprotocol error: filename does not match requestã€ã®ã‚¨ãƒ©ãƒ¼ã¯ã©ã®ã‚ˆã†ã«ä¿®æ£ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:739 -msgid "Since release ``7.9p1`` of OpenSSH there is a `bug <https://bugzilla.mindrot.org/show_bug.cgi?id=2966>`_ in the SCP client that can trigger this error on the Ansible controller when using SCP as the file transfer mechanism::" +#: ../../rst/reference_appendices/faq.rst:776 +msgid "Since release ``7.9p1`` of OpenSSH there is a `bug <https://bugzilla.mindrot.org/show_bug.cgi?id=2966>`_ in the SCP client that can trigger this error on the Ansible controller when using SCP as the file transfer mechanism:" msgstr "OpenSSH ã®ãƒªãƒªãƒ¼ã‚¹ ``7.9p1`` ã§ã¯ã€SCP クライアント㫠`bug <https://bugzilla.mindrot.org/show_bug.cgi?id=2966>`_ ãŒã‚ã‚Šã€ãƒ•ã‚¡ã‚¤ãƒ«è»¢é€ãƒ¡ã‚«ãƒ‹ã‚ºãƒ ã¨ã—㦠SCP を使用ã™ã‚‹å ´åˆã«ã€Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã§ä»¥ä¸‹ã®ã‚¨ãƒ©ãƒ¼ãŒå‡ºåŠ›ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:744 +#: ../../rst/reference_appendices/faq.rst:781 +msgid "failed to transfer file to /tmp/ansible/file.txt\\r\\nprotocol error: filename does not match request" +msgstr "ファイルを /tmp/ansible/file.txt\\r\\n" +"protocol ã«è»¢é€ã§ãã¾ã›ã‚“ã§ã—ãŸã€‚エラー: ファイルåã¯ãƒªã‚¯ã‚¨ã‚¹ãƒˆã«ä¸€è‡´ã—ã¾ã›ã‚“。" + +#: ../../rst/reference_appendices/faq.rst:783 msgid "In these releases, SCP tries to validate that the path of the file to fetch matches the requested path. The validation fails if the remote filename requires quotes to escape spaces or non-ascii characters in its path. To avoid this error:" msgstr "æ–°ã—ã„リリースã§ã¯ã€SCP ã¯ã€å–å¾—ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ‘スãŒè¦æ±‚ã—ãŸãƒ‘スã¨ä¸€è‡´ã™ã‚‹ã“ã¨ã‚’検証ã—よã†ã¨ã—ã¾ã™ã€‚リモートã®ãƒ•ã‚¡ã‚¤ãƒ«åãŒã€ãƒ‘スã§ã‚¹ãƒšãƒ¼ã‚¹ã‚„ ASCII æ–‡å—以外ã®æ–‡å—を引用符ã§ã‚¨ã‚¹ã‚±ãƒ¼ãƒ—ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã«ã¯ã€æ¤œè¨¼ã«å¤±æ•—ã—ã¾ã™ã€‚ã“ã®ã‚¨ãƒ©ãƒ¼ã‚’回é¿ã™ã‚‹ã«ã¯ã€ä»¥ä¸‹ã‚’è¡Œã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:752 +#: ../../rst/reference_appendices/faq.rst:791 msgid "Use SFTP instead of SCP by setting ``scp_if_ssh`` to ``smart`` (which tries SFTP first) or to ``False``. You can do this in one of four ways:" msgstr "``scp_if_ssh`` ã‚’ ``smart`` (先㫠SFTP を試ã™)ã€ã¾ãŸã¯ ``False`` ã«è¨å®šã—ã¦ã€SCP ã®ä»£ã‚ã‚Šã« SFTP を使用ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:749 +#: ../../rst/reference_appendices/faq.rst:788 msgid "Rely on the default setting, which is ``smart`` - this works if ``scp_if_ssh`` is not explicitly set anywhere" msgstr "``smart`` ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®è¨å®šã«ä¾å˜ã—ã¾ã™ã€‚``scp_if_ssh`` ãŒæ˜Žç¤ºçš„ã«ã©ã“ã«ã‚‚è¨å®šã•ã‚Œã¦ã„ãªã„å ´åˆã«æ©Ÿèƒ½ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:750 +#: ../../rst/reference_appendices/faq.rst:789 msgid "Set a :ref:`host variable <host_variables>` or :ref:`group variable <group_variables>` in inventory: ``ansible_scp_if_ssh: False``" msgstr "インベントリー㫠:ref:`ホスト変数 <host_variables>` ã¾ãŸã¯ :ref:`グループ変数 <group_variables>` ã‚’è¨å®šã—ã¾ã™ (``ansible_scp_if_ssh: False``)。" -#: ../../rst/reference_appendices/faq.rst:751 +#: ../../rst/reference_appendices/faq.rst:790 msgid "Set an environment variable on your control node: ``export ANSIBLE_SCP_IF_SSH=False``" msgstr "コントãƒãƒ¼ãƒ«ãƒŽãƒ¼ãƒ‰ã§ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ (``export ANSIBLE_SCP_IF_SSH=False``)。" -#: ../../rst/reference_appendices/faq.rst:752 +#: ../../rst/reference_appendices/faq.rst:791 msgid "Pass an environment variable when you run Ansible: ``ANSIBLE_SCP_IF_SSH=smart ansible-playbook``" msgstr "Ansible を実行ã™ã‚‹ã¨ãã«ç’°å¢ƒå¤‰æ•°ã‚’渡ã—ã¾ã™ (``ANSIBLE_SCP_IF_SSH=smart ansible-playbook``)。" -#: ../../rst/reference_appendices/faq.rst:753 +#: ../../rst/reference_appendices/faq.rst:792 msgid "Modify your ``ansible.cfg`` file: add ``scp_if_ssh=False`` to the ``[ssh_connection]`` section" msgstr "``ansible.cfg`` ファイルã®å¤‰æ›´: ``scp_if_ssh=False`` ã‚’ ``[ssh_connection]`` セクションã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:757 +#: ../../rst/reference_appendices/faq.rst:796 msgid "If you must use SCP, set the ``-T`` arg to tell the SCP client to ignore path validation. You can do this in one of three ways:" msgstr "SCP を使用ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€``-T`` 引数をè¨å®šã—ã¦ã€SCP クライアントã«ãƒ‘スã®æ¤œè¨¼ã‚’無視ã™ã‚‹ã‚ˆã†ã«æŒ‡ç¤ºã—ã¾ã™ã€‚以下㮠3 ã¤ã®æ–¹æ³•ã®ã„ãšã‚Œã‹ã§å®Ÿè¡Œã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:755 +#: ../../rst/reference_appendices/faq.rst:794 msgid "Set a :ref:`host variable <host_variables>` or :ref:`group variable <group_variables>`: ``ansible_scp_extra_args=-T``," msgstr ":ref:`ホスト変数 <host_variables>` ã¾ãŸã¯ :ref:`グループ変数 <group_variables>` ã‚’è¨å®šã—ã¾ã™ (``ansible_scp_extra_args=-T``)。" -#: ../../rst/reference_appendices/faq.rst:756 +#: ../../rst/reference_appendices/faq.rst:795 msgid "Export or pass an environment variable: ``ANSIBLE_SCP_EXTRA_ARGS=-T``" msgstr "環境変数をエクスãƒãƒ¼ãƒˆã™ã‚‹ã‹ã€æ¸¡ã—ã¾ã™ (``ANSIBLE_SCP_EXTRA_ARGS=-T``)。" -#: ../../rst/reference_appendices/faq.rst:757 +#: ../../rst/reference_appendices/faq.rst:796 msgid "Modify your ``ansible.cfg`` file: add ``scp_extra_args=-T`` to the ``[ssh_connection]`` section" msgstr "``ansible.cfg`` ファイルã®å¤‰æ›´: ``scp_extra_args=-T`` ã‚’ ``[ssh_connection]`` セクションã«è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:759 +#: ../../rst/reference_appendices/faq.rst:798 msgid "If you see an ``invalid argument`` error when using ``-T``, then your SCP client is not performing filename validation and will not trigger this error." msgstr "``-T`` ã®ä½¿ç”¨æ™‚ã« ``invalid argument`` エラーãŒè¡¨ç¤ºã•ã‚Œã‚‹å ´åˆã¯ã€SCP クライアントãŒãƒ•ã‚¡ã‚¤ãƒ«åを検証ã—ã¦ãŠã‚‰ãšã€ã“ã®ã‚¨ãƒ©ãƒ¼ã¯ç™ºç”Ÿã—ã¾ã›ã‚“。" -#: ../../rst/reference_appendices/faq.rst:764 +#: ../../rst/reference_appendices/faq.rst:803 msgid "Does Ansible support multiple factor authentication 2FA/MFA/biometrics/finterprint/usbkey/OTP/..." msgstr "Ansible ã§ã¯ã€è¤‡æ•°ã®ãƒ•ã‚¡ã‚¯ã‚¿ãƒ¼èªè¨¼ 2FA/MFA/biometrics/finterprint/usbkey/OTP/... ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:766 +#: ../../rst/reference_appendices/faq.rst:805 msgid "No, Ansible is designed to execute multiple tasks against multiple targets, minimizing user interaction. As with most automation tools, it is not compatible with interactive security systems designed to handle human interaction. Most of these systems require a secondary prompt per target, which prevents scaling to thousands of targets. They also tend to have very short expiration periods so it requires frequent reauthorization, also an issue with many hosts and/or a long set of tasks." msgstr "ã„ã„ãˆã€Ansible ã¯è¤‡æ•°ã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã«å¯¾ã—ã¦è¤‡æ•°ã®ã‚¿ã‚¹ã‚¯ã‚’実行ã™ã‚‹ã‚ˆã†ã«è¨è¨ˆã•ã‚Œã¦ãŠã‚Šã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®æ“作を最å°é™ã«æŠ‘ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ã»ã¨ã‚“ã©ã®è‡ªå‹•åŒ–ツールã¨åŒæ§˜ã«ã€äººé–“ã®ç›¸äº’作用を処ç†ã™ã‚‹ã‚ˆã†ã«è¨è¨ˆã•ã‚ŒãŸã‚¤ãƒ³ã‚¿ãƒ©ã‚¯ãƒ†ã‚£ãƒ–ãªã‚»ã‚ュリティーシステムã¨ã®äº’æ›æ€§ã¯ã‚ã‚Šã¾ã›ã‚“。ã“れらã®ã‚·ã‚¹ãƒ†ãƒ ã®ã»ã¨ã‚“ã©ã¯ã€ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã”ã¨ã«ã‚»ã‚«ãƒ³ãƒ€ãƒªãƒ¼ãƒ—ãƒãƒ³ãƒ—トを必è¦ã¨ã™ã‚‹ãŸã‚ã€æ•°åƒã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã«æ‹¡å¼µã™ã‚‹ã“ã¨ãŒã§ãã¾ã›ã‚“。ã¾ãŸã€ã“れらã®ã‚·ã‚¹ãƒ†ãƒ ã¯æœ‰åŠ¹æœŸé™ãŒéžå¸¸ã«çŸã„ãŸã‚ã€å†èªè¨¼ãŒé »ç¹ã«å¿…è¦ã¨ãªã‚Šã¾ã™ãŒã€ã“れも多ãã®ãƒ›ã‚¹ãƒˆã‚„é•·ã„タスクセットã§ã¯å•é¡Œã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:772 +#: ../../rst/reference_appendices/faq.rst:811 msgid "In such environments we recommend securing around Ansible's execution but still allowing it to use an 'automation user' that does not require such measures. With AWX or the :ref:`Red Hat Ansible Automation Platform <ansible_platform>`, administrators can set up RBAC access to inventory, along with managing credentials and job execution." msgstr "ã“ã®ã‚ˆã†ãªç’°å¢ƒã§ã¯ã€Ansible ã®å®Ÿè¡Œã‚’ä¿è·ã—ãªãŒã‚‰ã€ãã®ã‚ˆã†ãªæ‰‹æ®µã‚’å¿…è¦ã¨ã—ãªã„「自動化ユーザーã€ã®ä½¿ç”¨ã‚’許å¯ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚AWX ã¾ãŸã¯ :ref:`Red Hat Ansible Automation Platform <ansible_platform>` を使用ã™ã‚‹ã¨ã€ç®¡ç†è€…ãŒã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã¸ã® RBAC アクセスをè¨å®šã—ã€èªè¨¼æƒ…å ±ã¨ã‚¸ãƒ§ãƒ–ã®å®Ÿè¡Œã‚’管ç†ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:779 +#: ../../rst/reference_appendices/faq.rst:818 msgid "The 'validate' option is not enough for my needs, what do I do?" msgstr "弊社ã®è¦ä»¶ã«ã¯ã€ã€Œvalidateã€ã‚ªãƒ—ションã¯å分ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã©ã†ã™ã‚Œã°ã‚ˆã„ã§ã—ょã†ã‹ï¼Ÿ" -#: ../../rst/reference_appendices/faq.rst:781 +#: ../../rst/reference_appendices/faq.rst:820 msgid "Many Ansible modules that create or update files have a ``validate`` option that allows you to abort the update if the validation command fails. This uses the temporary file Ansible creates before doing the final update. In many cases this does not work since the validation tools for the specific application require either specific names, multiple files or some other factor that is not present in this simple feature." msgstr "ファイル作æˆã¾ãŸã¯æ›´æ–°ã® Ansible モジュールã®å¤šãã«ã¯ ``validate`` オプションãŒã‚ã‚Šã€æ¤œè¨¼ã‚³ãƒžãƒ³ãƒ‰ãŒå¤±æ•—ã—ãŸå ´åˆã«æ›´æ–°ã‚’ä¸æ¢ã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€æœ€çµ‚æ›´æ–°ã‚’è¡Œã†å‰ã« Ansible ãŒä½œæˆã™ã‚‹ä¸€æ™‚ファイルを使用ã—ã¾ã™ã€‚多ãã®å ´åˆã€ç‰¹å®šã®ã‚¢ãƒ—リケーションã®æ¤œè¨¼ãƒ„ールã«ã¯ç‰¹å®šã®åå‰ã€è¤‡æ•°ã®ãƒ•ã‚¡ã‚¤ãƒ«ä»¥å¤–ã«ã€ã“ã®å˜ç´”ãªæ©Ÿèƒ½ã«å«ã¾ã‚Œã¦ã„ãªã„ä»–ã®è¦ç´ ãŒå¿…è¦ã«ãªã‚‹ãŸã‚ã€ã“ã‚Œã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。" -#: ../../rst/reference_appendices/faq.rst:785 +#: ../../rst/reference_appendices/faq.rst:824 msgid "For these cases you have to handle the validation and restoration yourself. The following is a simple example of how to do this with block/rescue and backups, which most file based modules also support:" msgstr "ã“ã®ã‚ˆã†ãªå ´åˆã¯ã€æ¤œè¨¼ã¨å¾©å…ƒã‚’自分ã§å‡¦ç†ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚以下ã¯ã€ãƒ–ãƒãƒƒã‚¯/レスã‚ューãŠã‚ˆã³ãƒãƒƒã‚¯ã‚¢ãƒƒãƒ—ã§ã“ã®ä½œæ¥ã‚’è¡Œã†ç°¡å˜ãªä¾‹ã§ã€ã»ã¨ã‚“ã©ã®ãƒ•ã‚¡ã‚¤ãƒ«ãƒ™ãƒ¼ã‚¹ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚‚サãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:817 +#: ../../rst/reference_appendices/faq.rst:856 msgid "Why does the ``regex_search`` filter return `None` instead of an empty string?" msgstr "``regex_search`` フィルターãŒç©ºã®æ–‡å—列ã§ã¯ãªã `None` ã‚’è¿”ã™ã®ã¯ãªãœã§ã™ã‹ã€‚" -#: ../../rst/reference_appendices/faq.rst:819 +#: ../../rst/reference_appendices/faq.rst:858 msgid "Until the jinja2 2.10 release, Jinja was only able to return strings, but Ansible needed Python objects in some cases. Ansible uses ``safe_eval`` and only sends strings that look like certain types of Python objects through this function. With ``regex_search`` that does not find a match, the result (``None``) is converted to the string \"None\" which is not useful in non-native jinja2." msgstr "jinja2 2.10 リリースã¾ã§ã€Jinja ã¯æ–‡å—列ã—ã‹è¿”ã™ã“ã¨ãŒã§ãã¾ã›ã‚“ã§ã—ãŸãŒã€Ansible 㧠Python オブジェクトãŒå¿…è¦ãªå ´åˆãŒã‚ã‚Šã¾ã—ãŸã€‚Ansible ã¯``safe_eval`` を使用ã—ã€ã“ã®é–¢æ•°ã‚’介ã—ã¦ç‰¹å®šã®ã‚¿ã‚¤ãƒ—ã® Python オブジェクトã®ã‚ˆã†ã«è¦‹ãˆã‚‹æ–‡å—列ã®ã¿ã‚’é€ä¿¡ã—ã¾ã™ã€‚``regex_search`` ã§ä¸€è‡´ã™ã‚‹ã‚‚ã®ãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã€çµæžœ (``None``) ã¯ã€éžãƒã‚¤ãƒ†ã‚£ãƒ–ã® jinja2 ã§ã¯å½¹ã«ç«‹ãŸãªã„æ–‡å—列「Noneã€ã«å¤‰æ›ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:821 +#: ../../rst/reference_appendices/faq.rst:860 msgid "The following example of a single templating action shows this behavior:" msgstr "次ã®å˜ä¸€ã®ãƒ†ãƒ³ãƒ—レートアクション例ã¯ã€ã“ã®å‹•ä½œã‚’示ã—ã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:827 +#: ../../rst/reference_appendices/faq.rst:866 msgid "This example does not result in a Python ``None``, so Ansible historically converted it to \"\" (empty string)." msgstr "ã“ã®ä¾‹ã§ã¯ Python ``None`` ãŒç™ºç”Ÿã—ãªã„ãŸã‚ã€ã“ã‚Œã¾ã§ Ansible ã¯ã“れを \"\" (空ã®æ–‡å—列) ã«å¤‰æ›ã—ã¦ã„ã¾ã—ãŸã€‚" -#: ../../rst/reference_appendices/faq.rst:829 +#: ../../rst/reference_appendices/faq.rst:868 msgid "The native jinja2 functionality actually allows us to return full Python objects, that are always represented as Python objects everywhere, and as such the result of a single templating action with ``regex_search`` can result in the Python ``None``." msgstr "ãƒã‚¤ãƒ†ã‚£ãƒ– jinja2 機能を使用ã™ã‚‹ã¨ã€å®Ÿéš›ã«å®Œå…¨ãª Python オブジェクトを返ã™ã“ã¨ãŒã§ãã¾ã™ã€‚ã“ã‚Œã¯ã€å¸¸ã«ã©ã“ã§ã‚‚ Python オブジェクトã¨ã—ã¦è¡¨ã•ã‚Œã€ãã®ãŸã‚ã€``regex_search`` ã®çµæžœãŒ Python ``None`` ã«ãªã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:833 +#: ../../rst/reference_appendices/faq.rst:872 msgid "Native jinja2 functionality is not needed when ``regex_search`` is used as an intermediate result that is then compared to the jinja2 ``none`` test." msgstr "``regex_search`` ã‚’ä¸é–“çµæžœã¨ã—ã¦ä½¿ç”¨ã—ã€jinja2 ``none`` テストã¨æ¯”較ã™ã‚‹å ´åˆã€ãƒã‚¤ãƒ†ã‚£ãƒ– jinja2 機能ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/reference_appendices/faq.rst:843 +#: ../../rst/reference_appendices/faq.rst:882 msgid "How do I submit a change to the documentation?" msgstr "ドã‚ュメントã¸ã®å¤‰æ›´ã‚’æ出ã™ã‚‹ã«ã¯ã©ã†ã™ã‚Œã°è‰¯ã„ã§ã™ã‹" -#: ../../rst/reference_appendices/faq.rst:845 +#: ../../rst/reference_appendices/faq.rst:884 msgid "Documentation for Ansible is kept in the main project git repository, and complete instructions for contributing can be found in the docs README `viewable on GitHub <https://github.com/ansible/ansible/blob/devel/docs/docsite/README.md>`_. Thanks!" msgstr "Ansible ã®ãƒ‰ã‚ュメントã¯ã€ä¸»è¦ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã® git リãƒã‚¸ãƒˆãƒªãƒ¼ã«ä¿å˜ã•ã‚Œã¦ãŠã‚Šã€è²¢çŒ®ã«é–¢ã™ã‚‹èª¬æ˜ŽãŒ `GitHub ã§ç¢ºèªã§ãã‚‹ <https://github.com/ansible/ansible/blob/devel/docs/docsite/README.md>`_ README ã«è¨˜è¼‰ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:852 +#: ../../rst/reference_appendices/faq.rst:891 msgid "What is the difference between ``ansible.legacy`` and ``ansible.builtin`` collections?" msgstr "``ansible.legacy`` コレクション㨠``ansible.builtin`` コレクションã®é•ã„ã¯ä½•ã§ã™ã‹ ?" -#: ../../rst/reference_appendices/faq.rst:854 +#: ../../rst/reference_appendices/faq.rst:893 msgid "Neither is a real collection. They are virtually constructed by the core engine (synthetic collections)." msgstr "ã©ã¡ã‚‰ã‚‚本当ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã§ã¯ã‚ã‚Šã¾ã›ã‚“。ã“れらã¯ã€ã‚³ã‚¢ã‚¨ãƒ³ã‚¸ãƒ³ (åˆæˆã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³) ã«ã‚ˆã£ã¦ä»®æƒ³çš„ã«æ§‹ç¯‰ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:856 +#: ../../rst/reference_appendices/faq.rst:895 msgid "The ``ansible.builtin`` collection only refers to plugins that ship with ``ansible-core``." msgstr "``ansible.builtin`` コレクションã¯ã€``ansible-core`` ã«åŒæ¢±ã•ã‚Œã‚‹ãƒ—ラグインã®ã¿ã‚’å‚ç…§ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:858 +#: ../../rst/reference_appendices/faq.rst:897 msgid "The ``ansible.legacy`` collection is a superset of ``ansible.builtin`` (you can reference the plugins from builtin through ``ansible.legacy``). You also get the ability to add 'custom' plugins in the :ref:`configured paths and adjacent directories <ansible_search_path>`, with the ability to override the builtin plugins that have the same name." msgstr "``ansible.legacy`` コレクションã¯ã€``ansible.builtin`` ã®ã‚¹ãƒ¼ãƒ‘ーセット (``ansible.legacy`` を使用ã—ã¦çµ„åè’ã‚ŒãŸãƒ—ラグインをå‚ç…§å¯èƒ½) ã§ã™ã€‚ã•ã‚‰ã«ã€åŒã˜åå‰ã®çµ„ã¿è¾¼ã¿ãƒ—ラグインを上書ãã§ãã‚‹ã®ã§ã€:ref:`configured paths and adjacent directories <ansible_search_path>` ã®ã‚«ã‚¹ã‚¿ãƒ ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ã‚’è¿½åŠ ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:861 +#: ../../rst/reference_appendices/faq.rst:900 msgid "Also, ``ansible.legacy`` is what you get by default when you do not specify an FQCN. So this:" -msgstr "ã¾ãŸã€``ansible.legacy`` ã¯ã€FQCN を指定ã—ãªã„å ´åˆã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§å–å¾—ã™ã‚‹ã®ã§ã€ã“れ㯠" +msgstr "ã¾ãŸã€``ansible.legacy`` ã¯ã€FQCN を指定ã—ãªã„å ´åˆã«ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§å–å¾—ã™ã‚‹ã‚‚ã®ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:868 +#: ../../rst/reference_appendices/faq.rst:907 msgid "Is really equivalent to:" -msgstr "ã¯ã€ä»¥ä¸‹ã¨åŒã˜ã‚ˆã†ãªã‚‚ã®ã§ã™ã€‚" +msgstr "ã“ã‚Œã¯ä»¥ä¸‹ã¨åŒç‰ã§ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:874 +#: ../../rst/reference_appendices/faq.rst:913 msgid "Though, if you do not override the ``shell`` module, you can also just write it as ``ansible.builtin.shell``, since legacy will resolve to the builtin collection." msgstr "``shell`` モジュールを上書ãã—ãªã„å ´åˆã¯ã€ãƒ¬ã‚¬ã‚·ãƒ¼ãŒçµ„ã¿è¾¼ã¿ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«å¯¾ã—ã¦è§£æ±ºã™ã‚‹ã®ã§ã€``ansible.builtin.shell`` ã¨è¨˜è¿°ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/faq.rst:880 +#: ../../rst/reference_appendices/faq.rst:919 msgid "I don't see my question here" msgstr "ã“ã“ã«è¨˜è¼‰ã•ã‚Œã¦ã„る以外ã«è³ªå•ãŒã‚ã‚Šã¾ã™" -#: ../../rst/reference_appendices/faq.rst:882 +#: ../../rst/reference_appendices/faq.rst:921 msgid "If you have not found an answer to your questions, you can ask on one of our mailing lists or chat channels. For instructions on subscribing to a list or joining a chat channel, see :ref:`communication`." msgstr "ã”ä¸æ˜Žãªç‚¹ãŒã”ã–ã„ã¾ã—ãŸã‚‰ã€ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆã¾ãŸã¯ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã®ã„ãšã‚Œã‹ã‚’å°‹ãã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚リストã®ã‚µãƒ–スクライブ方法やã€ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã¸ã®å‚åŠ æ–¹æ³•ã¯ã€:ref:`communication`ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/faq.rst:887 +#: ../../rst/reference_appendices/faq.rst:926 #: ../../rst/reference_appendices/glossary.rst:537 -#: ../../rst/reference_appendices/test_strategies.rst:268 +#: ../../rst/reference_appendices/test_strategies.rst:297 msgid "An introduction to playbooks" msgstr "Playbook ã®æ¦‚è¦" -#: ../../rst/reference_appendices/faq.rst:888 +#: ../../rst/reference_appendices/faq.rst:927 #: ../../rst/reference_appendices/glossary.rst:538 msgid ":ref:`playbooks_best_practices`" msgstr ":ref:`playbooks_best_practices`" -#: ../../rst/reference_appendices/faq.rst:889 +#: ../../rst/reference_appendices/faq.rst:928 #: ../../rst/reference_appendices/glossary.rst:539 msgid "Tips and tricks for playbooks" msgstr "Playbook ã®ãƒ’ントã¨è£æŠ€" -#: ../../rst/reference_appendices/faq.rst:890 -#: ../../rst/reference_appendices/test_strategies.rst:271 +#: ../../rst/reference_appendices/faq.rst:929 +#: ../../rst/reference_appendices/test_strategies.rst:300 msgid "`User Mailing List <https://groups.google.com/group/ansible-project>`_" -msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansible-project>`_" +msgstr "`User Mailing List <https://groups.google.com/group/ansible-project>`_" -#: ../../rst/reference_appendices/faq.rst:891 +#: ../../rst/reference_appendices/faq.rst:930 #: ../../rst/reference_appendices/glossary.rst:541 -#: ../../rst/reference_appendices/test_strategies.rst:272 +#: ../../rst/reference_appendices/test_strategies.rst:301 msgid "Have a question? Stop by the google group!" msgstr "ã”質å•ã¯ã”ã–ã„ã¾ã™ã‹ã€‚Google Group ã‚’ã”覧ãã ã•ã„。" @@ -7264,7 +7285,7 @@ msgid "Command-line options" msgstr "コマンドラインオプション" #: ../../rst/reference_appendices/general_precedence.rst:22 -#: ../../rst/reference_appendices/general_precedence.rst:61 +#: ../../rst/reference_appendices/general_precedence.rst:65 msgid "Playbook keywords" msgstr "Playbook ã‚ーワード" @@ -7297,86 +7318,86 @@ msgid "You can override all other settings from all other sources in all other p msgstr ":ref:`general_precedence_extra_vars` ã«ã‚ˆã‚Šã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§ã€ä»–ã®å„ªå…ˆé †ä½ã‚«ãƒ†ã‚´ãƒªãƒ¼ã®ä»–ã®ã‚½ãƒ¼ã‚¹ã‹ã‚‰ã®ä»–ã®è¨å®šã‚’ã™ã¹ã¦ä¸Šæ›¸ãã§ãã¾ã™ã€‚ãŸã ã—ã€ã“ã‚Œã¯ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã§ã¯ãªãã€:ref:`variable<general_precedence_variables>` を渡ã™æ‰‹æ®µã¨ã—ã¦ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’使用ã—ã¦ã„ã¾ã™ã€‚" #: ../../rst/reference_appendices/general_precedence.rst:50 -msgid "At the command line, if you pass multiple values for a parameter that accepts only a single value, the last defined value wins. For example, this :ref:`ad hoc task<intro_adhoc>` will connect as ``carol``, not as ``mike``::" -msgstr "コマンドラインã§ã€å˜å€¤ã®ã¿ã‚’å—ã‘入れるパラメーターã«å¤šå€¤ã‚’渡ã™ã¨ã€æœ€å¾Œã«å®šç¾©ã•ã‚ŒãŸå€¤ãŒå„ªå…ˆã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€ã“ã® :ref:`アドホックタスク<intro_adhoc>` ã¯ã€``mike`` ã§ã¯ãªãã€``carol`` ã¨ã—ã¦æŽ¥ç¶šã—ã¾ã™ã€‚" +msgid "At the command line, if you pass multiple values for a parameter that accepts only a single value, the last defined value wins. For example, this :ref:`ad hoc task<intro_adhoc>` will connect as ``carol``, not as ``mike``:" +msgstr "コマンドラインã§ã€å˜å€¤ã®ã¿ã‚’å—ã‘入れるパラメーターã«å¤šå€¤ã‚’渡ã™ã¨ã€æœ€å¾Œã«å®šç¾©ã•ã‚ŒãŸå€¤ãŒå„ªå…ˆã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€ã“ã® :ref:`ad hoc task<intro_adhoc>` ã¯ã€``mike`` ã§ã¯ãªãã€``carol`` ã¨ã—ã¦æŽ¥ç¶šã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:54 -msgid "Some parameters allow multiple values. In this case, Ansible will append all values from the hosts listed in inventory files inventory1 and inventory2::" +#: ../../rst/reference_appendices/general_precedence.rst:56 +msgid "Some parameters allow multiple values. In this case, Ansible will append all values from the hosts listed in inventory files inventory1 and inventory2:" msgstr "パラメーターã«ã‚ˆã£ã¦ã¯ã€å¤šå€¤ã‚’使用ã§ãã¾ã™ã€‚以下ã®å ´åˆã«ã¯ã€Ansible ã¯ã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ•ã‚¡ã‚¤ãƒ«ã€Œinventory1ã€ãŠã‚ˆã³ã€Œinventory2ã€ã«è¨˜è¼‰ã•ã‚Œã¦ã„るホストã‹ã‚‰ã®å€¤ã‚’ã™ã¹ã¦è¿½åŠ ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:58 +#: ../../rst/reference_appendices/general_precedence.rst:62 msgid "The help for each :ref:`command-line tool<command_line_tools>` lists available options for that tool." msgstr "å„ :ref:`コマンドラインツール<command_line_tools>` ã®ãƒ˜ãƒ«ãƒ—ã¯ã€å¯¾è±¡ã®ãƒ„ールã§åˆ©ç”¨å¯èƒ½ãªã‚ªãƒ—ションを表示ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:63 +#: ../../rst/reference_appendices/general_precedence.rst:67 msgid "Any :ref:`playbook keyword<playbook_keywords>` will override any command-line option and any configuration setting." msgstr ":ref:`Playbook ã‚ーワード<playbook_keywords>` ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã¨ã€æ§‹æˆè¨å®šã‚’ã™ã¹ã¦ã‚ªãƒ¼ãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:65 +#: ../../rst/reference_appendices/general_precedence.rst:69 msgid "Within playbook keywords, precedence flows with the playbook itself; the more specific wins against the more general:" msgstr "Playbook ã‚ーワード内ã®å„ªå…ˆé †ä½ã¯ã€Playbook ã®å†…容ã«ã‚ˆã‚Šå·¦å³ã•ã‚Œã¾ã™ (一般的ãªè¨å®šã‚ˆã‚Šå…·ä½“çš„ãªè¨å®šãŒå„ªå…ˆã•ã‚Œã¾ã™)。" -#: ../../rst/reference_appendices/general_precedence.rst:67 +#: ../../rst/reference_appendices/general_precedence.rst:71 msgid "play (most general)" msgstr "プレイ (最も一般的)" -#: ../../rst/reference_appendices/general_precedence.rst:68 +#: ../../rst/reference_appendices/general_precedence.rst:72 msgid "blocks/includes/imports/roles (optional and can contain tasks and each other)" msgstr "blocks/includes/imports/roles (ä»»æ„ã§ã€ã‚¿ã‚¹ã‚¯ã‚’å«ã‚ã‚‹ã“ã¨ã‚‚ã€ç›¸äº’ã«å«ã‚ã‚‹ã“ã¨ã‚‚å¯èƒ½)" -#: ../../rst/reference_appendices/general_precedence.rst:69 +#: ../../rst/reference_appendices/general_precedence.rst:73 msgid "tasks (most specific)" msgstr "タスク (最も具体的)" -#: ../../rst/reference_appendices/general_precedence.rst:71 -msgid "A simple example::" -msgstr "ç°¡å˜ãªä¾‹::" +#: ../../rst/reference_appendices/general_precedence.rst:75 +msgid "A simple example:" +msgstr "ç°¡å˜ãªä¾‹:" -#: ../../rst/reference_appendices/general_precedence.rst:83 +#: ../../rst/reference_appendices/general_precedence.rst:89 msgid "In this example, the ``connection`` keyword is set to ``ssh`` at the play level. The first task inherits that value, and connects using ``ssh``. The second task inherits that value, overrides it, and connects using ``paramiko``. The same logic applies to blocks and roles as well. All tasks, blocks, and roles within a play inherit play-level keywords; any task, block, or role can override any keyword by defining a different value for that keyword within the task, block, or role." msgstr "ã“ã®ä¾‹ã§ã¯ã€``connection`` ã‚ーワードã¯ãƒ—レイレベル㧠``ssh`` ã«è¨å®šã•ã‚Œã¦ã„ã¾ã™ã€‚最åˆã®ã‚¿ã‚¹ã‚¯ã¯ãã®å€¤ã‚’継承ã—ã€``ssh`` を使用ã—ã¦æŽ¥ç¶šã—ã¾ã™ã€‚2 番目ã®ã‚¿ã‚¹ã‚¯ã¯ã€ãã®å€¤ã‚’継承ã—ã¦ã‚ªãƒ¼ãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã—ã€``paramiko`` を使用ã—ã¦æŽ¥ç¶šã—ã¾ã™ã€‚ブãƒãƒƒã‚¯ã‚„ãƒãƒ¼ãƒ«ã§ã‚‚åŒã˜ãƒã‚¸ãƒƒã‚¯ãŒé©ç”¨ã•ã‚Œã¾ã™ã€‚プレイ内ã®ã‚¿ã‚¹ã‚¯ã€ãƒ–ãƒãƒƒã‚¯ã€ãŠã‚ˆã³ãƒãƒ¼ãƒ«ã¯ã™ã¹ã¦ã€ãƒ—レイレベルã®ã‚ーワードを継承ã—ã¾ã™ã€‚ã‚ーワードよりタスクã€ãƒ–ãƒãƒƒã‚¯ã€ã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚’優先ã•ã›ã‚‹ã«ã¯ã€ã‚¿ã‚¹ã‚¯ã€ãƒ–ãƒãƒƒã‚¯ã€ã¾ãŸã¯ãƒãƒ¼ãƒ«å†…ã®å¯¾è±¡ã®ã‚ーワードã«ç•°ãªã‚‹å€¤ã‚’定義ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:86 +#: ../../rst/reference_appendices/general_precedence.rst:92 msgid "Remember that these are KEYWORDS, not variables. Both playbooks and variable files are defined in YAML but they have different significance. Playbooks are the command or 'state description' structure for Ansible, variables are data we use to help make playbooks more dynamic." msgstr "上記ã¯ã€å¤‰æ•°ã§ã¯ãªãã€ã‚ーワードã§ã‚る点ã«æ³¨æ„ã—ã¦ãã ã•ã„。Playbook や変数ファイルã¯ã„ãšã‚Œã‚‚ YAML ã§å®šç¾©ã—ã¾ã™ãŒã€ãã‚Œãžã‚Œé‡è¦æ€§ãŒç•°ãªã‚Šã¾ã™ã€‚Playbook ã¯ã‚³ãƒžãƒ³ãƒ‰ã¾ãŸã¯ Ansible ã®ã€ŒçŠ¶æ…‹è¨˜è¿°ã€æ§‹é€ ã§ã€å¤‰æ•°ã¯ Playbook をより動的ã«ä½¿ç”¨ã§ãるよã†ã«ã™ã‚‹ãŸã‚ã®ãƒ‡ãƒ¼ã‚¿ã§ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:94 +#: ../../rst/reference_appendices/general_precedence.rst:100 msgid "Any variable will override any playbook keyword, any command-line option, and any configuration setting." msgstr "変数ã¯ã€Playbook ã®ã‚ーワードã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã€æ§‹æˆè¨å®šã‚’ã™ã¹ã¦ã‚ªãƒ¼ãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:96 +#: ../../rst/reference_appendices/general_precedence.rst:102 msgid "Variables that have equivalent playbook keywords, command-line options, and configuration settings are known as :ref:`connection_variables`. Originally designed for connection parameters, this category has expanded to include other core variables like the temporary directory and the python interpreter." msgstr "åŒç‰ã® Playbook ã‚ーワードã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã€ãŠã‚ˆã³æ§‹æˆè¨å®šã‚’å«ã‚€å¤‰æ•°ã¯ :ref:`connection_variables` ã¨å‘¼ã°ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ã‚«ãƒ†ã‚´ãƒªãƒ¼ã¯ã€å½“åˆã¯è¨å®šãƒ‘ラメーターå‘ã‘ã«è¨è¨ˆã•ã‚Œã¦ã¾ã—ãŸãŒã€ä¸€æ™‚ディレクトリーや Python インタープリターãªã©ã€ä»–ã®ã‚³ã‚¢å¤‰æ•°ã‚’å«ã‚るよã†ã«æ‹¡å¼µã•ã‚Œã¾ã—ãŸã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:98 +#: ../../rst/reference_appendices/general_precedence.rst:104 msgid "Connection variables, like all variables, can be set in multiple ways and places. You can define variables for hosts and groups in :ref:`inventory<intro_inventory>`. You can define variables for tasks and plays in ``vars:`` blocks in :ref:`playbooks<about_playbooks>`. However, they are still variables - they are data, not keywords or configuration settings. Variables that override playbook keywords, command-line options, and configuration settings follow the same rules of :ref:`variable precedence <ansible_variable_precedence>` as any other variables." msgstr "接続変数ã¯ã™ã¹ã¦ã®å¤‰æ•°ã¨åŒæ§˜ã€è¤‡æ•°ã®æ‰‹æ³•ã‚„å ´æ‰€ã§è¨å®šã§ãã¾ã™ã€‚:ref:`インベントリー<intro_inventory>` ã§ãƒ›ã‚¹ãƒˆã¨ã‚°ãƒ«ãƒ¼ãƒ—ã®å¤‰æ•°ã‚’定義ã§ãã¾ã™ã€‚:ref:`Playbook<about_playbooks>` ã® ``vars:`` ブãƒãƒƒã‚¯ã«ã€ã‚¿ã‚¹ã‚¯ã¨ãƒ—レイã®å¤‰æ•°ã‚’定義ã§ãã¾ã™ã€‚ãŸã ã—ã€ä¸Šè¨˜ã¯ã€ã‚ーワードや構æˆè¨å®šã§ã¯ãªãã€ãƒ‡ãƒ¼ã‚¿ã‚’æ ¼ç´ã™ã‚‹å¤‰æ•°ã§ã™ã€‚Playbook ã‚ーワードã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã€ãŠã‚ˆã³è¨å®šã‚ªãƒ—ションをオーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã™ã‚‹å¤‰æ•°ã¯ã€ä»–ã®å¤‰æ•°ãŒä½¿ç”¨ã™ã‚‹ :ref:`変数ã®å„ªå…ˆé †ä½ <ansible_variable_precedence>` ã¨åŒã˜ãƒ«ãƒ¼ãƒ«ã«å¾“ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:100 -msgid "When set in a playbook, variables follow the same inheritance rules as playbook keywords. You can set a value for the play, then override it in a task, block, or role::" +#: ../../rst/reference_appendices/general_precedence.rst:106 +msgid "When set in a playbook, variables follow the same inheritance rules as playbook keywords. You can set a value for the play, then override it in a task, block, or role:" msgstr "変数ã¯ã€Playbook ã«è¨å®šã•ã‚Œã‚‹ã¨ã€Playbook ã‚ーワードã¨åŒã˜ç¶™æ‰¿ãƒ«ãƒ¼ãƒ«ã«å¾“ã„ã¾ã™ã€‚プレイã®å€¤ã‚’è¨å®šã™ã‚‹ã¨ã€ã‚¿ã‚¹ã‚¯ã€ãƒ–ãƒãƒƒã‚¯ã€ã¾ãŸã¯ãƒãƒ¼ãƒ«ã®å€¤ã‚’オーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:125 +#: ../../rst/reference_appendices/general_precedence.rst:133 msgid "Variable scope: how long is a value available?" msgstr "変数ã®ç¯„囲: 値ãŒæœ‰åŠ¹ãªæœŸé–“" -#: ../../rst/reference_appendices/general_precedence.rst:127 +#: ../../rst/reference_appendices/general_precedence.rst:135 msgid "Variable values set in a playbook exist only within the playbook object that defines them. These 'playbook object scope' variables are not available to subsequent objects, including other plays." msgstr "Playbook ã«è¨å®šã—ãŸå¤‰æ•°ã®å€¤ã¯ã€ãã®å€¤ã‚’定義ã™ã‚‹ Playbook オブジェクト内ã«ã®ã¿å˜åœ¨ã—ã¾ã™ã€‚ã“ã®ã‚ˆã†ãªã€ŒPlaybook オブジェクトã®ç¯„囲ã€ã®å¤‰æ•°ã¯ã€ä»–ã®ãƒ—レイãªã©ã€å¾Œç¶šã®ã‚ªãƒ–ジェクトã§ã¯åˆ©ç”¨ã§ãã¾ã›ã‚“。" -#: ../../rst/reference_appendices/general_precedence.rst:129 -msgid "Variable values associated directly with a host or group, including variables defined in inventory, by vars plugins, or using modules like :ref:`set_fact<set_fact_module>` and :ref:`include_vars<include_vars_module>`, are available to all plays. These 'host scope' variables are also available via the ``hostvars[]`` dictionary." +#: ../../rst/reference_appendices/general_precedence.rst:137 +msgid "Variable values associated directly with a host or group, including variables defined in inventory, by vars plugins, or using modules like :ref:`set_fact<set_fact_module>` and :ref:`include_vars<include_vars_module>`, are available to all plays. These 'host scope' variables are also available through the ``hostvars[]`` dictionary." msgstr "インベントリーã€vars プラグインã€:ref:`set_fact<set_fact_module>` ã‚„ :ref:`include_vars<include_vars_module>` ã¨ã„ã£ãŸãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ä½¿ç”¨ãªã©ã€ãƒ›ã‚¹ãƒˆã‚„グループã«ç›´æŽ¥é–¢é€£ä»˜ã‘られãŸå¤‰æ•°å€¤ã¯ã€å…¨ãƒ—レイã§åˆ©ç”¨ã§ãã¾ã™ã€‚ã¾ãŸã€ã“れらã®ã€Œãƒ›ã‚¹ãƒˆç¯„囲ã€å¤‰æ•°ã¯ã€``hostvars[]`` ディクショナリーã‹ã‚‰åˆ©ç”¨ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:134 +#: ../../rst/reference_appendices/general_precedence.rst:142 msgid "Using ``-e`` extra variables at the command line" msgstr "コマンドラインã§ã®è¿½åŠ 変数 (``-e``) ã®ä½¿ç”¨" -#: ../../rst/reference_appendices/general_precedence.rst:136 -msgid "To override all other settings in all other categories, you can use extra variables: ``--extra-vars`` or ``-e`` at the command line. Values passed with ``-e`` are variables, not command-line options, and they will override configuration settings, command-line options, and playbook keywords as well as variables set elsewhere. For example, this task will connect as ``brian`` not as ``carol``::" +#: ../../rst/reference_appendices/general_precedence.rst:144 +msgid "To override all other settings in all other categories, you can use extra variables: ``--extra-vars`` or ``-e`` at the command line. Values passed with ``-e`` are variables, not command-line options, and they will override configuration settings, command-line options, and playbook keywords as well as variables set elsewhere. For example, this task will connect as ``brian`` not as ``carol``:" msgstr "ä»–ã®ã‚«ãƒ†ã‚´ãƒªãƒ¼ã®å…¨è¨å®šã‚’オーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã™ã‚‹ã«ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã§è¿½åŠ 変数 (``--extra-vars`` ã¾ãŸã¯ ``-e``) を使用ã—ã¾ã™ã€‚``-e`` ã§æ¸¡ã•ã‚Œã‚‹å€¤ã¯ã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã§ã¯ãªã変数ã§ã€ä»–ã§è¨å®šã—ãŸå¤‰æ•°ã‚’ã¯ã˜ã‚ã€æ§‹æˆè¨å®šã€ã‚³ãƒžãƒ³ãƒ‰ãƒ©ã‚¤ãƒ³ã‚ªãƒ—ションã€Playbook ã‚ーワードをオーãƒãƒ¼ãƒ©ã‚¤ãƒ‰ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ã“ã®ã‚¿ã‚¹ã‚¯ã¯ã€``carol`` ã§ã¯ãªã ``brian`` ã¨ã—ã¦æŽ¥ç¶šã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/general_precedence.rst:140 +#: ../../rst/reference_appendices/general_precedence.rst:150 msgid "You must specify both the variable name and the value with ``--extra-vars``." msgstr "変数åã¨å€¤ã¯ã€``--extra-vars`` ã§æŒ‡å®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" @@ -7451,7 +7472,7 @@ msgstr "完了を待ãŸãšã«ãƒãƒƒã‚¯ã‚°ãƒ©ã‚¦ãƒ³ãƒ‰ã§å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«æ§‹ #: ../../rst/reference_appendices/glossary.rst:47 msgid "Callback Plugin" -msgstr "Callback プラグイン" +msgstr "Callback Plugin (コールãƒãƒƒã‚¯ãƒ—ラグイン)" #: ../../rst/reference_appendices/glossary.rst:49 msgid "Refers to some user-written code that can intercept results from Ansible and do something with them. Some supplied examples in the GitHub project perform custom logging, send email, or even play sound effects." @@ -7551,8 +7572,8 @@ msgid "Facts" msgstr "ファクト" #: ../../rst/reference_appendices/glossary.rst:122 -msgid "Facts are simply things that are discovered about remote nodes. While they can be used in :term:`playbooks` and templates just like variables, facts are things that are inferred, rather than set. Facts are automatically discovered by Ansible when running plays by executing the internal :ref:`setup module <setup_module>` on the remote nodes. You never have to call the setup module explicitly, it just runs, but it can be disabled to save time if it is not needed or you can tell ansible to collect only a subset of the full facts via the ``gather_subset:`` option. For the convenience of users who are switching from other configuration management systems, the fact module will also pull in facts from the :program:`ohai` and :program:`facter` tools if they are installed. These are fact libraries from Chef and Puppet, respectively. (These may also be disabled via ``gather_subset:``)" -msgstr "端的ã«è¨€ã†ã¨ã€ãƒ•ã‚¡ã‚¯ãƒˆã¯ãƒªãƒ¢ãƒ¼ãƒˆãƒŽãƒ¼ãƒ‰ã«ã¤ã„ã¦ç™ºè¦‹ã•ã‚Œã‚‹äº‹æŸ„を指ã—ã¾ã™ã€‚ファクトã¯å¤‰æ•°ã®ã‚ˆã†ã« :term:`Playbook` やテンプレートã§ä½¿ç”¨ã§ãã¾ã™ãŒã€ãƒ•ã‚¡ã‚¯ãƒˆã¯è¨å®šã•ã‚Œã‚‹äº‹æŸ„ã¨ã„ã†ã‚ˆã‚Šã¯æŽ¨æ¸¬ã•ã‚Œã‚‹äº‹æŸ„ã¨è¨€ãˆã¾ã™ã€‚ファクトã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒŽãƒ¼ãƒ‰ã§å†…部 :ref:`セットアップモジュール <setup_module>` を実行ã™ã‚‹ã“ã¨ã§ãƒ—レイã®å®Ÿè¡Œä¸ã« Ansible ã«ã‚ˆã‚Šè‡ªå‹•çš„ã«æ¤œå‡ºã•ã‚Œã‚‹ãŸã‚ã€ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—モジュールを明示的ã«å‘¼ã³å‡ºã™ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“。ãã‚Œã¯ãŸã 実行ã•ã‚Œã¾ã™ã€‚ãã®å¿…è¦ãŒãªã‘ã‚Œã°æ™‚間を節約ã™ã‚‹ãŸã‚ã«ç„¡åŠ¹ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã—ã€``gather_subset:`` オプションã§å…¨ãƒ•ã‚¡ã‚¯ãƒˆã®ã‚µãƒ–セットã ã‘ã‚’åŽé›†ã™ã‚‹ã‚ˆã†ã« Ansible ã«æŒ‡ç¤ºã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ä»–ã®è¨å®šç®¡ç†ã‚·ã‚¹ãƒ†ãƒ ã‹ã‚‰åˆ‡ã‚Šæ›¿ãˆã‚’è¡Œã‚ã‚Œã¦ã„ã‚‹å ´åˆã®åˆ©ç‚¹ã¨ã—ã¦ã€ãƒ•ã‚¡ã‚¯ãƒˆãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€Chef 㨠Puppet ã®ãƒ•ã‚¡ã‚¯ãƒˆãƒ©ã‚¤ãƒ–ラリーã‹ã‚‰ã€ãã‚Œãžã‚Œ :program:`ohai` ツールãŠã‚ˆã³ :program:`facter` ツールã‹ã‚‰ã‚‚ (インストールã•ã‚Œã¦ã„ã‚‹å ´åˆ) ファクトをå–ã‚Šè¾¼ã¿ã¾ã™ (ã“れ㯠``gather_subset:`` ã§ç„¡åŠ¹ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™)。" +msgid "Facts are simply things that are discovered about remote nodes. While they can be used in :term:`playbooks` and templates just like variables, facts are things that are inferred, rather than set. Facts are automatically discovered by Ansible when running plays by executing the internal :ref:`setup module <setup_module>` on the remote nodes. You never have to call the setup module explicitly, it just runs, but it can be disabled to save time if it is not needed or you can tell ansible to collect only a subset of the full facts through the ``gather_subset:`` option. For the convenience of users who are switching from other configuration management systems, the fact module will also pull in facts from the :program:`ohai` and :program:`facter` tools if they are installed. These are fact libraries from Chef and Puppet, respectively. (These may also be disabled through ``gather_subset:``)" +msgstr "端的ã«è¨€ã†ã¨ã€ãƒ•ã‚¡ã‚¯ãƒˆã¯ãƒªãƒ¢ãƒ¼ãƒˆãƒŽãƒ¼ãƒ‰ã«ã¤ã„ã¦ç™ºè¦‹ã•ã‚Œã‚‹äº‹æŸ„を指ã—ã¾ã™ã€‚ファクトã¯å¤‰æ•°ã®ã‚ˆã†ã« :term:`playbooks` やテンプレートã§ä½¿ç”¨ã§ãã¾ã™ãŒã€ãƒ•ã‚¡ã‚¯ãƒˆã¯è¨å®šã•ã‚Œã‚‹äº‹æŸ„ã¨ã„ã†ã‚ˆã‚Šã¯æŽ¨æ¸¬ã•ã‚Œã‚‹äº‹æŸ„ã¨è¨€ãˆã¾ã™ã€‚ファクトã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒŽãƒ¼ãƒ‰ã§å†…部 :ref:`setup module <setup_module>` を実行ã™ã‚‹ã“ã¨ã§ãƒ—レイã®å®Ÿè¡Œä¸ã« Ansible ã«ã‚ˆã‚Šè‡ªå‹•çš„ã«æ¤œå‡ºã•ã‚Œã‚‹ãŸã‚ã€ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—モジュールを明示的ã«å‘¼ã³å‡ºã™ã“ã¨ã¯ã‚ã‚Šã¾ã›ã‚“。ãã‚Œã¯ãŸã 実行ã•ã‚Œã¾ã™ã€‚ãã®å¿…è¦ãŒãªã‘ã‚Œã°æ™‚間を節約ã™ã‚‹ãŸã‚ã«ç„¡åŠ¹ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã—ã€``gather_subset:`` オプションã§å…¨ãƒ•ã‚¡ã‚¯ãƒˆã®ã‚µãƒ–セットã ã‘ã‚’åŽé›†ã™ã‚‹ã‚ˆã†ã« Ansible ã«æŒ‡ç¤ºã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ä»–ã®è¨å®šç®¡ç†ã‚·ã‚¹ãƒ†ãƒ ã‹ã‚‰åˆ‡ã‚Šæ›¿ãˆã‚’è¡Œã‚ã‚Œã¦ã„ã‚‹å ´åˆã®åˆ©ç‚¹ã¨ã—ã¦ã€ãƒ•ã‚¡ã‚¯ãƒˆãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€Chef 㨠Puppet ã®ãƒ•ã‚¡ã‚¯ãƒˆãƒ©ã‚¤ãƒ–ラリーã‹ã‚‰ã€ãã‚Œãžã‚Œ :program:`ohai` ツールãŠã‚ˆã³ :program:`facter` ツールã‹ã‚‰ã‚‚ (インストールã•ã‚Œã¦ã„ã‚‹å ´åˆ) ファクトをå–ã‚Šè¾¼ã¿ã¾ã™ (ã“れ㯠``gather_subset:`` ã§ç„¡åŠ¹ã«ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™)。" #: ../../rst/reference_appendices/glossary.rst:136 msgid "Filter Plugin" @@ -7604,7 +7625,7 @@ msgstr "グループã¯ã€ãƒ—ールã«å‰²ã‚Šå½“ã¦ã‚‰ã‚ŒãŸè¤‡æ•°ã®ãƒ›ã‚¹ãƒˆã§ #: ../../rst/reference_appendices/glossary.rst:175 msgid "Group Vars" -msgstr "グループ変数" +msgstr "Group Vars (グループ変数)" #: ../../rst/reference_appendices/glossary.rst:177 msgid "The :file:`group_vars/` files are files that live in a directory alongside an inventory file, with an optional filename named after each group. This is a convenient place to put variables that are provided to a given group, especially complex data structures, so that these variables do not have to be embedded in the :term:`inventory` file or :term:`playbook <playbooks>`." @@ -7612,7 +7633,7 @@ msgstr ":file:`group_vars/` ファイルã¯ã€å„グループã«ç”±æ¥ã™ã‚‹ä»»æ #: ../../rst/reference_appendices/glossary.rst:183 msgid "Handlers" -msgstr "ãƒãƒ³ãƒ‰ãƒ©ãƒ¼" +msgstr "Handler (ãƒãƒ³ãƒ‰ãƒ©ãƒ¼)" #: ../../rst/reference_appendices/glossary.rst:185 msgid "Handlers are just like regular tasks in an Ansible :term:`playbook <playbooks>` (see :term:`Tasks`) but are only run if the Task contains a ``notify`` keyword and also indicates that it changed something. For example, if a config file is changed, then the task referencing the config file templating operation may notify a service restart handler. This means services can be bounced only if they need to be restarted. Handlers can be used for things other than service restarts, but service restarts are the most common usage." @@ -7628,7 +7649,7 @@ msgstr "ホストã¨ã¯ã€Ansible ãŒç®¡ç†ã™ã‚‹ãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ã®ã“ã¨ã #: ../../rst/reference_appendices/glossary.rst:200 msgid "Host Specifier" -msgstr "ホスト指定å" +msgstr "Host Specifier (ホスト指定å)" #: ../../rst/reference_appendices/glossary.rst:202 msgid "Each :term:`Play <plays>` in Ansible maps a series of :term:`tasks` (which define the role, purpose, or orders of a system) to a set of systems." @@ -7671,12 +7692,12 @@ msgid "Inventory" msgstr "インベントリー" #: ../../rst/reference_appendices/glossary.rst:234 -msgid "A file (by default, Ansible uses a simple INI format) that describes :term:`Hosts <Host>` and :term:`Groups <Group>` in Ansible. Inventory can also be provided via an :term:`Inventory Script` (sometimes called an \"External Inventory Script\")." -msgstr "Ansible 㧠:term:`ホスト <Host>` 㨠:term:`グループ <Group>` を記述ã—ãŸãƒ•ã‚¡ã‚¤ãƒ« (デフォルトã§ã¯ã€Ansible ã¯ç°¡å˜ãª INI å½¢å¼ã‚’使用)。インベントリーã¯ã€:term:`インベントリースクリプト` (「外部インベントリースクリプトã€ã¨å‘¼ã°ã‚Œã‚‹ã“ã¨ã‚‚ã‚ã‚Šã¾ã™) を介ã—ã¦æä¾›ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" +msgid "A file (by default, Ansible uses a simple INI format) that describes :term:`Hosts <Host>` and :term:`Groups <Group>` in Ansible. Inventory can also be provided through an :term:`Inventory Script` (sometimes called an \"External Inventory Script\")." +msgstr "Ansible 㧠:term:`Hosts <Host>` 㨠:term:`Groups <Group>` を記述ã—ãŸãƒ•ã‚¡ã‚¤ãƒ« (デフォルトã§ã¯ã€Ansible ã¯ç°¡å˜ãª INI å½¢å¼ã‚’使用)。インベントリーã¯ã€:term:`Inventory Script` (「外部インベントリースクリプトã€ã¨å‘¼ã°ã‚Œã‚‹ã“ã¨ã‚‚ã‚ã‚Šã¾ã™) を介ã—ã¦æä¾›ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" #: ../../rst/reference_appendices/glossary.rst:238 msgid "Inventory Script" -msgstr "インベントリースクリプト" +msgstr "Inventory Script (インベントリースクリプト)" #: ../../rst/reference_appendices/glossary.rst:240 msgid "A very simple program (or a complicated one) that looks up :term:`hosts <Host>`, :term:`group` membership for hosts, and variable information from an external resource -- whether that be a SQL database, a CMDB solution, or something like LDAP. This concept was adapted from Puppet (where it is called an \"External Nodes Classifier\") and works more or less exactly the same way." @@ -7907,7 +7928,7 @@ msgid "SSH (Native)" msgstr "SSH (ãƒã‚¤ãƒ†ã‚£ãƒ–)" #: ../../rst/reference_appendices/glossary.rst:461 -msgid "Native OpenSSH as an Ansible transport is specified with ``-c ssh`` (or a config file, or a keyword in the :term:`playbook <playbooks>`) and can be useful if wanting to login via Kerberized SSH or using SSH jump hosts, and so on. In 1.2.1, ``ssh`` will be used by default if the OpenSSH binary on the control machine is sufficiently new. Previously, Ansible selected ``paramiko`` as a default. Using a client that supports ``ControlMaster`` and ``ControlPersist`` is recommended for maximum performance -- if you don't have that and don't need Kerberos, jump hosts, or other features, ``paramiko`` is a good choice. Ansible will warn you if it doesn't detect ControlMaster/ControlPersist capability." +msgid "Native OpenSSH as an Ansible transport is specified with ``-c ssh`` (or a config file, or a keyword in the :term:`playbook <playbooks>`) and can be useful if wanting to login through Kerberized SSH or using SSH jump hosts, and so on. In 1.2.1, ``ssh`` will be used by default if the OpenSSH binary on the control machine is sufficiently new. Previously, Ansible selected ``paramiko`` as a default. Using a client that supports ``ControlMaster`` and ``ControlPersist`` is recommended for maximum performance -- if you don't have that and don't need Kerberos, jump hosts, or other features, ``paramiko`` is a good choice. Ansible will warn you if it doesn't detect ControlMaster/ControlPersist capability." msgstr "Ansible ã®ãƒˆãƒ©ãƒ³ã‚¹ãƒãƒ¼ãƒˆã¨ã—ã¦ã®ãƒã‚¤ãƒ†ã‚£ãƒ–㪠OpenSSH ã¯ã€``-c ssh`` (ã¾ãŸã¯è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã€ã‚ã‚‹ã„㯠:term:`playbook <playbooks>` ã®ã‚ーワード) ã§æŒ‡å®šã—ã¾ã™ã€‚ã“れ㯠Kerberized SSH ã§ãƒã‚°ã‚¤ãƒ³ã—ãŸã„å ´åˆã‚„ã€SSH ジャンプホストを使用ã—ãŸã„å ´åˆãªã©ã«ä¾¿åˆ©ã§ã™ã€‚1.2.1 ã§ã¯ã€ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ãƒžã‚·ãƒ³ä¸Šã® OpenSSH ãƒã‚¤ãƒŠãƒªãƒ¼ãŒå分ã«æ–°ã—ã„å ´åˆã¯ã€``ssh`` ãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã“ã‚Œã¾ã§ã® Ansible ã§ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ ``paramiko`` ãŒé¸æŠžã•ã‚Œã¦ã„ã¾ã—ãŸã€‚最大é™ã®ãƒ‘フォーマンスを得るãŸã‚ã«ã¯ã€``ControlMaster`` ãŠã‚ˆã³ ``ControlPersist`` をサãƒãƒ¼ãƒˆã—ã¦ã„るクライアントを使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¦ã„ã¾ã™ã€‚ã‚‚ã—ãã‚ŒãŒãªãã€Kerberos やジャンプホストãªã©ã®æ©Ÿèƒ½ãŒä¸è¦ãªå ´åˆã¯ã€``paramiko`` を使用ã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚Ansible ã¯ã€ControlMaster/ControlPersist 機能を検出ã§ããªã„ã¨è¦å‘Šã‚’発ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/glossary.rst:472 @@ -7985,7 +8006,7 @@ msgstr "よãã‚ã‚‹è³ªå• (FAQ)" #: ../../rst/reference_appendices/glossary.rst:540 msgid "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" -msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansible-devel>`_" +msgstr "`User Mailing List <https://groups.google.com/group/ansible-devel>`_" #: ../../rst/reference_appendices/interpreter_discovery.rst:4 msgid "Interpreter Discovery" @@ -8137,11 +8158,11 @@ msgstr "パスをå–å¾—ã—ã€ãã®ãƒžã‚¦ãƒ³ãƒˆãƒã‚¤ãƒ³ãƒˆã‚’è¿”ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/module_utils.rst:50 #: ansible.module_utils.basic.AnsibleModule.find_mount_point #: ansible.module_utils.basic.AnsibleModule.get_bin_path -#: ansible.module_utils.basic.AnsibleModule.is_executable #: ansible.module_utils.basic.AnsibleModule.run_command #: ansible.module_utils.common.arg_spec.ArgumentSpecValidator #: ansible.module_utils.common.arg_spec.ArgumentSpecValidator.validate #: ansible.module_utils.common.arg_spec.ValidationResult +#: ansible.module_utils.common.file.is_executable #: ansible.module_utils.common.parameters.sanitize_keys #: ansible.module_utils.common.validation.check_missing_parameters #: ansible.module_utils.common.validation.check_mutually_exclusive @@ -8211,23 +8232,23 @@ msgstr "``PATH`` ã¨ã€æ¤œç´¢ã™ã‚‹ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã®ã‚ªãƒ—ションã®ä¸€ msgid "if found return full path; otherwise return None" msgstr "見ã¤ã‹ã£ãŸå ´åˆã¯ãƒ•ãƒ«ãƒ‘スを返ã—ã¾ã™ã€‚見ã¤ã‹ã‚‰ãªã„å ´åˆã¯ None ã‚’è¿”ã—ã¾ã™ã€‚" -#: ansible.module_utils.basic.AnsibleModule.is_executable:1 of +#: ansible.module_utils.common.file.is_executable:1 of msgid "is the given path executable?" msgstr "指定ã®ãƒ‘スã¯å®Ÿè¡Œãƒ•ã‚¡ã‚¤ãƒ«ã§ã™ã‹ã€‚" -#: ansible.module_utils.basic.AnsibleModule.is_executable:3 of +#: ansible.module_utils.common.file.is_executable:3 of msgid "The path of the file to check." msgstr "確èªã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã®ãƒ‘ス。" -#: ansible.module_utils.basic.AnsibleModule.is_executable:5 of +#: ansible.module_utils.common.file.is_executable:5 of msgid "Limitations:" msgstr "制é™äº‹é …:" -#: ansible.module_utils.basic.AnsibleModule.is_executable:7 of +#: ansible.module_utils.common.file.is_executable:7 of msgid "Does not account for FSACLs." msgstr "FSACL を考慮ã—ã¾ã›ã‚“。" -#: ansible.module_utils.basic.AnsibleModule.is_executable:8 of +#: ansible.module_utils.common.file.is_executable:8 of msgid "Most times we really want to know \"Can the current user execute this file\". This function does not tell us that, only if any execute bit is set." msgstr "ã»ã¨ã‚“ã©ã®å ´åˆã¯ã€ã€Œç¾åœ¨ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’実行ã§ãã‚‹ã‹ã©ã†ã‹ã€ã‚’本当ã«çŸ¥ã‚ŠãŸã„ã®ã§ã™ã€‚ã“ã®é–¢æ•°ã¯ã€å®Ÿè¡Œãƒ“ットãŒè¨å®šã•ã‚Œã¦ã„ã‚‹ã‹ã©ã†ã‹ã ã‘ã§ã€ãれを知るã“ã¨ã¯ã§ãã¾ã›ã‚“。" @@ -8545,12 +8566,9 @@ msgstr "ã“ã‚Œã¯ã€æ¤œè¨¼ã—ãŸãƒ‘ラメーターãŠã‚ˆã³ã‚¨ãƒ©ãƒ¼ãŒå«ã¾ã‚Œ #: ansible.module_utils.common.arg_spec.ValidationResult:7 of msgid "Terms to be validated and coerced to the correct type." -msgstr "検証ã•ã‚Œã€æ£ã—ã„タイプã«å¼·åˆ¶ã•ã‚Œã‚‹ç”¨èªžã€‚" - -#: ansible.module_utils.common.arg_spec.ValidationResult._no_log_values:1 of -msgid ":class:`set` of values marked as ``no_log`` in the argument spec. This is a temporary holding place for these values and may move in the future." -msgstr "引数仕様㧠``no_log`` ã¨ãƒžãƒ¼ã‚¯ã•ã‚ŒãŸå€¤ã® :class:`set`。ã“ã‚Œã¯ã€ã“れらã®å€¤ã®ä¸€æ™‚çš„ãªä¿æŒã¨ãªã‚Šã€ä»Šå¾Œç§»å‹•ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" +msgstr "検証ã•ã‚Œã€æ£ã—ã„タイプã«å¼·åˆ¶ã•ã‚Œã‚‹ç”¨èªžã§ã™ã€‚" +#: ../../docstring #: ansible.module_utils.common.arg_spec.ValidationResult.errors:1 of msgid ":class:`~ansible.module_utils.errors.AnsibleValidationErrorMultiple` containing all :class:`~ansible.module_utils.errors.AnsibleValidationError` objects if there were any failures during validation." msgstr "検証ä¸ã«å¤±æ•—ã—ãŸå ´åˆã¯ã€ã™ã¹ã¦ã® :class:`~ansible.module_utils.errors.AnsibleValidationError` オブジェクトをå«ã‚€ :class:`~ansible.module_utils.errors.AnsibleValidationErrorMultiple`。" @@ -8949,6 +8967,7 @@ msgstr "フォールãƒãƒƒã‚¯ãƒãƒªãƒ‡ãƒ¼ã‚¿ãƒ¼ãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã§ã—㟠msgid "Single argument spec validation error" msgstr "å˜ä¸€ã®å¼•æ•°ã®ä»•æ§˜æ¤œè¨¼ã‚¨ãƒ©ãƒ¼" +#: ../../docstring #: ansible.module_utils.errors.AnsibleValidationError.error_message:1 #: ansible.module_utils.errors.AnsibleValidationError.msg:1 of msgid "The error message passed in when the exception was raised." @@ -8958,6 +8977,7 @@ msgstr "例外ãŒç™ºç”Ÿã—ãŸã¨ãã«æ¸¡ã•ã‚ŒãŸã‚¨ãƒ©ãƒ¼ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸" msgid "Multiple argument spec validation errors" msgstr "複数ã®å¼•æ•°ä»•æ§˜æ¤œè¨¼ã‚¨ãƒ©ãƒ¼" +#: ../../docstring #: ansible.module_utils.errors.AnsibleValidationErrorMultiple.errors:1 of msgid ":class:`list` of :class:`AnsibleValidationError` objects" msgstr ":class:`AnsibleValidationError` オブジェクト㮠:class:`list`" @@ -8994,6 +9014,10 @@ msgstr "パラメータータイプã®ã‚¨ãƒ©ãƒ¼" msgid "Error with parameter value" msgstr "パラメーター値ã®ã‚¨ãƒ©ãƒ¼" +#: ansible.module_utils.errors.DeprecationError:1 of +msgid "Error processing parameter deprecations" +msgstr "パラメーターã®éžæŽ¨å¥¨ã‚¢ã‚¤ãƒ†ãƒ ã®å‡¦ç†ä¸ã«ç™ºç”Ÿã™ã‚‹ã‚¨ãƒ©ãƒ¼" + #: ansible.module_utils.errors.ElementError:1 of msgid "Error when validating elements" msgstr "è¦ç´ 検証時ã®ã‚¨ãƒ©ãƒ¼" @@ -9226,7 +9250,7 @@ msgstr "ãƒãƒ³ãƒ‰ãƒ©ãƒ¼ã¨ã—ã¦æ‰±ã‚れるタスクãŒå«ã¾ã‚Œã‚‹ã‚»ã‚¯ã‚·ãƒ§ #: ../../rst/reference_appendices/playbooks_keywords.rst:86 msgid "hosts" -msgstr "hosts" +msgstr "ホスト" #: ../../rst/reference_appendices/playbooks_keywords.rst:86 msgid "A list of groups, hosts or host pattern that translates into a list of hosts that are the play's target." @@ -9373,7 +9397,7 @@ msgstr "プレイã«ä½¿ç”¨ã™ã‚‹ connection プラグインをé¸æŠžã§ãã¾ã™ #: ../../rst/reference_appendices/playbooks_keywords.rst:332 #: ../../rst/reference_appendices/playbooks_keywords.rst:461 msgid "tags" -msgstr "tags" +msgstr "ã‚¿ã‚°" #: ../../rst/reference_appendices/playbooks_keywords.rst:134 #: ../../rst/reference_appendices/playbooks_keywords.rst:230 @@ -9619,7 +9643,7 @@ msgstr "until" msgid "This keyword implies a ':term:`retries` loop' that will go on until the condition supplied here is met or we hit the :term:`retries` limit." msgstr "ã“ã®ã‚ーワードã¯ã€ã“ã“ã§æä¾›ã•ã‚ŒãŸæ¡ä»¶ãŒæº€ãŸã•ã‚Œã‚‹ã¾ã§ã€ã¾ãŸã¯ :term:`retries` ã®åˆ¶é™ã«åˆ°é”ã™ã‚‹ã¾ã§å®Ÿè¡Œã•ã‚Œã‚‹ ':term:`retries` loop' ã‚’æ„味ã—ã¾ã™ã€‚" -#: ../../<generated>:1 +#: ../../rst/reference_appendices/playbooks_keywords.rst:481 msgid "with_<lookup_plugin>" msgstr "with_<lookup_plugin>" @@ -9636,8 +9660,8 @@ msgid "Ansible 2.5 and above work with Python 3. Previous to 2.5, using Python 3 msgstr "Ansible 2.5 以é™ã§ã¯ Python 3 を使用ã—ã¾ã™ãŒã€Python 3 を使用ã™ã‚‹ Ansible 2.4 以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€ãƒ†ã‚¯ãƒŽãƒã‚¸ãƒ¼ãƒ—レビューã¨ã¿ãªã•ã‚Œã¾ã™ã€‚以下ã®ãƒˆãƒ”ックã§ã¯ã€Python 3 を使用ã§ãるよã†ã«ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ã¨ç®¡ç†ãƒžã‚·ãƒ³ã‚’è¨å®šã™ã‚‹æ–¹æ³•ã‚’説明ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/python_3_support.rst:9 -msgid "On the controller we support Python 3.5 or greater and Python 2.7 or greater. Module-side, we support Python 3.5 or greater and Python 2.6 or greater." -msgstr "コントãƒãƒ¼ãƒ©ãƒ¼ã§ã¯ã€Python 3.5 以é™ã€ãŠã‚ˆã³ Python 2.7 以é™ã‚’サãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚モジュールå´ã§ã¯ã€Python 3.5 以é™ã€Python 2.6 以é™ã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" +msgid "See :ref: `Control Node Requirements <control_node_requirements>` and :ref: `Managed Node Requirements <managed_node_requirements>` for the specific versions supported." +msgstr "サãƒãƒ¼ãƒˆå¯¾è±¡ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€:ref:`Control Node Requirements <control_node_requirements>` ãŠã‚ˆã³ :ref:`Managed Node Requirements <managed_node_requirements>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" #: ../../rst/reference_appendices/python_3_support.rst:12 msgid "On the controller side" @@ -9648,11 +9672,11 @@ msgid "The easiest way to run :command:`/usr/bin/ansible` under Python 3 is to i msgstr "Python 3 㧠:command:`/usr/bin/ansible` を最も簡å˜ã«å®Ÿè¡Œã™ã‚‹ã«ã¯ã€pip ã® Python 3 ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’インストールã—ã¾ã™ã€‚ã“ã‚Œã§ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã€Python 3 を使用ã—㦠:command:`/usr/bin/ansible` を実行ã§ãã¾ã™ã€‚" #: ../../rst/reference_appendices/python_3_support.rst:23 -msgid "If you are running Ansible :ref:`from_source` and want to use Python 3 with your source checkout, run your command via ``python3``. For example:" +msgid "If you are running Ansible :ref:`from_source` and want to use Python 3 with your source checkout, run your command through ``python3``. For example:" msgstr "Ansible :ref:`from_source` を実行ã—ã¦ã„ã¦ã€ã‚½ãƒ¼ã‚¹ã®ãƒã‚§ãƒƒã‚¯ã‚¢ã‚¦ãƒˆã« Python 3 を使用ã™ã‚‹ã«ã¯ã€``python3`` ã§ã‚³ãƒžãƒ³ãƒ‰ã‚’実行ã—ã¾ã™ã€‚以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/python_3_support.rst:32 -msgid "Individual Linux distribution packages may be packaged for Python2 or Python3. When running from distro packages you'll only be able to use Ansible with the Python version for which it was installed. Sometimes distros will provide a means of installing for several Python versions (via a separate package or via some commands that are run after install). You'll need to check with your distro to see if that applies in your case." +msgid "Individual Linux distribution packages may be packaged for Python2 or Python3. When running from distro packages you'll only be able to use Ansible with the Python version for which it was installed. Sometimes distros will provide a means of installing for several Python versions (through a separate package or through some commands that are run after install). You'll need to check with your distro to see if that applies in your case." msgstr "個々㮠Linux ディストリビューションパッケージã¯ã€Python2 ã¾ãŸã¯ Python3 ã«ãƒ‘ッケージ化ã•ã‚Œã¾ã™ã€‚ディストリビューションã‹ã‚‰å®Ÿè¡Œã™ã‚‹å ´åˆã¯ã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¦ã„ã‚‹ Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã®ã¿ Ansible を使用ã§ãã¾ã™ã€‚障害ã«ã‚ˆã‚Šã€è¤‡æ•°ã® Python ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (別ã®ãƒ‘ッケージã€ã¾ãŸã¯ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«å¾Œã«å®Ÿè¡Œã•ã‚Œã‚‹ä¸€éƒ¨ã®ã‚³ãƒžãƒ³ãƒ‰ã‚’介ã—ã¦) インストールを行ã†æ‰‹æ®µãŒæä¾›ã•ã‚Œã¾ã™ã€‚" #: ../../rst/reference_appendices/python_3_support.rst:40 @@ -9864,7 +9888,6 @@ msgid "Ansible Community Package Release" msgstr "Ansible コミュニティーパッケージã®ãƒªãƒªãƒ¼ã‚¹" #: ../../rst/reference_appendices/release_and_maintenance.rst:81 -#: ../../rst/reference_appendices/release_and_maintenance.rst:125 msgid "Status" msgstr "ステータス" @@ -9873,359 +9896,462 @@ msgid "Core version dependency" msgstr "Core ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ä¾å˜é–¢ä¿‚" #: ../../rst/reference_appendices/release_and_maintenance.rst:83 -msgid "7.0.0" -msgstr "7.0.0" +msgid "8.0.0" +msgstr "8.0.0" #: ../../rst/reference_appendices/release_and_maintenance.rst:83 msgid "In development (unreleased)" msgstr "é–‹ç™ºä¸ (未リリース)" #: ../../rst/reference_appendices/release_and_maintenance.rst:84 -msgid "`6.x Changelogs`_" -msgstr "`6.x Changelogs`_" +msgid "`7.x Changelogs`_" +msgstr "`7.x Changelogs`_" #: ../../rst/reference_appendices/release_and_maintenance.rst:84 msgid "Current" msgstr "ç¾è¡Œ" #: ../../rst/reference_appendices/release_and_maintenance.rst:85 +msgid "`6.x Changelogs`_" +msgstr "`6.x Changelogs`_" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:85 +msgid "Unmaintained (end of life) after Ansible 6.7.0" +msgstr "Ansible 6.7.0 以é™ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹å¯¾è±¡å¤– (サãƒãƒ¼ãƒˆçµ‚了)" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:86 msgid "`5.x Changelogs`_" msgstr "`5.x Changelogs`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:85 #: ../../rst/reference_appendices/release_and_maintenance.rst:86 #: ../../rst/reference_appendices/release_and_maintenance.rst:87 #: ../../rst/reference_appendices/release_and_maintenance.rst:88 -#: ../../rst/reference_appendices/release_and_maintenance.rst:132 -#: ../../rst/reference_appendices/release_and_maintenance.rst:133 -#: ../../rst/reference_appendices/release_and_maintenance.rst:134 -#: ../../rst/reference_appendices/release_and_maintenance.rst:135 -#: ../../rst/reference_appendices/release_and_maintenance.rst:136 -#: ../../rst/reference_appendices/release_and_maintenance.rst:137 -#: ../../rst/reference_appendices/release_and_maintenance.rst:138 +#: ../../rst/reference_appendices/release_and_maintenance.rst:89 msgid "Unmaintained (end of life)" msgstr "メンテナンス対象外 (エンドオフライフ)" -#: ../../rst/reference_appendices/release_and_maintenance.rst:86 +#: ../../rst/reference_appendices/release_and_maintenance.rst:87 msgid "`4.x Changelogs`_" msgstr "`4.x Changelogs`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:87 +#: ../../rst/reference_appendices/release_and_maintenance.rst:88 msgid "`3.x Changelogs`_" msgstr "`3.x Changelogs`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:88 +#: ../../rst/reference_appendices/release_and_maintenance.rst:89 msgid "`2.10 Changelogs`_" msgstr "`2.10 Changelogs`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:99 +#: ../../rst/reference_appendices/release_and_maintenance.rst:101 msgid "ansible-core release cycle" msgstr "ansible-core リリースサイクル" -#: ../../rst/reference_appendices/release_and_maintenance.rst:101 +#: ../../rst/reference_appendices/release_and_maintenance.rst:103 msgid "``ansible-core`` is developed and released on a flexible release cycle. We can extend this cycle to properly implement and test larger changes before a new release is made available. See :ref:`ansible_core_roadmaps` for upcoming release details." msgstr "``ansible-core`` ã¯ã€æŸ”軟ãªãƒªãƒªãƒ¼ã‚¹ã‚µã‚¤ã‚¯ãƒ«ã§é–‹ç™ºãŠã‚ˆã³ãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã¾ã™ã€‚ã“ã®ã‚µã‚¤ã‚¯ãƒ«ã‚’延長ã—ã¦ã€æ–°ã—ã„リリースãŒåˆ©ç”¨å¯èƒ½ã«ãªã‚‹å‰ã«ã€ã‚ˆã‚Šå¤§ããªå¤‰æ›´ã‚’é©åˆ‡ã«å®Ÿè£…ãŠã‚ˆã³ãƒ†ã‚¹ãƒˆã§ãã¾ã™ã€‚今後ã®ãƒªãƒªãƒ¼ã‚¹ã®è©³ç´°ã«ã¤ã„ã¦ã¯ :ref:`ansible_core_roadmaps` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:103 +#: ../../rst/reference_appendices/release_and_maintenance.rst:105 msgid "``ansible-core`` has a graduated maintenance structure that extends to three major releases. For more information, read about the :ref:`development_and_stable_version_maintenance_workflow` or see the chart in :ref:`release_schedule` for the degrees to which current releases are maintained." msgstr "``ansible-core`` ã«ã¯ã€3 ã¤ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã§å±•é–‹ã•ã‚Œã‚‹æ®µéšŽçš„ãªãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹æ§‹é€ ãŒã‚ã‚Šã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`development_and_stable_version_maintenance_workflow`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。ã¾ãŸã€ç¾åœ¨ã®ãƒªãƒªãƒ¼ã‚¹ãŒã©ã®ç¨‹åº¦ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ã‚‹ã‹ã«ã¤ã„ã¦ã¯ã€:ref:`release_schedule` ã®è¡¨ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:109 +#: ../../rst/reference_appendices/release_and_maintenance.rst:111 msgid "Older, unmaintained versions of ``ansible-core`` can contain unfixed security vulnerabilities (*CVEs*). If you are using a release of ``ansible-core`` that is no longer maintained, we strongly encourage you to upgrade as soon as possible to benefit from the latest features and security fixes. ``ansible-core`` maintenance continues for 3 releases. Thus the latest release receives security and general bug fixes when it is first released, security and critical bug fixes when the next ``ansible-core`` version is released, and **only** security fixes once the follow on to that version is released." msgstr "``ansible-core``ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„以å‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ã¯ã€ã‚»ã‚ュリティー脆弱性 (*CVE*) ãŒå«ã¾ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ä¿å®ˆã®ãªã„``ansible-core``ã®ãƒªãƒªãƒ¼ã‚¹ã‚’使用ã—ã¦ã„ã‚‹å ´åˆã«ã¯ã€æœ€æ–°ã®æ©Ÿèƒ½ãŠã‚ˆã³ã‚»ã‚ュリティー修æ£ã‚’活用ã§ãるよã†ã«ã€ã™ãã«ã‚¢ãƒƒãƒ—グレードã™ã‚‹ã“ã¨ã‚’å¼·ã推奨ã—ã¾ã™ã€‚``ansible-core``ã®ä¿å®ˆã¯ã€3リリース分継続ã•ã‚Œã¾ã™ã€‚ãã®ãŸã‚ã€æœ€æ–°ã®ãƒªãƒªãƒ¼ã‚¹ã§ã¯ã€åˆå›žãƒªãƒªãƒ¼ã‚¹æ™‚ã«ã‚»ã‚ュリティーã¨ä¸€èˆ¬çš„ãªãƒã‚°ä¿®æ£ãŒã€æ¬¡ã®``ansible-core``ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹ã¨ã€ã‚»ã‚ュリティーã¨é‡å¤§ãªãƒã‚°ä¿®æ£ãŒã€ãã®æ¬¡ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹ã¨ã€ã‚»ã‚ュリティー修æ£**ã®ã¿**ãŒæä¾›ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:111 +#: ../../rst/reference_appendices/release_and_maintenance.rst:113 msgid "You can refer to the :ref:`core_porting_guides` for tips on updating your playbooks to run on newer versions of ``ansible-core``." msgstr "Playbook ã‚’æ›´æ–°ã—ã¦``ansible-core`` ã®æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§å®Ÿè¡Œã™ã‚‹ã¨ãã®ãƒ’ントã¯ã€ã€Œ:ref:`core_porting_guides`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:113 +#: ../../rst/reference_appendices/release_and_maintenance.rst:115 msgid "You can install ``ansible-core`` with ``pip``. See :ref:`intro_installation_guide` for details." msgstr "``pip`` 㧠``ansible-core`` をインストールã§ãã¾ã™ã€‚詳細ã¯ã€ã€Œ:ref:`intro_installation_guide`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:118 -msgid "``ansible-core`` changelogs" -msgstr "``ansible-core`` 変更ãƒã‚° (Changelog)" +#: ../../rst/reference_appendices/release_and_maintenance.rst:121 +msgid "``ansible-core`` support matrix" +msgstr "``ansible-core`` サãƒãƒ¼ãƒˆãƒžãƒˆãƒªãƒƒã‚¯ã‚¹" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:123 +msgid "This table links to the changelogs for each major ``ansible-core`` release. These changelogs contain the dates and significant changes in each minor release. Dates listed indicate the start date of the maintenance cycle." +msgstr "以下ã®è¡¨ã«ã¯ã€``ansible-core`` ã®å„メジャーリリースã®å¤‰æ›´ãƒã‚°ã¸ã®ãƒªãƒ³ã‚¯ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ã‚ˆã†ãªå¤‰æ›´ãƒã‚°ã«ã¯ã€å„マイナーリリースã®æ—¥ä»˜ã‚„ã€å¤§ããªå¤‰æ›´ãŒå«ã¾ã‚Œã¾ã™ã€‚記載ã®æ—¥ä»˜ã¯ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚µã‚¤ã‚¯ãƒ«ã®é–‹å§‹æ—¥ã‚’指ã—ã¾ã™ã€‚" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:129 +msgid "Version" +msgstr "ãƒãƒ¼ã‚¸ãƒ§ãƒ³" -#: ../../rst/reference_appendices/release_and_maintenance.rst:120 -msgid "This table links to the changelogs for each major ``ansible-core`` release. These changelogs contain the dates and significant changes in each minor release." -msgstr "以下ã®è¡¨ã«ã¯ã€``ansible-core`` ã®å„メジャーリリースã®å¤‰æ›´ãƒã‚°ã¸ã®ãƒªãƒ³ã‚¯ãŒå«ã¾ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ã‚ˆã†ãªå¤‰æ›´ãƒã‚°ã«ã¯ã€å„マイナーリリースã®æ—¥ä»˜ã‚„ã€å¤§ããªå¤‰æ›´ãŒå«ã¾ã‚Œã¾ã™ã€‚" +#: ../../rst/reference_appendices/release_and_maintenance.rst:130 +msgid "Support" +msgstr "サãƒãƒ¼ãƒˆ" -#: ../../rst/reference_appendices/release_and_maintenance.rst:125 -msgid "``ansible-core``/``ansible-base``" -msgstr "``ansible-core``/``ansible-base``" +#: ../../rst/reference_appendices/release_and_maintenance.rst:131 +msgid "End Of Life" +msgstr "ライフサイクル終了日" -#: ../../rst/reference_appendices/release_and_maintenance.rst:125 -msgid "Expected end of life" -msgstr "想定ã®ãƒ©ã‚¤ãƒ•ã‚µã‚¤ã‚¯ãƒ«çµ‚了日" +#: ../../rst/reference_appendices/release_and_maintenance.rst:132 +msgid "Controller Python" +msgstr "Controller Python" -#: ../../rst/reference_appendices/release_and_maintenance.rst:126 -msgid "Release" -msgstr "Release" +#: ../../rst/reference_appendices/release_and_maintenance.rst:133 +msgid "Target Python / PowerShell" +msgstr "Target Python / PowerShell" -#: ../../rst/reference_appendices/release_and_maintenance.rst:128 -msgid "devel" -msgstr "devel" +#: ../../rst/reference_appendices/release_and_maintenance.rst:134 +msgid "`2.15`_" +msgstr "`2.15`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:128 -msgid "In development (ansible-core 2.14 unreleased, trunk)" -msgstr "é–‹ç™ºä¸ (未リリース㮠ansible-core 2.14 (trunk))" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 22 May 2023" +msgstr "一般æä¾›: 2023 å¹´ 5 月 22 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:128 -msgid "TBD" -msgstr "TBD" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 06 Nov 2023" +msgstr "クリティカル: 2023 å¹´ 11 月 6 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:129 -msgid "`2.13 ansible-core Changelogs`_" -msgstr "`2.10 ansible-base Release Notes`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 20 May 2024" +msgstr "ã‚»ã‚ュリティー: 2024 å¹´ 5 月 20 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:129 -msgid "Maintained (security **and** general bug fixes)" -msgstr "メンテナンス対象 (ã‚»ã‚ュリティー **ãŠã‚ˆã³** 一般的ãªãƒã‚°ã®ä¿®æ£)" +#: ../../rst/reference_appendices/release_and_maintenance.rst:138 +msgid "Nov 2024" +msgstr "2024 å¹´ 11 月" -#: ../../rst/reference_appendices/release_and_maintenance.rst:129 -msgid "Nov 2023" -msgstr "2023 å¹´ 11 月" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.9 - 3.11" +msgstr "Python 3.9 - 3.11" -#: ../../rst/reference_appendices/release_and_maintenance.rst:130 -msgid "`2.12 ansible-core Changelogs`_" -msgstr "`2.10 ansible-base Release Notes`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 2.7" +msgstr "Python 2.7" -#: ../../rst/reference_appendices/release_and_maintenance.rst:130 -msgid "Maintained (security **and** critical bug fixes)" -msgstr "メンテナンス対象 (ã‚»ã‚ュリティー **ãŠã‚ˆã³** é‡å¤§ãªãƒã‚°ã®ä¿®æ£)" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.5 - 3.11" +msgstr "Python 3.5 - 3.11" -#: ../../rst/reference_appendices/release_and_maintenance.rst:130 -msgid "May 2023" -msgstr "2023 å¹´ 5 月" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "PowerShell 3 - 5.1" +msgstr "PowerShell 3 - 5.1" -#: ../../rst/reference_appendices/release_and_maintenance.rst:131 -msgid "`2.11 ansible-core Changelogs`_" -msgstr "`2.10 ansible-base Release Notes`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst:143 +msgid "`2.14`_" +msgstr "`2.14`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:131 -msgid "Maintained (security bug fixes only)" -msgstr "メンテナンス対象 (ã‚»ã‚ュリティーãƒã‚°ä¿®æ£ã®ã¿)" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 07 Nov 2022" +msgstr "一般æä¾›: 2022 å¹´ 11 月 7 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:131 -msgid "Nov 2022" -msgstr "2022 å¹´ 11 月" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 22 May 2023" +msgstr "クリティカル: 2023 å¹´ 5 月 22 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:132 -msgid "`2.10 ansible-base Changelogs`_" -msgstr "`2.10 ansible-base Release Notes`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 06 Nov 2023" +msgstr "ã‚»ã‚ュリティー: 2023 å¹´ 11 月 6 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:132 -#: ../../rst/reference_appendices/release_and_maintenance.rst:133 -#: ../../rst/reference_appendices/release_and_maintenance.rst:134 -#: ../../rst/reference_appendices/release_and_maintenance.rst:135 -#: ../../rst/reference_appendices/release_and_maintenance.rst:136 -#: ../../rst/reference_appendices/release_and_maintenance.rst:137 -#: ../../rst/reference_appendices/release_and_maintenance.rst:138 -msgid "EOL" -msgstr "EOL" +#: ../../rst/reference_appendices/release_and_maintenance.rst:147 +msgid "20 May 2024" +msgstr "2024 å¹´ 5 月 20 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:133 -msgid "`2.9 Changelogs`_" -msgstr "`2.9 Changelogs`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst:152 +msgid "`2.13`_" +msgstr "`2.13`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:134 -msgid "`2.8 Changelogs`_" -msgstr "`2.8 Changelogs`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 23 May 2022" +msgstr "一般æä¾›: 2022 å¹´ 5 月 23 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:135 -msgid "`2.7 Changelogs`_" -msgstr "`2.7 Changelogs`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 07 Nov 2022" +msgstr "クリティカル: 2022 å¹´ 11 月 7 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:136 -msgid "`2.6 Changelogs`_" -msgstr "`2.6 Changelogs`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 22 May 2023" +msgstr "ã‚»ã‚ュリティー: 2023 å¹´ 5 月 22 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:137 -msgid "`2.5 Changelogs`_" -msgstr "`2.5 Changelogs`_" +#: ../../rst/reference_appendices/release_and_maintenance.rst:156 +msgid "06 Nov 2023" +msgstr "2023 å¹´ 11 月 6 æ—¥" -#: ../../rst/reference_appendices/release_and_maintenance.rst:138 -msgid "<2.5" -msgstr "2.5 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³" +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.8 - 3.10" +msgstr "Python 3.8 - 3.10" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.5 - 3.10" +msgstr "Python 3.5 - 3.10" #: ../../rst/reference_appendices/release_and_maintenance.rst:161 +msgid "`2.12`_" +msgstr "`2.12`_" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 08 Nov 2021" +msgstr "一般æä¾›: 2021 å¹´ 11 月 8 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 23 May 2022" +msgstr "クリティカル: 2022 å¹´ 5 月 23 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 07 Nov 2022" +msgstr "ã‚»ã‚ュリティー: 2022 å¹´ 11 月 7 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:165 +msgid "22 May 2023" +msgstr "2023 å¹´ 5 月 22 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 2.6" +msgstr "Python 2.6" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:170 +msgid "`2.11`_" +msgstr "`2.11`_" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 26 Apr 2021" +msgstr "一般æä¾›: 2021 å¹´ 4 月 26 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 08 Nov 2021" +msgstr "クリティカル: 2021 å¹´ 11 月 8 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 23 May 2022" +msgstr "ã‚»ã‚ュリティー: 2022 å¹´ 5 月 23 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "**EOL**" +msgstr "**EOL**" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "07 Nov 2022" +msgstr "2023 å¹´ 11 月 7 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.5 - 3.9" +msgstr "Python 3.5 - 3.9" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 2.6 - 2.7" +msgstr "Python 2.6 - 2.7" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:181 +msgid "`2.10`_" +msgstr "`2.10`_" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 13 Aug 2020" +msgstr "一般æä¾›: 2020 å¹´ 8 月 13 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 26 Apr 2021" +msgstr "クリティカル: 2021 å¹´ 4 月 26 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 08 Nov 2021" +msgstr "ã‚»ã‚ュリティー: 2021 å¹´ 11 月 8 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "23 May 2022" +msgstr "2022 å¹´ 5 月 23 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:192 +msgid "`2.9`_" +msgstr "`2.9`_" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "GA: 31 Oct 2019" +msgstr "一般æä¾›: 2019 å¹´ 10 月 31 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Critical: 13 Aug 2020" +msgstr "クリティカル: 2020 å¹´ 8 月 13 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Security: 26 Apr 2021" +msgstr "ã‚»ã‚ュリティー: 2021 å¹´ 4 月 26 æ—¥" + +#: ../../rst/reference_appendices/release_and_maintenance.rst +msgid "Python 3.5 - 3.8" +msgstr "Python 3.5 - 3.8" + +#: ../../rst/reference_appendices/release_and_maintenance.rst:295 msgid "Preparing for a new release" msgstr "æ–°ã—ã„リリースã®æº–å‚™" -#: ../../rst/reference_appendices/release_and_maintenance.rst:166 +#: ../../rst/reference_appendices/release_and_maintenance.rst:300 msgid "Feature freezes" msgstr "機能フリーズ" -#: ../../rst/reference_appendices/release_and_maintenance.rst:168 +#: ../../rst/reference_appendices/release_and_maintenance.rst:302 msgid "During final preparations for a new release, core developers and maintainers focus on improving the release candidate, not on adding or reviewing new features. We may impose a feature freeze." msgstr "æ–°ã—ã„リリースã®æœ€çµ‚準備ä¸ã€ã‚³ã‚¢é–‹ç™ºè€…ã¨ãƒ¡ãƒ³ãƒ†ãƒŠã¯ã€æ–°æ©Ÿèƒ½ã®è¿½åŠ やレビューã§ã¯ãªãã€ãƒªãƒªãƒ¼ã‚¹å€™è£œã®æ”¹å–„ã«é›†ä¸ã—ã¾ã™ã€‚機能フリーズを指示ã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:170 +#: ../../rst/reference_appendices/release_and_maintenance.rst:304 msgid "A feature freeze means that we delay new features and fixes unrelated to the pending release so we can create the new release as soon as possible." msgstr "機能フリーズã¨ã¯ã€ä¿ç•™ä¸ã®ãƒªãƒªãƒ¼ã‚¹ã«é–¢é€£ã®ãªã„新機能や修æ£ã‚’é…らã›ã¦ã€æ–°ã—ã„リリースをã§ãã‚‹ã ã‘æ—©ã作æˆã§ãるよã†ã«ã™ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:175 +#: ../../rst/reference_appendices/release_and_maintenance.rst:309 msgid "Release candidates" msgstr "リリースã®å€™è£œ (Release Candidate)" -#: ../../rst/reference_appendices/release_and_maintenance.rst:177 +#: ../../rst/reference_appendices/release_and_maintenance.rst:311 msgid "We create at least one release candidate before each new major release of Ansible or ``ansible-core``. Release candidates allow the Ansible community to try out new features, test existing playbooks on the release candidate, and report bugs or issues they find." msgstr "Ansibleã¾ãŸã¯``ansible-core``ã®æ–°ã—ã„メジャーリリースã®å‰ã«æ¯Žå›žã€å°‘ãªãã¨ã‚‚1ã¤ã®ãƒªãƒªãƒ¼ã‚¹å€™è£œã‚’作æˆã—ã¾ã™ã€‚リリース候補を使用ã™ã‚‹ã“ã¨ã§ã€Ansibleコミュニティã¯æ–°æ©Ÿèƒ½ã‚’試ã—ãŸã‚Šã€ãƒªãƒªãƒ¼ã‚¹å€™è£œã§æ—¢å˜ã®Playbookをテストã—ãŸã‚Šã€è¦‹ã¤ã‹ã£ãŸãƒã‚°ã‚„å•é¡Œã‚’å ±å‘Šã—ãŸã‚Šã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:179 +#: ../../rst/reference_appendices/release_and_maintenance.rst:313 msgid "Ansible and ``ansible-core`` tag the first release candidate (RC1) which is usually scheduled to last five business days. If no major bugs or issues are identified during this period, the release candidate becomes the final release." msgstr "Ansible ãŠã‚ˆã³ ``ansible-core`` ã¯ã€æœ€åˆã®ãƒªãƒªãƒ¼ã‚¹å€™è£œã®ã‚¿ã‚° (RC1) ãŒä»˜ã‘られã¾ã™ã€‚通常ã€RC1 ã¯æœ€å¾Œã®5å–¶æ¥æ—¥ã«ã‚¹ã‚±ã‚¸ãƒ¥ãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚ã“ã®æœŸé–“ã«ãƒ¡ã‚¸ãƒ£ãƒ¼ãªãƒã‚°ã‚„å•é¡ŒãŒç‰¹å®šã•ã‚Œãªã„å ´åˆã«ã¯ã€ãƒªãƒªãƒ¼ã‚¹å€™è£œãŒæœ€çµ‚リリースã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:181 +#: ../../rst/reference_appendices/release_and_maintenance.rst:315 msgid "If there are major problems with the first candidate, the team and the community fix them and tag a second release candidate (RC2). This second candidate lasts for a shorter duration than the first. If no problems have been reported for an RC2 after two business days, the second release candidate becomes the final release." msgstr "最åˆã®å€™è£œã«å¤§ããªå•é¡ŒãŒã‚ã‚‹å ´åˆã¯ã€ãƒãƒ¼ãƒ ãŠã‚ˆã³ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãŒä¿®æ£ã‚’åŠ ãˆã¦ã€2 番目ã®å€™è£œã®ã‚¿ã‚° (RC2) ãŒä»˜ã‘られã¾ã™ã€‚2 番目ã®å€™è£œã¯ã€1 番目よりも期間ã¯çŸããªã‚Šã¾ã™ã€‚2 å–¶æ¥æ—¥ãŒçµŒéŽã—ã¦å•é¡ŒãŒå ±å‘Šã•ã‚Œãªã„å ´åˆã¯ã€ã“ã®2番目ã®ãƒªãƒªãƒ¼ã‚¹å€™è£œãŒæœ€çµ‚çš„ãªãƒªãƒªãƒ¼ã‚¹ã¨ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:183 +#: ../../rst/reference_appendices/release_and_maintenance.rst:317 msgid "If there are major problems in RC2, the cycle begins again with another release candidate and repeats until the maintainers agree that all major problems have been fixed." msgstr "RC2ã«é‡å¤§ãªå•é¡ŒãŒã‚ã‚‹å ´åˆã«ã¯ã€ã‚µã‚¤ã‚¯ãƒ«ã¯åˆ¥ã®ãƒªãƒªãƒ¼ã‚¹å€™è£œã‹ã‚‰å†é–‹ã•ã‚Œã€ã™ã¹ã¦ã®ä¸»è¦ãªå•é¡ŒãŒä¿®æ£ã•ã‚ŒãŸã“ã¨ã«ãƒ¡ãƒ³ãƒ†ãƒŠãŒåŒæ„ã™ã‚‹ã¾ã§ç¹°ã‚Šè¿”ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:189 +#: ../../rst/reference_appendices/release_and_maintenance.rst:323 msgid "Development and maintenance workflows" msgstr "開発ã¨ä¿å®ˆã®ãƒ¯ãƒ¼ã‚¯ãƒ•ãƒãƒ¼" -#: ../../rst/reference_appendices/release_and_maintenance.rst:191 +#: ../../rst/reference_appendices/release_and_maintenance.rst:325 msgid "In between releases, the Ansible community develops new features, maintains existing functionality, and fixes bugs in ``ansible-core`` and in the collections included in the Ansible community package." msgstr "次ã®ãƒªãƒªãƒ¼ã‚¹ã¾ã§ã®é–“ã«ã€Ansibleコミュニティã¯æ–°ã—ã„機能を開発ã—ã¦æ—¢å˜ã®æ©Ÿèƒ½ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã‚’è¡Œã„ã€``ansible-core`` ã‚„ Ansible コミュニティーパッケージã«å«ã¾ã‚Œã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒã‚°ã‚’ä¿®æ£ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:194 +#: ../../rst/reference_appendices/release_and_maintenance.rst:328 msgid "Ansible community package workflow" msgstr "Ansible コミュニティパッケージã®ãƒ¯ãƒ¼ã‚¯ãƒ•ãƒãƒ¼" -#: ../../rst/reference_appendices/release_and_maintenance.rst:196 +#: ../../rst/reference_appendices/release_and_maintenance.rst:330 msgid "The Ansible community develops and maintains the features and functionality included in the Ansible community package in Collections repositories, with a workflow that looks like this:" msgstr "Ansibleコミュニティã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒªãƒã‚¸ãƒˆãƒªã®Ansibleコミュニティパッケージã«å«ã¾ã‚Œã‚‹æ©Ÿèƒ½ã‚’開発ãŠã‚ˆã³ä¿å®ˆã—ã¾ã™ã€‚ワークフãƒãƒ¼ã¯æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:198 +#: ../../rst/reference_appendices/release_and_maintenance.rst:332 msgid "Developers add new features and bug fixes to the individual Collections, following each Collection's rules on contributing." msgstr "開発者ã¯ã€è²¢çŒ®ã«é–¢ã™ã‚‹å„コレクションã®ãƒ«ãƒ¼ãƒ«ã«å¾“ã£ã¦ã€å€‹ã€…ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«æ–°æ©Ÿèƒ½ã¨ãƒã‚°ä¿®æ£ã‚’è¿½åŠ ã™ã‚‹ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:199 -#: ../../rst/reference_appendices/release_and_maintenance.rst:213 +#: ../../rst/reference_appendices/release_and_maintenance.rst:333 +#: ../../rst/reference_appendices/release_and_maintenance.rst:347 msgid "Each new feature and each bug fix includes a changelog fragment describing the work." msgstr "å„新機能ã¨å„ãƒã‚°ä¿®æ£ã«ã¯ã€ä½œæ¥ã‚’説明ã™ã‚‹å¤‰æ›´ãƒã‚°ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆãŒå«ã¾ã‚Œã¦ã„る。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:200 +#: ../../rst/reference_appendices/release_and_maintenance.rst:334 msgid "Release engineers create a minor release for the current version every three weeks to ensure that the latest bug fixes are available to users." msgstr "リリースエンジニアã¯ã€æœ€æ–°ã®ãƒã‚°ä¿®æ£ã‚’ユーザーãŒåˆ©ç”¨ã§ãるよã†ã«ã€ç¾åœ¨ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã‚’3週間ã”ã¨ã«ä½œæˆã™ã‚‹ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:201 +#: ../../rst/reference_appendices/release_and_maintenance.rst:335 msgid "At the end of the development period, the release engineers announce which Collections, and which major version of each included Collection, will be included in the next release of the Ansible community package. New Collections and new major versions may not be added after this, and the work of creating a new release begins." msgstr "開発期間ã®çµ‚ã‚ã‚Šã«ã€ãƒªãƒªãƒ¼ã‚¹ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã¯ã€Ansibleコミュニティパッケージã®æ¬¡ã®ãƒªãƒªãƒ¼ã‚¹ã«å«ã¾ã‚Œã‚‹ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã¨ã€è¿½åŠ 済ã¿ã®å„コレクションã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’発表ã—ã¾ã™ã€‚ã“れ以é™ã¯ã€ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãŠã‚ˆã³ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯æ–°ãŸã«è¿½åŠ ã§ããšã€æ–°ã—ã„リリースã®ä½œæˆæº–å‚™ãŒé–‹å§‹ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:203 +#: ../../rst/reference_appendices/release_and_maintenance.rst:337 msgid "We generally do not provide fixes for unmaintained releases of the Ansible community package, however, there can sometimes be exceptions for critical issues." msgstr "通常ã€Ansible コミュニティーパッケージã§ä¿å®ˆã•ã‚Œã¦ã„ãªã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«å¯¾ã™ã‚‹ä¿®æ£ã¯æä¾›ã—ã¦ã„ã¾ã›ã‚“ãŒã€é‡å¤§ãªå•é¡Œã«é–¢ã—ã¦ã¯ä¾‹å¤–ã§å¯¾å¿œã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:205 +#: ../../rst/reference_appendices/release_and_maintenance.rst:339 msgid "Some Collections are maintained by the Ansible team, some by Partner organizations, and some by community teams. For more information on adding features or fixing bugs in Ansible-maintained Collections, see :ref:`contributing_maintained_collections`." msgstr "Ansibleãƒãƒ¼ãƒ ã€ãƒ‘ートナー組織ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒãƒ¼ãƒ ãŒã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã‚’ãã‚Œãžã‚Œéƒ¨åˆ†çš„ã«ç®¡ç†ã—ã¦ã„ã¾ã™ã€‚ Ansibleã§ç®¡ç†ã•ã‚Œã¦ã„るコレクションã®æ©Ÿèƒ½ã®è¿½åŠ ã‚„ãƒã‚°ã®ä¿®æ£ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€:ref:`contributing_maintained_collections` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:208 +#: ../../rst/reference_appendices/release_and_maintenance.rst:342 msgid "ansible-core workflow" msgstr "ansible-core ワークフãƒãƒ¼" -#: ../../rst/reference_appendices/release_and_maintenance.rst:210 +#: ../../rst/reference_appendices/release_and_maintenance.rst:344 msgid "The Ansible community develops and maintains ``ansible-core`` on GitHub_, with a workflow that looks like this:" msgstr "Ansibleコミュニティã¯ã€GitHub_ã®``ansible-core``ã§é–‹ç™ºã¨ç¶æŒã‚’è¡Œã£ã¦ãŠã‚Šã€æ¬¡ã®ã‚ˆã†ãªãƒ¯ãƒ¼ã‚¯ãƒ•ãƒãƒ¼ã‚’使用ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:212 +#: ../../rst/reference_appendices/release_and_maintenance.rst:346 msgid "Developers add new features and bug fixes to the ``devel`` branch." msgstr "開発者ã¯ã€``devel``ブランãƒã«æ–°æ©Ÿèƒ½ã¨ãƒã‚°ä¿®æ£ã‚’è¿½åŠ ã™ã‚‹ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:214 +#: ../../rst/reference_appendices/release_and_maintenance.rst:348 msgid "The development team backports bug fixes to one, two, or three stable branches, depending on the severity of the bug. They do not backport new features." msgstr "開発ãƒãƒ¼ãƒ ã¯ã€ãƒã‚°ã®é‡å¤§åº¦ã«å¿œã˜ã¦ã€ãƒã‚°ä¿®æ£ã‚’1ã¤ã€2ã¤ã€ã¾ãŸã¯3ã¤ã®å®‰å®šã—ãŸãƒ–ランãƒã«ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã—ã€æ–°æ©Ÿèƒ½ã®ãƒãƒƒã‚¯ãƒãƒ¼ãƒˆã¯è¡Œã‚ãªã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:215 +#: ../../rst/reference_appendices/release_and_maintenance.rst:349 msgid "Release engineers create a minor release for each maintained version every three weeks to ensure that the latest bug fixes are available to users." msgstr "リリースエンジニアã¯ã€æœ€æ–°ã®ãƒã‚°ä¿®æ£ã‚’ユーザーãŒåˆ©ç”¨ã§ãるよã†ã«ã€å„ä¿å®ˆãƒãƒ¼ã‚¸ãƒ§ãƒ³ã®ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã‚’3週間ã”ã¨ã«ä½œæˆã™ã‚‹ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:216 +#: ../../rst/reference_appendices/release_and_maintenance.rst:350 msgid "At the end of the development period, the release engineers impose a feature freeze and the work of creating a new release begins." msgstr "開発期間ã®çµ‚ã‚ã‚Šã«ã€ãƒªãƒªãƒ¼ã‚¹ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã¯æ©Ÿèƒ½ã‚’フリーズã—ã€æ–°ã—ã„リリースã®æº–備を開始ã™ã‚‹ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:218 +#: ../../rst/reference_appendices/release_and_maintenance.rst:352 msgid "We generally do not provide fixes for unmaintained releases of ``ansible-core``, however, there can sometimes be exceptions for critical issues." msgstr "通常ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã•ã‚Œã¦ã„ãªã„``ansible-core``リリースã«å¯¾ã™ã‚‹ä¿®æ£ã¯æä¾›ã—ã¦ã„ã¾ã›ã‚“ãŒã€é‡å¤§ãªå•é¡Œã«é–¢ã—ã¦ã¯ä¾‹å¤–ã§å¯¾å¿œã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:220 +#: ../../rst/reference_appendices/release_and_maintenance.rst:354 msgid "For more information about adding features or fixing bugs in ``ansible-core`` see :ref:`community_development_process`." msgstr "``ansible-core`` ã®æ©Ÿèƒ½ã®è¿½åŠ ã¾ãŸã¯ãƒã‚°ã®ä¿®æ£ã®è©³ç´°ã«ã¤ã„ã¦ã¯ã€:ref:`community_development_process` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:227 +#: ../../rst/reference_appendices/release_and_maintenance.rst:361 msgid "Generating changelogs" msgstr "変更ãƒã‚°ã®ç”Ÿæˆ" -#: ../../rst/reference_appendices/release_and_maintenance.rst:229 +#: ../../rst/reference_appendices/release_and_maintenance.rst:363 msgid "We generate changelogs based on fragments. When creating new features for existing modules and plugins or fixing bugs, create a changelog fragment describing the change. A changelog entry is not needed for new modules or plugins. Details for those items will be generated from the module documentation." msgstr "変更ãƒã‚°ã¯ã€ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã«åŸºã¥ã„ã¦ç”Ÿæˆã•ã‚Œã¾ã™ã€‚æ—¢å˜ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„プラグインã®æ–°ã—ã„機能を作æˆã—ãŸã‚Šã€ãƒã‚°ã‚’ä¿®æ£ã—ãŸã‚Šã™ã‚‹ã¨ãã¯ã€å¤‰æ›´ç‚¹ã‚’記述ã—ãŸå¤‰æ›´ãƒã‚°ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’作æˆã—ã¾ã™ã€‚変更ãƒã‚°ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã¯ã€æ–°ã—ã„モジュールやプラグインã«ã¯å¿…è¦ã‚ã‚Šã¾ã›ã‚“。ãれらã®é …ç›®ã®è©³ç´°ã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ãƒ‰ã‚ュメントã‹ã‚‰ç”Ÿæˆã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:231 +#: ../../rst/reference_appendices/release_and_maintenance.rst:365 msgid "To add changelog fragments to Collections in the Ansible community package, we recommend the `antsibull-changelog utility <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelogs.rst>`_." msgstr "Ansibleコミュニティパッケージã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã«å¤‰æ›´ãƒã‚°ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã™ã‚‹ã«ã¯ã€`antsibull-changelog utility <https://github.com/ansible-community/antsibull-changelog/blob/main/docs/changelogs.rst>`_を推奨ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:233 +#: ../../rst/reference_appendices/release_and_maintenance.rst:367 msgid "To add changelog fragments for new features and bug fixes in ``ansible-core``, see the :ref:`changelog examples and instructions<changelogs_how_to>` in the Community Guide." msgstr "``ansible-core``ã«æ–°æ©Ÿèƒ½ã¨ãƒã‚°ä¿®æ£ã®å¤‰æ›´ãƒã‚°ãƒ•ãƒ©ã‚°ãƒ¡ãƒ³ãƒˆã‚’è¿½åŠ ã™ã‚‹ã«ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ã‚¬ã‚¤ãƒ‰ã®:ref:`changelog examples and instructions<changelogs_how_to>`ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:236 +#: ../../rst/reference_appendices/release_and_maintenance.rst:370 msgid "Deprecation cycles" msgstr "éžæŽ¨å¥¨ã‚µã‚¤ã‚¯ãƒ«" -#: ../../rst/reference_appendices/release_and_maintenance.rst:238 +#: ../../rst/reference_appendices/release_and_maintenance.rst:372 msgid "Sometimes we remove a feature, normally in favor of a reimplementation that we hope does a better job. To do this we have a deprecation cycle. First we mark a feature as 'deprecated'. This is normally accompanied with warnings to the user as to why we deprecated it, what alternatives they should switch to and when (which version) we are scheduled to remove the feature permanently." msgstr "通常ã€å†å®Ÿè£…ã—ã¦ã‚¸ãƒ§ãƒ–実行ã®æ”¹å–„を希望ã™ã‚‹å ´åˆãªã©ã€æ©Ÿèƒ½ã‚’削除ã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ã“れを行ã†ãŸã‚ã«ã€éžæŽ¨å¥¨ã®ã‚µã‚¤ã‚¯ãƒ«ãŒã‚ã‚Šã¾ã™ã€‚ã¾ãšã€æ©Ÿèƒ½ã‚’「éžæŽ¨å¥¨ã€ã¨ã—ã¦ãƒžãƒ¼ã‚¯ã—ã¾ã™ã€‚ã“ã‚Œã«ã¯é€šå¸¸ã€éžæŽ¨å¥¨ã«ãªã£ãŸç†ç”±ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒåˆ‡ã‚Šæ›¿ãˆã‚‹å¿…è¦ã®ã‚る代替手段ã€ãŠã‚ˆã³æ©Ÿèƒ½ã‚’完全ã«å‰Šé™¤ã™ã‚‹äºˆå®šã®æ™‚期 (ãƒãƒ¼ã‚¸ãƒ§ãƒ³) ã«é–¢ã™ã‚‹è¦å‘ŠãŒä¼´ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:241 +#: ../../rst/reference_appendices/release_and_maintenance.rst:375 msgid "Ansible community package deprecation cycle" msgstr "Ansibleコミュニティパッケージã®éžæŽ¨å¥¨ã‚µã‚¤ã‚¯ãƒ«" -#: ../../rst/reference_appendices/release_and_maintenance.rst:243 +#: ../../rst/reference_appendices/release_and_maintenance.rst:377 msgid "Since Ansible is a package of individual collections, the deprecation cycle depends on the collection maintainers. We recommend the collection maintainers deprecate a feature in one Ansible major version and do not remove that feature for one year, or at least until the next major Ansible version. For example, deprecate the feature in 3.1.0 and do not remove the feature until 5.0.0 or 4.0.0 at the earliest. Collections should use semantic versioning, such that the major collection version cannot be changed within an Ansible major version. Therefore, the removal should not happen before the next major Ansible community package release. This is up to each collection maintainer and cannot be guaranteed." msgstr "Ansible ã¯å€‹åˆ¥ã®ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ‘ッケージã§ã‚ã‚‹ãŸã‚ã€éžæŽ¨å¥¨ã®ã‚µã‚¤ã‚¯ãƒ«ã¯ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚コレクションメンテナー㯠1 ã¤ã® Ansible メジャーãƒãƒ¼ã‚¸ãƒ§ãƒ³ã§ã“ã®æ©Ÿèƒ½ã‚’éžæŽ¨å¥¨ã«ã—ã€1 å¹´é–“ã§ãã®æ©Ÿèƒ½ã‚’削除ã™ã‚‹ã‹ã€å°‘ãªãã¨ã‚‚次㮠Ansible ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¾ã§ã«å‰Šé™¤ã—ãªã„ã“ã¨ã‚’推奨ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€3.1.0 ã§ã“ã®æ©Ÿèƒ½ã‚’éžæŽ¨å¥¨ã«ã—ãŸå ´åˆã¯ã€æœ€ä½Žã§ã‚‚ 5.0.0 ã¾ãŸã¯ 4.0.0 ã¾ã§ã®æ©Ÿèƒ½ã‚’削除ã—ãªã„ã§ãã ã•ã„。コレクションã¯ã‚»ãƒžãƒ³ãƒ†ã‚£ãƒƒã‚¯ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã‚’使用ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã—ãŸãŒã£ã¦ã€ãƒ¡ã‚¸ãƒ£ãƒ¼ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ã€Ansible メジャーãƒãƒ¼ã‚¸ãƒ§ãƒ³å†…ã§å¤‰æ›´ã§ãã¾ã›ã‚“。ã—ãŸãŒã£ã¦ã€æ¬¡ã®ãƒ¡ã‚¸ãƒ£ãƒ¼ãƒªãƒªãƒ¼ã‚¹ã® Ansible コミュニティーパッケージリリースã®å‰ã«å‰Šé™¤ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。ã“ã‚Œã¯ã€å„コレクションã®ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼ã®å½¹å‰²ã§ã‚ã‚Šã€ä¿è¨¼ã•ã‚Œã¦ã„ã‚‹ã‚‚ã®ã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/reference_appendices/release_and_maintenance.rst:246 +#: ../../rst/reference_appendices/release_and_maintenance.rst:380 msgid "ansible-core deprecation cycle" msgstr "ansible-core éžæŽ¨å¥¨ã‚µã‚¤ã‚¯ãƒ«" -#: ../../rst/reference_appendices/release_and_maintenance.rst:248 +#: ../../rst/reference_appendices/release_and_maintenance.rst:382 msgid "The deprecation cycle in ``ansible-core`` is normally across 4 feature releases (2.x. where the x marks a feature release). The feature is normally removed in the 4th release after we announce the deprecation. For example, something deprecated in 2.10 will be removed in 2.14. The tracking is tied to the number of releases, not the release numbering itself." msgstr "``ansible-core`` ã®éžæŽ¨å¥¨ã‚µã‚¤ã‚¯ãƒ«ã¯é€šå¸¸ 4 ã¤ã®æ©Ÿèƒ½ãƒªãƒªãƒ¼ã‚¹ (ãŸã¨ãˆã° 2.x. ã® x ã¯æ©Ÿèƒ½ãƒªãƒªãƒ¼ã‚¹ã‚’示ã™) ã«ã¾ãŸãŒã‚‹ãŸã‚ã€æ©Ÿèƒ½ã¯é€šå¸¸ã€éžæŽ¨å¥¨ã‚’発表ã—ã¦ã‹ã‚‰ 4 番目ã®ãƒªãƒªãƒ¼ã‚¹ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚ãŸã¨ãˆã°ã€2.10 ã§éžæŽ¨å¥¨ã«ãªã£ãŸã‚‚ã®ã¯ã€2.14 ã§å‰Šé™¤ã•ã‚Œã¾ã™ã€‚追跡ã¯ã€ãƒªãƒªãƒ¼ã‚¹ç•ªå·ã§ã¯ãªãã€ãƒªãƒªãƒ¼ã‚¹ã®æ•°ã«è‡ªä½“ã«é–¢é€£ä»˜ã‘られã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/release_and_maintenance.rst:252 +#: ../../rst/reference_appendices/release_and_maintenance.rst:386 msgid ":ref:`community_committer_guidelines`" msgstr ":ref:`community_committer_guidelines`" -#: ../../rst/reference_appendices/release_and_maintenance.rst:253 +#: ../../rst/reference_appendices/release_and_maintenance.rst:387 msgid "Guidelines for Ansible core contributors and maintainers" msgstr "Ansible ã§ä¸å¿ƒã¨ãªã‚‹è²¢çŒ®è€…ãŠã‚ˆã³ãƒ¡ãƒ³ãƒ†ãƒŠãƒ¼å‘ã‘ガイドライン" -#: ../../rst/reference_appendices/release_and_maintenance.rst:254 +#: ../../rst/reference_appendices/release_and_maintenance.rst:388 msgid ":ref:`testing_strategies`" msgstr ":ref:`testing_strategies`" -#: ../../rst/reference_appendices/release_and_maintenance.rst:255 +#: ../../rst/reference_appendices/release_and_maintenance.rst:389 msgid "Testing strategies" msgstr "ストラテジーã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/reference_appendices/release_and_maintenance.rst:256 +#: ../../rst/reference_appendices/release_and_maintenance.rst:390 msgid ":ref:`ansible_community_guide`" msgstr ":ref:`ansible_community_guide`" -#: ../../rst/reference_appendices/release_and_maintenance.rst:257 +#: ../../rst/reference_appendices/release_and_maintenance.rst:391 msgid "Community information and contributing" msgstr "ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼æƒ…å ±ãŠã‚ˆã³è²¢çŒ®" -#: ../../rst/reference_appendices/release_and_maintenance.rst:258 +#: ../../rst/reference_appendices/release_and_maintenance.rst:392 msgid "`Development Mailing List <https://groups.google.com/group/ansible-devel>`_" msgstr "`Development Mailing List <https://groups.google.com/group/ansible-devel>`_" -#: ../../rst/reference_appendices/release_and_maintenance.rst:259 +#: ../../rst/reference_appendices/release_and_maintenance.rst:393 msgid "Mailing list for development topics" msgstr "開発トピックã®ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆ" @@ -10302,7 +10428,7 @@ msgid "ansible_loop" msgstr "ansible_loop" #: ../../rst/reference_appendices/special_variables.rst:32 -msgid "A dictionary/map containing extended loop information when enabled via ``loop_control.extended``" +msgid "A dictionary/map containing extended loop information when enabled through ``loop_control.extended``" msgstr "``loop_control.extended`` ã§æœ‰åŠ¹ã«ã—ãŸå ´åˆã« loop ã®æ‹¡å¼µæƒ…å ±ã‚’å«ã‚€ãƒ‡ã‚£ã‚¯ã‚·ãƒ§ãƒŠãƒªãƒ¼/マップ" #: ../../rst/reference_appendices/special_variables.rst:35 @@ -10370,7 +10496,7 @@ msgid "ansible_play_role_names" msgstr "ansible_play_role_names" #: ../../rst/reference_appendices/special_variables.rst:60 -msgid "The names of the roles currently imported into the current play. This list does **not** contain the role names that are implicitly included via dependencies." +msgid "The names of the roles currently imported into the current play. This list does **not** contain the role names that are implicitly included through dependencies." msgstr "ç¾åœ¨ã®ãƒ—レイã«ã‚¤ãƒ³ãƒãƒ¼ãƒˆã•ã‚Œã¦ã„ã‚‹ãƒãƒ¼ãƒ«å。ã“ã®ä¸€è¦§ã«ã¯ã€ä¾å˜é–¢ä¿‚ã§æš—黙的ã«å«ã¾ã‚Œã‚‹ãƒãƒ¼ãƒ«å㯠**å«ã¾ã‚Œã¾ã›ã‚“**。" #: ../../rst/reference_appendices/special_variables.rst:64 @@ -10455,7 +10581,7 @@ msgstr "ç¾åœ¨ã®ãƒ›ã‚¹ãƒˆãŒæ‰€å±žã™ã‚‹ã‚°ãƒ«ãƒ¼ãƒ—ã®ä¸€è¦§" #: ../../rst/reference_appendices/special_variables.rst:95 msgid "groups" -msgstr "groups" +msgstr "グループ" #: ../../rst/reference_appendices/special_variables.rst:95 msgid "A dictionary/map with all the groups in inventory and each group has the list of hosts that belong to it" @@ -10609,7 +10735,7 @@ msgstr "ansible_python_interpreter" msgid "The path to the Python executable Ansible should use on the target host." msgstr "Ansible ãŒã‚¿ãƒ¼ã‚²ãƒƒãƒˆãƒ›ã‚¹ãƒˆã§ä½¿ç”¨ã™ã¹ã Python 実行ファイルã¸ã®ãƒ‘ス" -#: ../../<generated>:1 +#: ../../rst/reference_appendices/special_variables.rst:168 msgid "ansible_user" msgstr "ansible_user" @@ -10658,154 +10784,154 @@ msgid "In the above setup, ``--check`` mode in Ansible can be used as a layer of msgstr "上記ã®è¨å®šã§ã¯ã€Ansible ã® ``--check`` モードã¯ã€ãƒ†ã‚¹ãƒˆã®ãƒ¬ã‚¤ãƒ¤ãƒ¼ã¨ã—ã¦ã‚‚使用ã§ãã¾ã™ã€‚æ—¢å˜ã®ã‚·ã‚¹ãƒ†ãƒ ã«å¯¾ã—ã¦ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã® Playbook を実行ã™ã‚‹å ´åˆã« ``--check`` フラグを `ansible` コマンドã«ä½¿ç”¨ã™ã‚‹ã¨ã€å¤‰æ›´ãŒåŠ ãˆã‚‰ã‚Œã¦ã‚·ã‚¹ãƒ†ãƒ ãŒé©åˆ‡ãªçŠ¶æ…‹ã«ãªã£ã¦ã„る㨠Ansible ãŒåˆ¤æ–ã—ã¦ã„ã‚‹ã‹ã©ã†ã‹ã‚’レãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" #: ../../rst/reference_appendices/test_strategies.rst:49 -msgid "This can let you know up front if there is any need to deploy onto the given system. Ordinarily, scripts and commands don't run in check mode, so if you want certain steps to execute in normal mode even when the ``--check`` flag is used, such as calls to the script module, disable check mode for those tasks::" +msgid "This can let you know up front if there is any need to deploy onto the given system. Ordinarily, scripts and commands don't run in check mode, so if you want certain steps to execute in normal mode even when the ``--check`` flag is used, such as calls to the script module, disable check mode for those tasks:" msgstr "ã“ã®ãƒ¬ãƒãƒ¼ãƒˆã«ã‚ˆã‚Šã€ç‰¹å®šã®ã‚·ã‚¹ãƒ†ãƒ ã«ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆãŒå¿…è¦ã‹ã©ã†ã‹ã‚’事å‰ã«æŠŠæ¡ã§ãã¾ã™ã€‚check モードã§ã¯ã€ä¸€èˆ¬çš„ãªã‚¹ã‚¯ãƒªãƒ—トやコマンドã¯å®Ÿè¡Œã•ã‚Œãªã„ãŸã‚ã€ã‚¹ã‚¯ãƒªãƒ—トモジュールã¸ã®å‘¼ã³å‡ºã—ãªã©ã€``--check`` フラグãŒä½¿ç”¨ã•ã‚Œã¦ã„ã¦ã‚‚通常モードã§ç‰¹å®šã®æ‰‹é †ã‚’実行ã™ã‚‹å ´åˆã¯ã€ã“ã®ã‚ˆã†ãªã‚¿ã‚¹ã‚¯ã®ãƒã‚§ãƒƒã‚¯ãƒ¢ãƒ¼ãƒ‰ã‚’無効ã«ã—ã¦ãã ã•ã„::" -#: ../../rst/reference_appendices/test_strategies.rst:61 +#: ../../rst/reference_appendices/test_strategies.rst:63 msgid "Modules That Are Useful for Testing" msgstr "テストã«ä¾¿åˆ©ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«" -#: ../../rst/reference_appendices/test_strategies.rst:63 -msgid "Certain playbook modules are particularly good for testing. Below is an example that ensures a port is open::" +#: ../../rst/reference_appendices/test_strategies.rst:65 +msgid "Certain playbook modules are particularly good for testing. Below is an example that ensures a port is open:" msgstr "Playbook ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§ã¯ã€ç‰¹ã«ãƒ†ã‚¹ãƒˆã«é©ã—ã¦ã„ã‚‹ã‚‚ã®ã‚‚ã‚ã‚Šã¾ã™ã€‚以下ã®ä¾‹ã¯ã€ãƒãƒ¼ãƒˆãŒé–‹æ”¾ã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:72 -msgid "Here's an example of using the URI module to make sure a web service returns::" +#: ../../rst/reference_appendices/test_strategies.rst:76 +msgid "Here's an example of using the URI module to make sure a web service returns:" msgstr "以下ã®ä¾‹ã¯ã€URI モジュールを使用ã—ã¦ã€Web サービスãŒè¿”ã•ã‚Œã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:83 -msgid "It's easy to push an arbitrary script (in any language) on a remote host and the script will automatically fail if it has a non-zero return code::" +#: ../../rst/reference_appendices/test_strategies.rst:89 +msgid "It's easy to push an arbitrary script (in any language) on a remote host and the script will automatically fail if it has a non-zero return code:" msgstr "リモートホストã§ä»»æ„ã®ã‚¹ã‚¯ãƒªãƒ—ト (言語ã¯å•ã‚ãªã„) ãŒç°¡å˜ã«ãƒ—ッシュã•ã‚Œã‚‹ãŸã‚ã€ã‚¼ãƒä»¥å¤–ã®ãƒªã‚¿ãƒ¼ãƒ³ã‚³ãƒ¼ãƒ‰ãŒæŒ‡å®šã•ã‚Œã¦ã„ã‚‹ã¨ã€ã‚¹ã‚¯ãƒªãƒ—トã¯è‡ªå‹•çš„ã«å¤±æ•—ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:90 +#: ../../rst/reference_appendices/test_strategies.rst:98 msgid "If using roles (you should be, roles are great!), scripts pushed by the script module can live in the 'files/' directory of a role." msgstr "ãƒãƒ¼ãƒ«ã‚’使用ã™ã‚‹å ´åˆ (ãƒãƒ¼ãƒ«ã¯ä¾¿åˆ©ãªã®ã§ä½¿ç”¨ã‚’推奨)ã€ã‚¹ã‚¯ãƒªãƒ—トモジュールãŒãƒ—ッシュã™ã‚‹ã‚¹ã‚¯ãƒªãƒ—トã¯ã€ãƒãƒ¼ãƒ«ã®ã€Œfiles/ã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ã«é…ç½®ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:92 -msgid "And the assert module makes it very easy to validate various kinds of truth::" +#: ../../rst/reference_appendices/test_strategies.rst:100 +msgid "And the assert module makes it very easy to validate various kinds of truth:" msgstr "ã¾ãŸã€ã‚¢ã‚µãƒ¼ãƒˆãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã¨ã€ã•ã¾ã–ã¾ãªçœŸå½ã®æ¤œè¨¼ãŒéžå¸¸ã«ç°¡å˜ã«ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:104 -msgid "Should you feel the need to test for the existence of files that are not declaratively set by your Ansible configuration, the 'stat' module is a great choice::" +#: ../../rst/reference_appendices/test_strategies.rst:114 +msgid "Should you feel the need to test for the existence of files that are not declaratively set by your Ansible configuration, the 'stat' module is a great choice:" msgstr "Ansible è¨å®šã§è¨å®šãŒå®£è¨€ã•ã‚Œã¦ã„ãªã„ファイルã®å˜åœ¨ã‚’テストã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã¯ã€ã€Œstatã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒæœ€é©ã§ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:117 +#: ../../rst/reference_appendices/test_strategies.rst:129 msgid "As mentioned above, there's no need to check things like the return codes of commands. Ansible is checking them automatically. Rather than checking for a user to exist, consider using the user module to make it exist." msgstr "上記ã®ã‚ˆã†ã«ã€ã‚³ãƒžãƒ³ãƒ‰ã®ãƒªã‚¿ãƒ¼ãƒ³ã‚³ãƒ¼ãƒ‰ãªã©ã‚’ãƒã‚§ãƒƒã‚¯ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。Ansible ãŒã“ã®ã‚ˆã†ãªã‚³ãƒ¼ãƒ‰ã‚’自動的ã«ãƒã‚§ãƒƒã‚¯ã—ã¾ã™ã€‚ユーザーã®å˜åœ¨ã‚’ãƒã‚§ãƒƒã‚¯ã™ã‚‹ä»£ã‚ã‚Šã«ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã—ã¦ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’å˜åœ¨ã•ã›ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:120 +#: ../../rst/reference_appendices/test_strategies.rst:132 msgid "Ansible is a fail-fast system, so when there is an error creating that user, it will stop the playbook run. You do not have to check up behind it." msgstr "Ansible ã¯ãƒ•ã‚§ã‚¤ãƒ«ãƒ•ã‚¡ãƒ¼ã‚¹ãƒˆã‚·ã‚¹ãƒ†ãƒ ã§ã‚ã‚‹ãŸã‚ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®ä½œæˆæ™‚ã«ã‚¨ãƒ©ãƒ¼ãŒã‚ã‚‹ã¨ã€Playbook ã®å®Ÿè¡ŒãŒåœæ¢ã—ã¾ã™ã€‚ãƒãƒƒã‚¯ã‚°ãƒ©ã‚¦ãƒ³ãƒ‰ã§è¡Œã‚ã‚Œã¦ã„る内容を確èªã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/reference_appendices/test_strategies.rst:124 +#: ../../rst/reference_appendices/test_strategies.rst:136 msgid "Testing Lifecycle" msgstr "ライフサイクルã®ãƒ†ã‚¹ãƒˆ" -#: ../../rst/reference_appendices/test_strategies.rst:126 +#: ../../rst/reference_appendices/test_strategies.rst:138 msgid "If writing some degree of basic validation of your application into your playbooks, they will run every time you deploy." msgstr "アプリケーションã®åŸºæœ¬æ¤œè¨¼ã‚’ Playbook ã«è¨˜è¿°ã™ã‚‹ã¨ã€ãƒ‡ãƒ—ãƒã‚¤æ™‚ã«å¿…ãšã“ã®æ¤œè¨¼ãŒå®Ÿè¡Œã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:128 +#: ../../rst/reference_appendices/test_strategies.rst:140 msgid "As such, deploying into a local development VM and a staging environment will both validate that things are according to plan ahead of your production deploy." msgstr "ãã®ãŸã‚ã€ãƒãƒ¼ã‚«ãƒ«ã®é–‹ç™ºä»®æƒ³ãƒžã‚·ãƒ³ã‚„ステージ環境ã«ãƒ‡ãƒ—ãƒã‚¤ã™ã‚‹ã¨ã„ãšã‚Œã‚‚ã€å®Ÿç¨¼åƒã§ã®ãƒ‡ãƒ—ãƒã‚¤ã®å‰ã«è¨ˆç”»é€šã‚Šã«ä½œæ¥ãŒé€²ã‚“ã§ã„ã‚‹ã‹ã©ã†ã‹ã‚’検証ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:131 -msgid "Your workflow may be something like this::" +#: ../../rst/reference_appendices/test_strategies.rst:143 +msgid "Your workflow may be something like this:" msgstr "ワークフãƒãƒ¼ã¯ã€æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:138 +#: ../../rst/reference_appendices/test_strategies.rst:152 msgid "Something like an integration test battery should be written by your QA team if you are a production webservice. This would include things like Selenium tests or automated API tests and would usually not be something embedded into your Ansible playbooks." msgstr "実稼åƒã® Web サービスを使用ã™ã‚‹å ´åˆã«ã¯ã€QA ãƒãƒ¼ãƒ ãŒåŒæ§˜ã®çµ±åˆãƒ†ã‚¹ãƒˆãƒãƒƒãƒ†ãƒªãƒ¼ã‚’記述ã™ã‚‹ã‚ˆã†ã«ã—ã¦ãã ã•ã„。ã“ã®ã‚ˆã†ãªãƒ†ã‚¹ãƒˆã«ã¯ Selenium テストや自動化 API テストãªã©ãŒå«ã¾ã‚Œã€é€šå¸¸ã¯ã€Ansible Playbook ã«çµ„ã¿è¾¼ã¾ã‚Œã¦ã„ã‚‹ã‚‚ã®ã§ã¯ã‚ã‚Šã¾ã›ã‚“。" -#: ../../rst/reference_appendices/test_strategies.rst:141 +#: ../../rst/reference_appendices/test_strategies.rst:155 msgid "However, it does make sense to include some basic health checks into your playbooks, and in some cases it may be possible to run a subset of the QA battery against remote nodes. This is what the next section covers." msgstr "ãŸã ã—ã€ã„ãã¤ã‹ã®åŸºæœ¬çš„ãªãƒ˜ãƒ«ã‚¹ãƒã‚§ãƒƒã‚¯ã‚’ Playbook ã«è¿½åŠ ã™ã‚‹ã¨ä¾¿åˆ©ã§ã™ã€‚å ´åˆã«ã‚ˆã£ã¦ã¯ã€ãƒªãƒ¢ãƒ¼ãƒˆãƒŽãƒ¼ãƒ‰ã«å¯¾ã—㦠QA ãƒãƒƒãƒ†ãƒªãƒ¼ã®ã‚µãƒ–セットを実行ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ã“ã®ç‚¹ã«ã¤ã„ã¦ã¯ã€æ¬¡ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:145 +#: ../../rst/reference_appendices/test_strategies.rst:159 msgid "Integrating Testing With Rolling Updates" msgstr "ãƒãƒ¼ãƒªãƒ³ã‚°ã‚¢ãƒƒãƒ—デートã¸ã®ãƒ†ã‚¹ãƒˆã®çµ±åˆ" -#: ../../rst/reference_appendices/test_strategies.rst:147 +#: ../../rst/reference_appendices/test_strategies.rst:161 msgid "If you have read into :ref:`playbooks_delegation` it may quickly become apparent that the rolling update pattern can be extended, and you can use the success or failure of the playbook run to decide whether to add a machine into a load balancer or not." msgstr ":ref:`playbooks_delegation` ã‚’èªã‚€ã¨ã€ãƒãƒ¼ãƒªãƒ³ã‚°ã‚¢ãƒƒãƒ—デートã®ãƒ‘ターンを拡張ã§ãã€ã¾ãŸã€Playbook 実行ã®æˆå¦ã§ãƒãƒ¼ãƒ‰ãƒãƒ©ãƒ³ã‚µãƒ¼ã«ãƒžã‚·ãƒ³ã‚’ 1 å°è¿½åŠ ã™ã‚‹ã‹ã©ã†ã‹ã‚’決定ã§ãã‚‹ã“ã¨ãŒå³åº§ã«æ˜Žç¢ºã«ãªã£ãŸã“ã¨ã§ã—ょã†ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:150 -msgid "This is the great culmination of embedded tests::" +#: ../../rst/reference_appendices/test_strategies.rst:164 +msgid "This is the great culmination of embedded tests:" msgstr "ã“ã‚Œã¯ã€çµ„ã¿è¾¼ã¿ãƒ†ã‚¹ãƒˆã®é›†å¤§æˆã§ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:175 +#: ../../rst/reference_appendices/test_strategies.rst:200 msgid "Of course in the above, the \"take out of the pool\" and \"add back\" steps would be replaced with a call to an Ansible load balancer module or appropriate shell command. You might also have steps that use a monitoring module to start and end an outage window for the machine." msgstr "上記ã§ã¯å½“然ã€ã€Œãƒ—ールã‹ã‚‰å–å¾—ã™ã‚‹ã€æ‰‹é †ã‚„ã€Œè¿½åŠ ã—ç›´ã™ã€æ‰‹é †ã¯ã€Ansible ã®ãƒãƒ¼ãƒ‰ãƒãƒ©ãƒ³ã‚µãƒ¼ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚„ã€é©åˆ‡ãª shell コマンドã®å‘¼ã³å‡ºã—ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚ã¾ãŸã€ãƒžã‚·ãƒ³ã®ã‚µãƒ¼ãƒ“スåœæ¢æœŸé–“を開始/終了ã™ã‚‹ãƒ¢ãƒ‹ã‚¿ãƒªãƒ³ã‚°ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹æ‰‹é †ãªã©ã‚‚å«ã¾ã‚Œã¦ã„ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ãŒã€" -#: ../../rst/reference_appendices/test_strategies.rst:179 +#: ../../rst/reference_appendices/test_strategies.rst:204 msgid "However, what you can see from the above is that tests are used as a gate -- if the \"apply_testing_checks\" step is not performed, the machine will not go back into the pool." msgstr "上記ã§åˆ†ã‹ã‚‹ã‚ˆã†ã«ã€ãƒ†ã‚¹ãƒˆã¯ã‚²ãƒ¼ãƒˆã¨ã—ã¦ä½¿ç”¨ã•ã‚Œã¦ã„ã¾ã™ã€‚ã¤ã¾ã‚Šã€ã€Œapply_testing_checksã€ã®æ‰‹é †ãŒå®Ÿè¡Œã•ã‚Œãªã„å ´åˆã¯ã€ãƒžã‚·ãƒ³ãŒãƒ—ールã«æˆ»ã‚‰ãªã„よã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:182 +#: ../../rst/reference_appendices/test_strategies.rst:207 msgid "Read the delegation chapter about \"max_fail_percentage\" and you can also control how many failing tests will stop a rolling update from proceeding." msgstr "ãƒãƒ¼ãƒªãƒ³ã‚°ã‚¢ãƒƒãƒ—デートã®ç¶šè¡Œã‚’妨ã’るテストã®å¤±æ•—回数を制御ã§ãã¾ã™ã€‚ã“ã®ç‚¹ã«ã¤ã„ã¦ã¯ã€ã€Œmax_fail_percentageã€å‘ã‘ã®ç« ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" -#: ../../rst/reference_appendices/test_strategies.rst:185 -msgid "This above approach can also be modified to run a step from a testing machine remotely against a machine::" +#: ../../rst/reference_appendices/test_strategies.rst:210 +msgid "This above approach can also be modified to run a step from a testing machine remotely against a machine:" msgstr "上記ã®ã‚¢ãƒ—ãƒãƒ¼ãƒã‚’変更ã—ã¦ã€ãƒžã‚·ãƒ³ã«å¯¾ã—ã¦ãƒªãƒ¢ãƒ¼ãƒˆã®ãƒ†ã‚¹ãƒˆãƒžã‚·ãƒ³ã‹ã‚‰æ‰‹é †ã‚’実行ã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:213 +#: ../../rst/reference_appendices/test_strategies.rst:240 msgid "In the above example, a script is run from the testing server against a remote node prior to bringing it back into the pool." msgstr "上記ã®ä¾‹ã§ã¯ã€ãƒ—ールã«ãƒžã‚·ãƒ³ã‚’戻ã™å‰ã«ã€ãƒªãƒ¢ãƒ¼ãƒˆã®ãƒŽãƒ¼ãƒ‰ã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã‚µãƒ¼ãƒãƒ¼ã‹ã‚‰ã‚¹ã‚¯ãƒªãƒ—トを実行ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:216 +#: ../../rst/reference_appendices/test_strategies.rst:243 msgid "In the event of a problem, fix the few servers that fail using Ansible's automatically generated retry file to repeat the deploy on just those servers." msgstr "å•é¡ŒãŒç™ºç”Ÿã—ãŸå ´åˆã«ã¯ã€Ansible ãŒè‡ªå‹•ã§ç”Ÿæˆã—ãŸå†è©¦è¡Œãƒ•ã‚¡ã‚¤ãƒ«ã‚’使用ã—ã¦ã€å¤±æ•—ã—ãŸã‚µãƒ¼ãƒãƒ¼æ•°å°ã‚’ä¿®æ£ã—ã€ãã®ã‚µãƒ¼ãƒãƒ¼ã ã‘ã«ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã‚’ç¹°ã‚Šè¿”ã—実行ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:220 +#: ../../rst/reference_appendices/test_strategies.rst:247 msgid "Achieving Continuous Deployment" msgstr "継続的ãªãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã®å®Ÿç¾" -#: ../../rst/reference_appendices/test_strategies.rst:222 +#: ../../rst/reference_appendices/test_strategies.rst:249 msgid "If desired, the above techniques may be extended to enable continuous deployment practices." msgstr "ä»»æ„ã§ã€ä¸Šè¨˜ã®æ‰‹æ³•ã‚’æ‹¡å¼µã—ã¦ã€ç¶™ç¶šã—ã¦ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆãŒã§ãるよã†ã«ã—ã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:224 -msgid "The workflow may look like this::" +#: ../../rst/reference_appendices/test_strategies.rst:251 +msgid "The workflow may look like this:" msgstr "ワークフãƒãƒ¼ã¯ã€æ¬¡ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:231 +#: ../../rst/reference_appendices/test_strategies.rst:260 msgid "Some Ansible users use the above approach to deploy a half-dozen or dozen times an hour without taking all of their infrastructure offline. A culture of automated QA is vital if you wish to get to this level." msgstr "Ansible ユーザーã«ã‚ˆã£ã¦ã¯ã€ä¸Šè¨˜ã®ã‚¢ãƒ—ãƒãƒ¼ãƒã‚’使用ã—ã¦ã€ã™ã¹ã¦ã®ã‚¤ãƒ³ãƒ•ãƒ©ã‚¹ãƒˆãƒ©ã‚¯ãƒãƒ£ãƒ¼ã‚’オフラインã«ã™ã‚‹ã“ã¨ãªãã€1 時間㫠6 回ã€ã¾ãŸã¯ 12 回デプãƒã‚¤ã—ã¦ã„ã¾ã™ã€‚ã“ã®ãƒ¬ãƒ™ãƒ«ã«åˆ°é”ã™ã‚‹ã«ã¯ã€è‡ªå‹•åŒ– QA ã®æ–‡åŒ–ãŒå¿…è¦ä¸å¯æ¬ ã§ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:234 +#: ../../rst/reference_appendices/test_strategies.rst:263 msgid "If you are still doing a large amount of manual QA, you should still make the decision on whether to deploy manually as well, but it can still help to work in the rolling update patterns of the previous section and incorporate some basic health checks using modules like 'script', 'stat', 'uri', and 'assert'." msgstr "大é‡ã® QA を手動ã§ç¶šã‘ã¦ã„ã‚‹å ´åˆã«ã¯ã€æ‰‹å‹•ã§ãƒ‡ãƒ—ãƒã‚¤ã™ã‚‹ã¹ãã‹ã©ã†ã‹æ±ºå®šã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ãŒã€å‰é …ã®ã‚ˆã†ã«ãƒãƒ¼ãƒªãƒ³ã‚°ã‚¢ãƒƒãƒ—デートã®ãƒ‘ターンを使用ã—ã¦ä½œæ¥ã‚’ã—ã€ã€Œscriptã€ã€ã€Œstatã€ã€ã€Œuriã€ã€ã€Œassertã€ãªã©ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã§åŸºæœ¬çš„ãªãƒ˜ãƒ«ã‚¹ãƒã‚§ãƒƒã‚¯ã‚’組ã¿è¾¼ã‚€ã ã‘ã§ã‚‚役立ã¤å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:239 +#: ../../rst/reference_appendices/test_strategies.rst:268 msgid "Conclusion" msgstr "ã¾ã¨ã‚" -#: ../../rst/reference_appendices/test_strategies.rst:241 +#: ../../rst/reference_appendices/test_strategies.rst:270 msgid "Ansible believes you should not need another framework to validate basic things of your infrastructure is true. This is the case because Ansible is an order-based system that will fail immediately on unhandled errors for a host, and prevent further configuration of that host. This forces errors to the top and shows them in a summary at the end of the Ansible run." msgstr "Ansible ã§ã¯ã€ã‚¤ãƒ³ãƒ•ãƒ©ã‚¹ãƒˆãƒ©ã‚¯ãƒãƒ£ãƒ¼ã®åŸºæœ¬çš„ãªå†…容ãŒæ£ã—ã„ã‹ã‚’検証ã™ã‚‹ãƒ•ãƒ¬ãƒ¼ãƒ ワークを別ã«ç”¨æ„ã™ã‚‹å¿…è¦ã¯ãªã„ã¨è€ƒãˆã¾ã™ã€‚ã“ã‚Œã¯ã€Ansible ã¯é †åºãƒ™ãƒ¼ã‚¹ã®ã‚·ã‚¹ãƒ†ãƒ ã§ã€ãƒ›ã‚¹ãƒˆã«æœªå‡¦ç†ã®ã‚¨ãƒ©ãƒ¼ãŒã‚ã‚‹ã¨å³åº§ã«å¤±æ•—ã—ã€ãã®ãƒ›ã‚¹ãƒˆã®è¨å®šãŒã“れ以上進ã¾ãªã„よã†ã«ã—ã¾ã™ã€‚ã“ã†ã™ã‚‹ã“ã¨ã§ã€ã‚¨ãƒ©ãƒ¼ãŒè¡¨é¢åŒ–ã—ã€Ansible ã®å®Ÿè¡Œã®æœ€å¾Œã«ã¾ã¨ã‚ã¨ã—ã¦ã€ã‚¨ãƒ©ãƒ¼ãŒè¡¨ç¤ºã•ã‚Œã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:245 +#: ../../rst/reference_appendices/test_strategies.rst:274 msgid "However, as Ansible is designed as a multi-tier orchestration system, it makes it very easy to incorporate tests into the end of a playbook run, either using loose tasks or roles. When used with rolling updates, testing steps can decide whether to put a machine back into a load balanced pool or not." msgstr "ãŸã ã—ã€Ansible ã¯ã€è¤‡æ•°éšŽå±¤ã®ã‚ªãƒ¼ã‚±ã‚¹ãƒˆãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã‚·ã‚¹ãƒ†ãƒ ã¨ã—ã¦è¨è¨ˆã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€éžå¸¸ã«ç°¡å˜ã«ã‚¿ã‚¹ã‚¯ã¾ãŸã¯ãƒãƒ¼ãƒ«ã‚’使用ã—㦠Playbook 実行ã®æœ€å¾Œã«ãƒ†ã‚¹ãƒˆã‚’組ã¿è¾¼ã‚€ã“ã¨ãŒã§ãã¾ã™ã€‚ãƒãƒ¼ãƒªãƒ³ã‚°ã‚¢ãƒƒãƒ—デートã§ä½¿ç”¨ã™ã‚‹å ´åˆã¯ã€ãƒ†ã‚¹ãƒˆã®æ‰‹é †ã§ã€ãƒãƒ¼ãƒ‰ãƒãƒ©ãƒ³ã‚µãƒ¼ã®ãƒ—ールã«ãƒžã‚·ãƒ³ã‚’戻ã™ã‹ã©ã†ã‹ã‚’判æ–ã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:249 +#: ../../rst/reference_appendices/test_strategies.rst:278 msgid "Finally, because Ansible errors propagate all the way up to the return code of the Ansible program itself, and Ansible by default runs in an easy push-based mode, Ansible is a great step to put into a build environment if you wish to use it to roll out systems as part of a Continuous Integration/Continuous Delivery pipeline, as is covered in sections above." msgstr "最後ã«ã€Ansible ã®ã‚¨ãƒ©ãƒ¼ã¯ã€Ansible ã®ãƒ—ãƒã‚°ãƒ©ãƒ 自体ã®ãƒªã‚¿ãƒ¼ãƒ³ã‚³ãƒ¼ãƒ‰ã«ã¾ã§ä¼æ¬ã•ã‚Œã€ã¾ãŸ Ansible ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ç°¡å˜ãªãƒ—ッシュベースモードã§å®Ÿè¡Œã•ã‚Œã‚‹ãŸã‚ã€ä¸Šè¨˜ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³ã§èª¬æ˜Žã•ã‚Œã¦ã„るよã†ã«ã€ã“れを使用ã—ã¦ç¶™ç¶šçš„ãªçµ±åˆ/継続的ãªãƒ‡ãƒªãƒãƒªãƒ¼ãƒ‘イプラインã®ä¸€éƒ¨ã¨ã—ã¦ã‚·ã‚¹ãƒ†ãƒ を展開ã™ã‚‹å ´åˆã« Ansible をビルド環境ã«æ´»ç”¨ã™ã‚‹ã¨å¤§ããªä¸€æ©ã«ãªã‚Šã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:253 +#: ../../rst/reference_appendices/test_strategies.rst:282 msgid "The focus should not be on infrastructure testing, but on application testing, so we strongly encourage getting together with your QA team and ask what sort of tests would make sense to run every time you deploy development VMs, and which sort of tests they would like to run against the staging environment on every deploy. Obviously at the development stage, unit tests are great too. But don't unit test your playbook. Ansible describes states of resources declaratively, so you don't have to. If there are cases where you want to be sure of something though, that's great, and things like stat/assert are great go-to modules for that purpose." msgstr "インフラストラクãƒãƒ£ãƒ¼ãƒ†ã‚¹ãƒˆã§ã¯ãªãã€ã‚¢ãƒ—リケーションã®ãƒ†ã‚¹ãƒˆã«ç„¦ç‚¹ã‚’当ã¦ã‚‹ãŸã‚ã€QA ãƒãƒ¼ãƒ ã¨é€£æºã—ã¦ã€ã©ã®ã‚ˆã†ãªãƒ†ã‚¹ãƒˆã‚’ã€é–‹ç™ºä»®æƒ³ãƒžã‚·ãƒ³ã®ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆæ™‚ã«æ¯Žå›žå®Ÿè¡Œã™ã‚‹ã¨ä¾¿åˆ©ã‹ã€ã¾ãŸãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆæ™‚ã«æ¯Žå›žã€ã‚¹ãƒ†ãƒ¼ã‚¸ç’°å¢ƒã«ã©ã®ã‚ˆã†ãªãƒ†ã‚¹ãƒˆã‚’実行ã™ã‚‹ã‹ã‚’確èªã—ã¦ãã ã•ã„。明らã‹ã«ã€é–‹ç™ºæ®µéšŽã§ã¯ã€ãƒ¦ãƒ‹ãƒƒãƒˆãƒ†ã‚¹ãƒˆã‚‚ç´ æ™´ã‚‰ã—ã„ã§ã™ãŒã€Playbook をユニットテストã«ã¯ã—ãªã„ã§ãã ã•ã„。Ansible ã¯ãƒªã‚½ãƒ¼ã‚¹ã®çŠ¶æ…‹ã‚’宣言的ã«è¨˜è¿°ã™ã‚‹ãŸã‚ã€ãã®å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。ãŸã ã—ã€ä½•ã‹ã‚’確èªã—ãŸã„å ´åˆã¯ã€stat/assert ã®ã‚ˆã†ãªãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã¨è‰¯ã„ã§ã—ょã†ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:259 +#: ../../rst/reference_appendices/test_strategies.rst:288 msgid "In all, testing is a very organizational and site-specific thing. Everybody should be doing it, but what makes the most sense for your environment will vary with what you are deploying and who is using it -- but everyone benefits from a more robust and reliable deployment system." msgstr "çµå±€ã€ãƒ†ã‚¹ãƒˆã¯éžå¸¸ã«çµ„織的ã§ã€ã‚µã‚¤ãƒˆå›ºæœ‰ã®å†…容ã¨ãªã£ã¦ã„ã¾ã™ã€‚テストã¯å¿…ãšè¡Œã†ã¹ãã§ã™ãŒã€è²´ç¤¾ã®ç’°å¢ƒã«æœ€ã‚‚有用ãªãƒ†ã‚¹ãƒˆã¯ã€ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆã®å†…容やã€èª°ãŒä½¿ç”¨ã™ã‚‹ã‹ã«ã‚ˆã‚Šç•°ãªã‚Šã¾ã™ã€‚ã—ã‹ã—ã€èª°ã‚‚ãŒã€å¼·åŠ›ã§ä¿¡é ¼æ€§ã®é«˜ã„デプãƒã‚¤ãƒ¡ãƒ³ãƒˆã‚·ã‚¹ãƒ†ãƒ ã‹ã‚‰æ©æµã‚’å—ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" -#: ../../rst/reference_appendices/test_strategies.rst:269 +#: ../../rst/reference_appendices/test_strategies.rst:298 msgid ":ref:`playbooks_delegation`" msgstr ":ref:`playbooks_delegation`" -#: ../../rst/reference_appendices/test_strategies.rst:270 +#: ../../rst/reference_appendices/test_strategies.rst:299 msgid "Delegation, useful for working with load balancers, clouds, and locally executed steps." msgstr "å§”è² (ãƒãƒ¼ãƒ‰ãƒãƒ©ãƒ³ã‚µãƒ¼ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã€ãŠã‚ˆã³ãƒãƒ¼ã‚«ãƒ«ã§å®Ÿè¡Œã—ãŸæ‰‹é †ã‚’使用ã™ã‚‹éš›ã«å½¹ã«ç«‹ã¡ã¾ã™)" @@ -10813,6 +10939,10 @@ msgstr "å§”è² (ãƒãƒ¼ãƒ‰ãƒãƒ©ãƒ³ã‚µãƒ¼ã€ã‚¯ãƒ©ã‚¦ãƒ‰ã€ãŠã‚ˆã³ãƒãƒ¼ã‚«ãƒ«ã msgid "Red Hat Ansible Automation Platform" msgstr "Red Hat Ansible Automation Platform" +#: ../../rst/reference_appendices/tower.rst:8 +msgid "Red Hat Ansible Automation Platform is available on multiple cloud platforms. See `Ansible on Clouds <https://access.redhat.com/documentation/en-us/ansible_on_clouds/2.x>`_ for details." +msgstr "Red Hat Ansible Automation Platform ã¯ã€è¤‡æ•°ã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ラットフォームã§åˆ©ç”¨ã§ãã¾ã™ã€‚詳細ã¯ã€`Ansible on Clouds <https://access.redhat.com/documentation/en-us/ansible_on_clouds/2.x>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" + #: ../../rst/reference_appendices/tower.rst:10 msgid "`Red Hat Ansible Automation Platform <https://www.ansible.com/products/automation-platform>`_ (RHAAP) is an integrated solution for operationalizing Ansible across your team, organization, and enterprise. The platform includes a controller with a web console and REST API, analytics, execution environments, and much more." msgstr "`Red Hat Ansible Automation Platform <https://www.ansible.com/products/automation-platform>`_(RHAAP)ã¯ã€ãƒãƒ¼ãƒ ã€çµ„ç¹”ã€ä¼æ¥å…¨ä½“㧠Ansible ã‚’æ“作ã™ã‚‹çµ±åˆã‚½ãƒªãƒ¥ãƒ¼ã‚·ãƒ§ãƒ³ã§ã™ã€‚ã“ã®ãƒ—ラットフォームã«ã¯ã€Web コンソールãŠã‚ˆã³ REST APIã€è§£æžã€å®Ÿè¡Œç’°å¢ƒã‚’å‚™ãˆãŸã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©ãƒ¼ãŒå«ã¾ã‚Œã¾ã™ã€‚" @@ -11402,4 +11532,73 @@ msgstr "RHAAP ã¯ã€Red Hat ãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹ Ansible AWX ã®è£½å“ãƒãƒ¼ã‚¸ #~ msgid "Ansible Tower is the downstream Red-Hat supported product version of Ansible AWX. Find out more about Ansible Tower features and how to download it on the `Ansible Tower webpage <https://www.ansible.com/products/tower>`_. Ansible Tower is part of the Red Hat Ansible Automation subscription, and comes bundled with amazing support from Red Hat, Inc." #~ msgstr "Ansible Tower ã¯ã€Red Hat ãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹ Ansible AWX ã®è£½å“ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ (ダウンストリーム) ã§ã™ã€‚Ansible Tower ã®æ©Ÿèƒ½ã¨ãã®ãƒ€ã‚¦ãƒ³ãƒãƒ¼ãƒ‰æ–¹æ³•ã®è©³ç´°ã¯ã€`Ansible Tower web ページ <https://www.ansible.com/products/tower>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。Ansible Tower ã¯ã€Red Hat Ansible Automation サブスクリプションã«å«ã¾ã‚Œã€Red Hat, Inc ã®ã‚µãƒãƒ¼ãƒˆãŒåˆ©ç”¨ã§ãã¾ã™ã€‚" +#~ msgid "You can add ``-o ServerAliveInterval=NumberOfSeconds`` in ``ssh_args`` from ``ansible.cfg``. Without this option, SSH and therefore Ansible will wait until the TCP connection times out. Another solution is to add ``ServerAliveInterval`` into your global SSH configuration. A good value for ``ServerAliveInterval`` is up to you to decide; keep in mind that ``ServerAliveCountMax=3`` is the SSH default so any value you set will be tripled before terminating the SSH session." +#~ msgstr "``ansible.cfg`` ã‹ã‚‰ã€``ssh_args`` ã« ``-o ServerAliveInterval=NumberOfSeconds`` ã‚’è¿½åŠ ã§ãã¾ã™ã€‚ã“ã®ã‚ªãƒ—ションãŒãªã„ã¨ã€SSH 㨠Ansible 㯠TCP 接続ãŒã‚¿ã‚¤ãƒ アウトã«ãªã‚‹ã¾ã§å¾…æ©Ÿã—ã¾ã™ã€‚別ã®è§£æ±ºæ–¹æ³•ã¯ã€``ServerAliveInterval`` ã‚’ã‚°ãƒãƒ¼ãƒãƒ«ã® SSH è¨å®šã«è¿½åŠ ã™ã‚‹ã“ã¨ã§ã™ã€‚``ServerAliveInterval`` ã«é©ã—ãŸå€¤ã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒæ±ºå®šã—ã¾ã™ã€‚ãŸã ã—ã€SSH ã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã¯ ``ServerAliveCountMax=3`` ã§ã‚ã‚‹ãŸã‚ã€SSH セッションã®çµ‚了å‰ã«è¨å®šã—ãŸå€¤ãŒ 3 å€ã«ãªã‚‹ç‚¹ã«æ³¨æ„ã—ã¦ãã ã•ã„。" + +#~ msgid "A file (by default, Ansible uses a simple INI format) that describes :term:`Hosts <Host>` and :term:`Groups <Group>` in Ansible. Inventory can also be provided via an :term:`Inventory Script` (sometimes called an \"External Inventory Script\")." +#~ msgstr "Ansible 㧠:term:`ホスト <Host>` 㨠:term:`グループ <Group>` を記述ã—ãŸãƒ•ã‚¡ã‚¤ãƒ« (デフォルトã§ã¯ã€Ansible ã¯ç°¡å˜ãª INI å½¢å¼ã‚’使用)。インベントリーã¯ã€:term:`インベントリースクリプト` (「外部インベントリースクリプトã€ã¨å‘¼ã°ã‚Œã‚‹ã“ã¨ã‚‚ã‚ã‚Šã¾ã™) を介ã—ã¦æä¾›ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚" + +#~ msgid ":class:`set` of values marked as ``no_log`` in the argument spec. This is a temporary holding place for these values and may move in the future." +#~ msgstr "引数仕様㧠``no_log`` ã¨ãƒžãƒ¼ã‚¯ã•ã‚ŒãŸå€¤ã® :class:`set`。ã“ã‚Œã¯ã€ã“れらã®å€¤ã®ä¸€æ™‚çš„ãªä¿æŒã¨ãªã‚Šã€ä»Šå¾Œç§»å‹•ã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" + +#~ msgid "On the controller we support Python 3.5 or greater and Python 2.7 or greater. Module-side, we support Python 3.5 or greater and Python 2.6 or greater." +#~ msgstr "コントãƒãƒ¼ãƒ©ãƒ¼ã§ã¯ã€Python 3.5 以é™ã€ãŠã‚ˆã³ Python 2.7 以é™ã‚’サãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚モジュールå´ã§ã¯ã€Python 3.5 以é™ã€Python 2.6 以é™ã‚’サãƒãƒ¼ãƒˆã—ã¾ã™ã€‚" + +#~ msgid "``ansible-core``/``ansible-base``" +#~ msgstr "``ansible-core``/``ansible-base``" + +#~ msgid "Release" +#~ msgstr "Release" + +#~ msgid "devel" +#~ msgstr "devel" + +#~ msgid "In development (ansible-core 2.14 unreleased, trunk)" +#~ msgstr "é–‹ç™ºä¸ (未リリース㮠ansible-core 2.14 (trunk))" + +#~ msgid "TBD" +#~ msgstr "TBD" + +#~ msgid "`2.13 ansible-core Changelogs`_" +#~ msgstr "`2.10 ansible-base Release Notes`_" + +#~ msgid "Maintained (security **and** general bug fixes)" +#~ msgstr "メンテナンス対象 (ã‚»ã‚ュリティー **ãŠã‚ˆã³** 一般的ãªãƒã‚°ã®ä¿®æ£)" + +#~ msgid "`2.12 ansible-core Changelogs`_" +#~ msgstr "`2.10 ansible-base Release Notes`_" + +#~ msgid "Maintained (security **and** critical bug fixes)" +#~ msgstr "メンテナンス対象 (ã‚»ã‚ュリティー **ãŠã‚ˆã³** é‡å¤§ãªãƒã‚°ã®ä¿®æ£)" + +#~ msgid "`2.11 ansible-core Changelogs`_" +#~ msgstr "`2.10 ansible-base Release Notes`_" + +#~ msgid "Maintained (security bug fixes only)" +#~ msgstr "メンテナンス対象 (ã‚»ã‚ュリティーãƒã‚°ä¿®æ£ã®ã¿)" + +#~ msgid "`2.10 ansible-base Changelogs`_" +#~ msgstr "`2.10 ansible-base Release Notes`_" + +#~ msgid "EOL" +#~ msgstr "EOL" + +#~ msgid "`2.9 Changelogs`_" +#~ msgstr "`2.9 Changelogs`_" + +#~ msgid "`2.8 Changelogs`_" +#~ msgstr "`2.8 Changelogs`_" + +#~ msgid "`2.7 Changelogs`_" +#~ msgstr "`2.7 Changelogs`_" + +#~ msgid "`2.6 Changelogs`_" +#~ msgstr "`2.6 Changelogs`_" + +#~ msgid "`2.5 Changelogs`_" +#~ msgstr "`2.5 Changelogs`_" + +#~ msgid "<2.5" +#~ msgstr "2.5 よりå‰ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/roadmap.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/roadmap.po index cb0b0559..04857f63 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/roadmap.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/roadmap.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/roadmap/COLLECTIONS_2_10.rst:3 msgid "Ansible project 2.10" @@ -113,7 +113,7 @@ msgstr "ansible-3.0 ã§é‡å¤§ãªå¤‰æ›´ãŒå°Žå…¥ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ #: ../../rst/roadmap/COLLECTIONS_4.rst:55 #: ../../rst/roadmap/COLLECTIONS_5.rst:58 #: ../../rst/roadmap/COLLECTIONS_6.rst:56 -#: ../../rst/roadmap/COLLECTIONS_7.rst:55 +#: ../../rst/roadmap/COLLECTIONS_7.rst:57 msgid "For more information, reach out on a mailing list or a chat channel - see :ref:`communication` for more details." msgstr "詳細ã¯ã€ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆã¾ãŸã¯ãƒãƒ£ãƒƒãƒˆãƒãƒ£ãƒ³ãƒãƒ«ã‚’ã”利用ãã ã•ã„。「:ref:`communication`ã€ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -193,7 +193,7 @@ msgstr "ã“ã®æ—¥ä»˜ä»¥é™ã¯ã€æ–°ã—ã„モジュールやメジャー機能㯠#: ../../rst/roadmap/COLLECTIONS_4.rst:35 #: ../../rst/roadmap/COLLECTIONS_5.rst:38 #: ../../rst/roadmap/COLLECTIONS_6.rst:36 -#: ../../rst/roadmap/COLLECTIONS_7.rst:35 +#: ../../rst/roadmap/COLLECTIONS_7.rst:37 msgid "After this date only changes blocking a release are accepted. Accepted changes require creating a new rc and may slip the final release date." msgstr "ã“ã®æ—¥ä»˜ä»¥é™ã¯ã€ãƒªãƒªãƒ¼ã‚¹ã‚’ブãƒãƒƒã‚¯ã™ã‚‹å¤‰æ›´ã®ã¿ãŒè¨±å¯ã•ã‚Œã¾ã™ã€‚å—ã‘入れå¯èƒ½ãªå¤‰æ›´ã«ã¯ã€æ–°ã—ã„ rc を作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€æœ€çµ‚リリース日ã¯å‡¦ç†ã•ã‚Œãªã„å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚" @@ -209,7 +209,7 @@ msgstr "Ansible3.0.0 ã§é‡å¤§ãªå¤‰æ›´ãŒå°Žå…¥ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã #: ../../rst/roadmap/COLLECTIONS_4.rst:45 #: ../../rst/roadmap/COLLECTIONS_5.rst:48 #: ../../rst/roadmap/COLLECTIONS_6.rst:46 -#: ../../rst/roadmap/COLLECTIONS_7.rst:45 +#: ../../rst/roadmap/COLLECTIONS_7.rst:47 msgid "Ansible minor releases" msgstr "Ansible マイナーリリース" @@ -522,7 +522,7 @@ msgstr "ã“ã®æ—¥ä»˜ä»¥é™ã¯ã€æ–°ã—ã„モジュールやメジャー機能㯠#: ../../rst/roadmap/COLLECTIONS_5.rst:40 #: ../../rst/roadmap/COLLECTIONS_6.rst:38 -#: ../../rst/roadmap/COLLECTIONS_7.rst:37 +#: ../../rst/roadmap/COLLECTIONS_7.rst:39 msgid "Collections will only be updated to a new version if a blocker is approved. Collection owners should discuss any blockers at a community IRC meeting (before this freeze) to decide whether to bump the version of the collection for a fix. See the `Community IRC meeting agenda <https://github.com/ansible/community/issues/539>`_." msgstr "コレクションã¯ã€ãƒ–ãƒãƒƒã‚«ãƒ¼ãŒæ‰¿èªã•ã‚ŒãŸå ´åˆã«ã®ã¿æ–°ã—ã„ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«æ›´æ–°ã•ã‚Œã¾ã™ã€‚コレクションã®æ‰€æœ‰è€…ã¯ã€(フリーズã®å‰ã«) ä¿®æ£ã®ãŸã‚ã«ã‚³ãƒ¬ã‚¯ã‚·ãƒ§ãƒ³ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’上ã’ã‚‹ã‹ã©ã†ã‹ã‚’決定ã™ã‚‹ãŸã‚ã«ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ IRC ミーティングã®ãƒ–ãƒãƒƒã‚«ãƒ¼ã«ã¤ã„ã¦æ¤œè¨Žã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚`コミュニティー IRC ミーティングã®è°é¡Œ <https://github.com/ansible/community/issues/539>`_ ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -754,8 +754,8 @@ msgid "First ansible-core 2.14 release candidate." msgstr "最åˆã® ansible-core 2.14 リリース候補。" #: ../../rst/roadmap/COLLECTIONS_7.rst -msgid "2022-10-18" -msgstr "2022-10-18" +msgid "2022-10-25" +msgstr "2022-10-25" #: ../../rst/roadmap/COLLECTIONS_7.rst:22 msgid "Ansible-7.0.0 alpha2." @@ -798,42 +798,58 @@ msgid "Ansible-7.0.0 rc1 [2]_ [3]_ (weekly release candidates as needed; test an msgstr "Ansible-7.0.0 rc1 [2]_ [3]_ (å¿…è¦ã«å¿œã˜ã¦é€±æ¬¡ãƒªãƒªãƒ¼ã‚¹å€™è£œã€‚ã™ã¹ã¦ã®ãƒ–ãƒãƒƒã‚«ãƒ¼ãƒã‚°ã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã—ã€è¦å‘Šã—ã¾ã™)。ブãƒãƒƒã‚«ãƒ¼ãƒã‚°ã¯ãƒªãƒªãƒ¼ã‚¹ã‚’é…延ã•ã›ã¾ã™ã€‚" #: ../../rst/roadmap/COLLECTIONS_7.rst -msgid "2022-11-29" -msgstr "2022-11-29" +msgid "2022-11-18" +msgstr "2022-11-18" #: ../../rst/roadmap/COLLECTIONS_7.rst:29 -msgid "Ansible-7.0.0 release." -msgstr "Ansible-7.0.0 リリース" +msgid "Last day to trigger an Ansible-7.0.0rc2 release because of major defects in Ansible-7.0.0rc1." +msgstr "Ansible-7.0.0rc2 リリースをトリガーã™ã‚‹æœ€çµ‚æ—¥ (Ansible-7.0.0rc1 ã«é‡å¤§ãªå•é¡ŒãŒã‚ã‚‹å ´åˆ)。" #: ../../rst/roadmap/COLLECTIONS_7.rst -msgid "2022-12-06" -msgstr "2022-12-06" +msgid "2022-11-22" +msgstr "2022-11-22" #: ../../rst/roadmap/COLLECTIONS_7.rst:30 -msgid "Release of ansible-core 2.14.1." -msgstr "Ansible-core 2.14.1 ã®ãƒªãƒªãƒ¼ã‚¹" +msgid "Ansible-7.0.0rc2 when necessary, otherwise Ansible-7.0.0 release." +msgstr "å¿…è¦ã«å¿œã˜ã¦ Ansible-7.0.0rc2。ãれ以外㯠Ansible-7.0.0 リリース。" #: ../../rst/roadmap/COLLECTIONS_7.rst -msgid "2022-12-20" -msgstr "2022-12-20" +msgid "2022-11-29" +msgstr "2022-11-29" #: ../../rst/roadmap/COLLECTIONS_7.rst:31 -msgid "Release of Ansible-7.1.0 (bugfix + compatible features: every three weeks.)" -msgstr "Ansible-7.1.0 ã®ãƒªãƒªãƒ¼ã‚¹ (ãƒã‚°ä¿®æ£ + 互æ›æ€§ã®ã‚る機能: 3 週間ã”ã¨)" +msgid "Ansible-7.0.0 release when Ansible-7.0.0rc2 was necessary." +msgstr "Ansible-7.0.0 リリース (Ansible-7.0.0rc2 ãŒå¿…è¦ã ã£ãŸå ´åˆ)。" + +#: ../../rst/roadmap/COLLECTIONS_7.rst +msgid "2022-12-05" +msgstr "2022-12-05" + +#: ../../rst/roadmap/COLLECTIONS_7.rst:32 +msgid "Release of ansible-core 2.14.1." +msgstr "Ansible-core 2.14.1 ã®ãƒªãƒªãƒ¼ã‚¹" + +#: ../../rst/roadmap/COLLECTIONS_7.rst +msgid "2022-12-06" +msgstr "2022-12-06" #: ../../rst/roadmap/COLLECTIONS_7.rst:33 +msgid "Release of Ansible-7.1.0 (bugfix + compatible features: every four weeks.)" +msgstr "Ansible-7.1.0 ã®ãƒªãƒªãƒ¼ã‚¹ (ãƒã‚°ä¿®æ£ + 互æ›æ€§ã®ã‚る機能: 4 週間ã”ã¨)" + +#: ../../rst/roadmap/COLLECTIONS_7.rst:35 msgid "No new modules or major features accepted after this date. In practice, this means we will freeze the semver collection versions to compatible release versions. For example, if the version of community.crypto on this date was community.crypto 2.3.0; Ansible-7.0.0 could ship with community.crypto 2.3.1. It would not ship with community.crypto 2.4.0." msgstr "ã“ã®æ—¥ä»˜ä»¥é™ã¯ã€æ–°ã—ã„モジュールやメジャー機能ã¯è¿½åŠ ã•ã‚Œã¾ã›ã‚“。実際ã«ã¯ã€semver コレクションã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯äº’æ›æ€§ã®ã‚るリリースãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ãƒ•ãƒªãƒ¼ã‚ºã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€ã“ã®æ—¥ä»˜ã® community.crypto ã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒ community.crypto 2.3.0 ã§ã‚ã‚Œã°ã€ansible-7.0.0 㯠community.crypto 2.3.1 ã«åŒæ¢±ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã—ãŸã€‚community.crypto 2.4.0 ã«ã¯åŒæ¢±ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/roadmap/COLLECTIONS_7.rst:41 +#: ../../rst/roadmap/COLLECTIONS_7.rst:43 msgid "Breaking changes will be introduced in Ansible 7.0.0, although we encourage the use of deprecation periods that will show up in at least one Ansible release before the breaking change happens, this is not guaranteed." msgstr "Ansible 7.0.0 㧠é‡å¤§ãªå¤‰æ›´ãŒå°Žå…¥ã•ã‚Œã¾ã™ãŒã€é‡å¤§ãªå¤‰æ›´ãŒç™ºç”Ÿã™ã‚‹å‰ã«å°‘ãªãã¨ã‚‚ 1 ã¤ã® Ansible リリースã«è¡¨ç¤ºã•ã‚Œã‚‹éžæŽ¨å¥¨æœŸé–“ã®ä½¿ç”¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ãŒã€ã“ã‚Œã¯ä¿è¨¼ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/roadmap/COLLECTIONS_7.rst:47 -msgid "Ansible 7.x minor releases will occur approximately every three weeks if changes to collections have been made or if it is deemed necessary to force an upgrade to a later ansible-core-2.14.x. Ansible 7.x minor releases may contain new features but not backwards incompatibilities. In practice, this means we will include new collection versions where either the patch or the minor version number has changed but not when the major number has changed. For example, if Ansible-7.0.0 ships with community.crypto 2.3.0; Ansible-6.1.0 may ship with community.crypto 2.4.0 but would not ship with community.crypto 3.0.0." -msgstr "コレクションã«å¤‰æ›´ãŒåŠ ãˆã‚‰ã‚ŒãŸå ´åˆã€ã¾ãŸã¯å¾Œã§ ansible-core-2.14.x ã¸ã®ã‚¢ãƒƒãƒ—グレードを強制ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã¨è¦‹ãªã•ã‚ŒãŸå ´åˆã€Ansible 7.x マイナーリリースã¯ç´„ 3 週間ã”ã¨ã«è¡Œã‚ã‚Œã¾ã™ã€‚Ansible 7.x マイナーリリースã«ã¯æ–°æ©Ÿèƒ½ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€å¾Œæ–¹äº’æ›æ€§ã¯å«ã¾ã‚Œã¦ã„ã¾ã›ã‚“。実際ã«ã¯ã€ã“ã‚Œã¯ã€ãƒ‘ッãƒã¾ãŸã¯ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã®ã„ãšã‚Œã‹ãŒå¤‰æ›´ã•ã‚ŒãŸã«ã‚‚ã‹ã‹ã‚らãšã€ãƒ¡ã‚¸ãƒ£ãƒ¼ç•ªå·ãŒå¤‰æ›´ã•ã‚ŒãŸã¨ãã«å¤‰æ›´ã•ã‚Œãªã„æ–°ã—ã„コレクションãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å«ã‚ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€Ansible-7.0.0 ㌠community.crypto 2.3.0 ã«åŒæ¢±ã•ã‚Œã‚‹ã¨ã€Ansible-6.1.0 㯠community.crypto 2.4.0 ã«åŒæ¢±ã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ãŒã€community.crypto.3.0.0 ã«ã¯åŒæ¢±ã•ã‚Œã¾ã›ã‚“。" +#: ../../rst/roadmap/COLLECTIONS_7.rst:49 +msgid "Ansible 7.x minor releases will occur approximately every four weeks if changes to collections have been made or to align to a later ansible-core-2.14.x. Ansible 7.x minor releases may contain new features but not backwards incompatibilities. In practice, this means we will include new collection versions where either the patch or the minor version number has changed but not when the major number has changed. For example, if Ansible-7.0.0 ships with community.crypto 2.3.0; Ansible-7.1.0 may ship with community.crypto 2.4.0 but would not ship with community.crypto 3.0.0." +msgstr "コレクションã«å¤‰æ›´ãŒåŠ ãˆã‚‰ã‚ŒãŸå ´åˆã€ã¾ãŸã¯å¾Œã«ãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹ ansible-core-2.14.x ã¨èª¿æ•´ã™ã‚‹å¿…è¦ãŒã‚ã‚‹å ´åˆã«ã€Ansible 7.x マイナーリリースã¯ç´„ 4 週間ã”ã¨ã«è¡Œã‚ã‚Œã¾ã™ã€‚Ansible 7.x マイナーリリースã«ã¯æ–°æ©Ÿèƒ½ãŒå«ã¾ã‚Œã¦ã„ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ãŒã€å¾Œæ–¹äº’æ›æ€§ã¯å«ã¾ã‚Œã¦ã„ã¾ã›ã‚“。実際ã«ã¯ã€ã“ã‚Œã¯ã€ãƒ‘ッãƒã¾ãŸã¯ãƒžã‚¤ãƒŠãƒ¼ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã®ã„ãšã‚Œã‹ãŒå¤‰æ›´ã•ã‚ŒãŸã«ã‚‚ã‹ã‹ã‚らãšã€ãƒ¡ã‚¸ãƒ£ãƒ¼ç•ªå·ãŒå¤‰æ›´ã•ã‚ŒãŸã¨ãã«å¤‰æ›´ã•ã‚Œãªã„æ–°ã—ã„コレクションãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’å«ã‚ã‚‹ã“ã¨ã‚’æ„味ã—ã¾ã™ã€‚ãŸã¨ãˆã°ã€Ansible-7.0.0 ㌠community.crypto 2.3.0 ã«åŒæ¢±ã•ã‚Œã‚‹ã¨ã€Ansible-6.1.0 㯠community.crypto 2.4.0 ã«åŒæ¢±ã•ã‚Œã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ãŒã€community.crypto.3.0.0 ã«ã¯åŒæ¢±ã•ã‚Œã¾ã›ã‚“。" -#: ../../rst/roadmap/COLLECTIONS_7.rst:52 +#: ../../rst/roadmap/COLLECTIONS_7.rst:54 msgid "Minor releases will stop when Ansible-8 is released. See the :ref:`Release and Maintenance Page <release_and_maintenance>` for more information." msgstr "Ansible-8 ãŒãƒªãƒªãƒ¼ã‚¹ã•ã‚Œã‚‹ã¨ã€ãƒžã‚¤ãƒŠãƒ¼ãƒªãƒªãƒ¼ã‚¹ã¯åœæ¢ã—ã¾ã™ã€‚詳細㯠:ref:`Release and Maintenance Page <release_and_maintenance>` ã‚’å‚ç…§ã—ã¦ãã ã•ã„。" @@ -906,7 +922,7 @@ msgstr "``ansible-base`` リãƒã‚¸ãƒˆãƒªãƒ¼ã‚’表ã™æ–°ã—ã„ ``ansible/ansible` #: ../../rst/roadmap/ROADMAP_2_10.rst:43 msgid "Additional Resources" -msgstr "è¿½åŠ æƒ…å ±" +msgstr "é–¢é€£æƒ…å ±" #: ../../rst/roadmap/ROADMAP_2_10.rst:45 msgid "The 2.10 release of Ansible will fundamentally change the scope of plugins included in the ``ansible/ansible`` repository, by moving much of the plugins into smaller collection repositories that will be shipped through https://galaxy.ansible.com/" @@ -2062,4 +2078,10 @@ msgstr "ç¾åœ¨ã® Ansible ãŠã‚ˆã³ ``ansible-base`` ã®ãƒãƒ¼ãƒ‰ãƒžãƒƒãƒ—を確 #~ msgid "Post on the ``#ansible-community`` Freenode IRC channel" #~ msgstr "Freenode IRC ãƒãƒ£ãƒ³ãƒãƒ« ``#ansible-community`` ã§ç™ºè¨€" +#~ msgid "2022-10-18" +#~ msgstr "2022-10-18" + +#~ msgid "Ansible-7.0.0 release." +#~ msgstr "Ansible-7.0.0 リリース" + diff --git a/docs/docsite/rst/locales/ja/LC_MESSAGES/scenario_guides.po b/docs/docsite/rst/locales/ja/LC_MESSAGES/scenario_guides.po index a9909292..156f5bc4 100644 --- a/docs/docsite/rst/locales/ja/LC_MESSAGES/scenario_guides.po +++ b/docs/docsite/rst/locales/ja/LC_MESSAGES/scenario_guides.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: Ansible devel\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-05 09:34+0200\n" +"POT-Creation-Date: 2023-03-01 20:16+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.8.1\n" +"Generated-By: Babel 2.9.0\n" #: ../../rst/scenario_guides/cloud_guides.rst:5 #: ../../rst/scenario_guides/guides.rst:17 @@ -166,8 +166,8 @@ msgid "Gathering facts" msgstr "ファクトã®åŽé›†" #: ../../rst/scenario_guides/guide_aci.rst:114 -msgid "Because we run the modules on the Ansible controller gathering facts will not work. That is why when using these ACI modules it is mandatory to disable facts gathering. You can do this globally in your ``ansible.cfg`` or by adding ``gather_facts: no`` to every play." -msgstr "Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã™ã‚‹ãŸã‚ã€ãƒ•ã‚¡ã‚¯ãƒˆã®åŽé›†ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。ãã®ãŸã‚ã€ã“れら㮠ACI モジュールを使用ã™ã‚‹å ´åˆã¯ãƒ•ã‚¡ã‚¯ãƒˆã®åŽé›†ã‚’無効ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€``ansible.cfg`` ã§ã‚°ãƒãƒ¼ãƒãƒ«ã«è¡Œã†ã‹ã€ã™ã¹ã¦ã®ãƒ—レイ㫠``gather_facts: no`` ã‚’è¿½åŠ ã—ã¦è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "Because we run the modules on the Ansible controller gathering facts will not work. That is why when using these ACI modules it is mandatory to disable facts gathering. You can do this globally in your ``ansible.cfg`` or by adding ``gather_facts: false`` to every play." +msgstr "Ansible コントãƒãƒ¼ãƒ©ãƒ¼ã§ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’実行ã™ã‚‹ãŸã‚ã€ãƒ•ã‚¡ã‚¯ãƒˆã®åŽé›†ã¯æ©Ÿèƒ½ã—ã¾ã›ã‚“。ãã®ãŸã‚ã€ã“れら㮠ACI モジュールを使用ã™ã‚‹å ´åˆã¯ãƒ•ã‚¡ã‚¯ãƒˆã®åŽé›†ã‚’無効ã«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€``ansible.cfg`` ã§ã‚°ãƒãƒ¼ãƒãƒ«ã«è¡Œã†ã‹ã€ã™ã¹ã¦ã®ãƒ—レイ㫠``gather_facts: false`` ã‚’è¿½åŠ ã—ã¦è¡Œã†ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_aci.rst:128 msgid "Delegating to localhost" @@ -319,8 +319,8 @@ msgid "HTTP redirects can redirect from HTTP to HTTPS so ensure that the proxy e msgstr "HTTP リダイレクト㯠HTTP ã‹ã‚‰ HTTPS ã¸ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã§ãã‚‹ãŸã‚ã€ä¸¡æ–¹ã®ãƒ—ãƒãƒˆã‚³ãƒ«ã®ãƒ—ãƒã‚シー環境ãŒæ£ã—ãè¨å®šã•ã‚Œã¦ã„ã‚‹ã“ã¨ã‚’確èªã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_aci.rst:238 -msgid "If proxy support is not needed, but the system may have it configured nevertheless, use the parameter ``use_proxy: no`` to avoid accidental system proxy usage." -msgstr "プãƒã‚シーサãƒãƒ¼ãƒˆãŒå¿…è¦ãªãã¦ã‚‚ã€ã‚·ã‚¹ãƒ†ãƒ ãŒãれをè¨å®šã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹å ´åˆã¯ã€``use_proxy: no`` パラメーターを使用ã—ã¦ã€èª¤ã£ãŸã‚·ã‚¹ãƒ†ãƒ プãƒã‚シーã®ä½¿ç”¨ã‚’回é¿ã—ã¾ã™ã€‚" +msgid "If proxy support is not needed, but the system may have it configured nevertheless, use the parameter ``use_proxy: false`` to avoid accidental system proxy usage." +msgstr "プãƒã‚シーサãƒãƒ¼ãƒˆãŒå¿…è¦ãªãã¦ã‚‚ã€ã‚·ã‚¹ãƒ†ãƒ ãŒãれをè¨å®šã™ã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹å ´åˆã¯ã€``use_proxy: false`` パラメーターを使用ã—ã¦ã€èª¤ã£ãŸã‚·ã‚¹ãƒ†ãƒ プãƒã‚シーã®ä½¿ç”¨ã‚’回é¿ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_aci.rst:240 msgid "Selective proxy support using the ``no_proxy`` environment variable is also supported." @@ -822,7 +822,7 @@ msgstr "Ansible Network ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ãƒ¼ãƒšãƒ¼ã‚¸ã€‚é€£çµ¡å…ˆæƒ…å ±ãŠã‚ˆã #: ../../rst/scenario_guides/guide_aci.rst:658 msgid "`User Mailing List <https://groups.google.com/group/ansible-project>`_" -msgstr "`メーリングリストã®ä½¿ç”¨ <https://groups.google.com/group/ansible-project>`_" +msgstr "`User Mailing List <https://groups.google.com/group/ansible-project>`_" #: ../../rst/scenario_guides/guide_aci.rst:659 msgid "Have a question? Stop by the google group!" @@ -865,52 +865,52 @@ msgid "Cloud modules, including Alicloud modules, execute on your local machine msgstr "Alicloud モジュールをå«ã‚€ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€ãƒ›ã‚¹ãƒˆã«å®šç¾©ã•ã‚ŒãŸãƒªãƒ¢ãƒ¼ãƒˆãƒžã‚·ãƒ³ã§ã¯ãªãã€ãƒãƒ¼ã‚«ãƒ«ãƒžã‚·ãƒ³ (コントãƒãƒ¼ãƒ«ãƒžã‚·ãƒ³) 㧠``connection: local`` を使用ã—ã¦å®Ÿè¡Œã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_alicloud.rst:16 -msgid "Normally, you'll use the following pattern for plays that provision Alicloud resources::" +msgid "Normally, you'll use the following pattern for plays that provision Alicloud resources:" msgstr "通常ã€Alicloud リソースをプãƒãƒ“ジョニングã™ã‚‹ãƒ—レイã«ã¯æ¬¡ã®ãƒ‘ターンを使用ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:28 +#: ../../rst/scenario_guides/guide_alicloud.rst:30 #: ../../rst/scenario_guides/guide_vultr.rst:45 msgid "Authentication" msgstr "èªè¨¼" -#: ../../rst/scenario_guides/guide_alicloud.rst:30 +#: ../../rst/scenario_guides/guide_alicloud.rst:32 msgid "You can specify your Alicloud authentication credentials (access key and secret key) by passing them as environment variables or by storing them in a vars file." msgstr "Alicloud ã®èªè¨¼æƒ…å ± (アクセスã‚ーãŠã‚ˆã³ã‚·ãƒ¼ã‚¯ãƒ¬ãƒƒãƒˆã‚ー) を指定ã™ã‚‹ã«ã¯ã€ãã®èªè¨¼æƒ…å ±ã‚’ç’°å¢ƒå¤‰æ•°ã¨ã—ã¦æ¸¡ã™ã‹ã€vars ファイルã«ä¿å˜ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:33 -msgid "To pass authentication credentials as environment variables::" +#: ../../rst/scenario_guides/guide_alicloud.rst:35 +msgid "To pass authentication credentials as environment variables:" msgstr "環境変数ã¨ã—ã¦èªè¨¼æƒ…å ±ã‚’æ¸¡ã™ã«ã¯ã€ä»¥ä¸‹ã‚’実行ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:38 -msgid "To store authentication credentials in a vars_file, encrypt them with :ref:`Ansible Vault<vault>` to keep them secure, then list them::" +#: ../../rst/scenario_guides/guide_alicloud.rst:42 +msgid "To store authentication credentials in a vars_files, encrypt them with :ref:`Ansible Vault<vault>` to keep them secure, then list them:" msgstr "èªè¨¼æƒ…å ±ã‚’ vars_file ã«ä¿å˜ã™ã‚‹ã«ã¯ã€:ref:`Ansible Vault<vault>` ã§èªè¨¼æƒ…å ±ã‚’æš—å·åŒ–ã—ã¦ã‚»ã‚ュアã«ç¶æŒã—ã¦ã‹ã‚‰ã€ãã®èªè¨¼æƒ…å ±ã®ä¸€è¦§ã‚’表示ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:44 -msgid "Note that if you store your credentials in a vars_file, you need to refer to them in each Alicloud module. For example::" +#: ../../rst/scenario_guides/guide_alicloud.rst:50 +msgid "Note that if you store your credentials in a vars_files, you need to refer to them in each Alicloud module. For example:" msgstr "èªè¨¼æƒ…å ±ã‚’ vars_file ã«ä¿å˜ã™ã‚‹å ´åˆã¯ã€å„ Alicloud モジュールã§èªè¨¼æƒ…å ±ã‚’å‚ç…§ã™ã‚‹å¿…è¦ãŒã‚ã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„。以下ã«ä¾‹ã‚’示ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:54 +#: ../../rst/scenario_guides/guide_alicloud.rst:62 #: ../../rst/scenario_guides/guide_rax.rst:86 msgid "Provisioning" msgstr "プãƒãƒ“ジョニング" -#: ../../rst/scenario_guides/guide_alicloud.rst:56 +#: ../../rst/scenario_guides/guide_alicloud.rst:64 msgid "Alicloud modules create Alicloud ECS instances, disks, virtual private clouds, virtual switches, security groups and other resources." msgstr "Alicloud モジュールã¯ã€Alicloud ECS インスタンスã€ãƒ‡ã‚£ã‚¹ã‚¯ã€ä»®æƒ³ãƒ—ライベートクラウドã€ä»®æƒ³ã‚¹ã‚¤ãƒƒãƒã€ã‚»ã‚ュリティーグループã€ãŠã‚ˆã³ãã®ä»–ã®ãƒªã‚½ãƒ¼ã‚¹ã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:58 +#: ../../rst/scenario_guides/guide_alicloud.rst:66 msgid "You can use the ``count`` parameter to control the number of resources you create or terminate. For example, if you want exactly 5 instances tagged ``NewECS``, set the ``count`` of instances to 5 and the ``count_tag`` to ``NewECS``, as shown in the last task of the example playbook below. If there are no instances with the tag ``NewECS``, the task creates 5 new instances. If there are 2 instances with that tag, the task creates 3 more. If there are 8 instances with that tag, the task terminates 3 of those instances." msgstr "``count`` パラメーターを使用ã—ã¦ã€ä½œæˆã¾ãŸã¯çµ‚了ã™ã‚‹ãƒªã‚½ãƒ¼ã‚¹ã®æ•°ã‚’制御ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ãŸã¨ãˆã°ã€``NewECS`` ã¨ã‚¿ã‚°ãŒä»˜ã„ãŸã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ãŒ 5 ã¤å¿…è¦ãªå ´åˆã¯ã€ä»¥ä¸‹ã® Playbook ã®ä¾‹ã®æœ€å¾Œã®ã‚¿ã‚¹ã‚¯ã®ã‚ˆã†ã«ã€ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã® ``count`` ã‚’ 5 ã«ã€``count_tag`` ã‚’ ``NewECS`` ã«ã€ãã‚Œãžã‚Œè¨å®šã—ã¾ã™ã€‚タグ㌠``NewECS`` ã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ãŒãªã„å ´åˆã€ã‚¿ã‚¹ã‚¯ã¯ 5 ã¤ã®æ–°è¦ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã‚’作æˆã—ã¾ã™ã€‚ãã®ã‚¿ã‚°ã‚’æŒã¤ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ãŒ 2 ã¤ã‚ã‚‹å ´åˆã€ã“ã®ã‚¿ã‚¹ã‚¯ã¯ã•ã‚‰ã« 3 ã¤ã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã‚’作æˆã—ã¾ã™ã€‚ãã®ã‚¿ã‚°ã‚’æŒã¤ 8 ã¤ã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ãŒã‚ã‚‹å ´åˆã€ã‚¿ã‚¹ã‚¯ã¯ãã®ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã®ã†ã¡ 3 ã¤ã‚’終了ã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:63 +#: ../../rst/scenario_guides/guide_alicloud.rst:71 msgid "If you do not specify a ``count_tag``, the task creates the number of instances you specify in ``count`` with the ``instance_name`` you provide." msgstr "``count_tag`` を指定ã—ãªã„ã¨ã€ã‚¿ã‚¹ã‚¯ã¯ã€æŒ‡å®šã—㟠``instance_name`` 㧠``count`` ã«æŒ‡å®šã—ãŸã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã®æ•°ã‚’作æˆã—ã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:121 +#: ../../rst/scenario_guides/guide_alicloud.rst:129 msgid "In the example playbook above, data about the vpc, vswitch, group, and instances created by this playbook are saved in the variables defined by the \"register\" keyword in each task." msgstr "上記ã®ã‚µãƒ³ãƒ—ル Playbook ã§ã¯ã€ã“ã® Playbook ã§ä½œæˆã•ã‚Œã‚‹ vpcã€vswitchã€groupã€ãŠã‚ˆã³ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã«é–¢ã™ã‚‹ãƒ‡ãƒ¼ã‚¿ãŒã€å„タスクã®ã€Œregisterã€ã‚ーワードã§å®šç¾©ã•ã‚Œã‚‹å¤‰æ•°ã«ä¿å˜ã•ã‚Œã¾ã™ã€‚" -#: ../../rst/scenario_guides/guide_alicloud.rst:124 +#: ../../rst/scenario_guides/guide_alicloud.rst:132 msgid "Each Alicloud module offers a variety of parameter options. Not all options are demonstrated in the above example. See each individual module for further details and examples." msgstr "å„ Alicloud モジュールã¯ã€ã•ã¾ã–ã¾ãªãƒ‘ラメーターオプションをæä¾›ã—ã¾ã™ã€‚上記ã®ä¾‹ã§ã€ã™ã¹ã¦ã®ã‚ªãƒ—ションãŒç¤ºã•ã‚Œã¦ã„ã‚‹ã‚ã‘ã§ã¯ã‚ã‚Šã¾ã›ã‚“。詳細ãŠã‚ˆã³ã‚µãƒ³ãƒ—ルã¯ã€å„モジュールをå‚ç…§ã—ã¦ãã ã•ã„。" @@ -1044,7 +1044,7 @@ msgid "Using Environment Variables" msgstr "è¿½åŠ ã®ç’°å¢ƒå¤‰æ•°" #: ../../rst/scenario_guides/guide_azure.rst:80 -msgid "To pass service principal credentials via the environment, define the following variables:" +msgid "To pass service principal credentials through the environment, define the following variables:" msgstr "環境経由ã§ã‚µãƒ¼ãƒ“スプリンシパルã®èªè¨¼æƒ…å ±ã‚’æ¸¡ã™ã«ã¯ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’定義ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_azure.rst:82 @@ -1067,7 +1067,7 @@ msgid "AZURE_TENANT" msgstr "AZURE_TENANT" #: ../../rst/scenario_guides/guide_azure.rst:87 -msgid "To pass Active Directory username/password via the environment, define the following variables:" +msgid "To pass Active Directory username/password through the environment, define the following variables:" msgstr "環境経由㧠Active Directory ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼å/パスワードを渡ã™ã«ã¯ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’定義ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_azure.rst:89 @@ -1081,8 +1081,8 @@ msgid "AZURE_PASSWORD" msgstr "AZURE_PASSWORD" #: ../../rst/scenario_guides/guide_azure.rst:93 -msgid "To pass Active Directory username/password in ADFS via the environment, define the following variables:" -msgstr "環境経由㧠Active Directory ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼å/パスワードを渡ã™ã«ã¯ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’定義ã—ã¾ã™ã€‚" +msgid "To pass Active Directory username/password in ADFS through the environment, define the following variables:" +msgstr "環境経由㧠ADFS ã« Active Directory ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼å/パスワードを渡ã™ã«ã¯ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’定義ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_azure.rst:99 msgid "AZURE_ADFS_AUTHORITY_URL" @@ -1380,7 +1380,7 @@ msgid "Disabling certificate validation on Azure endpoints" msgstr "Azure エンドãƒã‚¤ãƒ³ãƒˆã§ã®è¨¼æ˜Žæ›¸æ¤œè¨¼ã®ç„¡åŠ¹åŒ–" #: ../../rst/scenario_guides/guide_azure.rst:478 -msgid "When an HTTPS proxy is present, or when using Azure Stack, it may be necessary to disable certificate validation for Azure endpoints in the Azure modules. This is not a recommended security practice, but may be necessary when the system CA store cannot be altered to include the necessary CA certificate. Certificate validation can be controlled by setting the \"cert_validation_mode\" value in a credential profile, via the \"AZURE_CERT_VALIDATION_MODE\" environment variable, or by passing the \"cert_validation_mode\" argument to any Azure module. The default value is \"validate\"; setting the value to \"ignore\" will prevent all certificate validation. The module argument takes precedence over a credential profile value, which takes precedence over the environment value." +msgid "When an HTTPS proxy is present, or when using Azure Stack, it may be necessary to disable certificate validation for Azure endpoints in the Azure modules. This is not a recommended security practice, but may be necessary when the system CA store cannot be altered to include the necessary CA certificate. Certificate validation can be controlled by setting the \"cert_validation_mode\" value in a credential profile, through the \"AZURE_CERT_VALIDATION_MODE\" environment variable, or by passing the \"cert_validation_mode\" argument to any Azure module. The default value is \"validate\"; setting the value to \"ignore\" will prevent all certificate validation. The module argument takes precedence over a credential profile value, which takes precedence over the environment value." msgstr "HTTPS プãƒã‚シーãŒå˜åœ¨ã™ã‚‹å ´åˆã€ã¾ãŸã¯ Azure Stack を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€Azure モジュール㧠Azure エンドãƒã‚¤ãƒ³ãƒˆã®è¨¼æ˜Žæ›¸æ¤œè¨¼ã‚’無効ã«ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯æŽ¨å¥¨ã•ã‚Œã‚‹ã‚»ã‚ュリティー対ç–ã§ã¯ã‚ã‚Šã¾ã›ã‚“ãŒã€ã‚·ã‚¹ãƒ†ãƒ CA ストアを変更ã—ã¦å¿…è¦ãª CA 証明書をå«ã‚ã‚‹ã“ã¨ãŒã§ããªã„å ´åˆã«å¿…è¦ã«ãªã‚‹ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚証明書ã®æ¤œè¨¼ã¯ã€èªè¨¼æƒ…å ±ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ã§ã€Œcert_validation_modeã€å€¤ã‚’è¨å®šã™ã‚‹ã‹ã€ç’°å¢ƒå¤‰æ•°ã€ŒAZURE_CERT_VALIDATION_MODEã€ã‚’経由ã™ã‚‹ã‹ã€ã€Œcert_validation_modeã€å¼•æ•°ã‚’ä»»æ„ã® Azure モジュールã«æ¸¡ã™ã“ã¨ã§åˆ¶å¾¡ã§ãã¾ã™ã€‚デフォルト値ã¯ã€Œvalidateã€ã§ã€ã€Œignoreã€ã«è¨å®šã™ã‚‹ã¨è¨¼æ˜Žæ›¸ã®æ¤œè¨¼ã¯è¡Œã‚ã‚Œã¾ã›ã‚“。モジュールã®å¼•æ•°ã¯ã€ç’°å¢ƒã®å€¤ã‚ˆã‚Šã‚‚優先ã•ã‚Œã‚‹èªè¨¼æƒ…å ±ãƒ—ãƒãƒ•ã‚¡ã‚¤ãƒ«ã®å€¤ã‚ˆã‚Šã‚‚優先ã•ã‚Œã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_cloudstack.rst:2 @@ -1925,7 +1925,7 @@ msgstr "project" #: ../../rst/scenario_guides/guide_gce.rst:274 msgid "name" -msgstr "name" +msgstr "åå‰" #: ../../rst/scenario_guides/guide_gce.rst:274 msgid "This field does not accept an array of names. Use a loop to create multiple instances." @@ -2210,7 +2210,7 @@ msgstr "ã¾ãŸã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªãƒ¼ (``etc/ansible/hosts #: ../../rst/scenario_guides/guide_infoblox.rst:283 msgid "`Infoblox website <https://www.infoblox.com//>`_" -msgstr "`Infoblox Web サイト <https://www.infoblox.com//>`_" +msgstr "`Infoblox website <https://www.infoblox.com//>`_" #: ../../rst/scenario_guides/guide_infoblox.rst:284 msgid "The Infoblox website" @@ -2536,7 +2536,7 @@ msgstr "Ansible ã‚’ root ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã‚’実行ã #: ../../rst/scenario_guides/guide_oracle.rst:66 #: ../../rst/scenario_guides/guide_vultr.rst:16 msgid "Configuration" -msgstr "è¨å®š" +msgstr "Configuration (構æˆ)" #: ../../rst/scenario_guides/guide_oracle.rst:68 msgid "When creating and configuring Oracle Cloud Infrastructure resources, Ansible modules use the authentication information outlined `here <https://docs.cloud.oracle.com/iaas/Content/API/Concepts/sdkconfig.htm>`_. ." @@ -2623,7 +2623,7 @@ msgid "Packet.net Guide" msgstr "Packet.net ガイド" #: ../../rst/scenario_guides/guide_packet.rst:8 -msgid "`Packet.net <https://packet.net>`_ is a bare metal infrastructure host that's supported by Ansible (>=2.3) via a dynamic inventory script and two cloud modules. The two modules are:" +msgid "`Packet.net <https://packet.net>`_ is a bare metal infrastructure host that's supported by Ansible (>=2.3) through a dynamic inventory script and two cloud modules. The two modules are:" msgstr "`Packet.net <https://packet.net>`_ ã¯ã€å‹•çš„インベントリースクリプト㨠2 ã¤ã®ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’介ã—㦠Ansible (2.3 以é™) ã§å¯¾å¿œã—ã¦ã„るベアメタルインフラストラクãƒãƒ£ãƒ¼ãƒ›ã‚¹ãƒˆã§ã™ã€‚ã“ã® 2 ã¤ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯æ¬¡ã®ã¨ãŠã‚Šã§ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:10 @@ -2636,27 +2636,27 @@ msgstr "packet_device: パケット上ã®ã‚µãƒ¼ãƒãƒ¼ã‚’管ç†ã—ã¾ã™ã€‚ã“ã® #: ../../rst/scenario_guides/guide_packet.rst:13 msgid "Note, this guide assumes you are familiar with Ansible and how it works. If you're not, have a look at their :ref:`docs <ansible_documentation>` before getting started." -msgstr "本ガイドã§ã¯ã€Ansible ã«ç²¾é€šã—ã¦ã„ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚Ansible ã«ã‚ã¾ã‚Šç²¾é€šã—ã¦ã„ãªã„å ´åˆã¯ã€é–‹å§‹ã™ã‚‹å‰ã«ã€Œ:ref:`docs <ansible_documentation>`ã€ã‚’ãŠèªã¿ãã ã•ã„。" +msgstr "注記: 本ガイドã§ã¯ã€Ansible ã«ç²¾é€šã—ã¦ã„ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚Ansible ã«ã‚ã¾ã‚Šç²¾é€šã—ã¦ã„ãªã„å ´åˆã¯ã€é–‹å§‹ã™ã‚‹å‰ã«ã€Œ:ref:`docs <ansible_documentation>`ã€ã‚’ãŠèªã¿ãã ã•ã„。" #: ../../rst/scenario_guides/guide_packet.rst:18 msgid "The Packet modules and inventory script connect to the Packet API using the packet-python package. You can install it with pip:" msgstr "Packet モジュールã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯ã€packets-python パッケージを使用ã—㦠Packet API ã«æŽ¥ç¶šã—ã¾ã™ã€‚ã“ã‚Œã¯ã€pip ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:24 -msgid "In order to check the state of devices created by Ansible on Packet, it's a good idea to install one of the `Packet CLI clients <https://www.packet.net/developers/integrations/>`_. Otherwise you can check them via the `Packet portal <https://app.packet.net/portal>`_." +msgid "In order to check the state of devices created by Ansible on Packet, it's a good idea to install one of the `Packet CLI clients <https://www.packet.net/developers/integrations/>`_. Otherwise you can check them through the `Packet portal <https://app.packet.net/portal>`_." msgstr "パケット上㧠Ansible ãŒä½œæˆã—ãŸãƒ‡ãƒã‚¤ã‚¹ã®çŠ¶æ…‹ã‚’ãƒã‚§ãƒƒã‚¯ã™ã‚‹ã«ã¯ã€`Packet CLI clients <https://www.packet.net/developers/integrations/>`_ ã®ã„ãšã‚Œã‹ã‚’インストールã™ã‚‹ã“ã¨ãŒæŽ¨å¥¨ã•ã‚Œã¾ã™ã€‚ãã†ã§ãªã„å ´åˆã¯ã€`Packet portal <https://app.packet.net/portal>`_ ã§ç¢ºèªã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:26 -msgid "To use the modules and inventory script you'll need a Packet API token. You can generate an API token via the Packet portal `here <https://app.packet.net/portal#/api-keys>`__. The simplest way to authenticate yourself is to set the Packet API token in an environment variable:" -msgstr "モジュールãŠã‚ˆã³ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã«ã¯ã€ãƒ‘ケット API トークンãŒå¿…è¦ã§ã™ã€‚パケットãƒãƒ¼ã‚¿ãƒ« (`ã“ã¡ã‚‰ <https://app.packet.net/portal#/api-keys>`__) を使用ã—㦠API トークンを生æˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚èªè¨¼ã™ã‚‹æœ€ã‚‚ç°¡å˜ãªæ–¹æ³•ã¯ã€ç’°å¢ƒå¤‰æ•°ã§ Packet API トークンをè¨å®šã™ã‚‹ã“ã¨ã§ã™ã€‚" +msgid "To use the modules and inventory script you'll need a Packet API token. You can generate an API token through the Packet portal `here <https://app.packet.net/portal#/api-keys>`__. The simplest way to authenticate yourself is to set the Packet API token in an environment variable:" +msgstr "モジュールãŠã‚ˆã³ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã«ã¯ã€ãƒ‘ケット API トークンãŒå¿…è¦ã§ã™ã€‚パケットãƒãƒ¼ã‚¿ãƒ« (`here <https://app.packet.net/portal#/api-keys>`__) を使用ã—㦠API トークンを生æˆã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚èªè¨¼ã™ã‚‹æœ€ã‚‚ç°¡å˜ãªæ–¹æ³•ã¯ã€ç’°å¢ƒå¤‰æ•°ã§ Packet API トークンをè¨å®šã™ã‚‹ã“ã¨ã§ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:32 msgid "If you're not comfortable exporting your API token, you can pass it as a parameter to the modules." msgstr "API トークンã®ã‚¨ã‚¯ã‚¹ãƒãƒ¼ãƒˆãŒä¸æ˜Žãªå ´åˆã¯ã€ã“れをパラメーターã¨ã—ã¦ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«æ¸¡ã™ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:34 -msgid "On Packet, devices and reserved IP addresses belong to `projects <https://www.packet.com/developers/api/#projects>`_. In order to use the packet_device module, you need to specify the UUID of the project in which you want to create or manage devices. You can find a project's UUID in the Packet portal `here <https://app.packet.net/portal#/projects/list/table/>`_ (it's just under the project table) or via one of the available `CLIs <https://www.packet.net/developers/integrations/>`_." -msgstr "パケットã§ã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã¨äºˆç´„済ã¿ã® IP アドレスã¯ã€`プãƒã‚¸ã‚§ã‚¯ãƒˆ <https://www.packet.com/developers/api/#projects>`_ ã«å±žã—ã¾ã™ã€‚packet_device モジュールを使用ã™ã‚‹ã«ã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã®ä½œæˆã¾ãŸã¯ç®¡ç†ã‚’è¡Œã†ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã® UUID を指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プãƒã‚¸ã‚§ã‚¯ãƒˆã® UUID ã¯ã€ãƒ‘ケットãƒãƒ¼ã‚¿ãƒ« (`ã“ã¡ã‚‰ <https://app.packet.net/portal#/projects/list/table/>`_ (プãƒã‚¸ã‚§ã‚¯ãƒˆãƒ†ãƒ¼ãƒ–ルã®ã™ã下ã«ã‚ã‚Šã¾ã™)) ã¾ãŸã¯åˆ©ç”¨å¯èƒ½ãª `CLI <https://www.packet.net/developers/integrations/>`_ ã®ã„ãšã‚Œã‹ã‚’介ã—ã¦è¦‹ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "On Packet, devices and reserved IP addresses belong to `projects <https://www.packet.com/developers/api/#projects>`_. In order to use the packet_device module, you need to specify the UUID of the project in which you want to create or manage devices. You can find a project's UUID in the Packet portal `here <https://app.packet.net/portal#/projects/list/table/>`_ (it's just under the project table) or through one of the available `CLIs <https://www.packet.net/developers/integrations/>`_." +msgstr "パケットã§ã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã¨äºˆç´„済ã¿ã® IP アドレスã¯ã€`projects <https://www.packet.com/developers/api/#projects>`_ ã«å±žã—ã¾ã™ã€‚packet_device モジュールを使用ã™ã‚‹ã«ã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã®ä½œæˆã¾ãŸã¯ç®¡ç†ã‚’è¡Œã†ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã® UUID を指定ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚プãƒã‚¸ã‚§ã‚¯ãƒˆã® UUID ã¯ã€ãƒ‘ケットãƒãƒ¼ã‚¿ãƒ« (`here <https://app.packet.net/portal#/projects/list/table/>`_ (プãƒã‚¸ã‚§ã‚¯ãƒˆãƒ†ãƒ¼ãƒ–ルã®ã™ã下ã«ã‚ã‚Šã¾ã™)) ã¾ãŸã¯åˆ©ç”¨å¯èƒ½ãª `CLIs <https://www.packet.net/developers/integrations/>`_ ã®ã„ãšã‚Œã‹ã‚’介ã—ã¦è¦‹ã¤ã‘ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:37 #: ../../rst/scenario_guides/guide_scaleway.rst:39 @@ -2673,12 +2673,12 @@ msgid "Device Creation" msgstr "デãƒã‚¤ã‚¹ã®ä½œæˆ" #: ../../rst/scenario_guides/guide_packet.rst:49 -msgid "The following code block is a simple playbook that creates one `Type 0 <https://www.packet.com/cloud/servers/t1-small/>`_ server (the 'plan' parameter). You have to supply 'plan' and 'operating_system'. 'location' defaults to 'ewr1' (Parsippany, NJ). You can find all the possible values for the parameters via a `CLI client <https://www.packet.net/developers/integrations/>`_." -msgstr "以下ã®ã‚³ãƒ¼ãƒ‰ãƒ–ãƒãƒƒã‚¯ã¯ã€`Type 0 <https://www.packet.com/cloud/servers/t1-small/>`_ サーãƒãƒ¼ (「planã€ãƒ‘ラメーター) を作æˆã™ã‚‹ç°¡å˜ãª Playbook ã§ã™ã€‚「planã€ãŠã‚ˆã³ã€Œoperating_systemã€ã‚’定義ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚「locationã€ã¯ã€ã€Œewr1ã€(Parsippanyã€NJ) ã«è¨å®šã•ã‚Œã¾ã™ã€‚`CLI クライアント <https://www.packet.net/developers/integrations/>`_ を介ã—ã¦ã€ãƒ‘ラメーターã§å¯èƒ½ãªå€¤ã‚’ã™ã¹ã¦ç¢ºèªã§ãã¾ã™ã€‚" +msgid "The following code block is a simple playbook that creates one `Type 0 <https://www.packet.com/cloud/servers/t1-small/>`_ server (the 'plan' parameter). You have to supply 'plan' and 'operating_system'. 'location' defaults to 'ewr1' (Parsippany, NJ). You can find all the possible values for the parameters through a `CLI client <https://www.packet.net/developers/integrations/>`_." +msgstr "以下ã®ã‚³ãƒ¼ãƒ‰ãƒ–ãƒãƒƒã‚¯ã¯ã€`Type 0 <https://www.packet.com/cloud/servers/t1-small/>`_ サーãƒãƒ¼ (「planã€ãƒ‘ラメーター) を作æˆã™ã‚‹ç°¡å˜ãª Playbook ã§ã™ã€‚「planã€ãŠã‚ˆã³ã€Œoperating_systemã€ã‚’定義ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚「locationã€ã¯ã€ã€Œewr1ã€(Parsippanyã€NJ) ã«è¨å®šã•ã‚Œã¾ã™ã€‚`CLI client <https://www.packet.net/developers/integrations/>`_ を介ã—ã¦ã€ãƒ‘ラメーターã§å¯èƒ½ãªå€¤ã‚’ã™ã¹ã¦ç¢ºèªã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:70 -msgid "After running ``ansible-playbook playbook_create.yml``, you should have a server provisioned on Packet. You can verify via a CLI or in the `Packet portal <https://app.packet.net/portal#/projects/list/table>`__." -msgstr "``ansible-playbook playbook_create.yml`` ã®å®Ÿè¡Œå¾Œã«ã€ãƒ‘ケット上ã«ã‚µãƒ¼ãƒãƒ¼ã‚’プãƒãƒ“ジョニングã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚CLI ã¾ãŸã¯ `パケットãƒãƒ¼ã‚¿ãƒ« <https://app.packet.net/portal#/projects/list/table>`__ ã§ç¢ºèªã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" +msgid "After running ``ansible-playbook playbook_create.yml``, you should have a server provisioned on Packet. You can verify through a CLI or in the `Packet portal <https://app.packet.net/portal#/projects/list/table>`__." +msgstr "``ansible-playbook playbook_create.yml`` ã®å®Ÿè¡Œå¾Œã«ã€ãƒ‘ケット上ã«ã‚µãƒ¼ãƒãƒ¼ã‚’プãƒãƒ“ジョニングã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚CLI ã¾ãŸã¯ `Packet portal <https://app.packet.net/portal#/projects/list/table>`__ ã§ç¢ºèªã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:72 msgid "If you get an error with the message \"failed to set machine state present, error: Error 404: Not Found\", please verify your project UUID." @@ -2746,7 +2746,7 @@ msgid "As with most Ansible modules, the default states of the Packet modules ar msgstr "ã»ã¨ã‚“ã©ã® Ansible モジュールã¨åŒæ§˜ã«ã€Packet モジュールã®ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆçŠ¶æ…‹ã¯å†ªç‰ã§ã™ã€‚ã¤ã¾ã‚Šã€Playbook ã‚’å†å®Ÿè¡Œã—ãŸå¾Œã‚‚プãƒã‚¸ã‚§ã‚¯ãƒˆã®ãƒªã‚½ãƒ¼ã‚¹ã¯åŒã˜ã¾ã¾ã«ãªã‚Šã¾ã™ã€‚ã—ãŸãŒã£ã¦ã€Playbook 㧠``packet_sshkey`` モジュールã®å‘¼ã³å‡ºã—ã‚’ç¶æŒã§ãã¾ã™ã€‚パブリックã‚ーãŒã™ã§ã«ãƒ‘ケットアカウントã«ã‚ã‚‹å ´åˆã¯ã€å‘¼ã³å‡ºã—ã¦ã‚‚効果ãŒã‚ã‚Šã¾ã›ã‚“。" #: ../../rst/scenario_guides/guide_packet.rst:186 -msgid "The second module call provisions 3 Packet Type 0 (specified using the 'plan' parameter) servers in the project identified via the 'project_id' parameter. The servers are all provisioned with CoreOS beta (the 'operating_system' parameter) and are customized with cloud-config user data passed to the 'user_data' parameter." +msgid "The second module call provisions 3 Packet Type 0 (specified using the 'plan' parameter) servers in the project identified by the 'project_id' parameter. The servers are all provisioned with CoreOS beta (the 'operating_system' parameter) and are customized with cloud-config user data passed to the 'user_data' parameter." msgstr "2 ã¤ç›®ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«å‘¼ã³å‡ºã—ã¯ã€ã€Œproject_idã€ãƒ‘ラメーターã§è˜åˆ¥ã•ã‚Œã‚‹ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã® 3 Packet タイプ 0 (「planã€ãƒ‘ラメーターã§æŒ‡å®š) サーãƒãƒ¼ã‚’プãƒãƒ“ジョニングã—ã¾ã™ã€‚サーãƒãƒ¼ã¯ã™ã¹ã¦ CoreOS ベータã§ãƒ—ãƒãƒ“ジョニングã•ã‚Œ (「operating_systemã€ãƒ‘ラメーター)ã€ã€Œuser_dataã€ãƒ‘ラメーターã«æ¸¡ã•ã‚Œã‚‹ cloud-config ユーザーデータã§ã‚«ã‚¹ã‚¿ãƒžã‚¤ã‚ºã•ã‚Œã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:188 @@ -2758,7 +2758,7 @@ msgid "Run the playbook:" msgstr "Playbook を実行ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:196 -msgid "Once the playbook quits, your new devices should be reachable via SSH. Try to connect to one and check if etcd has started properly:" +msgid "Once the playbook quits, your new devices should be reachable through SSH. Try to connect to one and check if etcd has started properly:" msgstr "Playbook ãŒçµ‚了ã™ã‚‹ã¨ã€SSH を介ã—ã¦æ–°è¦ãƒ‡ãƒã‚¤ã‚¹ã«ã‚¢ã‚¯ã‚»ã‚¹ã§ãã‚‹ã¯ãšã§ã™ã€‚1 ã¤ã®ãƒ‡ãƒã‚¤ã‚¹ã«æŽ¥ç¶šã—ã¦ã€etcd ãŒæ£å¸¸ã«èµ·å‹•ã—ãŸã‹ã©ã†ã‹ã‚’確èªã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_packet.rst:203 @@ -2834,7 +2834,7 @@ msgid "Prerequisites for using the rax modules are minimal. In addition to ansi msgstr "rax モジュール使用ã®å‰ææ¡ä»¶ã¯æœ€å°é™ã§ã™ã€‚Ansible 自体ã®ä»–ã«ã€ã™ã¹ã¦ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒå¿…è¦ã§ã€pyrax 1.5 以é™ã«å¯¾ã—ã¦ãƒ†ã‚¹ãƒˆã•ã‚Œã¦ã„ã¾ã™ã€‚実行ホストã«ã€ã“ã® Python モジュールをインストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_rax.rst:20 -msgid "``pyrax`` is not currently available in many operating system package repositories, so you will likely need to install it via pip:" +msgid "``pyrax`` is not currently available in many operating system package repositories, so you will likely need to install it through pip:" msgstr "``pyrax`` ã¯ã€ç¾åœ¨å¤šãã®ã‚ªãƒšãƒ¬ãƒ¼ãƒ†ã‚£ãƒ³ã‚°ã‚·ã‚¹ãƒ†ãƒ パッケージリãƒã‚¸ãƒˆãƒªãƒ¼ã§ã¯åˆ©ç”¨ã§ããªã„ãŸã‚ã€pip を使用ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_rax.rst:27 @@ -2870,7 +2870,7 @@ msgid "Most users will not be using virtualenv, but some users, particularly Pyt msgstr "ã»ã¨ã‚“ã©ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã¯ virtualenv を使用ã—ã¾ã›ã‚“ãŒã€ä¸€éƒ¨ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ã€ç‰¹ã« Python ã®é–‹ç™ºè€…ã¯ãれを使用ã™ã‚‹å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_rax.rst:72 -msgid "There are special considerations when Ansible is installed to a Python virtualenv, rather than the default of installing at a global scope. Ansible assumes, unless otherwise instructed, that the python binary will live at /usr/bin/python. This is done via the interpreter line in modules, however when instructed by setting the inventory variable 'ansible_python_interpreter', Ansible will use this specified path instead to find Python. This can be a cause of confusion as one may assume that modules running on 'localhost', or perhaps running via 'local_action', are using the virtualenv Python interpreter. By setting this line in the inventory, the modules will execute in the virtualenv interpreter and have available the virtualenv packages, specifically pyrax. If using virtualenv, you may wish to modify your localhost inventory definition to find this location as follows:" +msgid "There are special considerations when Ansible is installed to a Python virtualenv, rather than the default of installing at a global scope. Ansible assumes, unless otherwise instructed, that the python binary will live at /usr/bin/python. This is done through the interpreter line in modules, however when instructed by setting the inventory variable 'ansible_python_interpreter', Ansible will use this specified path instead to find Python. This can be a cause of confusion as one may assume that modules running on 'localhost', or perhaps running through 'local_action', are using the virtualenv Python interpreter. By setting this line in the inventory, the modules will execute in the virtualenv interpreter and have available the virtualenv packages, specifically pyrax. If using virtualenv, you may wish to modify your localhost inventory definition to find this location as follows:" msgstr "Ansible ㌠Python virtualenv ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã‚‹å ´åˆã«ã¯ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ã‚°ãƒãƒ¼ãƒãƒ«ã‚¹ã‚³ãƒ¼ãƒ—ã§ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ã¯ãªãã€ç‰¹åˆ¥ãªè€ƒæ…®äº‹é …ãŒã‚ã‚Šã¾ã™ã€‚Ansible ã¯ã€ç‰¹ã«æŒ‡ç¤ºãŒãªã„é™ã‚Šã€Python ã®ãƒã‚¤ãƒŠãƒªãƒ¼ã‚’ /usr/bin/python ã«ç½®ãã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ—リターã®è¡Œã‹ã‚‰è¡Œã‚ã‚Œã¾ã™ãŒã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼å¤‰æ•°ã€Œansible_python_interpreterã€ã‚’è¨å®šã—ã¦æŒ‡ç¤ºã™ã‚‹ã¨ã€Ansible 㯠Python ã®æ¤œç´¢ã®ä»£ã‚ã‚Šã«ã€ã“ã®æŒ‡å®šã•ã‚ŒãŸãƒ‘スを使用ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ã€Œlocalhostã€ã§å®Ÿè¡Œã—ã¦ã„るモジュールã€ã¾ãŸã¯ã€Œlocal_actionã€ã§å®Ÿè¡Œã•ã‚Œã‚‹ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒ virtualenv Python インタープリターを使用ã—ã¦ã„ã‚‹ã¨æ€ã„込んã§ã—ã¾ã†ãŸã‚ã€æ··ä¹±ãŒç”Ÿã˜ã‚‹å¯èƒ½æ€§ãŒã‚ã‚Šã¾ã™ã€‚ã“ã®è¡Œã‚’インベントリーã«è¨å®šã™ã‚‹ã¨ã€ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ virtualenv インタープリターã§å®Ÿè¡Œã—ã€virtualenv パッケージ (具体的ã«ã¯ pyrax) ãŒåˆ©ç”¨ã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚virtualenv を使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ä»¥ä¸‹ã®ã‚ˆã†ã«ã€localhost インベントリー定義を変更ã—ã¦ã“ã®å ´æ‰€ãŒæ¤œå‡ºã•ã‚Œã‚‹ã‚ˆã†ã«ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_rax.rst:81 @@ -2926,7 +2926,7 @@ msgid "Host Inventory" msgstr "ホストインベントリー" #: ../../rst/scenario_guides/guide_rax.rst:157 -msgid "Once your nodes are spun up, you'll probably want to talk to them again. The best way to handle this is to use the \"rax\" inventory plugin, which dynamically queries Rackspace Cloud and tells Ansible what nodes you have to manage. You might want to use this even if you are spinning up cloud instances via other tools, including the Rackspace Cloud user interface. The inventory plugin can be used to group resources by metadata, region, OS, and so on. Utilizing metadata is highly recommended in \"rax\" and can provide an easy way to sort between host groups and roles. If you don't want to use the ``rax.py`` dynamic inventory script, you could also still choose to manually manage your INI inventory file, though this is less recommended." +msgid "Once your nodes are spun up, you'll probably want to talk to them again. The best way to handle this is to use the \"rax\" inventory plugin, which dynamically queries Rackspace Cloud and tells Ansible what nodes you have to manage. You might want to use this even if you are spinning up cloud instances through other tools, including the Rackspace Cloud user interface. The inventory plugin can be used to group resources by metadata, region, OS, and so on. Utilizing metadata is highly recommended in \"rax\" and can provide an easy way to sort between host groups and roles. If you don't want to use the ``rax.py`` dynamic inventory script, you could also still choose to manually manage your INI inventory file, though this is less recommended." msgstr "ノードãŒèµ·å‹•ã—ãŸã‚‰ã€å†ã³ãƒŽãƒ¼ãƒ‰ã¨ã‚„ã‚Šå–ã‚Šã—ãŸããªã‚‹ã§ã—ょã†ã€‚ã“れを処ç†ã™ã‚‹æœ€å–„ã®æ–¹æ³•ã¯ã€ã€Œraxã€ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ãƒ—ラグインを使用ã™ã‚‹ã“ã¨ã§ã™ã€‚ã“ã‚Œã¯ã€Rackspace Cloud ã«å‹•çš„ã«ã‚¯ã‚¨ãƒªãƒ¼ã‚’実行ã—ã€ç®¡ç†ã™ã‚‹å¿…è¦ãŒã‚るノードを Ansible ã«é€šçŸ¥ã—ã¾ã™ã€‚Rackspace Cloud ユーザーインターフェースãªã©ã€ä»–ã®ãƒ„ールã§ã‚¯ãƒ©ã‚¦ãƒ‰ã‚¤ãƒ³ã‚¹ã‚¿ãƒ³ã‚¹ã‚’èµ·å‹•ã—ã¦ã„ã‚‹å ´åˆã§ã‚‚ã€ã“ã®ãƒ—ラグインを使用ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚インベントリープラグインã¯ã€ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã€ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã€OS ãªã©ã§ãƒªã‚½ãƒ¼ã‚¹ã‚’グループ化ã™ã‚‹ãŸã‚ã«ä½¿ç”¨ã§ãã¾ã™ã€‚メタデータã®ä½¿ç”¨ã¯ã€Œraxã€ã§å¼·ã推奨ã•ã‚Œã€ãƒ›ã‚¹ãƒˆã‚°ãƒ«ãƒ¼ãƒ—ã¨ãƒãƒ¼ãƒ«ã¨ã®é–“ã§ç°¡å˜ã«ä¸¦ã¹æ›¿ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚``rax.py`` ダイナミックインベントリースクリプトを使用ã—ãŸããªã„å ´åˆã¯ã€INI インベントリーファイルを手動ã§ç®¡ç†ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ãŒã€ã“ã‚Œã¯ã‚ã¾ã‚ŠãŠå‹§ã‚ã§ãã¾ã›ã‚“。" #: ../../rst/scenario_guides/guide_rax.rst:159 @@ -3090,7 +3090,7 @@ msgid "Scaleway Guide" msgstr "Scaleway ガイド" #: ../../rst/scenario_guides/guide_scaleway.rst:12 -msgid "`Scaleway <https://scaleway.com>`_ is a cloud provider supported by Ansible, version 2.6 or higher via a dynamic inventory plugin and modules. Those modules are:" +msgid "`Scaleway <https://scaleway.com>`_ is a cloud provider supported by Ansible, version 2.6 or higher through a dynamic inventory plugin and modules. Those modules are:" msgstr "`Scaleway <https://scaleway.com>`_ ã¯ã€å‹•çš„インベントリープラグインãŠã‚ˆã³ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’介ã—㦠Ansible (ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 2.6 以é™) ãŒå¯¾å¿œã™ã‚‹ã‚¯ãƒ©ã‚¦ãƒ‰ãƒ—ãƒãƒã‚¤ãƒ€ãƒ¼ã§ã™ã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #: ../../rst/scenario_guides/guide_scaleway.rst:15 @@ -3110,8 +3110,8 @@ msgid "This guide assumes you are familiar with Ansible and how it works. If you msgstr "本ガイドã§ã¯ã€Ansible ã«ç²¾é€šã—ã¦ã„ã‚‹ã“ã¨ã‚’å‰æã¨ã—ã¦ã„ã¾ã™ã€‚Ansible ã«ã‚ã¾ã‚Šç²¾é€šã—ã¦ã„ãªã„å ´åˆã¯ã€é–‹å§‹ã™ã‚‹å‰ã«ã€Œ:ref:`ansible_documentation`ã€ã‚’ãŠèªã¿ãã ã•ã„。" #: ../../rst/scenario_guides/guide_scaleway.rst:28 -msgid "The Scaleway modules and inventory script connect to the Scaleway API using `Scaleway REST API <https://developer.scaleway.com>`_. To use the modules and inventory script you'll need a Scaleway API token. You can generate an API token via the Scaleway console `here <https://cloud.scaleway.com/#/credentials>`__. The simplest way to authenticate yourself is to set the Scaleway API token in an environment variable:" -msgstr "Scaleway モジュールã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯ã€`Scaleway REST API <https://developer.scaleway.com>`_ を使用ã—㦠Scaleway API ã«æŽ¥ç¶šã—ã¾ã™ã€‚モジュールã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã«ã¯ã€Scaleway API トークンãŒå¿…è¦ã§ã™ã€‚API トークンã¯ã€Scaleway コンソール (`ã“ã¡ã‚‰ <https://cloud.scaleway.com/#/credentials>`__) ã§ç”Ÿæˆã§ãã¾ã™ã€‚自身をèªè¨¼ã™ã‚‹æœ€ã‚‚ç°¡å˜ãªæ–¹æ³•ã¯ã€ç’°å¢ƒå¤‰æ•°ã« Scaleway API トークンをè¨å®šã™ã‚‹ã“ã¨ã§ã™ã€‚" +msgid "The Scaleway modules and inventory script connect to the Scaleway API using `Scaleway REST API <https://developer.scaleway.com>`_. To use the modules and inventory script you'll need a Scaleway API token. You can generate an API token through the Scaleway console `here <https://cloud.scaleway.com/#/credentials>`__. The simplest way to authenticate yourself is to set the Scaleway API token in an environment variable:" +msgstr "Scaleway モジュールã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トã¯ã€`Scaleway REST API <https://developer.scaleway.com>`_ を使用ã—㦠Scaleway API ã«æŽ¥ç¶šã—ã¾ã™ã€‚モジュールã¨ã‚¤ãƒ³ãƒ™ãƒ³ãƒˆãƒªãƒ¼ã‚¹ã‚¯ãƒªãƒ—トを使用ã™ã‚‹ã«ã¯ã€Scaleway API トークンãŒå¿…è¦ã§ã™ã€‚API トークンã¯ã€Scaleway コンソール (`here <https://cloud.scaleway.com/#/credentials>`__) ã§ç”Ÿæˆã§ãã¾ã™ã€‚自身をèªè¨¼ã™ã‚‹æœ€ã‚‚ç°¡å˜ãªæ–¹æ³•ã¯ã€ç’°å¢ƒå¤‰æ•°ã« Scaleway API トークンをè¨å®šã™ã‚‹ã“ã¨ã§ã™ã€‚" #: ../../rst/scenario_guides/guide_scaleway.rst:37 msgid "If you're not comfortable exporting your API token, you can pass it as a parameter to the modules using the ``api_token`` argument." @@ -3295,7 +3295,7 @@ msgstr "ãƒãƒ¼ã‚«ãƒ«ã® ``ansible.cfg`` è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã‚’çµ±åˆã™ã‚‹æ–¹æ³•" #: ../../rst/scenario_guides/guide_vagrant.rst:127 msgid "`Vagrant Home <https://www.vagrantup.com/>`_" -msgstr "`Vagrant ホーム<https://www.vagrantup.com/>`_" +msgstr "`Vagrant Home <https://www.vagrantup.com/>`_" #: ../../rst/scenario_guides/guide_vagrant.rst:128 msgid "The Vagrant homepage with downloads" @@ -3303,7 +3303,7 @@ msgstr "ダウンãƒãƒ¼ãƒ‰ã‚’å«ã‚€ Vagrant ホームページ" #: ../../rst/scenario_guides/guide_vagrant.rst:129 msgid "`Vagrant Documentation <https://www.vagrantup.com/docs/>`_" -msgstr "`Vagrant ドã‚ュメント <https://www.vagrantup.com/docs/>`_" +msgstr "`Vagrant Documentation <https://www.vagrantup.com/docs/>`_" #: ../../rst/scenario_guides/guide_vagrant.rst:130 msgid "Vagrant Documentation" @@ -3604,8 +3604,8 @@ msgid "All the vcenter_rest modules accept the following arguments:" msgstr "ã™ã¹ã¦ã® vcenter_rest モジュールã¯ã€ä»¥ä¸‹ã®å¼•æ•°ã‚’å—ã‘入れã¾ã™ã€‚" #: ../../rst/scenario_guides/vmware_rest_scenarios/authentication.rst:36 -msgid "``vcenter_host``" -msgstr "``vcenter_host``" +msgid "``vcenter_hostname``" +msgstr "``vcenter_hostname``" #: ../../rst/scenario_guides/vmware_rest_scenarios/authentication.rst:37 msgid "``vcenter_username``" @@ -3683,7 +3683,7 @@ msgstr "æƒ…å ±ã®åŽé›†æ–¹æ³•" #: ../../rst/scenario_guides/vmware_rest_scenarios/collect_information.rst:35 msgid "In these examples, we use the ``vcenter_*_info`` module to collect information about the associated resources." -msgstr "ã“ã®ä¾‹ã§ã¯ã€``vcenter_*_info`` モジュールを使用ã—ã¦ã€é–¢é€£ä»˜ã‘られãŸãƒªã‚½ãƒ¼ã‚¹ã«é–¢ã™ã‚‹æƒ…å ±ã‚’åŽé›†ã—ã¾ã™ã€‚" +msgstr "ã“れらã®ä¾‹ã§ã¯ã€``vcenter_*_info`` モジュールを使用ã—ã¦ã€é–¢é€£ä»˜ã‘られãŸãƒªã‚½ãƒ¼ã‚¹ã«é–¢ã™ã‚‹æƒ…å ±ã‚’åŽé›†ã—ã¾ã™ã€‚" #: ../../rst/scenario_guides/vmware_rest_scenarios/collect_information.rst:37 msgid "All these modules return a ``value`` key. Depending on the context, this ``value`` key will be either a list or a dictionary." @@ -3741,7 +3741,7 @@ msgstr "想定ã©ãŠã‚Šã«ã€å‡ºåŠ›ã® ``value`` ã‚ーã¯ãƒªã‚¹ãƒˆã«ãªã‚Šã¾ã #: ../../rst/scenario_guides/vmware_rest_scenarios/collect_information.rst:54 msgid "Cluster" -msgstr "クラスター" +msgstr "Cluster" #: ../../rst/scenario_guides/vmware_rest_scenarios/collect_information.rst:56 msgid "Here we do the same with ``vcenter_cluster_info``:" @@ -7203,4 +7203,7 @@ msgstr "仮想マシンã®ãƒ«ãƒ¼ãƒˆãƒ†ãƒ¼ãƒ–ルを確èªã™ã‚‹ã«ã¯ã€``vcenter #~ msgid "Wait for ``netplan`` support in ``open-vm-tools``" #~ msgstr "``open-vm-tools`` 㧠``netplan`` ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã‚‹ã®ã‚’å¾…ã¡ã¾ã™ã€‚" +#~ msgid "To pass Active Directory username/password in ADFS via the environment, define the following variables:" +#~ msgstr "環境経由㧠Active Directory ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼å/パスワードを渡ã™ã«ã¯ã€ä»¥ä¸‹ã®å¤‰æ•°ã‚’定義ã—ã¾ã™ã€‚" + diff --git a/docs/docsite/rst/playbook_guide/complex_data_manipulation.rst b/docs/docsite/rst/playbook_guide/complex_data_manipulation.rst index 11ed3c38..e7d23b33 100644 --- a/docs/docsite/rst/playbook_guide/complex_data_manipulation.rst +++ b/docs/docsite/rst/playbook_guide/complex_data_manipulation.rst @@ -230,7 +230,7 @@ These example produces ``{"a": "b", "c": "d"}`` vars: single_list: [ 'a', 'b', 'c', 'd' ] - mydict: "{{ dict(single_list | slice(2)) }}" + mydict: "{{ dict(single_list[::2] | zip_longest(single_list[1::2])) }}" .. code-block:: YAML+Jinja @@ -240,7 +240,7 @@ These example produces ``{"a": "b", "c": "d"}`` list_of_pairs: [ ['a', 'b'], ['c', 'd'] ] mydict: "{{ dict(list_of_pairs) }}" -Both end up being the same thing, with ``slice(2)`` transforming ``single_list`` to a ``list_of_pairs`` generator. +Both end up being the same thing, with ``zip_longest`` transforming ``single_list`` to a ``list_of_pairs`` generator. diff --git a/docs/docsite/rst/playbook_guide/playbooks_checkmode.rst b/docs/docsite/rst/playbook_guide/playbooks_checkmode.rst index 4b21f7cf..6b8c8277 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_checkmode.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_checkmode.rst @@ -27,8 +27,8 @@ Enforcing or preventing check mode on tasks If you want certain tasks to run in check mode always, or never, regardless of whether you run the playbook with or without ``--check``, you can add the ``check_mode`` option to those tasks: - - To force a task to run in check mode, even when the playbook is called without ``--check``, set ``check_mode: yes``. - - To force a task to run in normal mode and make changes to the system, even when the playbook is called with ``--check``, set ``check_mode: no``. + - To force a task to run in check mode, even when the playbook is called without ``--check``, set ``check_mode: true``. + - To force a task to run in normal mode and make changes to the system, even when the playbook is called with ``--check``, set ``check_mode: false``. For example: @@ -47,9 +47,9 @@ For example: check_mode: true register: changes_to_important_config -Running single tasks with ``check_mode: yes`` can be useful for testing Ansible modules, either to test the module itself or to test the conditions under which a module would make changes. You can register variables (see :ref:`playbooks_conditionals`) on these tasks for even more detail on the potential changes. +Running single tasks with ``check_mode: true`` can be useful for testing Ansible modules, either to test the module itself or to test the conditions under which a module would make changes. You can register variables (see :ref:`playbooks_conditionals`) on these tasks for even more detail on the potential changes. -.. note:: Prior to version 2.2 only the equivalent of ``check_mode: no`` existed. The notation for that was ``always_run: yes``. +.. note:: Prior to version 2.2 only the equivalent of ``check_mode: false`` existed. The notation for that was ``always_run: yes``. Skipping tasks or ignoring errors in check mode ----------------------------------------------- diff --git a/docs/docsite/rst/playbook_guide/playbooks_conditionals.rst b/docs/docsite/rst/playbook_guide/playbooks_conditionals.rst index f920fd74..1de9ec39 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_conditionals.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_conditionals.rst @@ -175,6 +175,10 @@ Ansible always registers something in a registered variable for every host, even ansible.builtin.command: /bin/still/something_else when: result is skipped + - name: Run only if the task that registered the "result" variable changed something. + ansible.builtin.command: /bin/still/something_else + when: result is changed + .. note:: Older versions of Ansible used ``success`` and ``fail``, but ``succeeded`` and ``failed`` use the correct tense. All of these options are now valid. @@ -460,6 +464,44 @@ For example, you can template out a configuration file that is very different be - default.conf mypaths: ['search_location_one/somedir/', '/opt/other_location/somedir/'] +.. _debugging_conditionals: + +Debugging conditionals +====================== + +If your conditional ``when`` statement is not behaving as you intended, you can add a ``debug`` statement to determine if the condition evaluates to ``true`` or ``false``. A common cause of unexpected behavior in conditionals is testing an integer as a string or a string as an integer. To debug a conditional statement, add the entire statement as the ``var:`` value in a ``debug`` task. Ansible then shows the test and how the statement evaluates. For example, here is a set of tasks and sample output: + +.. code-block:: yaml + + - name: check value of return code + ansible.builtin.debug: + var: bar_status.rc + + - name: check test for rc value as string + ansible.builtin.debug: + var: bar_status.rc == "127" + + - name: check test for rc value as integer + ansible.builtin.debug: + var: bar_status.rc == 127 + +.. code-block:: ansible-output + + TASK [check value of return code] ********************************************************************************* + ok: [foo-1] => { + "bar_status.rc": "127" + } + + TASK [check test for rc value as string] ************************************************************************** + ok: [foo-1] => { + "bar_status.rc == \"127\"": false + } + + TASK [check test for rc value as integer] ************************************************************************* + ok: [foo-1] => { + "bar_status.rc == 127": true + } + .. _commonly_used_facts: Commonly-used facts diff --git a/docs/docsite/rst/playbook_guide/playbooks_tags.rst b/docs/docsite/rst/playbook_guide/playbooks_tags.rst index 4da0af02..deff48bd 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_tags.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_tags.rst @@ -257,7 +257,7 @@ If you want tag inheritance, you probably want to use imports. However, using bo .. code-block:: yaml - - name: Apply the db tag to the include and to all tasks in db.yaml + - name: Apply the db tag to the include and to all tasks in db.yml include_tasks: file: db.yml # adds 'db' tag to tasks within db.yml @@ -301,7 +301,7 @@ For example: .. warning:: * Fact gathering is tagged with 'always' by default. It is only skipped if - you apply a tag and then use a different tag in ``--tags`` or the same + you apply a tag to the play and then use a different tag in ``--tags`` or the same tag in ``--skip-tags``. .. warning:: @@ -339,7 +339,7 @@ Once you have added tags to your tasks, includes, blocks, plays, roles, and impo * ``--tags tagged`` - run only tasks with at least one tag * ``--tags untagged`` - run only tasks with no tags -For example, to run only tasks and blocks tagged ``configuration`` and ``packages`` in a very long playbook: +For example, to run only tasks and blocks tagged either ``configuration`` or ``packages`` in a very long playbook: .. code-block:: bash diff --git a/docs/docsite/rst/playbook_guide/playbooks_tests.rst b/docs/docsite/rst/playbook_guide/playbooks_tests.rst index 71eaee83..ccf6f9e6 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_tests.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_tests.rst @@ -461,11 +461,11 @@ When looking to determine types, it may be tempting to use the ``type_debug`` fi a_list: ["a", "list"] assert: that: - # Note that a string is classed as also being "iterable", "sequence" and "mapping" - - a_string is string + # Note that a string is classed as also being "iterable" and "sequence", but not "mapping" + - a_string is string and a_string is iterable and a_string is sequence and a_string is not mapping # Note that a dictionary is classed as not being a "string", but is "iterable", "sequence" and "mapping" - - a_dictionary is not string and a_dictionary is mapping + - a_dictionary is not string and a_dictionary is iterable and a_dictionary is mapping # Note that a list is classed as not being a "string" or "mapping" but is "iterable" and "sequence" - a_list is not string and a_list is not mapping and a_list is iterable diff --git a/docs/docsite/rst/plugins/connection.rst b/docs/docsite/rst/plugins/connection.rst index e29842b6..3652ffe1 100644 --- a/docs/docsite/rst/plugins/connection.rst +++ b/docs/docsite/rst/plugins/connection.rst @@ -9,7 +9,7 @@ Connection plugins Connection plugins allow Ansible to connect to the target hosts so it can execute tasks on them. Ansible ships with many connection plugins, but only one can be used per host at a time. -By default, Ansible ships with several connection plugins. The most commonly used are the :ref:`paramiko SSH<paramiko_ssh_connection>`, native ssh (just called :ref:`ssh<ssh_connection>`), and :ref:`local<local_connection>` connection types. All of these can be used in playbooks and with :command:`/usr/bin/ansible` to decide how you want to talk to remote machines. If necessary, you can :ref:`create custom connection plugins <developing_connection_plugins>`. +By default, Ansible ships with several connection plugins. The most commonly used are the :ref:`paramiko SSH<paramiko_connection>`, native ssh (just called :ref:`ssh<ssh_connection>`), and :ref:`local<local_connection>` connection types. All of these can be used in playbooks and with :command:`/usr/bin/ansible` to decide how you want to talk to remote machines. If necessary, you can :ref:`create custom connection plugins <developing_connection_plugins>`. The basics of these connection types are covered in the :ref:`getting started<intro_getting_started>` section. @@ -43,7 +43,7 @@ Plugins are self-documenting. Each plugin should document its configuration opti :ref:`ansible_host<magic_variables_and_hostvars>` The name of the host to connect to, if different from the :ref:`inventory <intro_inventory>` hostname. :ref:`ansible_port<faq_setting_users_and_ports>` - The ssh port number, for :ref:`ssh <ssh_connection>` and :ref:`paramiko_ssh <paramiko_ssh_connection>` it defaults to 22. + The ssh port number, for :ref:`ssh <ssh_connection>` and :ref:`paramiko_ssh <paramiko_connection>` it defaults to 22. :ref:`ansible_user<faq_setting_users_and_ports>` The default user name to use for log in. Most plugins default to the 'current user running Ansible'. diff --git a/docs/docsite/rst/plugins/test.rst b/docs/docsite/rst/plugins/test.rst index 9bad4e72..7922c122 100644 --- a/docs/docsite/rst/plugins/test.rst +++ b/docs/docsite/rst/plugins/test.rst @@ -60,7 +60,7 @@ Tests will always have an ``_input`` and this is normally what is on the left si Using test plugins with lists ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -As mentioned above, one way to use tests is with the ``select`` familiy of filters (``select``, ``reject``, ``selectattr``, ``rejectattr``). +As mentioned above, one way to use tests is with the ``select`` family of filters (``select``, ``reject``, ``selectattr``, ``rejectattr``). .. code-block:: YAML+Jinja diff --git a/docs/docsite/rst/porting_guides/porting_guide_4.rst b/docs/docsite/rst/porting_guides/porting_guide_4.rst index 4e91a30d..5f45910b 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_4.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_4.rst @@ -160,7 +160,7 @@ cisco.nxos junipernetworks.junos ~~~~~~~~~~~~~~~~~~~~~ -- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resuorce module. +- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resource module. Porting Guide for v4.9.0 ======================== diff --git a/docs/docsite/rst/porting_guides/porting_guide_5.rst b/docs/docsite/rst/porting_guides/porting_guide_5.rst index 6257ccd1..7afc11e2 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_5.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_5.rst @@ -173,7 +173,7 @@ vmware.vmware_rest - The vmware_rest 2.0.0 support vSphere 7.0.2 onwards. - vcenter_vm_storage_policy - the format of the ``disks`` parameter has changed. -- vcenter_vm_storage_policy - the module has a new mandatory paramter: ``vm_home``. +- vcenter_vm_storage_policy - the module has a new mandatory parameter: ``vm_home``. Major Changes ------------- @@ -412,7 +412,7 @@ community.hashi_vault junipernetworks.junos ~~~~~~~~~~~~~~~~~~~~~ -- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resuorce module. +- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resource module. Porting Guide for v5.0.1 ======================== @@ -618,7 +618,7 @@ amazon.aws ~~~~~~~~~~ - amazon.aws collection - Due to the AWS SDKs announcing the end of support for Python less than 3.6 (https://boto3.amazonaws.com/v1/documentation/api/1.17.64/guide/migrationpy3.html) this collection now requires Python 3.6+ (https://github.com/ansible-collections/amazon.aws/pull/298). -- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.18.0`` and ``boto3<1.15.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/502). +- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.18.0`` and ``boto3<1.15.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/502). - ec2_instance - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_instance``. - ec2_instance_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_instance_info``. - ec2_vpc_endpoint - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_vpc_endpoint``. @@ -680,7 +680,7 @@ cloudscale_ch.cloud community.aws ~~~~~~~~~~~~~ -- community.aws collection - The community.aws collection has dropped support for ``botocore<1.18.0`` and ``boto3<1.15.0`` (https://github.com/ansible-collections/community.aws/pull/711). Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/442). +- community.aws collection - The community.aws collection has dropped support for ``botocore<1.18.0`` and ``boto3<1.15.0`` (https://github.com/ansible-collections/community.aws/pull/711). Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/442). community.ciscosmb ~~~~~~~~~~~~~~~~~~ diff --git a/docs/docsite/rst/porting_guides/porting_guide_6.rst b/docs/docsite/rst/porting_guides/porting_guide_6.rst index a111451f..d7a0e98d 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_6.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_6.rst @@ -273,7 +273,7 @@ Deprecated Features ------------------- - The google.cloud collection is considered unmaintained and will be removed from Ansible 8 if no one starts maintaining it again before Ansible 8. See `the removal process for details on how this works <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__ (https://github.com/ansible-community/community-topics/issues/105). -- The servicenow.servicenow collection has been deprecated by its maintainers (https://github.com/ServiceNowITOM/servicenow-ansible/pull/69) and will be removed from Ansible 7. It can still be installed manually, but it is suggested to swich to `servicenow.itsm <https://galaxy.ansible.com/servicenow/itsm>`__ instead (https://github.com/ansible-community/community-topics/issues/124). +- The servicenow.servicenow collection has been deprecated by its maintainers (https://github.com/ServiceNowITOM/servicenow-ansible/pull/69) and will be removed from Ansible 7. It can still be installed manually, but it is suggested to switch to `servicenow.itsm <https://galaxy.ansible.com/servicenow/itsm>`__ instead (https://github.com/ansible-community/community-topics/issues/124). Porting Guide for v6.2.0 ======================== @@ -576,7 +576,7 @@ Ansible-core amazon.aws ~~~~~~~~~~ -- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574). +- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574). ansible.netcommon ~~~~~~~~~~~~~~~~~ @@ -678,12 +678,12 @@ cisco.nxos - The minimum required ansible.netcommon version has been bumped to v2.6.1. - Updated base plugin references to ansible.netcommon. - `nxos_facts` - change default gather_subset to `min` from `!config` (https://github.com/ansible-collections/cisco.nxos/issues/418). -- nxos_file_copy has been rewritten as a module. This change also removes the dependency on pexpect for file_pull operation. Since this now uses AnsibleModule class for argspec validation, the validation messages will be slighlty different. Expect changes in the return payload in some cases. All functionality remains unchanged. +- nxos_file_copy has been rewritten as a module. This change also removes the dependency on pexpect for file_pull operation. Since this now uses AnsibleModule class for argspec validation, the validation messages will be slightly different. Expect changes in the return payload in some cases. All functionality remains unchanged. community.aws ~~~~~~~~~~~~~ -- community.aws collection - The community.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/809). +- community.aws collection - The community.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/809). - s3_bucket_notifications - refactor module to support SNS / SQS targets as well as the existing support for Lambda functions (https://github.com/ansible-collections/community.aws/issues/140). community.general @@ -956,7 +956,7 @@ community.network junipernetworks.junos ~~~~~~~~~~~~~~~~~~~~~ -- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resuorce module. +- 'router_id' options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resource module. purestorage.flasharray ~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/docsite/rst/porting_guides/porting_guide_7.rst b/docs/docsite/rst/porting_guides/porting_guide_7.rst index bb8b01bf..d5a94f26 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_7.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_7.rst @@ -92,6 +92,105 @@ Networking No notable changes +Porting Guide for v7.4.0 +======================== + +Breaking Changes +---------------- + +Ansible-core +~~~~~~~~~~~~ + +- ansible-test - Integration tests which depend on specific file permissions when running in an ansible-test managed host environment may require changes. Tests that require permissions other than ``755`` or ``644`` may need to be updated to set the necessary permissions as part of the test run. + +Major Changes +------------- + +community.hrobot +~~~~~~~~~~~~~~~~ + +- firewall - Hetzner added output rules support to the firewall. This change unfortunately means that using old versions of the firewall module will always set the output rule list to empty, thus disallowing the server to send out packets (https://github.com/ansible-collections/community.hrobot/issues/75, https://github.com/ansible-collections/community.hrobot/pull/76). + +community.vmware +~~~~~~~~~~~~~~~~ + +- Use true/false (lowercase) for boolean values in documentation and examples (https://github.com/ansible-collections/community.vmware/issues/1660). + +fortinet.fortios +~~~~~~~~~~~~~~~~ + +- Add annotations of member operation for every module. +- Update ``fortios.py`` for higher performance; +- supports temporary session key and pre/post login banner; +- update the examples on how to use member operation in Q&A. + +purestorage.fusion +~~~~~~~~~~~~~~~~~~ + +- Patching of resource properties was brought to parity with underlying Python SDK, meaning the collection can create/update/delete all resource properties the SDK can +- fusion_volume - fixed and reorganized, arguments changed + +Deprecated Features +------------------- + +amazon.aws +~~~~~~~~~~ + +- support for passing both profile and security tokens through a mix of environment variables and parameters has been deprecated and support will be removed in release 6.0.0. After release 6.0.0 it will only be possible to pass either a profile or security tokens, regardless of mechanism used to pass them. To explicitly block a parameter coming from an environment variable pass an empty string as the parameter value. Support for passing profile and security tokens together was originally deprecated in release 1.2.0, however only partially implemented in release 5.0.0 (https://github.com/ansible-collections/amazon.aws/pull/1355). + +community.aws +~~~~~~~~~~~~~ + +- ecs_service - In a release after 2024-06-01, tha default value of ``purge_placement_constraints`` will be change from ``false`` to ``true`` (https://github.com/ansible-collections/community.aws/pull/1716). +- ecs_service - In a release after 2024-06-01, tha default value of ``purge_placement_strategy`` will be change from ``false`` to ``true`` (https://github.com/ansible-collections/community.aws/pull/1716). +- iam_role - All top level return values other than ``iam_role`` and ``changed`` have been deprecated and will be removed in a release after 2023-12-01 (https://github.com/ansible-collections/community.aws/issues/551). +- iam_role - In a release after 2023-12-01 the contents of ``assume_role_policy_document`` will no longer be converted from CamelCase to snake_case. The ``assume_role_policy_document_raw`` return value already returns the policy document in this future format (https://github.com/ansible-collections/community.aws/issues/551). +- iam_role_info - In a release after 2023-12-01 the contents of ``assume_role_policy_document`` will no longer be converted from CamelCase to snake_case. The ``assume_role_policy_document_raw`` return value already returns the policy document in this future format (https://github.com/ansible-collections/community.aws/issues/551). + +community.hashi_vault +~~~~~~~~~~~~~~~~~~~~~ + +- hashi_vault lookup - in ``v5.0.0`` duplicate term string options will raise an exception instead of showing a warning (https://github.com/ansible-collections/community.hashi_vault/issues/356). + +purestorage.fusion +~~~~~~~~~~~~~~~~~~ + +- fusion_hw - hardware module is being removed as changing hardware type has never been supported by Pure Storage Fusion +- fusion_info - nigs subset is deprecated in favor of network_interface_groups and will be removed in the version 1.7.0 (https://github.com/Pure-Storage-Ansible/Fusion-Collection/pull/46). +- fusion_info - placements subset is deprecated in favor of placement_groups and will be removed in the version 1.7.0 (https://github.com/Pure-Storage-Ansible/Fusion-Collection/pull/62). +- fusion_pg - placement_engine option is deprecated because Fusion API does not longer support this parameter It will be removed in the version 2.0.0 (https://github.com/Pure-Storage-Ansible/Fusion-Collection/pull/53). +- fusion_se - parameters "addresses", "gateway" and "network_interface_groups" are deprecated in favor of "iscsi" and will be removed in version 2.0.0 +- fusion_tn - tenant networks are being replaced by storage endpoints ```fusion_se``` and Network Interface Groups ```fusion_nig``` + +Porting Guide for v7.3.0 +======================== + +Breaking Changes +---------------- + +hetzner.hcloud +~~~~~~~~~~~~~~ + +- inventory plugin - Python v3.5+ is now required. + +Major Changes +------------- + +kubernetes.core +~~~~~~~~~~~~~~~ + +- refactor K8sAnsibleMixin into module_utils/k8s/ (https://github.com/ansible-collections/kubernetes.core/pull/481). + +Deprecated Features +------------------- + +- Since the google.cloud collection seems to be maintained again, we `cancelled the removal process <https://github.com/ansible-collections/overview/blob/main/removal_from_ansible.rst#cancelling-removal-of-an-unmaintained-collection>`__. So contrary to an earlier announcement, this collection is NOT deprecated and will NOT be removed from Ansible 8 (https://github.com/ansible-community/community-topics/issues/105). + +community.general +~~~~~~~~~~~~~~~~~ + +- gitlab_runner - the option ``access_level`` will lose its default value in community.general 8.0.0. From that version on, you have set this option to ``ref_protected`` explicitly, if you want to have a protected runner (https://github.com/ansible-collections/community.general/issues/5925). + Porting Guide for v7.2.0 ======================== @@ -322,7 +421,7 @@ amazon.aws - Tags beginning with ``aws:`` will not be removed when purging tags, these tags are reserved by Amazon and may not be updated or deleted (https://github.com/ansible-collections/amazon.aws/issues/817). - amazon.aws collection - Support for ansible-core < 2.11 has been dropped (https://github.com/ansible-collections/amazon.aws/pull/1087). -- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/934). +- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/934). - amazon.aws collection - the ``profile`` parameter is now mutually exclusive with the ``aws_access_key``, ``aws_secret_key`` and ``security_token`` parameters (https://github.com/ansible-collections/amazon.aws/pull/834). - aws_az_info - the module alias ``aws_az_facts`` was deprecated in Ansible 2.9 and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/832). - aws_s3 - the default value for ``ensure overwrite`` has been changed to ``different`` instead of ``always`` so that the module is idempotent by default (https://github.com/ansible-collections/amazon.aws/issues/811). @@ -370,7 +469,7 @@ community.aws - cloudwatchlogs_log_group_metric_filter - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudwatchlogs_log_group_metric_filter``. - community.aws collection - Support for ansible-core < 2.11 has been dropped (https://github.com/ansible-collections/community.aws/pull/1541). - community.aws collection - The ``community.aws`` collection has now dropped support for and any requirements upon the original ``boto`` AWS SDK, and now uses the ``boto3``/``botocore`` AWS SDK (https://github.com/ansible-collections/community.aws/pull/898). -- community.aws collection - The community.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/1362). +- community.aws collection - The community.aws collection has dropped support for ``botocore<1.21.0`` and ``boto3<1.18.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/1362). - community.aws collection - the ``profile`` parameter is now mutually exclusive with the ``aws_access_key``, ``aws_secret_key`` and ``security_token`` parameters (https://github.com/ansible-collections/amazon.aws/pull/834). - ec2_eip - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_eip``. - ec2_eip_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.ec2_eip_info``. @@ -481,7 +580,7 @@ Ansible-core amazon.aws ~~~~~~~~~~ -- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574). +- amazon.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/574). - autoscaling_group - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_group``. - autoscaling_group_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_group_info``. - cloudtrail - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.cloudtrail``. @@ -578,7 +677,7 @@ cisco.nxos community.aws ~~~~~~~~~~~~~ -- community.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/956). +- community.aws collection - The amazon.aws collection has dropped support for ``botocore<1.20.0`` and ``boto3<1.17.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/956). community.docker ~~~~~~~~~~~~~~~~ diff --git a/docs/docsite/rst/reference_appendices/release_and_maintenance.rst b/docs/docsite/rst/reference_appendices/release_and_maintenance.rst index cf523778..551ff25f 100644 --- a/docs/docsite/rst/reference_appendices/release_and_maintenance.rst +++ b/docs/docsite/rst/reference_appendices/release_and_maintenance.rst @@ -41,8 +41,8 @@ The two community releases are related - the release cycle follows this pattern: * Work on new features continues in Collections * Individual Collections can make multiple minor and major releases -#. Minor releases of three maintained ansible-core versions every three weeks (2.11.1) -#. Minor releases of the single maintained Ansible community package version every three weeks (4.1.0) +#. Minor releases of three maintained ansible-core versions every four weeks (2.11.1) +#. Minor releases of the single maintained Ansible community package version every four weeks (4.1.0) #. Feature freeze on ansible-core #. Release candidate for ansible-core, testing, additional release candidates as necessary #. Release of the next ansible-core major version, cycle begins again @@ -50,7 +50,7 @@ The two community releases are related - the release cycle follows this pattern: Ansible community package release cycle --------------------------------------- -The Ansible community team typically releases two major versions of the community package per year, on a flexible release cycle that trails the release of ``ansible-core``. This cycle can be extended to allow for larger changes to be properly implemented and tested before a new release is made available. See :ref:`ansible_roadmaps` for upcoming release details. Between major versions, we release a new minor version of the Ansible community package every three weeks. Minor releases include new backwards-compatible features, modules and plugins, as well as bug fixes. +The Ansible community team typically releases two major versions of the community package per year, on a flexible release cycle that trails the release of ``ansible-core``. This cycle can be extended to allow for larger changes to be properly implemented and tested before a new release is made available. See :ref:`ansible_roadmaps` for upcoming release details. Between major versions, we release a new minor version of the Ansible community package every four weeks. Minor releases include new backwards-compatible features, modules and plugins, as well as bug fixes. Starting with version 2.10, the Ansible community team guarantees maintenance for only one major community package release at a time. For example, when Ansible 4.0.0 gets released, the team will stop making new 3.x releases. Community members may maintain older versions if desired. @@ -331,7 +331,7 @@ The Ansible community develops and maintains the features and functionality incl * Developers add new features and bug fixes to the individual Collections, following each Collection's rules on contributing. * Each new feature and each bug fix includes a changelog fragment describing the work. - * Release engineers create a minor release for the current version every three weeks to ensure that the latest bug fixes are available to users. + * Release engineers create a minor release for the current version every four weeks to ensure that the latest bug fixes are available to users. * At the end of the development period, the release engineers announce which Collections, and which major version of each included Collection, will be included in the next release of the Ansible community package. New Collections and new major versions may not be added after this, and the work of creating a new release begins. We generally do not provide fixes for unmaintained releases of the Ansible community package, however, there can sometimes be exceptions for critical issues. @@ -346,7 +346,7 @@ The Ansible community develops and maintains ``ansible-core`` on GitHub_, with a * Developers add new features and bug fixes to the ``devel`` branch. * Each new feature and each bug fix includes a changelog fragment describing the work. * The development team backports bug fixes to one, two, or three stable branches, depending on the severity of the bug. They do not backport new features. - * Release engineers create a minor release for each maintained version every three weeks to ensure that the latest bug fixes are available to users. + * Release engineers create a minor release for each maintained version every four weeks to ensure that the latest bug fixes are available to users. * At the end of the development period, the release engineers impose a feature freeze and the work of creating a new release begins. We generally do not provide fixes for unmaintained releases of ``ansible-core``, however, there can sometimes be exceptions for critical issues. diff --git a/docs/docsite/rst/reference_appendices/special_variables.rst b/docs/docsite/rst/reference_appendices/special_variables.rst index e159f476..73bd07c0 100644 --- a/docs/docsite/rst/reference_appendices/special_variables.rst +++ b/docs/docsite/rst/reference_appendices/special_variables.rst @@ -7,141 +7,145 @@ Magic variables --------------- These variables cannot be set directly by the user; Ansible will always override them to reflect internal state. -ansible_check_mode - Boolean that indicates if we are in check mode or not +.. glossary:: -ansible_config_file - The full path of used Ansible configuration file + ansible_check_mode + Boolean that indicates if we are in check mode or not -ansible_dependent_role_names - The names of the roles currently imported into the current play as dependencies of other plays + ansible_config_file + The full path of used Ansible configuration file -ansible_diff_mode - Boolean that indicates if we are in diff mode or not + ansible_dependent_role_names + The names of the roles currently imported into the current play as dependencies of other plays -ansible_forks - Integer reflecting the number of maximum forks available to this run + ansible_diff_mode + Boolean that indicates if we are in diff mode or not -ansible_inventory_sources - List of sources used as inventory + ansible_forks + Integer reflecting the number of maximum forks available to this run -ansible_limit - Contents of the ``--limit`` CLI option for the current execution of Ansible + ansible_inventory_sources + List of sources used as inventory -ansible_loop - A dictionary/map containing extended loop information when enabled through ``loop_control.extended`` + ansible_limit + Contents of the ``--limit`` CLI option for the current execution of Ansible -ansible_loop_var - The name of the value provided to ``loop_control.loop_var``. Added in ``2.8`` + ansible_loop + A dictionary/map containing extended loop information when enabled through ``loop_control.extended`` -ansible_index_var - The name of the value provided to ``loop_control.index_var``. Added in ``2.9`` + ansible_loop_var + The name of the value provided to ``loop_control.loop_var``. Added in ``2.8`` -ansible_parent_role_names - When the current role is being executed by means of an :ref:`include_role <include_role_module>` or :ref:`import_role <import_role_module>` action, this variable contains a list of all parent roles, with the most recent role (in other words, the role that included/imported this role) being the first item in the list. - When multiple inclusions occur, this list lists the *last* role (in other words, the role that included this role) as the *first* item in the list. It is also possible that a specific role exists more than once in this list. + ansible_index_var + The name of the value provided to ``loop_control.index_var``. Added in ``2.9`` - For example: When role **A** includes role **B**, inside role B, ``ansible_parent_role_names`` will equal to ``['A']``. If role **B** then includes role **C**, the list becomes ``['B', 'A']``. + ansible_parent_role_names + When the current role is being executed by means of an :ref:`include_role <include_role_module>` or :ref:`import_role <import_role_module>` action, this variable contains a list of all parent roles, with the most recent role (in other words, the role that included/imported this role) being the first item in the list. + When multiple inclusions occur, this list lists the *last* role (in other words, the role that included this role) as the *first* item in the list. It is also possible that a specific role exists more than once in this list. -ansible_parent_role_paths - When the current role is being executed by means of an :ref:`include_role <include_role_module>` or :ref:`import_role <import_role_module>` action, this variable contains a list of all parent roles paths, with the most recent role (in other words, the role that included/imported this role) being the first item in the list. - Please refer to ``ansible_parent_role_names`` for the order of items in this list. + For example: When role **A** includes role **B**, inside role B, ``ansible_parent_role_names`` will equal to ``['A']``. If role **B** then includes role **C**, the list becomes ``['B', 'A']``. -ansible_play_batch - List of active hosts in the current play run limited by the serial, aka 'batch'. Failed/Unreachable hosts are not considered 'active'. + ansible_parent_role_paths + When the current role is being executed by means of an :ref:`include_role <include_role_module>` or :ref:`import_role <import_role_module>` action, this variable contains a list of all parent roles paths, with the most recent role (in other words, the role that included/imported this role) being the first item in the list. + Please refer to ``ansible_parent_role_names`` for the order of items in this list. -ansible_play_hosts - List of hosts in the current play run, not limited by the serial. Failed/Unreachable hosts are excluded from this list. + ansible_play_batch + List of active hosts in the current play run limited by the serial, aka 'batch'. Failed/Unreachable hosts are not considered 'active'. -ansible_play_hosts_all - List of all the hosts that were targeted by the play + ansible_play_hosts + List of hosts in the current play run, not limited by the serial. Failed/Unreachable hosts are excluded from this list. -ansible_play_role_names - The names of the roles currently imported into the current play. This list does **not** contain the role names that are - implicitly included through dependencies. + ansible_play_hosts_all + List of all the hosts that were targeted by the play -ansible_playbook_python - The path to the python interpreter being used by Ansible on the controller + ansible_play_role_names + The names of the roles currently imported into the current play. This list does **not** contain the role names that are + implicitly included through dependencies. -ansible_role_names - The names of the roles currently imported into the current play, or roles referenced as dependencies of the roles - imported into the current play. + ansible_playbook_python + The path to the python interpreter being used by Ansible on the controller -ansible_role_name - The fully qualified collection role name, in the format of ``namespace.collection.role_name`` + ansible_role_names + The names of the roles currently imported into the current play, or roles referenced as dependencies of the roles + imported into the current play. -ansible_collection_name - The name of the collection the task that is executing is a part of. In the format of ``namespace.collection`` + ansible_role_name + The fully qualified collection role name, in the format of ``namespace.collection.role_name`` -ansible_run_tags - Contents of the ``--tags`` CLI option, which specifies which tags will be included for the current run. Note that if ``--tags`` is not passed, this variable will default to ``["all"]``. + ansible_collection_name + The name of the collection the task that is executing is a part of. In the format of ``namespace.collection`` -ansible_search_path - Current search path for action plugins and lookups, in other words, where we search for relative paths when you do ``template: src=myfile`` + ansible_run_tags + Contents of the ``--tags`` CLI option, which specifies which tags will be included for the current run. Note that if ``--tags`` is not passed, this variable will default to ``["all"]``. -ansible_skip_tags - Contents of the ``--skip-tags`` CLI option, which specifies which tags will be skipped for the current run. + ansible_search_path + Current search path for action plugins and lookups, in other words, where we search for relative paths when you do ``template: src=myfile`` -ansible_verbosity - Current verbosity setting for Ansible + ansible_skip_tags + Contents of the ``--skip-tags`` CLI option, which specifies which tags will be skipped for the current run. -ansible_version - Dictionary/map that contains information about the current running version of ansible, it has the following keys: full, major, minor, revision and string. + ansible_verbosity + Current verbosity setting for Ansible -group_names - List of groups the current host is part of + ansible_version + Dictionary/map that contains information about the current running version of ansible, it has the following keys: full, major, minor, revision and string. -groups - A dictionary/map with all the groups in inventory and each group has the list of hosts that belong to it + group_names + List of groups the current host is part of -hostvars - A dictionary/map with all the hosts in inventory and variables assigned to them + groups + A dictionary/map with all the groups in inventory and each group has the list of hosts that belong to it -inventory_hostname - The inventory name for the 'current' host being iterated over in the play + hostvars + A dictionary/map with all the hosts in inventory and variables assigned to them -inventory_hostname_short - The short version of `inventory_hostname` + inventory_hostname + The inventory name for the 'current' host being iterated over in the play -inventory_dir - The directory of the inventory source in which the `inventory_hostname` was first defined + inventory_hostname_short + The short version of `inventory_hostname` -inventory_file - The file name of the inventory source in which the `inventory_hostname` was first defined + inventory_dir + The directory of the inventory source in which the `inventory_hostname` was first defined -omit - Special variable that allows you to 'omit' an option in a task, for example ``- user: name=bob home={{ bobs_home|default(omit) }}`` + inventory_file + The file name of the inventory source in which the `inventory_hostname` was first defined -play_hosts - Deprecated, the same as ansible_play_batch + omit + Special variable that allows you to 'omit' an option in a task, for example ``- user: name=bob home={{ bobs_home|default(omit) }}`` -ansible_play_name - The name of the currently executed play. Added in ``2.8``. (`name` attribute of the play, not file name of the playbook.) + play_hosts + Deprecated, the same as ansible_play_batch -playbook_dir - The path to the directory of the current playbook being executed. NOTE: This might be different than directory of the playbook passed to the ``ansible-playbook`` command line when a playbook contains a ``import_playbook`` statement. + ansible_play_name + The name of the currently executed play. Added in ``2.8``. (`name` attribute of the play, not file name of the playbook.) -role_name - The name of the role currently being executed. + playbook_dir + The path to the directory of the current playbook being executed. NOTE: This might be different than directory of the playbook passed to the ``ansible-playbook`` command line when a playbook contains a ``import_playbook`` statement. -role_names - Deprecated, the same as ansible_play_role_names + role_name + The name of the role currently being executed. -role_path - The path to the dir of the currently running role + role_names + Deprecated, the same as ansible_play_role_names + + role_path + The path to the dir of the currently running role Facts ----- These are variables that contain information pertinent to the current host (`inventory_hostname`). They are only available if gathered first. See :ref:`vars_and_facts` for more information. -ansible_facts - Contains any facts gathered or cached for the `inventory_hostname` - Facts are normally gathered by the :ref:`setup <setup_module>` module automatically in a play, but any module can return facts. +.. glossary:: + + ansible_facts + Contains any facts gathered or cached for the `inventory_hostname` + Facts are normally gathered by the :ref:`setup <setup_module>` module automatically in a play, but any module can return facts. -ansible_local - Contains any 'local facts' gathered or cached for the `inventory_hostname`. - The keys available depend on the custom facts created. - See the :ref:`setup <setup_module>` module and :ref:`local_facts` for more details. + ansible_local + Contains any 'local facts' gathered or cached for the `inventory_hostname`. + The keys available depend on the custom facts created. + See the :ref:`setup <setup_module>` module and :ref:`local_facts` for more details. .. _connection_variables: @@ -151,17 +155,19 @@ Connection variables are normally used to set the specifics on how to execute ac Only the common ones are described as each connection/become/shell/etc plugin can define its own overrides and specific variables. See :ref:`general_precedence_rules` for how connection variables interact with :ref:`configuration settings<ansible_configuration_settings>`, :ref:`command-line options<command_line_tools>`, and :ref:`playbook keywords<playbook_keywords>`. -ansible_become_user - The user Ansible 'becomes' after using privilege escalation. This must be available to the 'login user'. +.. glossary:: + + ansible_become_user + The user Ansible 'becomes' after using privilege escalation. This must be available to the 'login user'. -ansible_connection - The connection plugin actually used for the task on the target host. + ansible_connection + The connection plugin actually used for the task on the target host. -ansible_host - The ip/name of the target host to use instead of `inventory_hostname`. + ansible_host + The ip/name of the target host to use instead of `inventory_hostname`. -ansible_python_interpreter - The path to the Python executable Ansible should use on the target host. + ansible_python_interpreter + The path to the Python executable Ansible should use on the target host. -ansible_user - The user Ansible 'logs in' as. + ansible_user + The user Ansible 'logs in' as. diff --git a/docs/docsite/sphinx_conf/core_conf.py b/docs/docsite/sphinx_conf/core_conf.py index 7f1663b3..a279c02f 100644 --- a/docs/docsite/sphinx_conf/core_conf.py +++ b/docs/docsite/sphinx_conf/core_conf.py @@ -104,6 +104,7 @@ exclude_patterns = [ 'community/collection_contributors/collection_integration_tests.rst', 'community/collection_contributors/collection_integration_running.rst', 'community/collection_contributors/collection_reviewing.rst', + 'community/collection_contributors/collection_requirements.rst', 'community/collection_contributors/collection_unit_tests.rst', 'community/maintainers.rst', 'community/contributions_collections.rst', diff --git a/docs/docsite/sphinx_conf/core_lang_conf.py b/docs/docsite/sphinx_conf/core_lang_conf.py index 49efc6ee..2d4ecc14 100644 --- a/docs/docsite/sphinx_conf/core_lang_conf.py +++ b/docs/docsite/sphinx_conf/core_lang_conf.py @@ -104,6 +104,7 @@ exclude_patterns = [ 'community/collection_contributors/collection_integration_tests.rst', 'community/collection_contributors/collection_integration_running.rst', 'community/collection_contributors/collection_reviewing.rst', + 'community/collection_contributors/collection_requirements.rst', 'community/collection_contributors/collection_unit_tests.rst', 'community/maintainers.rst', 'community/contributions_collections.rst', diff --git a/docs/man/man1/ansible-config.1 b/docs/man/man1/ansible-config.1 index 28b88cde..a5724586 100644 --- a/docs/man/man1/ansible-config.1 +++ b/docs/man/man1/ansible-config.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-CONFIG" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-CONFIG" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-config \- View ansible configuration. .SH SYNOPSIS diff --git a/docs/man/man1/ansible-console.1 b/docs/man/man1/ansible-console.1 index 039959b2..026ae8a5 100644 --- a/docs/man/man1/ansible-console.1 +++ b/docs/man/man1/ansible-console.1 @@ -27,27 +27,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-CONSOLE" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-CONSOLE" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-console \- REPL console for executing Ansible tasks. .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible\-console [\-h] [\-\-version] [\-v] [\-b] -[\-\-become\-method BECOME_METHOD] -[\-\-become\-user BECOME_USER] -[\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] -[\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] -[\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] -[\-c CONNECTION] [\-T TIMEOUT] -[\-\-ssh\-common\-args SSH_COMMON_ARGS] -[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] -[\-\-scp\-extra\-args SCP_EXTRA_ARGS] -[\-\-ssh\-extra\-args SSH_EXTRA_ARGS] -[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] -[\-C] [\-\-syntax\-check] [\-D] [\-\-vault\-id VAULT_IDS] -[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] -[\-f FORKS] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] +.B usage: ansible\-console [\-h] [\-\-version] [\-v] [\-b] [\-\-become\-method BECOME_METHOD] [\-\-become\-user BECOME_USER] [\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-i INVENTORY] +[\-\-list\-hosts] [\-l SUBSET] [\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] [\-\-ssh\-common\-args SSH_COMMON_ARGS] +[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] [\-\-scp\-extra\-args SCP_EXTRA_ARGS] [\-\-ssh\-extra\-args SSH_EXTRA_ARGS] [\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] +[\-C] [\-D] [\-\-vault\-id VAULT_IDS] [\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-f FORKS] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] [\-e EXTRA_VARS] [\-\-task\-timeout TASK_TIMEOUT] [\-\-step] [pattern] .UNINDENT @@ -63,7 +52,7 @@ runtime: .IP \(bu 2 \fIcd [pattern]\fP: change host/group (you can use host patterns eg.: .UNINDENT -.IP "System Message: WARNING/2 (docs/man/man1/ansible-console.1.rst:, line 46)" +.IP "System Message: WARNING/2 (:, line 35)" Bullet list ends without a blank line; unexpected unindent. .sp app*.dc*:!app01*) @@ -179,13 +168,6 @@ one\-step\-at\-a\-time: confirm each task before running .UNINDENT .UNINDENT .sp -\fB\-\-syntax\-check\fP -.INDENT 0.0 -.INDENT 3.5 -perform a syntax check on the playbook, but do not execute it -.UNINDENT -.UNINDENT -.sp \fB\-\-task\-timeout\fP \(aqTASK_TIMEOUT\(aq .INDENT 0.0 .INDENT 3.5 diff --git a/docs/man/man1/ansible-doc.1 b/docs/man/man1/ansible-doc.1 index 434e92c4..8c262a24 100644 --- a/docs/man/man1/ansible-doc.1 +++ b/docs/man/man1/ansible-doc.1 @@ -27,18 +27,15 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-DOC" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-DOC" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-doc \- plugin documentation tool .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible\-doc [\-h] [\-\-version] [\-v] [\-M MODULE_PATH] -[\-\-playbook\-dir BASEDIR] -[\-t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}] -[\-j] [\-r ROLES_PATH] -[\-e ENTRY_POINT | \-s | \-F | \-l | \-\-metadata\-dump] -[\-\-no\-fail\-on\-errors] +.B usage: ansible\-doc [\-h] [\-\-version] [\-v] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] +[\-t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}] [\-j] [\-r ROLES_PATH] +[\-e ENTRY_POINT | \-s | \-F | \-l | \-\-metadata\-dump] [\-\-no\-fail\-on\-errors] [plugin ...] .UNINDENT .SH DESCRIPTION diff --git a/docs/man/man1/ansible-galaxy.1 b/docs/man/man1/ansible-galaxy.1 index 646e1b93..36d42830 100644 --- a/docs/man/man1/ansible-galaxy.1 +++ b/docs/man/man1/ansible-galaxy.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-GALAXY" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-GALAXY" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-galaxy \- Perform various Role and Collection related operations. .SH SYNOPSIS diff --git a/docs/man/man1/ansible-inventory.1 b/docs/man/man1/ansible-inventory.1 index dcf9152d..e35df15c 100644 --- a/docs/man/man1/ansible-inventory.1 +++ b/docs/man/man1/ansible-inventory.1 @@ -27,18 +27,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-INVENTORY" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-INVENTORY" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-inventory \- None .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible\-inventory [\-h] [\-\-version] [\-v] [\-i INVENTORY] -[\-\-vault\-id VAULT_IDS] -[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] -[\-\-playbook\-dir BASEDIR] [\-e EXTRA_VARS] [\-\-list] -[\-\-host HOST] [\-\-graph] [\-y] [\-\-toml] [\-\-vars] -[\-\-export] [\-\-output OUTPUT_FILE] +.B usage: ansible\-inventory [\-h] [\-\-version] [\-v] [\-i INVENTORY] [\-\-vault\-id VAULT_IDS] [\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-\-playbook\-dir BASEDIR] +[\-e EXTRA_VARS] [\-\-list] [\-\-host HOST] [\-\-graph] [\-y] [\-\-toml] [\-\-vars] [\-\-export] [\-\-output OUTPUT_FILE] [host|group] .UNINDENT .SH DESCRIPTION diff --git a/docs/man/man1/ansible-playbook.1 b/docs/man/man1/ansible-playbook.1 index 42b123f9..82f0599e 100644 --- a/docs/man/man1/ansible-playbook.1 +++ b/docs/man/man1/ansible-playbook.1 @@ -27,28 +27,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-PLAYBOOK" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-PLAYBOOK" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-playbook \- Runs Ansible playbooks, executing the defined tasks on the targeted hosts. .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible\-playbook [\-h] [\-\-version] [\-v] [\-\-private\-key PRIVATE_KEY_FILE] -[\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] -[\-\-ssh\-common\-args SSH_COMMON_ARGS] -[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] -[\-\-scp\-extra\-args SCP_EXTRA_ARGS] -[\-\-ssh\-extra\-args SSH_EXTRA_ARGS] -[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] -[\-\-force\-handlers] [\-\-flush\-cache] [\-b] -[\-\-become\-method BECOME_METHOD] -[\-\-become\-user BECOME_USER] -[\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] -[\-t TAGS] [\-\-skip\-tags SKIP_TAGS] [\-C] -[\-\-syntax\-check] [\-D] [\-i INVENTORY] [\-\-list\-hosts] -[\-l SUBSET] [\-e EXTRA_VARS] [\-\-vault\-id VAULT_IDS] -[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] -[\-f FORKS] [\-M MODULE_PATH] [\-\-list\-tasks] +.B usage: ansible\-playbook [\-h] [\-\-version] [\-v] [\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] [\-\-ssh\-common\-args SSH_COMMON_ARGS] +[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] [\-\-scp\-extra\-args SCP_EXTRA_ARGS] [\-\-ssh\-extra\-args SSH_EXTRA_ARGS] +[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] [\-\-force\-handlers] [\-\-flush\-cache] [\-b] [\-\-become\-method BECOME_METHOD] [\-\-become\-user BECOME_USER] +[\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-t TAGS] [\-\-skip\-tags SKIP_TAGS] [\-C] [\-D] [\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] [\-e EXTRA_VARS] +[\-\-vault\-id VAULT_IDS] [\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-f FORKS] [\-M MODULE_PATH] [\-\-syntax\-check] [\-\-list\-tasks] [\-\-list\-tags] [\-\-step] [\-\-start\-at\-task START_AT_TASK] playbook [playbook ...] .UNINDENT diff --git a/docs/man/man1/ansible-pull.1 b/docs/man/man1/ansible-pull.1 index 2fe0c038..bafa0193 100644 --- a/docs/man/man1/ansible-pull.1 +++ b/docs/man/man1/ansible-pull.1 @@ -27,28 +27,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-PULL" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-PULL" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-pull \- pulls playbooks from a VCS repo and executes them for the local host .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible\-pull [\-h] [\-\-version] [\-v] [\-\-private\-key PRIVATE_KEY_FILE] -[\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] -[\-\-ssh\-common\-args SSH_COMMON_ARGS] -[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] -[\-\-scp\-extra\-args SCP_EXTRA_ARGS] -[\-\-ssh\-extra\-args SSH_EXTRA_ARGS] -[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] -[\-\-vault\-id VAULT_IDS] -[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] -[\-e EXTRA_VARS] [\-t TAGS] [\-\-skip\-tags SKIP_TAGS] -[\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] [\-M MODULE_PATH] -[\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] -[\-\-purge] [\-o] [\-s SLEEP] [\-f] [\-d DEST] [\-U URL] [\-\-full] -[\-C CHECKOUT] [\-\-accept\-host\-key] [\-m MODULE_NAME] -[\-\-verify\-commit] [\-\-clean] [\-\-track\-subs] [\-\-check] -[\-\-diff] +.B usage: ansible\-pull [\-h] [\-\-version] [\-v] [\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] [\-\-ssh\-common\-args SSH_COMMON_ARGS] +[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] [\-\-scp\-extra\-args SCP_EXTRA_ARGS] [\-\-ssh\-extra\-args SSH_EXTRA_ARGS] [\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] +[\-\-vault\-id VAULT_IDS] [\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-e EXTRA_VARS] [\-t TAGS] [\-\-skip\-tags SKIP_TAGS] [\-i INVENTORY] +[\-\-list\-hosts] [\-l SUBSET] [\-M MODULE_PATH] [\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-\-purge] [\-o] [\-s SLEEP] [\-f] [\-d DEST] [\-U URL] [\-\-full] +[\-C CHECKOUT] [\-\-accept\-host\-key] [\-m MODULE_NAME] [\-\-verify\-commit] [\-\-clean] [\-\-track\-subs] [\-\-check] [\-\-diff] [playbook.yml ...] .UNINDENT .SH DESCRIPTION diff --git a/docs/man/man1/ansible-vault.1 b/docs/man/man1/ansible-vault.1 index 42e7d7a4..4127214d 100644 --- a/docs/man/man1/ansible-vault.1 +++ b/docs/man/man1/ansible-vault.1 @@ -27,16 +27,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE-VAULT" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE-VAULT" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible-vault \- encryption/decryption utility for Ansible data files .SH SYNOPSIS -.INDENT 0.0 -.TP -.B usage: ansible\-vault [\-h] [\-\-version] [\-v] -{create,decrypt,edit,view,encrypt,encrypt_string,rekey} -\&... -.UNINDENT +.sp +usage: ansible\-vault [\-h] [\-\-version] [\-v] {create,decrypt,edit,view,encrypt,encrypt_string,rekey} ... .SH DESCRIPTION .sp can encrypt any structured data file used by Ansible. diff --git a/docs/man/man1/ansible.1 b/docs/man/man1/ansible.1 index 5f29078d..2d2a551c 100644 --- a/docs/man/man1/ansible.1 +++ b/docs/man/man1/ansible.1 @@ -27,27 +27,18 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "ANSIBLE" 1 "" "Ansible 2.14.3" "System administration commands" +.TH "ANSIBLE" 1 "" "Ansible 2.14.6" "System administration commands" .SH NAME ansible \- Define and run a single task 'playbook' against a set of hosts .SH SYNOPSIS .INDENT 0.0 .TP -.B usage: ansible [\-h] [\-\-version] [\-v] [\-b] [\-\-become\-method BECOME_METHOD] -[\-\-become\-user BECOME_USER] -[\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] -[\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] [\-P POLL_INTERVAL] -[\-B SECONDS] [\-o] [\-t TREE] [\-\-private\-key PRIVATE_KEY_FILE] -[\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] -[\-\-ssh\-common\-args SSH_COMMON_ARGS] -[\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] -[\-\-scp\-extra\-args SCP_EXTRA_ARGS] -[\-\-ssh\-extra\-args SSH_EXTRA_ARGS] -[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] [\-C] -[\-\-syntax\-check] [\-D] [\-e EXTRA_VARS] [\-\-vault\-id VAULT_IDS] -[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] -[\-f FORKS] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] -[\-\-task\-timeout TASK_TIMEOUT] [\-a MODULE_ARGS] [\-m MODULE_NAME] +.B usage: ansible [\-h] [\-\-version] [\-v] [\-b] [\-\-become\-method BECOME_METHOD] [\-\-become\-user BECOME_USER] [\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-i INVENTORY] [\-\-list\-hosts] +[\-l SUBSET] [\-P POLL_INTERVAL] [\-B SECONDS] [\-o] [\-t TREE] [\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] +[\-\-ssh\-common\-args SSH_COMMON_ARGS] [\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] [\-\-scp\-extra\-args SCP_EXTRA_ARGS] [\-\-ssh\-extra\-args SSH_EXTRA_ARGS] +[\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] [\-C] [\-D] [\-e EXTRA_VARS] [\-\-vault\-id VAULT_IDS] +[\-\-ask\-vault\-password | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-f FORKS] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] [\-\-task\-timeout TASK_TIMEOUT] [\-a MODULE_ARGS] +[\-m MODULE_NAME] pattern .UNINDENT .SH DESCRIPTION @@ -146,13 +137,6 @@ specify extra arguments to pass to ssh only (e.g. \-R) .UNINDENT .UNINDENT .sp -\fB\-\-syntax\-check\fP -.INDENT 0.0 -.INDENT 3.5 -perform a syntax check on the playbook, but do not execute it -.UNINDENT -.UNINDENT -.sp \fB\-\-task\-timeout\fP \(aqTASK_TIMEOUT\(aq .INDENT 0.0 .INDENT 3.5 diff --git a/lib/ansible/cli/arguments/option_helpers.py b/lib/ansible/cli/arguments/option_helpers.py index cb37d57c..a3efb1e2 100644 --- a/lib/ansible/cli/arguments/option_helpers.py +++ b/lib/ansible/cli/arguments/option_helpers.py @@ -235,8 +235,6 @@ def add_check_options(parser): """Add options for commands which can run with diagnostic information of tasks""" parser.add_argument("-C", "--check", default=False, dest='check', action='store_true', help="don't make any changes; instead, try to predict some of the changes that may occur") - parser.add_argument('--syntax-check', dest='syntax', action='store_true', - help="perform a syntax check on the playbook, but do not execute it") parser.add_argument("-D", "--diff", default=C.DIFF_ALWAYS, dest='diff', action='store_true', help="when changing (small) files and templates, show the differences in those" " files; works great with --check") diff --git a/lib/ansible/cli/doc.py b/lib/ansible/cli/doc.py index 80365303..9f560bcb 100755 --- a/lib/ansible/cli/doc.py +++ b/lib/ansible/cli/doc.py @@ -1241,10 +1241,16 @@ class DocCLI(CLI, RoleMixin): if 'module' in item: text.append(textwrap.fill(DocCLI.tty_ify('Module %s' % item['module']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) - description = item.get('description', 'The official documentation on the %s module.' % item['module']) - text.append(textwrap.fill(DocCLI.tty_ify(description), limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) - text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink('modules/%s_module.html' % item['module'])), - limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) + description = item.get('description') + if description is None and item['module'].startswith('ansible.builtin.'): + description = 'The official documentation on the %s module.' % item['module'] + if description is not None: + text.append(textwrap.fill(DocCLI.tty_ify(description), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) + if item['module'].startswith('ansible.builtin.'): + relative_url = 'collections/%s_module.html' % item['module'].replace('.', '/', 2) + text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink(relative_url)), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) elif 'name' in item and 'link' in item and 'description' in item: text.append(textwrap.fill(DocCLI.tty_ify(item['name']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) diff --git a/lib/ansible/cli/galaxy.py b/lib/ansible/cli/galaxy.py index 3cb7fe2c..c280380c 100755 --- a/lib/ansible/cli/galaxy.py +++ b/lib/ansible/cli/galaxy.py @@ -27,7 +27,7 @@ from ansible import context from ansible.cli.arguments import option_helpers as opt_help from ansible.errors import AnsibleError, AnsibleOptionsError from ansible.galaxy import Galaxy, get_collections_galaxy_meta_info -from ansible.galaxy.api import GalaxyAPI +from ansible.galaxy.api import GalaxyAPI, GalaxyError from ansible.galaxy.collection import ( build_collection, download_collections, @@ -242,7 +242,7 @@ class GalaxyCLI(CLI): help='The Ansible Galaxy API key which can be found at ' 'https://galaxy.ansible.com/me/preferences.') common.add_argument('-c', '--ignore-certs', action='store_true', dest='ignore_certs', help='Ignore SSL certificate validation errors.', default=None) - common.add_argument('--timeout', dest='timeout', type=int, + common.add_argument('--timeout', dest='timeout', type=int, default=60, help="The time to wait for operations against the galaxy server, defaults to 60s.") opt_help.add_verbosity_options(common) @@ -1214,7 +1214,7 @@ class GalaxyCLI(CLI): remote_data = None try: remote_data = self.api.lookup_role_by_name(role, False) - except AnsibleError as e: + except GalaxyError as e: if e.http_code == 400 and 'Bad Request' in e.message: # Role does not exist in Ansible Galaxy data = u"- the role %s was not found" % role diff --git a/lib/ansible/cli/playbook.py b/lib/ansible/cli/playbook.py index c94cf0ff..9c091a67 100755 --- a/lib/ansible/cli/playbook.py +++ b/lib/ansible/cli/playbook.py @@ -54,6 +54,8 @@ class PlaybookCLI(CLI): opt_help.add_module_options(self.parser) # ansible playbook specific opts + self.parser.add_argument('--syntax-check', dest='syntax', action='store_true', + help="perform a syntax check on the playbook, but do not execute it") self.parser.add_argument('--list-tasks', dest='listtasks', action='store_true', help="list all tasks that would be executed") self.parser.add_argument('--list-tags', dest='listtags', action='store_true', diff --git a/lib/ansible/executor/powershell/module_manifest.py b/lib/ansible/executor/powershell/module_manifest.py index 970e8489..87e2ce0a 100644 --- a/lib/ansible/executor/powershell/module_manifest.py +++ b/lib/ansible/executor/powershell/module_manifest.py @@ -319,7 +319,7 @@ def _create_powershell_wrapper(b_module_data, module_path, module_args, exec_manifest["actions"].insert(0, 'async_watchdog') exec_manifest["actions"].insert(0, 'async_wrapper') - exec_manifest["async_jid"] = str(random.randint(0, 999999999999)) + exec_manifest["async_jid"] = f'j{random.randint(0, 999999999999)}' exec_manifest["async_timeout_sec"] = async_timeout exec_manifest["async_startup_timeout"] = C.config.get_config_value("WIN_ASYNC_STARTUP_TIMEOUT", variables=task_vars) diff --git a/lib/ansible/galaxy/api.py b/lib/ansible/galaxy/api.py index 8dea8049..0d519980 100644 --- a/lib/ansible/galaxy/api.py +++ b/lib/ansible/galaxy/api.py @@ -11,12 +11,15 @@ import functools import hashlib import json import os +import socket import stat import tarfile import time import threading -from urllib.error import HTTPError +from http import HTTPStatus +from http.client import BadStatusLine, IncompleteRead +from urllib.error import HTTPError, URLError from urllib.parse import quote as urlquote, urlencode, urlparse, parse_qs, urljoin from ansible import constants as C @@ -34,10 +37,11 @@ from ansible.utils.path import makedirs_safe display = Display() _CACHE_LOCK = threading.Lock() COLLECTION_PAGE_SIZE = 100 -RETRY_HTTP_ERROR_CODES = [ # TODO: Allow user-configuration - 429, # Too Many Requests +RETRY_HTTP_ERROR_CODES = { # TODO: Allow user-configuration + HTTPStatus.TOO_MANY_REQUESTS, 520, # Galaxy rate limit error code (Cloudflare unknown error) -] + HTTPStatus.BAD_GATEWAY, # Common error from galaxy that may represent any number of transient backend issues +} def cache_lock(func): @@ -48,11 +52,24 @@ def cache_lock(func): return wrapped -def is_rate_limit_exception(exception): +def should_retry_error(exception): # Note: cloud.redhat.com masks rate limit errors with 403 (Forbidden) error codes. # Since 403 could reflect the actual problem (such as an expired token), we should # not retry by default. - return isinstance(exception, GalaxyError) and exception.http_code in RETRY_HTTP_ERROR_CODES + if isinstance(exception, GalaxyError) and exception.http_code in RETRY_HTTP_ERROR_CODES: + return True + + if isinstance(exception, AnsibleError) and (orig_exc := getattr(exception, 'orig_exc', None)): + # URLError is often a proxy for an underlying error, handle wrapped exceptions + if isinstance(orig_exc, URLError): + orig_exc = orig_exc.reason + + # Handle common URL related errors such as TimeoutError, and BadStatusLine + # Note: socket.timeout is only required for Py3.9 + if isinstance(orig_exc, (TimeoutError, BadStatusLine, IncompleteRead, socket.timeout)): + return True + + return False def g_connect(versions): @@ -327,7 +344,7 @@ class GalaxyAPI: @retry_with_delays_and_condition( backoff_iterator=generate_jittered_backoff(retries=6, delay_base=2, delay_threshold=40), - should_retry_error=is_rate_limit_exception + should_retry_error=should_retry_error ) def _call_galaxy(self, url, args=None, headers=None, method=None, auth_required=False, error_context_msg=None, cache=False, cache_key=None): @@ -385,7 +402,10 @@ class GalaxyAPI: except HTTPError as e: raise GalaxyError(e, error_context_msg) except Exception as e: - raise AnsibleError("Unknown error when attempting to call Galaxy at '%s': %s" % (url, to_native(e))) + raise AnsibleError( + "Unknown error when attempting to call Galaxy at '%s': %s" % (url, to_native(e)), + orig_exc=e + ) resp_data = to_text(resp.read(), errors='surrogate_or_strict') try: @@ -906,8 +926,7 @@ class GalaxyAPI: try: signatures = data["signatures"] except KeyError: - # Noisy since this is used by the dep resolver, so require more verbosity than Galaxy calls - display.vvvvvv(f"Server {self.api_server} has not signed {namespace}.{name}:{version}") + display.vvvv(f"Server {self.api_server} has not signed {namespace}.{name}:{version}") return [] else: return [signature_info["signature"] for signature_info in signatures] diff --git a/lib/ansible/galaxy/collection/__init__.py b/lib/ansible/galaxy/collection/__init__.py index 7a144c0d..23482665 100644 --- a/lib/ansible/galaxy/collection/__init__.py +++ b/lib/ansible/galaxy/collection/__init__.py @@ -767,6 +767,9 @@ def install_collections( "Skipping signature verification." ) + if concrete_coll_pin.type == 'galaxy': + concrete_coll_pin = concrete_coll_pin.with_signatures_repopulated() + try: install(concrete_coll_pin, output_path, artifacts_manager) except AnsibleError as err: @@ -911,7 +914,7 @@ def verify_collections( # NOTE: If there are no Galaxy server signatures, only user-provided signature URLs, # NOTE: those alone validate the MANIFEST.json and the remote collection is not downloaded. # NOTE: The remote MANIFEST.json is only used in verification if there are no signatures. - if not signatures and not collection.signature_sources: + if artifacts_manager.keyring is None or not signatures: api_proxy.get_collection_version_metadata( remote_collection, ) diff --git a/lib/ansible/galaxy/collection/concrete_artifact_manager.py b/lib/ansible/galaxy/collection/concrete_artifact_manager.py index 7c920b85..67d8e43f 100644 --- a/lib/ansible/galaxy/collection/concrete_artifact_manager.py +++ b/lib/ansible/galaxy/collection/concrete_artifact_manager.py @@ -27,9 +27,12 @@ if t.TYPE_CHECKING: from ansible.errors import AnsibleError from ansible.galaxy import get_collections_galaxy_meta_info +from ansible.galaxy.api import should_retry_error from ansible.galaxy.dependency_resolution.dataclasses import _GALAXY_YAML from ansible.galaxy.user_agent import user_agent from ansible.module_utils._text import to_bytes, to_native, to_text +from ansible.module_utils.api import retry_with_delays_and_condition +from ansible.module_utils.api import generate_jittered_backoff from ansible.module_utils.common.process import get_bin_path from ansible.module_utils.common._collections_compat import MutableMapping from ansible.module_utils.common.yaml import yaml_load @@ -160,17 +163,24 @@ class ConcreteArtifactsManager: token=token, ) # type: bytes except URLError as err: - raise_from( - AnsibleError( - 'Failed to download collection tar ' - "from '{coll_src!s}': {download_err!s}". - format( - coll_src=to_native(collection.src), - download_err=to_native(err), - ), + raise AnsibleError( + 'Failed to download collection tar ' + "from '{coll_src!s}': {download_err!s}". + format( + coll_src=to_native(collection.src), + download_err=to_native(err), ), - err, - ) + ) from err + except Exception as err: + raise AnsibleError( + 'Failed to download collection tar ' + "from '{coll_src!s}' due to the following unforeseen error: " + '{download_err!s}'. + format( + coll_src=to_native(collection.src), + download_err=to_native(err), + ), + ) from err else: display.vvv( "Collection '{coll!s}' obtained from " @@ -460,6 +470,10 @@ def _extract_collection_from_git(repo_url, coll_ver, b_path): # FIXME: use random subdirs while preserving the file names +@retry_with_delays_and_condition( + backoff_iterator=generate_jittered_backoff(retries=6, delay_base=2, delay_threshold=40), + should_retry_error=should_retry_error +) def _download_file(url, b_path, expected_hash, validate_certs, token=None, timeout=60): # type: (str, bytes, t.Optional[str], bool, GalaxyToken, int) -> bytes # ^ NOTE: used in download and verify_collections ^ @@ -478,13 +492,16 @@ def _download_file(url, b_path, expected_hash, validate_certs, token=None, timeo display.display("Downloading %s to %s" % (url, to_text(b_tarball_dir))) # NOTE: Galaxy redirects downloads to S3 which rejects the request # NOTE: if an Authorization header is attached so don't redirect it - resp = open_url( - to_native(url, errors='surrogate_or_strict'), - validate_certs=validate_certs, - headers=None if token is None else token.headers(), - unredirected_headers=['Authorization'], http_agent=user_agent(), - timeout=timeout - ) + try: + resp = open_url( + to_native(url, errors='surrogate_or_strict'), + validate_certs=validate_certs, + headers=None if token is None else token.headers(), + unredirected_headers=['Authorization'], http_agent=user_agent(), + timeout=timeout + ) + except Exception as err: + raise AnsibleError(to_native(err), orig_exc=err) with open(b_file_path, 'wb') as download_file: # type: t.BinaryIO actual_hash = _consume_file(resp, write_to=download_file) diff --git a/lib/ansible/galaxy/dependency_resolution/dataclasses.py b/lib/ansible/galaxy/dependency_resolution/dataclasses.py index 16fd6318..32acabdf 100644 --- a/lib/ansible/galaxy/dependency_resolution/dataclasses.py +++ b/lib/ansible/galaxy/dependency_resolution/dataclasses.py @@ -27,7 +27,7 @@ if t.TYPE_CHECKING: ) -from ansible.errors import AnsibleError +from ansible.errors import AnsibleError, AnsibleAssertionError from ansible.galaxy.api import GalaxyAPI from ansible.module_utils._text import to_bytes, to_native, to_text from ansible.module_utils.common.arg_spec import ArgumentSpecValidator @@ -166,6 +166,7 @@ def _is_concrete_artifact_pointer(tested_str): class _ComputedReqKindsMixin: + UNIQUE_ATTRS = ('fqcn', 'ver', 'src', 'type') def __init__(self, *args, **kwargs): if not self.may_have_offline_galaxy_info: @@ -180,6 +181,12 @@ class _ComputedReqKindsMixin: self.ver ) + def __hash__(self): + return hash(tuple(getattr(self, attr) for attr in _ComputedReqKindsMixin.UNIQUE_ATTRS)) + + def __eq__(self, candidate): + return hash(self) == hash(candidate) + @classmethod def from_dir_path_as_unknown( # type: ignore[misc] cls, # type: t.Type[Collection] @@ -571,3 +578,13 @@ class Candidate( def __init__(self, *args, **kwargs): super(Candidate, self).__init__() + + def with_signatures_repopulated(self): # type: (Candidate) -> Candidate + """Populate a new Candidate instance with Galaxy signatures. + :raises AnsibleAssertionError: If the supplied candidate is not sourced from a Galaxy-like index. + """ + if self.type != 'galaxy': + raise AnsibleAssertionError(f"Invalid collection type for {self!r}: unable to get signatures from a galaxy server.") + + signatures = self.src.get_collection_signatures(self.namespace, self.name, self.ver) + return self.__class__(self.fqcn, self.ver, self.src, self.type, frozenset([*self.signatures, *signatures])) diff --git a/lib/ansible/galaxy/dependency_resolution/providers.py b/lib/ansible/galaxy/dependency_resolution/providers.py index 817a1eb2..6ad1de84 100644 --- a/lib/ansible/galaxy/dependency_resolution/providers.py +++ b/lib/ansible/galaxy/dependency_resolution/providers.py @@ -28,8 +28,6 @@ from ansible.galaxy.dependency_resolution.versioning import ( from ansible.module_utils.six import string_types from ansible.utils.version import SemanticVersion, LooseVersion -from collections.abc import Set - try: from resolvelib import AbstractProvider from resolvelib import __version__ as resolvelib_version @@ -46,34 +44,6 @@ RESOLVELIB_UPPERBOUND = SemanticVersion("0.9.0") RESOLVELIB_VERSION = SemanticVersion.from_loose_version(LooseVersion(resolvelib_version)) -class PinnedCandidateRequests(Set): - """Custom set class to store Candidate objects. Excludes the 'signatures' attribute when determining if a Candidate instance is in the set.""" - CANDIDATE_ATTRS = ('fqcn', 'ver', 'src', 'type') - - def __init__(self, candidates): - self._candidates = set(candidates) - - def __iter__(self): - return iter(self._candidates) - - def __contains__(self, value): - if not isinstance(value, Candidate): - raise ValueError(f"Expected a Candidate object but got {value!r}") - for candidate in self._candidates: - # Compare Candidate attributes excluding "signatures" since it is - # unrelated to whether or not a matching Candidate is user-requested. - # Candidate objects in the set are not expected to have signatures. - for attr in PinnedCandidateRequests.CANDIDATE_ATTRS: - if getattr(value, attr) != getattr(candidate, attr): - break - else: - return True - return False - - def __len__(self): - return len(self._candidates) - - class CollectionDependencyProviderBase(AbstractProvider): """Delegate providing a requirement interface for the resolver.""" @@ -117,7 +87,7 @@ class CollectionDependencyProviderBase(AbstractProvider): Requirement.from_requirement_dict, art_mgr=concrete_artifacts_manager, ) - self._pinned_candidate_requests = PinnedCandidateRequests( + self._pinned_candidate_requests = set( # NOTE: User-provided signatures are supplemental, so signatures # NOTE: are not used to determine if a candidate is user-requested Candidate(req.fqcn, req.ver, req.src, req.type, None) @@ -392,7 +362,6 @@ class CollectionDependencyProviderBase(AbstractProvider): if not unsatisfied: if self._include_signatures: - signatures = src_server.get_collection_signatures(first_req.namespace, first_req.name, version) for extra_source in extra_signature_sources: signatures.append(get_signature_from_source(extra_source)) latest_matches.append( diff --git a/lib/ansible/module_utils/ansible_release.py b/lib/ansible/module_utils/ansible_release.py index 66a04b98..f59976b8 100644 --- a/lib/ansible/module_utils/ansible_release.py +++ b/lib/ansible/module_utils/ansible_release.py @@ -19,6 +19,6 @@ from __future__ import (absolute_import, division, print_function) __metaclass__ = type -__version__ = '2.14.3' +__version__ = '2.14.6' __author__ = 'Ansible, Inc.' __codename__ = "C'mon Everybody" diff --git a/lib/ansible/module_utils/api.py b/lib/ansible/module_utils/api.py index e780ec6b..2de8a4ef 100644 --- a/lib/ansible/module_utils/api.py +++ b/lib/ansible/module_utils/api.py @@ -26,11 +26,15 @@ The 'api' module provides the following common argument specs: from __future__ import (absolute_import, division, print_function) __metaclass__ = type +import copy import functools +import itertools import random import sys import time +import ansible.module_utils.compat.typing as t + def rate_limit_argument_spec(spec=None): """Creates an argument spec for working with rate limiting""" @@ -141,6 +145,15 @@ def retry_with_delays_and_condition(backoff_iterator, should_retry_error=None): :param backoff_iterator: An iterable of delays in seconds. :param should_retry_error: A callable that takes an exception of the decorated function and decides whether to retry or not (returns a bool). """ + def _emit_isolated_iterator_copies(original_iterator): # type: (t.Iterable[t.Any]) -> t.Generator + # Ref: https://stackoverflow.com/a/30232619/595220 + _copiable_iterator, _first_iterator_copy = itertools.tee(original_iterator) + yield _first_iterator_copy + while True: + yield copy.copy(_copiable_iterator) + backoff_iterator_generator = _emit_isolated_iterator_copies(backoff_iterator) + del backoff_iterator # prevent accidental use elsewhere + if should_retry_error is None: should_retry_error = retry_never @@ -152,7 +165,7 @@ def retry_with_delays_and_condition(backoff_iterator, should_retry_error=None): """ call_retryable_function = functools.partial(function, *args, **kwargs) - for delay in backoff_iterator: + for delay in next(backoff_iterator_generator): try: return call_retryable_function() except Exception as e: diff --git a/lib/ansible/module_utils/csharp/Ansible.Basic.cs b/lib/ansible/module_utils/csharp/Ansible.Basic.cs index c68281ef..97f5f3e2 100644 --- a/lib/ansible/module_utils/csharp/Ansible.Basic.cs +++ b/lib/ansible/module_utils/csharp/Ansible.Basic.cs @@ -1,6 +1,8 @@ +using Microsoft.Win32.SafeHandles; using System; using System.Collections; using System.Collections.Generic; +using System.ComponentModel; using System.Diagnostics; using System.IO; using System.Linq; @@ -176,7 +178,8 @@ namespace Ansible.Basic } string dateTime = DateTime.Now.ToFileTime().ToString(); - string dirName = String.Format("ansible-moduletmp-{0}-{1}", dateTime, new Random().Next(0, int.MaxValue)); + string dirName = String.Format("ansible-moduletmp-{0}-{1}-{2}", dateTime, System.Diagnostics.Process.GetCurrentProcess().Id, + new Random().Next(0, int.MaxValue)); string newTmpdir = Path.Combine(baseDir, dirName); #if CORECLR DirectoryInfo tmpdirInfo = Directory.CreateDirectory(newTmpdir); @@ -309,8 +312,8 @@ namespace Ansible.Basic public void ExitJson() { - WriteLine(GetFormattedResults(Result)); CleanupFiles(null, null); + WriteLine(GetFormattedResults(Result)); Exit(0); } @@ -337,8 +340,8 @@ namespace Ansible.Basic Result["exception"] = exception.ToString(); } - WriteLine(GetFormattedResults(Result)); CleanupFiles(null, null); + WriteLine(GetFormattedResults(Result)); Exit(1); } @@ -1444,10 +1447,22 @@ namespace Ansible.Basic { foreach (string path in cleanupFiles) { - if (File.Exists(path)) - File.Delete(path); - else if (Directory.Exists(path)) - Directory.Delete(path, true); + try + { +#if WINDOWS + FileCleaner.Delete(path); +#else + if (File.Exists(path)) + File.Delete(path); + else if (Directory.Exists(path)) + Directory.Delete(path, true); +#endif + } + catch (Exception e) + { + Warn(string.Format("Failure cleaning temp path '{0}': {1} {2}", + path, e.GetType().Name, e.Message)); + } } cleanupFiles = new List<string>(); } @@ -1486,4 +1501,247 @@ namespace Ansible.Basic Console.WriteLine(line); } } + +#if WINDOWS + // Windows is tricky as AVs and other software might still + // have an open handle to files causing a failure. Use a + // custom deletion mechanism to remove the files/dirs. + // https://github.com/ansible/ansible/pull/80247 + internal static class FileCleaner + { + private const int FileDispositionInformation = 13; + private const int FileDispositionInformationEx = 64; + + private const int ERROR_INVALID_PARAMETER = 0x00000057; + private const int ERROR_DIR_NOT_EMPTY = 0x00000091; + + private static bool? _supportsPosixDelete = null; + + [Flags()] + public enum DispositionFlags : uint + { + FILE_DISPOSITION_DO_NOT_DELETE = 0x00000000, + FILE_DISPOSITION_DELETE = 0x00000001, + FILE_DISPOSITION_POSIX_SEMANTICS = 0x00000002, + FILE_DISPOSITION_FORCE_IMAGE_SECTION_CHECK = 0x00000004, + FILE_DISPOSITION_ON_CLOSE = 0x00000008, + FILE_DISPOSITION_IGNORE_READONLY_ATTRIBUTE = 0x00000010, + } + + [Flags()] + public enum FileFlags : uint + { + FILE_FLAG_OPEN_NO_RECALL = 0x00100000, + FILE_FLAG_OPEN_REPARSE_POINT = 0x00200000, + FILE_FLAG_SESSION_AWARE = 0x00800000, + FILE_FLAG_POSIX_SEMANTICS = 0x01000000, + FILE_FLAG_BACKUP_SEMANTICS = 0x02000000, + FILE_FLAG_DELETE_ON_CLOSE = 0x04000000, + FILE_FLAG_SEQUENTIAL_SCAN = 0x08000000, + FILE_FLAG_RANDOM_ACCESS = 0x10000000, + FILE_FLAG_NO_BUFFERING = 0x20000000, + FILE_FLAG_OVERLAPPED = 0x40000000, + FILE_FLAG_WRITE_THROUGH = 0x80000000, + } + + [DllImport("Kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)] + private static extern SafeFileHandle CreateFileW( + [MarshalAs(UnmanagedType.LPWStr)] string lpFileName, + FileSystemRights dwDesiredAccess, + FileShare dwShareMode, + IntPtr lpSecurityAttributes, + FileMode dwCreationDisposition, + uint dwFlagsAndAttributes, + IntPtr hTemplateFile); + + private static SafeFileHandle CreateFile(string path, FileSystemRights access, FileShare share, FileMode mode, + FileAttributes attributes, FileFlags flags) + { + uint flagsAndAttributes = (uint)attributes | (uint)flags; + SafeFileHandle handle = CreateFileW(path, access, share, IntPtr.Zero, mode, flagsAndAttributes, + IntPtr.Zero); + if (handle.IsInvalid) + { + int errCode = Marshal.GetLastWin32Error(); + string msg = string.Format("CreateFileW({0}) failed 0x{1:X8}: {2}", + path, errCode, new Win32Exception(errCode).Message); + throw new Win32Exception(errCode, msg); + } + + return handle; + } + + [DllImport("Ntdll.dll")] + private static extern int NtSetInformationFile( + SafeFileHandle FileHandle, + out IntPtr IoStatusBlock, + ref int FileInformation, + int Length, + int FileInformationClass); + + [DllImport("Ntdll.dll")] + private static extern int RtlNtStatusToDosError( + int Status); + + public static void Delete(string path) + { + if (File.Exists(path)) + { + DeleteEntry(path, FileAttributes.ReadOnly); + } + else if (Directory.Exists(path)) + { + Queue<DirectoryInfo> dirQueue = new Queue<DirectoryInfo>(); + dirQueue.Enqueue(new DirectoryInfo(path)); + bool nonEmptyDirs = false; + HashSet<string> processedDirs = new HashSet<string>(); + + while (dirQueue.Count > 0) + { + DirectoryInfo currentDir = dirQueue.Dequeue(); + + bool deleteDir = true; + if (processedDirs.Add(currentDir.FullName)) + { + foreach (FileSystemInfo entry in currentDir.EnumerateFileSystemInfos()) + { + // Tries to delete each entry. Failures are ignored + // as they will be picked up when the dir is + // deleted and not empty. + if (entry is DirectoryInfo) + { + if ((entry.Attributes & FileAttributes.ReparsePoint) != 0) + { + // If it's a reparse point, just delete it directly. + DeleteEntry(entry.FullName, entry.Attributes, ignoreFailure: true); + } + else + { + // Add the dir to the queue to delete and it will be processed next round. + dirQueue.Enqueue((DirectoryInfo)entry); + deleteDir = false; + } + } + else + { + DeleteEntry(entry.FullName, entry.Attributes, ignoreFailure: true); + } + } + } + + if (deleteDir) + { + try + { + DeleteEntry(currentDir.FullName, FileAttributes.Directory); + } + catch (Win32Exception e) + { + if (e.NativeErrorCode == ERROR_DIR_NOT_EMPTY) + { + nonEmptyDirs = true; + } + else + { + throw; + } + } + } + else + { + dirQueue.Enqueue(currentDir); + } + } + + if (nonEmptyDirs) + { + throw new IOException("Directory contains files still open by other processes"); + } + } + } + + private static void DeleteEntry(string path, FileAttributes attr, bool ignoreFailure = false) + { + try + { + if ((attr & FileAttributes.ReadOnly) != 0) + { + // Windows does not allow files set with ReadOnly to be + // deleted. Pre-emptively unset the attribute. + // FILE_DISPOSITION_IGNORE_READONLY_ATTRIBUTE is quite new, + // look at using that flag with POSIX delete once Server 2019 + // is the baseline. + File.SetAttributes(path, FileAttributes.Normal); + } + + // REPARSE - Only touch the symlink itself and not the target + // BACKUP - Needed for dir handles, bypasses access checks for admins + // DELETE_ON_CLOSE is not used as it interferes with the POSIX delete + FileFlags flags = FileFlags.FILE_FLAG_OPEN_REPARSE_POINT | + FileFlags.FILE_FLAG_BACKUP_SEMANTICS; + + using (SafeFileHandle fileHandle = CreateFile(path, FileSystemRights.Delete, + FileShare.ReadWrite | FileShare.Delete, FileMode.Open, FileAttributes.Normal, flags)) + { + if (_supportsPosixDelete == null || _supportsPosixDelete == true) + { + // A POSIX delete will delete the filesystem entry even if + // it's still opened by another process so favour that if + // available. + DispositionFlags deleteFlags = DispositionFlags.FILE_DISPOSITION_DELETE | + DispositionFlags.FILE_DISPOSITION_POSIX_SEMANTICS; + + SetInformationFile(fileHandle, FileDispositionInformationEx, (int)deleteFlags); + if (_supportsPosixDelete == true) + { + return; + } + } + + // FileDispositionInformation takes in a struct with only a BOOLEAN value. + // Using an int will also do the same thing to set that flag to true. + SetInformationFile(fileHandle, FileDispositionInformation, Int32.MaxValue); + } + } + catch + { + if (!ignoreFailure) + { + throw; + } + } + } + + private static void SetInformationFile(SafeFileHandle handle, int infoClass, int value) + { + IntPtr ioStatusBlock = IntPtr.Zero; + + int ntStatus = NtSetInformationFile(handle, out ioStatusBlock, ref value, + Marshal.SizeOf(typeof(int)), infoClass); + + if (ntStatus != 0) + { + int errCode = RtlNtStatusToDosError(ntStatus); + + // The POSIX delete was added in Server 2016 (Win 10 14393/Redstone 1) + // Mark this flag so we don't try again. + if (infoClass == FileDispositionInformationEx && _supportsPosixDelete == null && + errCode == ERROR_INVALID_PARAMETER) + { + _supportsPosixDelete = false; + return; + } + + string msg = string.Format("NtSetInformationFile() failed 0x{0:X8}: {1}", + errCode, new Win32Exception(errCode).Message); + throw new Win32Exception(errCode, msg); + } + + if (infoClass == FileDispositionInformationEx) + { + _supportsPosixDelete = true; + } + } + } +#endif } diff --git a/lib/ansible/modules/copy.py b/lib/ansible/modules/copy.py index 37115faf..9bbc02f7 100644 --- a/lib/ansible/modules/copy.py +++ b/lib/ansible/modules/copy.py @@ -616,6 +616,8 @@ def main(): e.result['msg'] += ' Could not copy to {0}'.format(dest) module.fail_json(**e.results) + if module.check_mode: + module.exit_json(msg='dest directory %s would be created' % dirname, changed=True, src=src) os.makedirs(b_dirname) directory_args = module.load_file_common_arguments(module.params) directory_mode = module.params["directory_mode"] @@ -814,9 +816,8 @@ def main(): if backup_file: res_args['backup_file'] = backup_file - if not module.check_mode: - file_args = module.load_file_common_arguments(module.params, path=dest) - res_args['changed'] = module.set_fs_attributes_if_different(file_args, res_args['changed']) + file_args = module.load_file_common_arguments(module.params, path=dest) + res_args['changed'] = module.set_fs_attributes_if_different(file_args, res_args['changed']) module.exit_json(**res_args) diff --git a/lib/ansible/modules/package_facts.py b/lib/ansible/modules/package_facts.py index 57c1d3ea..ea3c6999 100644 --- a/lib/ansible/modules/package_facts.py +++ b/lib/ansible/modules/package_facts.py @@ -37,6 +37,8 @@ version_added: "2.5" requirements: - For 'portage' support it requires the C(qlist) utility, which is part of 'app-portage/portage-utils'. - For Debian-based systems C(python-apt) package must be installed on targeted hosts. + - For SUSE-based systems C(python3-rpm) package must be installed on targeted hosts. + This package is required because SUSE does not include RPM Python bindings by default. author: - Matthew Jones (@matburt) - Brian Coca (@bcoca) diff --git a/lib/ansible/modules/uri.py b/lib/ansible/modules/uri.py index f68b86a5..7919b9b2 100644 --- a/lib/ansible/modules/uri.py +++ b/lib/ansible/modules/uri.py @@ -94,9 +94,16 @@ options: force_basic_auth: description: - Force the sending of the Basic authentication header upon initial request. - - The library used by the uri module only sends authentication information when a webservice - responds to an initial request with a 401 status. Since some basic auth services do not properly - send a 401, logins will fail. + - When this setting is C(false), this module will first try an unauthenticated request, and when the server replies + with an C(HTTP 401) error, it will submit the Basic authentication header. + - When this setting is C(true), this module will immediately send a Basic authentication header on the first + request. + - "Use this setting in any of the following scenarios:" + - You know the webservice endpoint always requires HTTP Basic authentication, and you want to speed up your + requests by eliminating the first roundtrip. + - The web service does not properly send an HTTP 401 error to your client, so Ansible's HTTP library will not + properly respond with HTTP credentials, and logins will fail. + - The webservice bans or rate-limits clients that cause any HTTP 401 errors. type: bool default: no follow_redirects: diff --git a/lib/ansible/playbook/attribute.py b/lib/ansible/playbook/attribute.py index b28405d2..692aa9a7 100644 --- a/lib/ansible/playbook/attribute.py +++ b/lib/ansible/playbook/attribute.py @@ -178,7 +178,6 @@ class FieldAttribute(Attribute): value = self.default if callable(value): value = value() - setattr(obj, f'_{self.name}', value) return value diff --git a/lib/ansible/playbook/handler.py b/lib/ansible/playbook/handler.py index 675eecb3..68970b4f 100644 --- a/lib/ansible/playbook/handler.py +++ b/lib/ansible/playbook/handler.py @@ -19,14 +19,14 @@ from __future__ import (absolute_import, division, print_function) __metaclass__ = type -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.task import Task from ansible.module_utils.six import string_types class Handler(Task): - listen = FieldAttribute(isa='list', default=list, listof=string_types, static=True) + listen = NonInheritableFieldAttribute(isa='list', default=list, listof=string_types, static=True) def __init__(self, block=None, role=None, task_include=None): self.notified_hosts = [] diff --git a/lib/ansible/playbook/helpers.py b/lib/ansible/playbook/helpers.py index 38e32ef9..ff5042a7 100644 --- a/lib/ansible/playbook/helpers.py +++ b/lib/ansible/playbook/helpers.py @@ -308,6 +308,7 @@ def load_list_of_tasks(ds, play, block=None, role=None, task_include=None, use_h # template the role name now, if needed all_vars = variable_manager.get_vars(play=play, task=ir) templar = Templar(loader=loader, variables=all_vars) + ir.post_validate(templar=templar) ir._role_name = templar.template(ir._role_name) # uses compiled list from object diff --git a/lib/ansible/playbook/included_file.py b/lib/ansible/playbook/included_file.py index 409eaec7..b833077c 100644 --- a/lib/ansible/playbook/included_file.py +++ b/lib/ansible/playbook/included_file.py @@ -187,6 +187,7 @@ class IncludedFile: role_name = templar.template(role_name) new_task = original_task.copy() + new_task.post_validate(templar=templar) new_task._role_name = role_name for from_arg in new_task.FROM_ARGS: if from_arg in include_args: diff --git a/lib/ansible/playbook/loop_control.py b/lib/ansible/playbook/loop_control.py index 2f561665..d69e14fb 100644 --- a/lib/ansible/playbook/loop_control.py +++ b/lib/ansible/playbook/loop_control.py @@ -19,18 +19,18 @@ from __future__ import (absolute_import, division, print_function) __metaclass__ = type -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.base import FieldAttributeBase class LoopControl(FieldAttributeBase): - loop_var = FieldAttribute(isa='str', default='item', always_post_validate=True) - index_var = FieldAttribute(isa='str', always_post_validate=True) - label = FieldAttribute(isa='str') - pause = FieldAttribute(isa='float', default=0, always_post_validate=True) - extended = FieldAttribute(isa='bool', always_post_validate=True) - extended_allitems = FieldAttribute(isa='bool', default=True, always_post_validate=True) + loop_var = NonInheritableFieldAttribute(isa='str', default='item', always_post_validate=True) + index_var = NonInheritableFieldAttribute(isa='str', always_post_validate=True) + label = NonInheritableFieldAttribute(isa='str') + pause = NonInheritableFieldAttribute(isa='float', default=0, always_post_validate=True) + extended = NonInheritableFieldAttribute(isa='bool', always_post_validate=True) + extended_allitems = NonInheritableFieldAttribute(isa='bool', default=True, always_post_validate=True) def __init__(self): super(LoopControl, self).__init__() diff --git a/lib/ansible/playbook/play.py b/lib/ansible/playbook/play.py index 23bb36b2..3b763b9e 100644 --- a/lib/ansible/playbook/play.py +++ b/lib/ansible/playbook/play.py @@ -25,7 +25,7 @@ from ansible.errors import AnsibleParserError, AnsibleAssertionError from ansible.module_utils._text import to_native from ansible.module_utils.common.collections import is_sequence from ansible.module_utils.six import binary_type, string_types, text_type -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.base import Base from ansible.playbook.block import Block from ansible.playbook.collectionsearch import CollectionSearch @@ -55,35 +55,35 @@ class Play(Base, Taggable, CollectionSearch): """ # ================================================================================= - hosts = FieldAttribute(isa='list', required=True, listof=string_types, always_post_validate=True, priority=-2) + hosts = NonInheritableFieldAttribute(isa='list', required=True, listof=string_types, always_post_validate=True, priority=-2) # Facts - gather_facts = FieldAttribute(isa='bool', default=None, always_post_validate=True) + gather_facts = NonInheritableFieldAttribute(isa='bool', default=None, always_post_validate=True) # defaults to be deprecated, should be 'None' in future - gather_subset = FieldAttribute(isa='list', default=(lambda: C.DEFAULT_GATHER_SUBSET), listof=string_types, always_post_validate=True) - gather_timeout = FieldAttribute(isa='int', default=C.DEFAULT_GATHER_TIMEOUT, always_post_validate=True) - fact_path = FieldAttribute(isa='string', default=C.DEFAULT_FACT_PATH) + gather_subset = NonInheritableFieldAttribute(isa='list', default=(lambda: C.DEFAULT_GATHER_SUBSET), listof=string_types, always_post_validate=True) + gather_timeout = NonInheritableFieldAttribute(isa='int', default=C.DEFAULT_GATHER_TIMEOUT, always_post_validate=True) + fact_path = NonInheritableFieldAttribute(isa='string', default=C.DEFAULT_FACT_PATH) # Variable Attributes - vars_files = FieldAttribute(isa='list', default=list, priority=99) - vars_prompt = FieldAttribute(isa='list', default=list, always_post_validate=False) + vars_files = NonInheritableFieldAttribute(isa='list', default=list, priority=99) + vars_prompt = NonInheritableFieldAttribute(isa='list', default=list, always_post_validate=False) # Role Attributes - roles = FieldAttribute(isa='list', default=list, priority=90) + roles = NonInheritableFieldAttribute(isa='list', default=list, priority=90) # Block (Task) Lists Attributes - handlers = FieldAttribute(isa='list', default=list, priority=-1) - pre_tasks = FieldAttribute(isa='list', default=list, priority=-1) - post_tasks = FieldAttribute(isa='list', default=list, priority=-1) - tasks = FieldAttribute(isa='list', default=list, priority=-1) + handlers = NonInheritableFieldAttribute(isa='list', default=list, priority=-1) + pre_tasks = NonInheritableFieldAttribute(isa='list', default=list, priority=-1) + post_tasks = NonInheritableFieldAttribute(isa='list', default=list, priority=-1) + tasks = NonInheritableFieldAttribute(isa='list', default=list, priority=-1) # Flag/Setting Attributes - force_handlers = FieldAttribute(isa='bool', default=context.cliargs_deferred_get('force_handlers'), always_post_validate=True) - max_fail_percentage = FieldAttribute(isa='percent', always_post_validate=True) - serial = FieldAttribute(isa='list', default=list, always_post_validate=True) - strategy = FieldAttribute(isa='string', default=C.DEFAULT_STRATEGY, always_post_validate=True) - order = FieldAttribute(isa='string', always_post_validate=True) + force_handlers = NonInheritableFieldAttribute(isa='bool', default=context.cliargs_deferred_get('force_handlers'), always_post_validate=True) + max_fail_percentage = NonInheritableFieldAttribute(isa='percent', always_post_validate=True) + serial = NonInheritableFieldAttribute(isa='list', default=list, always_post_validate=True) + strategy = NonInheritableFieldAttribute(isa='string', default=C.DEFAULT_STRATEGY, always_post_validate=True) + order = NonInheritableFieldAttribute(isa='string', always_post_validate=True) # ================================================================================= diff --git a/lib/ansible/playbook/playbook_include.py b/lib/ansible/playbook/playbook_include.py index 03210ea3..8e3116f4 100644 --- a/lib/ansible/playbook/playbook_include.py +++ b/lib/ansible/playbook/playbook_include.py @@ -27,7 +27,7 @@ from ansible.module_utils._text import to_bytes from ansible.module_utils.six import string_types from ansible.parsing.splitter import split_args, parse_kv from ansible.parsing.yaml.objects import AnsibleBaseYAMLObject, AnsibleMapping -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.base import Base from ansible.playbook.conditional import Conditional from ansible.playbook.taggable import Taggable @@ -41,8 +41,8 @@ display = Display() class PlaybookInclude(Base, Conditional, Taggable): - import_playbook = FieldAttribute(isa='string') - vars_val = FieldAttribute(isa='dict', default=dict, alias='vars') + import_playbook = NonInheritableFieldAttribute(isa='string') + vars_val = NonInheritableFieldAttribute(isa='dict', default=dict, alias='vars') @staticmethod def load(data, basedir, variable_manager=None, loader=None): diff --git a/lib/ansible/playbook/role/definition.py b/lib/ansible/playbook/role/definition.py index b27a2317..f7ca3a85 100644 --- a/lib/ansible/playbook/role/definition.py +++ b/lib/ansible/playbook/role/definition.py @@ -25,7 +25,7 @@ from ansible import constants as C from ansible.errors import AnsibleError, AnsibleAssertionError from ansible.module_utils.six import string_types from ansible.parsing.yaml.objects import AnsibleBaseYAMLObject, AnsibleMapping -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.base import Base from ansible.playbook.collectionsearch import CollectionSearch from ansible.playbook.conditional import Conditional @@ -43,7 +43,7 @@ display = Display() class RoleDefinition(Base, Conditional, Taggable, CollectionSearch): - role = FieldAttribute(isa='string') + role = NonInheritableFieldAttribute(isa='string') def __init__(self, play=None, role_basedir=None, variable_manager=None, loader=None, collection_list=None): diff --git a/lib/ansible/playbook/role/metadata.py b/lib/ansible/playbook/role/metadata.py index 275ee548..a4dbcf7e 100644 --- a/lib/ansible/playbook/role/metadata.py +++ b/lib/ansible/playbook/role/metadata.py @@ -24,7 +24,7 @@ import os from ansible.errors import AnsibleParserError, AnsibleError from ansible.module_utils._text import to_native from ansible.module_utils.six import string_types -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.base import Base from ansible.playbook.collectionsearch import CollectionSearch from ansible.playbook.helpers import load_list_of_roles @@ -39,10 +39,10 @@ class RoleMetadata(Base, CollectionSearch): within each Role (meta/main.yml). ''' - allow_duplicates = FieldAttribute(isa='bool', default=False) - dependencies = FieldAttribute(isa='list', default=list) - galaxy_info = FieldAttribute(isa='GalaxyInfo') - argument_specs = FieldAttribute(isa='dict', default=dict) + allow_duplicates = NonInheritableFieldAttribute(isa='bool', default=False) + dependencies = NonInheritableFieldAttribute(isa='list', default=list) + galaxy_info = NonInheritableFieldAttribute(isa='GalaxyInfo') + argument_specs = NonInheritableFieldAttribute(isa='dict', default=dict) def __init__(self, owner=None): self._owner = owner diff --git a/lib/ansible/playbook/role_include.py b/lib/ansible/playbook/role_include.py index 39460372..75d26fb8 100644 --- a/lib/ansible/playbook/role_include.py +++ b/lib/ansible/playbook/role_include.py @@ -22,7 +22,7 @@ from os.path import basename import ansible.constants as C from ansible.errors import AnsibleParserError -from ansible.playbook.attribute import FieldAttribute +from ansible.playbook.attribute import NonInheritableFieldAttribute from ansible.playbook.block import Block from ansible.playbook.task_include import TaskInclude from ansible.playbook.role import Role @@ -52,9 +52,9 @@ class IncludeRole(TaskInclude): # ATTRIBUTES # private as this is a 'module options' vs a task property - allow_duplicates = FieldAttribute(isa='bool', default=True, private=True) - public = FieldAttribute(isa='bool', default=False, private=True) - rolespec_validate = FieldAttribute(isa='bool', default=True) + allow_duplicates = NonInheritableFieldAttribute(isa='bool', default=True, private=True, always_post_validate=True) + public = NonInheritableFieldAttribute(isa='bool', default=False, private=True, always_post_validate=True) + rolespec_validate = NonInheritableFieldAttribute(isa='bool', default=True, private=True, always_post_validate=True) def __init__(self, block=None, role=None, task_include=None): diff --git a/lib/ansible/playbook/task.py b/lib/ansible/playbook/task.py index 6a9136d2..ba35fcf0 100644 --- a/lib/ansible/playbook/task.py +++ b/lib/ansible/playbook/task.py @@ -66,22 +66,22 @@ class Task(Base, Conditional, Taggable, CollectionSearch): # inheritance is only triggered if the 'current value' is Sentinel, # default can be set at play/top level object and inheritance will take it's course. - args = FieldAttribute(isa='dict', default=dict) - action = FieldAttribute(isa='string') + args = NonInheritableFieldAttribute(isa='dict', default=dict) + action = NonInheritableFieldAttribute(isa='string') - async_val = FieldAttribute(isa='int', default=0, alias='async') - changed_when = FieldAttribute(isa='list', default=list) - delay = FieldAttribute(isa='int', default=5) + async_val = NonInheritableFieldAttribute(isa='int', default=0, alias='async') + changed_when = NonInheritableFieldAttribute(isa='list', default=list) + delay = NonInheritableFieldAttribute(isa='int', default=5) delegate_to = FieldAttribute(isa='string') delegate_facts = FieldAttribute(isa='bool') - failed_when = FieldAttribute(isa='list', default=list) - loop = FieldAttribute() + failed_when = NonInheritableFieldAttribute(isa='list', default=list) + loop = NonInheritableFieldAttribute() loop_control = NonInheritableFieldAttribute(isa='class', class_type=LoopControl, default=LoopControl) notify = FieldAttribute(isa='list') - poll = FieldAttribute(isa='int', default=C.DEFAULT_POLL_INTERVAL) - register = FieldAttribute(isa='string', static=True) - retries = FieldAttribute(isa='int', default=3) - until = FieldAttribute(isa='list', default=list) + poll = NonInheritableFieldAttribute(isa='int', default=C.DEFAULT_POLL_INTERVAL) + register = NonInheritableFieldAttribute(isa='string', static=True) + retries = NonInheritableFieldAttribute(isa='int', default=3) + until = NonInheritableFieldAttribute(isa='list', default=list) # deprecated, used to be loop and loop_args but loop has been repurposed loop_with = NonInheritableFieldAttribute(isa='string', private=True) diff --git a/lib/ansible/plugins/action/__init__.py b/lib/ansible/plugins/action/__init__.py index d199207c..436fb65a 100644 --- a/lib/ansible/plugins/action/__init__.py +++ b/lib/ansible/plugins/action/__init__.py @@ -1125,7 +1125,7 @@ class ActionBase(ABC): remote_files.append(remote_async_module_path) async_limit = self._task.async_val - async_jid = str(random.randint(0, 999999999999)) + async_jid = f'j{random.randint(0, 999999999999)}' # call the interpreter for async_wrapper directly # this permits use of a script for an interpreter on non-Linux platforms diff --git a/lib/ansible/plugins/filter/basename.yml b/lib/ansible/plugins/filter/basename.yml index 4e868df8..b6e31d23 100644 --- a/lib/ansible/plugins/filter/basename.yml +++ b/lib/ansible/plugins/filter/basename.yml @@ -5,6 +5,8 @@ DOCUMENTATION: short_description: get a path's base name description: - Returns the last name component of a path, what is left in the string that is not 'dirname'. + notes: + - The result of this filter is different from the Unix basename program; where basename for C(/foo/bar/) returns C(bar), the basename filter returns an empty string (C('')). options: _input: description: A path. @@ -15,7 +17,7 @@ DOCUMENTATION: plugin: ansible.builtin.dirname EXAMPLES: | - # To get the last name of a file path, like 'foo.txt' out of '/etc/asdf/foo.txt' + # To get the last name of a file path, like 'foo.txt' out of '/etc/asdf/foo.txt'. {{ mypath | basename }} RETURN: diff --git a/lib/ansible/plugins/filter/combine.yml b/lib/ansible/plugins/filter/combine.yml index 86788f31..4787b447 100644 --- a/lib/ansible/plugins/filter/combine.yml +++ b/lib/ansible/plugins/filter/combine.yml @@ -34,9 +34,14 @@ DOCUMENTATION: EXAMPLES: | # ab => {'a':1, 'b':3, 'c': 4} - ab: {{ {'a':1, 'b':2} | combine({'b':3, 'c':4}) }} + ab: {{ {'a':1, 'b':2} | ansible.builtin.combine({'b':3, 'c':4}) }} - many: "{{ dict1 | combine(dict2, dict3, dict4) }}" + many: "{{ dict1 | ansible.builtin.combine(dict2, dict3, dict4) }}" + + # defaults => {'a':{'b':3, 'c':4}, 'd': 5} + # customization => {'a':{'c':20}} + # final => {'a':{'b':3, 'c':20}, 'd': 5} + final: "{{ defaults | ansible.builtin.combine(customization, recursive=true) }}" RETURN: _value: diff --git a/lib/ansible/plugins/filter/dirname.yml b/lib/ansible/plugins/filter/dirname.yml index 52f7d5d4..4b8b0f7b 100644 --- a/lib/ansible/plugins/filter/dirname.yml +++ b/lib/ansible/plugins/filter/dirname.yml @@ -5,6 +5,8 @@ DOCUMENTATION: short_description: get a path's directory name description: - Returns the 'head' component of a path, basically everything that is not the 'basename'. + notes: + - The result of this filter is different from the Unix dirname program; where dirname for C(/foo/bar/) returns C(/foo), the dirname filter returns the full path (C(/foo/bar/)). options: _input: description: A path. @@ -15,7 +17,7 @@ DOCUMENTATION: plugin_type: filter EXAMPLES: | - # To get the dir name of a file path, like '/etc/asdf' out of '/etc/asdf/foo.txt' + # To get the dir name of a file path, like '/etc/asdf' out of '/etc/asdf/foo.txt'. {{ mypath | dirname }} RETURN: diff --git a/lib/ansible/plugins/filter/subelements.yml b/lib/ansible/plugins/filter/subelements.yml index a2d1a940..818237e9 100644 --- a/lib/ansible/plugins/filter/subelements.yml +++ b/lib/ansible/plugins/filter/subelements.yml @@ -1,7 +1,7 @@ DOCUMENTATION: name: subelements version_added: "2.7" - short_description: retuns a product of a list and it's elements + short_description: returns a product of a list and its elements positional: _input, _subelement, skip_missing description: - This produces a product of an object and the subelement values of that object, similar to the subelements lookup. This lets you specify individual subelements to use in a template I(_input). diff --git a/lib/ansible/plugins/filter/unvault.yml b/lib/ansible/plugins/filter/unvault.yml index 96a82ca8..7f91180a 100644 --- a/lib/ansible/plugins/filter/unvault.yml +++ b/lib/ansible/plugins/filter/unvault.yml @@ -28,7 +28,7 @@ EXAMPLES: | - name: save templated unvaulted data template: src=dump_template_data.j2 dest=/some/key/clear.txt vars: - template_data: '{{ secretdata|uvault(vaultsecret) }}' + template_data: '{{ secretdata|unvault(vaultsecret) }}' RETURN: _value: diff --git a/lib/ansible/plugins/lookup/password.py b/lib/ansible/plugins/lookup/password.py index 06ea8b36..b08845a7 100644 --- a/lib/ansible/plugins/lookup/password.py +++ b/lib/ansible/plugins/lookup/password.py @@ -86,30 +86,30 @@ EXAMPLES = """ - name: create a mysql user with a random password community.mysql.mysql_user: name: "{{ client }}" - password: "{{ lookup('ansible.builtin.password', 'credentials/' + client + '/' + tier + '/' + role + '/mysqlpassword length=15') }}" + password: "{{ lookup('ansible.builtin.password', 'credentials/' + client + '/' + tier + '/' + role + '/mysqlpassword', length=15) }}" priv: "{{ client }}_{{ tier }}_{{ role }}.*:ALL" - name: create a mysql user with a random password using only ascii letters community.mysql.mysql_user: name: "{{ client }}" - password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile chars=ascii_letters') }}" + password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile', chars=['ascii_letters']) }}" priv: '{{ client }}_{{ tier }}_{{ role }}.*:ALL' - name: create a mysql user with an 8 character random password using only digits community.mysql.mysql_user: name: "{{ client }}" - password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile length=8 chars=digits') }}" + password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile', length=8, chars=['digits']) }}" priv: "{{ client }}_{{ tier }}_{{ role }}.*:ALL" - name: create a mysql user with a random password using many different char sets community.mysql.mysql_user: name: "{{ client }}" - password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile chars=ascii_letters,digits,punctuation') }}" + password: "{{ lookup('ansible.builtin.password', '/tmp/passwordfile', chars=['ascii_letters', 'digits', 'punctuation']) }}" priv: "{{ client }}_{{ tier }}_{{ role }}.*:ALL" - name: create lowercase 8 character name for Kubernetes pod name ansible.builtin.set_fact: - random_pod_name: "web-{{ lookup('ansible.builtin.password', '/dev/null chars=ascii_lowercase,digits length=8') }}" + random_pod_name: "web-{{ lookup('ansible.builtin.password', '/dev/null', chars=['ascii_lowercase', 'digits'], length=8) }}" - name: create random but idempotent password ansible.builtin.set_fact: @@ -197,18 +197,31 @@ def _parse_content(content): ''' password = content salt = None + ident = None salt_slug = u' salt=' + ident_slug = u' ident=' + rem = u'' try: sep = content.rindex(salt_slug) except ValueError: # No salt pass else: - salt = password[sep + len(salt_slug):] + rem = content[sep + len(salt_slug):] password = content[:sep] - return password, salt + if rem: + try: + sep = rem.rindex(ident_slug) + except ValueError: + # no ident + salt = rem + else: + ident = rem[sep + len(ident_slug):] + salt = rem[:sep] + + return password, salt, ident def _format_content(password, salt, encrypt=None, ident=None): @@ -338,47 +351,73 @@ class LookupModule(LookupBase): self.set_options(var_options=variables, direct=kwargs) for term in terms: + + changed = None relpath, params = self._parse_parameters(term) path = self._loader.path_dwim(relpath) b_path = to_bytes(path, errors='surrogate_or_strict') chars = _gen_candidate_chars(params['chars']) - - changed = None - # make sure only one process finishes all the job first - first_process, lockfile = _get_lock(b_path) - - content = _read_password_file(b_path) - - if content is None or b_path == to_bytes('/dev/null'): - plaintext_password = random_password(params['length'], chars, params['seed']) - salt = None - changed = True - else: - plaintext_password, salt = _parse_content(content) - - encrypt = params['encrypt'] - if encrypt and not salt: - changed = True - try: - salt = random_salt(BaseHash.algorithms[encrypt].salt_size) - except KeyError: - salt = random_salt() - - ident = params['ident'] - if encrypt and not ident: - changed = True - try: - ident = BaseHash.algorithms[encrypt].implicit_ident - except KeyError: - ident = None - - if changed and b_path != to_bytes('/dev/null'): - content = _format_content(plaintext_password, salt, encrypt=encrypt, ident=ident) - _write_password_file(b_path, content) - - if first_process: - # let other processes continue - _release_lock(lockfile) + ident = None + first_process = None + lockfile = None + + try: + # make sure only one process finishes all the job first + first_process, lockfile = _get_lock(b_path) + content = _read_password_file(b_path) + + if content is None or b_path == to_bytes('/dev/null'): + plaintext_password = random_password(params['length'], chars, params['seed']) + salt = None + changed = True + else: + plaintext_password, salt, ident = _parse_content(content) + + encrypt = params['encrypt'] + if encrypt and not salt: + changed = True + try: + salt = random_salt(BaseHash.algorithms[encrypt].salt_size) + except KeyError: + salt = random_salt() + + ident = params['ident'] + if encrypt and not ident: + changed = True + try: + ident = BaseHash.algorithms[encrypt].implicit_ident + except KeyError: + ident = None + + encrypt = params['encrypt'] + if encrypt and not salt: + changed = True + try: + salt = random_salt(BaseHash.algorithms[encrypt].salt_size) + except KeyError: + salt = random_salt() + + if not ident: + ident = params['ident'] + elif params['ident'] and ident != params['ident']: + raise AnsibleError('The ident parameter provided (%s) does not match the stored one (%s).' % (ident, params['ident'])) + + if encrypt and not ident: + try: + ident = BaseHash.algorithms[encrypt].implicit_ident + except KeyError: + ident = None + if ident: + changed = True + + if changed and b_path != to_bytes('/dev/null'): + content = _format_content(plaintext_password, salt, encrypt=encrypt, ident=ident) + _write_password_file(b_path, content) + + finally: + if first_process: + # let other processes continue + _release_lock(lockfile) if encrypt: password = do_encrypt(plaintext_password, encrypt, salt=salt, ident=ident) diff --git a/lib/ansible/release.py b/lib/ansible/release.py index 66a04b98..f59976b8 100644 --- a/lib/ansible/release.py +++ b/lib/ansible/release.py @@ -19,6 +19,6 @@ from __future__ import (absolute_import, division, print_function) __metaclass__ = type -__version__ = '2.14.3' +__version__ = '2.14.6' __author__ = 'Ansible, Inc.' __codename__ = "C'mon Everybody" diff --git a/lib/ansible/template/__init__.py b/lib/ansible/template/__init__.py index 1498d3f8..17bee104 100644 --- a/lib/ansible/template/__init__.py +++ b/lib/ansible/template/__init__.py @@ -970,7 +970,7 @@ class Templar: # In case this is a recursive call and we set different concat # function up the stack, reset it in case the value of convert_data # changed in this call - self.environment.concat = self.environment.__class__.concat + myenv.concat = myenv.__class__.concat # the concat function is set for each Ansible environment, # however for convert_data=False we need to use the concat # function that avoids any evaluation and set it temporarily @@ -978,13 +978,13 @@ class Templar: # the concat function is called internally in Jinja, # most notably for macro execution if not self.jinja2_native and not convert_data: - self.environment.concat = ansible_concat + myenv.concat = ansible_concat self.cur_context = t.new_context(jvars, shared=True) rf = t.root_render_func(self.cur_context) try: - res = self.environment.concat(rf) + res = myenv.concat(rf) unsafe = getattr(self.cur_context, 'unsafe', False) if unsafe: res = wrap_var(res) @@ -1012,7 +1012,7 @@ class Templar: # "Hello world\n!\n" instead of "Hello world!\n". res_newlines = _count_newlines_from_end(res) if data_newlines > res_newlines: - res += self.environment.newline_sequence * (data_newlines - res_newlines) + res += myenv.newline_sequence * (data_newlines - res_newlines) if unsafe: res = wrap_var(res) return res diff --git a/lib/ansible/template/native_helpers.py b/lib/ansible/template/native_helpers.py index 343e10c7..3014c745 100644 --- a/lib/ansible/template/native_helpers.py +++ b/lib/ansible/template/native_helpers.py @@ -14,7 +14,6 @@ from ansible.module_utils._text import to_text from ansible.module_utils.six import string_types from ansible.parsing.yaml.objects import AnsibleVaultEncryptedUnicode from ansible.utils.native_jinja import NativeJinjaText -from ansible.utils.unsafe_proxy import wrap_var _JSON_MAP = { @@ -60,7 +59,6 @@ def ansible_eval_concat(nodes): # if this looks like a dictionary, list or bool, convert it to such if out.startswith(('{', '[')) or out in ('True', 'False'): - unsafe = hasattr(out, '__UNSAFE__') try: out = ast.literal_eval( ast.fix_missing_locations( @@ -71,9 +69,6 @@ def ansible_eval_concat(nodes): ) except (ValueError, SyntaxError, MemoryError): pass - else: - if unsafe: - out = wrap_var(out) return out diff --git a/lib/ansible/utils/_junit_xml.py b/lib/ansible/utils/_junit_xml.py index 3b958672..76c8878b 100644 --- a/lib/ansible/utils/_junit_xml.py +++ b/lib/ansible/utils/_junit_xml.py @@ -10,6 +10,7 @@ import datetime import decimal from xml.dom import minidom + # noinspection PyPep8Naming from xml.etree import ElementTree as ET @@ -17,6 +18,7 @@ from xml.etree import ElementTree as ET @dataclasses.dataclass # type: ignore[misc] # https://github.com/python/mypy/issues/5374 class TestResult(metaclass=abc.ABCMeta): """Base class for the result of a test case.""" + output: str | None = None message: str | None = None type: str | None = None @@ -48,6 +50,7 @@ class TestResult(metaclass=abc.ABCMeta): @dataclasses.dataclass class TestFailure(TestResult): """Failure info for a test case.""" + @property def tag(self) -> str: """Tag name for the XML element created by this result type.""" @@ -57,6 +60,7 @@ class TestFailure(TestResult): @dataclasses.dataclass class TestError(TestResult): """Error info for a test case.""" + @property def tag(self) -> str: """Tag name for the XML element created by this result type.""" @@ -66,6 +70,7 @@ class TestError(TestResult): @dataclasses.dataclass class TestCase: """An individual test case.""" + name: str assertions: int | None = None classname: str | None = None @@ -127,6 +132,7 @@ class TestCase: @dataclasses.dataclass class TestSuite: """A collection of test cases.""" + name: str hostname: str | None = None id: str | None = None @@ -138,6 +144,10 @@ class TestSuite: system_out: str | None = None system_err: str | None = None + def __post_init__(self): + if self.timestamp and self.timestamp.tzinfo != datetime.timezone.utc: + raise ValueError(f'timestamp.tzinfo must be {datetime.timezone.utc!r}') + @property def disabled(self) -> int: """The number of disabled test cases.""" @@ -181,7 +191,7 @@ class TestSuite: skipped=self.skipped, tests=self.tests, time=self.time, - timestamp=self.timestamp.isoformat(timespec='seconds') if self.timestamp else None, + timestamp=self.timestamp.replace(tzinfo=None).isoformat(timespec='seconds') if self.timestamp else None, ) def get_xml_element(self) -> ET.Element: @@ -205,6 +215,7 @@ class TestSuite: @dataclasses.dataclass class TestSuites: """A collection of test suites.""" + name: str | None = None suites: list[TestSuite] = dataclasses.field(default_factory=list) diff --git a/lib/ansible/utils/display.py b/lib/ansible/utils/display.py index e521f2a4..7d98ad47 100644 --- a/lib/ansible/utils/display.py +++ b/lib/ansible/utils/display.py @@ -228,6 +228,12 @@ class Display(metaclass=Singleton): except Exception as ex: self.warning(f"failed to patch stdout/stderr for fork-safety: {ex}") + try: + sys.stdout.reconfigure(errors='replace') + sys.stderr.reconfigure(errors='replace') + except Exception as ex: + self.warning(f"failed to reconfigure stdout/stderr with the replace error handler: {ex}") + def set_queue(self, queue): """Set the _final_q on Display, so that we know to proxy display over the queue instead of directly writing to stdout/stderr from forks diff --git a/lib/ansible/utils/encrypt.py b/lib/ansible/utils/encrypt.py index 3a8642d8..661fde34 100644 --- a/lib/ansible/utils/encrypt.py +++ b/lib/ansible/utils/encrypt.py @@ -240,12 +240,15 @@ class PasslibHash(BaseHash): settings['ident'] = ident # starting with passlib 1.7 'using' and 'hash' should be used instead of 'encrypt' - if hasattr(self.crypt_algo, 'hash'): - result = self.crypt_algo.using(**settings).hash(secret) - elif hasattr(self.crypt_algo, 'encrypt'): - result = self.crypt_algo.encrypt(secret, **settings) - else: - raise AnsibleError("installed passlib version %s not supported" % passlib.__version__) + try: + if hasattr(self.crypt_algo, 'hash'): + result = self.crypt_algo.using(**settings).hash(secret) + elif hasattr(self.crypt_algo, 'encrypt'): + result = self.crypt_algo.encrypt(secret, **settings) + else: + raise AnsibleError("installed passlib version %s not supported" % passlib.__version__) + except ValueError as e: + raise AnsibleError("Could not hash the secret.", orig_exc=e) # passlib.hash should always return something or raise an exception. # Still ensure that there is always a result. diff --git a/lib/ansible_core.egg-info/PKG-INFO b/lib/ansible_core.egg-info/PKG-INFO index 0c7edcf5..b625a17a 100644 --- a/lib/ansible_core.egg-info/PKG-INFO +++ b/lib/ansible_core.egg-info/PKG-INFO @@ -1,6 +1,6 @@ Metadata-Version: 2.1 Name: ansible-core -Version: 2.14.3 +Version: 2.14.6 Summary: Radically simple IT automation Home-page: https://ansible.com/ Author: Ansible, Inc. diff --git a/lib/ansible_core.egg-info/SOURCES.txt b/lib/ansible_core.egg-info/SOURCES.txt index 9444d2ff..dd37d2ed 100644 --- a/lib/ansible_core.egg-info/SOURCES.txt +++ b/lib/ansible_core.egg-info/SOURCES.txt @@ -91,6 +91,7 @@ docs/docsite/rst/community/collection_contributors/collection_integration_updati docs/docsite/rst/community/collection_contributors/collection_release_with_branches.rst docs/docsite/rst/community/collection_contributors/collection_release_without_branches.rst docs/docsite/rst/community/collection_contributors/collection_releasing.rst +docs/docsite/rst/community/collection_contributors/collection_requirements.rst docs/docsite/rst/community/collection_contributors/collection_reviewing.rst docs/docsite/rst/community/collection_contributors/collection_test_pr_locally.rst docs/docsite/rst/community/collection_contributors/collection_unit_tests.rst @@ -1353,6 +1354,10 @@ licenses/Apache-License.txt licenses/MIT-license.txt licenses/PSF-license.txt licenses/simplified_bsd.txt +packaging/release.py +packaging/pep517_backend/__init__.py +packaging/pep517_backend/_backend.py +packaging/pep517_backend/hooks.py packaging/release/Makefile packaging/release/tests/__init__.py packaging/release/tests/version_helper_test.py @@ -1387,6 +1392,7 @@ test/integration/targets/ansible-doc/aliases test/integration/targets/ansible-doc/fakecollrole.output test/integration/targets/ansible-doc/fakemodule.output test/integration/targets/ansible-doc/fakerole.output +test/integration/targets/ansible-doc/fix-urls.py test/integration/targets/ansible-doc/inventory test/integration/targets/ansible-doc/noop.output test/integration/targets/ansible-doc/noop_vars_plugin.output @@ -1628,10 +1634,13 @@ test/integration/targets/ansible-test-integration-constraints/ansible_collection test/integration/targets/ansible-test-integration-targets/aliases test/integration/targets/ansible-test-integration-targets/runme.sh test/integration/targets/ansible-test-integration-targets/test.py +test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/target-prefixes.something test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/destructive_a/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/destructive_b/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/disabled_a/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/disabled_b/aliases +test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/one-part_test/aliases +test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/two_part_test/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/unstable_a/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/unstable_b/aliases test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/unsupported_a/aliases @@ -1727,6 +1736,9 @@ test/integration/targets/ansible-test-units/ansible_collections/ns/col/tests/uni test/integration/targets/ansible-test-unsupported-directory/aliases test/integration/targets/ansible-test-unsupported-directory/runme.sh test/integration/targets/ansible-test-unsupported-directory/ansible_collections/ns/col/.keep +test/integration/targets/ansible-test-vendoring/aliases +test/integration/targets/ansible-test-vendoring/runme.sh +test/integration/targets/ansible-test-vendoring/ansible_collections/ns/col/tests/config.yml test/integration/targets/ansible-vault/aliases test/integration/targets/ansible-vault/empty-password test/integration/targets/ansible-vault/encrypted-vault-password @@ -2000,6 +2012,11 @@ test/integration/targets/callback_default/test_async.yml test/integration/targets/callback_default/test_dryrun.yml test/integration/targets/callback_default/test_non_lockstep.yml test/integration/targets/callback_default/test_yaml.yml +test/integration/targets/canonical-pep517-self-packaging/aliases +test/integration/targets/canonical-pep517-self-packaging/minimum-build-constraints.txt +test/integration/targets/canonical-pep517-self-packaging/modernish-build-constraints.txt +test/integration/targets/canonical-pep517-self-packaging/runme.sh +test/integration/targets/canonical-pep517-self-packaging/runme_test.py test/integration/targets/changed_when/aliases test/integration/targets/changed_when/meta/main.yml test/integration/targets/changed_when/tasks/main.yml @@ -2861,6 +2878,8 @@ test/integration/targets/include_import/roles/role3/tasks/tasks.yml test/integration/targets/include_import/roles/role3/tasks/vartest.yml test/integration/targets/include_import/roles/role3/vars/main.yml test/integration/targets/include_import/roles/role3/vars/role3vars.yml +test/integration/targets/include_import/roles/role_with_argspec/meta/argument_specs.yml +test/integration/targets/include_import/roles/role_with_argspec/tasks/main.yml test/integration/targets/include_import/roles/role_with_deps/meta/main.yml test/integration/targets/include_import/roles/role_with_deps/tasks/main.yml test/integration/targets/include_import/run_once/include_me.yml @@ -2879,6 +2898,7 @@ test/integration/targets/include_import/tasks/test_include_dupe_loop.yml test/integration/targets/include_import/tasks/test_include_tasks.yml test/integration/targets/include_import/tasks/test_include_tasks_tags.yml test/integration/targets/include_import/tasks/test_recursion.yml +test/integration/targets/include_import/tasks/test_templating_IncludeRole_FA.yml test/integration/targets/include_import/tasks/validate3.yml test/integration/targets/include_import/tasks/validate_tags.yml test/integration/targets/include_import/tasks/hello/.gitignore @@ -3067,8 +3087,10 @@ test/integration/targets/json_cleanup/module_output_cleaning.yml test/integration/targets/json_cleanup/runme.sh test/integration/targets/json_cleanup/library/bad_json test/integration/targets/keyword_inheritance/aliases +test/integration/targets/keyword_inheritance/dep_keyword_inheritance.yml test/integration/targets/keyword_inheritance/runme.sh test/integration/targets/keyword_inheritance/test.yml +test/integration/targets/keyword_inheritance/roles/role-meta-inheritance/meta/main.yml test/integration/targets/keyword_inheritance/roles/whoami/tasks/main.yml test/integration/targets/known_hosts/aliases test/integration/targets/known_hosts/defaults/main.yml @@ -4053,8 +4075,10 @@ test/integration/targets/template/templates/unused_vars_template.j2 test/integration/targets/template/vars/main.yml test/integration/targets/template_jinja2_non_native/46169.yml test/integration/targets/template_jinja2_non_native/aliases +test/integration/targets/template_jinja2_non_native/macro_override.yml test/integration/targets/template_jinja2_non_native/runme.sh test/integration/targets/template_jinja2_non_native/templates/46169.json.j2 +test/integration/targets/template_jinja2_non_native/templates/macro_override.j2 test/integration/targets/templating/aliases test/integration/targets/templating/tasks/main.yml test/integration/targets/templating/templates/invalid_test_name.j2 @@ -4726,6 +4750,7 @@ test/sanity/code-smell/update-bundled.json test/sanity/code-smell/update-bundled.py test/sanity/code-smell/update-bundled.requirements.in test/sanity/code-smell/update-bundled.requirements.txt +test/support/README.md test/support/integration/plugins/filter/json_query.py test/support/integration/plugins/module_utils/compat/__init__.py test/support/integration/plugins/module_utils/compat/ipaddress.py diff --git a/packaging/pep517_backend/__init__.py b/packaging/pep517_backend/__init__.py new file mode 100644 index 00000000..1d3bc14c --- /dev/null +++ b/packaging/pep517_backend/__init__.py @@ -0,0 +1 @@ +"""PEP 517 build backend for optionally pre-building docs before setuptools.""" diff --git a/packaging/pep517_backend/_backend.py b/packaging/pep517_backend/_backend.py new file mode 100644 index 00000000..ce97cfab --- /dev/null +++ b/packaging/pep517_backend/_backend.py @@ -0,0 +1,173 @@ +"""PEP 517 build backend wrapper for optionally pre-building docs for sdist.""" + +from __future__ import annotations + +import os +import re +import subprocess +import sys +import typing as t +from configparser import ConfigParser +from contextlib import contextmanager, suppress +from importlib import import_module +from io import StringIO +from pathlib import Path +from shutil import copytree +from tempfile import TemporaryDirectory + +try: + from contextlib import chdir as _chdir_cm +except ImportError: + @contextmanager + def _chdir_cm(path: os.PathLike) -> t.Iterator[None]: + original_wd = Path.cwd() + os.chdir(path) + try: + yield + finally: + os.chdir(original_wd) + +from setuptools.build_meta import ( + build_sdist as _setuptools_build_sdist, + get_requires_for_build_sdist as _setuptools_get_requires_for_build_sdist, +) + +with suppress(ImportError): + # NOTE: Only available for sdist builds that bundle manpages. Declared by + # NOTE: `get_requires_for_build_sdist()` when `--build-manpages` is passed. + from docutils.core import publish_file + from docutils.writers import manpage + + +__all__ = ( # noqa: WPS317, WPS410 + 'build_sdist', 'get_requires_for_build_sdist', +) + + +BUILD_MANPAGES_CONFIG_SETTING = '--build-manpages' +"""Config setting name toggle that is used to request manpage in sdists.""" + + +@contextmanager +def _run_in_temporary_directory() -> t.Iterator[Path]: + with TemporaryDirectory(prefix='.tmp-ansible-pep517-') as tmp_dir: + with _chdir_cm(tmp_dir): + yield Path(tmp_dir) + + +def _make_in_tree_ansible_importable() -> None: + """Add the library directory to module lookup paths.""" + lib_path = str(Path.cwd() / 'lib/') + sys.path.insert(0, lib_path) # NOTE: for the current runtime session + + +def _get_package_distribution_version() -> str: + """Retrieve the current version number from setuptools config.""" + setup_cfg_path = Path.cwd() / 'setup.cfg' + setup_cfg = ConfigParser() + setup_cfg.read_string(setup_cfg_path.read_text()) + cfg_version = setup_cfg.get('metadata', 'version') + importable_version_str = cfg_version.removeprefix('attr: ') + version_mod_str, version_var_str = importable_version_str.rsplit('.', 1) + _make_in_tree_ansible_importable() + return getattr(import_module(version_mod_str), version_var_str) + + +def _generate_rst_in_templates() -> t.Iterable[Path]: + """Create ``*.1.rst.in`` files out of CLI Python modules.""" + generate_man_cmd = ( + sys.executable, + 'hacking/build-ansible.py', + 'generate-man', + '--template-file=docs/templates/man.j2', + '--output-dir=docs/man/man1/', + '--output-format=man', + *Path('lib/ansible/cli/').glob('*.py'), + ) + subprocess.check_call(tuple(map(str, generate_man_cmd))) + return Path('docs/man/man1/').glob('*.1.rst.in') + + +def _convert_rst_in_template_to_manpage( + rst_doc_template: str, + destination_path: os.PathLike, + version_number: str, +) -> None: + """Render pre-made ``*.1.rst.in`` templates into manpages. + + This includes pasting the hardcoded version into the resulting files. + The resulting ``in``-files are wiped in the process. + """ + templated_rst_doc = rst_doc_template.replace('%VERSION%', version_number) + + with StringIO(templated_rst_doc) as in_mem_rst_doc: + publish_file( + source=in_mem_rst_doc, + destination_path=destination_path, + writer=manpage.Writer(), + ) + + +def build_sdist( # noqa: WPS210, WPS430 + sdist_directory: os.PathLike, + config_settings: dict[str, str] | None = None, +) -> str: + build_manpages_requested = BUILD_MANPAGES_CONFIG_SETTING in ( + config_settings or {} + ) + original_src_dir = Path.cwd().resolve() + with _run_in_temporary_directory() as tmp_dir: + tmp_src_dir = Path(tmp_dir) / 'src' + copytree(original_src_dir, tmp_src_dir, symlinks=True) + os.chdir(tmp_src_dir) + + if build_manpages_requested: + Path('docs/man/man1/').mkdir(exist_ok=True, parents=True) + version_number = _get_package_distribution_version() + for rst_in in _generate_rst_in_templates(): + _convert_rst_in_template_to_manpage( + rst_doc_template=rst_in.read_text(), + destination_path=rst_in.with_suffix('').with_suffix(''), + version_number=version_number, + ) + rst_in.unlink() + + Path('pyproject.toml').write_text( + re.sub( + r"""(?x) + backend-path\s=\s\[ # value is a list of double-quoted strings + [^]]+ + ].*\n + build-backend\s=\s"[^"]+".*\n # value is double-quoted + """, + 'build-backend = "setuptools.build_meta"\n', + Path('pyproject.toml').read_text(), + ) + ) + + built_sdist_basename = _setuptools_build_sdist( + sdist_directory=sdist_directory, + config_settings=config_settings, + ) + + return built_sdist_basename + + +def get_requires_for_build_sdist( + config_settings: dict[str, str] | None = None, +) -> list[str]: + build_manpages_requested = BUILD_MANPAGES_CONFIG_SETTING in ( + config_settings or {} + ) + build_manpages_requested = True # FIXME: Once pypa/build#559 is addressed. + + manpage_build_deps = [ + 'docutils', # provides `rst2man` + 'jinja2', # used in `hacking/build-ansible.py generate-man` + 'straight.plugin', # used in `hacking/build-ansible.py` for subcommand + 'pyyaml', # needed for importing in-tree `ansible-core` from `lib/` + ] if build_manpages_requested else [] + + return _setuptools_get_requires_for_build_sdist( + config_settings=config_settings, + ) + manpage_build_deps diff --git a/packaging/pep517_backend/hooks.py b/packaging/pep517_backend/hooks.py new file mode 100644 index 00000000..b834338a --- /dev/null +++ b/packaging/pep517_backend/hooks.py @@ -0,0 +1,9 @@ +# -*- coding: utf-8 -*- + +"""PEP 517 build backend for optionally pre-building docs before setuptools.""" + +from setuptools.build_meta import * # Re-exporting PEP 517 hooks # pylint: disable=unused-wildcard-import,wildcard-import + +from ._backend import ( # noqa: WPS436 # Re-exporting PEP 517 hooks + build_sdist, get_requires_for_build_sdist, +) diff --git a/packaging/release.py b/packaging/release.py new file mode 100755 index 00000000..795e3336 --- /dev/null +++ b/packaging/release.py @@ -0,0 +1,1469 @@ +#!/usr/bin/env python +# PYTHON_ARGCOMPLETE_OK +"""Manage upstream ansible-core releases.""" + +from __future__ import annotations + +import argparse +import contextlib +import dataclasses +import datetime +import enum +import functools +import gzip +import hashlib +import http.client +import inspect +import json +import math +import os +import pathlib +import re +import secrets +import shlex +import shutil +import stat +import subprocess +import sys +import tarfile +import tempfile +import typing as t +import urllib.error +import urllib.parse +import urllib.request +import venv +import webbrowser +import zipfile + +import jinja2 + +from packaging.version import Version, InvalidVersion + +# region CLI Framework + + +C = t.TypeVar("C", bound=t.Callable[[...], None]) + + +def path_to_str(value: t.Any) -> str: + """Return the given value converted to a string suitable for use as a command line argument.""" + return f"{value}/" if isinstance(value, pathlib.Path) and value.is_dir() else str(value) + + +def run( + *args: t.Any, + env: dict[str, t.Any] | None, + cwd: pathlib.Path | str, + capture_output: bool = False, +) -> CompletedProcess: + """Run the specified command.""" + args = [arg.relative_to(cwd) if isinstance(arg, pathlib.Path) else arg for arg in args] + + str_args = tuple(path_to_str(arg) for arg in args) + str_env = {key: path_to_str(value) for key, value in env.items()} if env is not None else None + + display.show(f"--> {shlex.join(str_args)}", color=Display.CYAN) + + try: + p = subprocess.run(str_args, check=True, text=True, env=str_env, cwd=cwd, capture_output=capture_output) + except subprocess.CalledProcessError as ex: + # improve type hinting and include stdout/stderr (if any) in the message + raise CalledProcessError( + message=str(ex), + cmd=str_args, + status=ex.returncode, + stdout=ex.stdout, + stderr=ex.stderr, + ) from None + + # improve type hinting + return CompletedProcess( + args=str_args, + stdout=p.stdout, + stderr=p.stderr, + ) + + +@contextlib.contextmanager +def suppress_when(error_as_warning: bool) -> None: + """Conditionally convert an ApplicationError in the provided context to a warning.""" + if error_as_warning: + try: + yield + except ApplicationError as ex: + display.warning(ex) + else: + yield + + +class ApplicationError(Exception): + """A fatal application error which will be shown without a traceback.""" + + +class CalledProcessError(Exception): + """Results from a failed process.""" + + def __init__(self, message: str, cmd: tuple[str, ...], status: int, stdout: str | None, stderr: str | None) -> None: + if stdout and (stdout := stdout.strip()): + message += f"\n>>> Standard Output\n{stdout}" + + if stderr and (stderr := stderr.strip()): + message += f"\n>>> Standard Error\n{stderr}" + + super().__init__(message) + + self.cmd = cmd + self.status = status + self.stdout = stdout + self.stderr = stderr + + +@dataclasses.dataclass(frozen=True) +class CompletedProcess: + """Results from a completed process.""" + + args: tuple[str, ...] + stdout: str | None + stderr: str | None + + +class Display: + """Display interface for sending output to the console.""" + + CLEAR = "\033[0m" + RED = "\033[31m" + BLUE = "\033[34m" + PURPLE = "\033[35m" + CYAN = "\033[36m" + + def fatal(self, message: t.Any) -> None: + """Print a fatal message to the console.""" + self.show(f"FATAL: {message}", color=self.RED) + + def warning(self, message: t.Any) -> None: + """Print a warning message to the console.""" + self.show(f"WARNING: {message}", color=self.PURPLE) + + def show(self, message: t.Any, color: str | None = None) -> None: + """Print a message to the console.""" + print(f"{color or self.CLEAR}{message}{self.CLEAR}", flush=True) + + +class CommandFramework: + """ + Simple command line framework inspired by nox. + + Argument parsing is handled by argparse. Each function annotated with an instance of this class becomes a subcommand. + Options are shared across all commands, and are defined by providing kwargs when creating an instance of this class. + Options are only defined for commands which have a matching parameter. + + The name of each kwarg is the option name, which will be prefixed with `--` and with underscores converted to dashes. + The value of each kwarg is passed as kwargs to ArgumentParser.add_argument. Passing None results in an internal only parameter. + + The following custom kwargs are recognized and are not passed to add_argument: + + name - Override the positional argument (option) passed to add_argument. + exclusive - Put the argument in an exclusive group of the given name. + """ + + def __init__(self, **kwargs: dict[str, t.Any] | None) -> None: + self.commands: list[C] = [] + self.arguments = kwargs + self.parsed_arguments: argparse.Namespace | None = None + + def __call__(self, func: C) -> C: + """Register the decorated function as a CLI command.""" + self.commands.append(func) + return func + + def run(self, *args: C, **kwargs) -> None: + """Run the specified command(s), using any provided internal args.""" + for arg in args: + self._run(arg, **kwargs) + + def main(self) -> None: + """Main program entry point.""" + parser = argparse.ArgumentParser(description=__doc__) + subparsers = parser.add_subparsers(metavar="COMMAND", required=True) + + for func in self.commands: + func_parser = subparsers.add_parser(self._format_command_name(func), description=func.__doc__, help=func.__doc__) + func_parser.set_defaults(func=func) + + exclusive_groups = {} + signature = inspect.signature(func) + + for name in signature.parameters: + if name not in self.arguments: + raise RuntimeError(f"The '{name}' argument, used by '{func.__name__}', has not been defined.") + + if (arguments := self.arguments.get(name)) is None: + continue # internal use + + arguments = arguments.copy() + exclusive = arguments.pop("exclusive", None) + + if exclusive: + if exclusive not in exclusive_groups: + exclusive_groups[exclusive] = func_parser.add_mutually_exclusive_group() + + command_parser = exclusive_groups[exclusive] + else: + command_parser = func_parser + + if option_name := arguments.pop("name", None): + arguments.update(dest=name) + else: + option_name = f"--{name.replace('_', '-')}" + + command_parser.add_argument(option_name, **arguments) + + try: + # noinspection PyUnresolvedReferences + import argcomplete + except ImportError: + pass + else: + argcomplete.autocomplete(parser) + + self.parsed_arguments = parser.parse_args() + + try: + self.run(self.parsed_arguments.func) + except ApplicationError as ex: + display.fatal(ex) + sys.exit(1) + + def _run(self, func: C, **kwargs) -> None: + """Run the specified command, using any provided internal args.""" + signature = inspect.signature(func) + func_args = {name: getattr(self.parsed_arguments, name) for name in signature.parameters if hasattr(self.parsed_arguments, name)} + func_args.update({name: value for name, value in kwargs.items() if name in signature.parameters}) + printable_args = ", ".join(f"{name}={repr(value)}" for name, value in func_args.items()) + label = f"{self._format_command_name(func)}({printable_args})" + + display.show(f"==> {label}", color=Display.BLUE) + + try: + func(**func_args) + except BaseException: + display.show(f"!!! {label}", color=Display.RED) + raise + + display.show(f"<== {label}", color=Display.BLUE) + + @staticmethod + def _format_command_name(func: C) -> str: + """Return the friendly name of the given command.""" + return func.__name__.replace("_", "-") + + +display = Display() + + +# endregion +# region Data Classes + + +@dataclasses.dataclass(frozen=True) +class GitHubRelease: + """Details required to create a GitHub release.""" + + user: str + repo: str + tag: str + target: str + title: str + body: str + pre_release: bool + + +@dataclasses.dataclass(frozen=True) +class PullRequest: + """Details required to create a pull request.""" + + upstream_user: str + upstream_repo: str + upstream_branch: str + user: str + repo: str + branch: str + title: str + body: str + + +@dataclasses.dataclass(frozen=True) +class Remote: + """Details about a git remote.""" + + name: str + user: str + repo: str + + +@dataclasses.dataclass(frozen=True) +class Remotes: + """Details about git removes.""" + + fork: Remote + upstream: Remote + + +@dataclasses.dataclass(frozen=True) +class GitState: + """Details about the state of the git repository.""" + + remotes: Remotes + branch: str | None + commit: str + + +@dataclasses.dataclass(frozen=True) +class ReleaseArtifact: + """Information about a release artifact on PyPI.""" + + package_type: str + package_label: str + url: str + size: int + digest: str + digest_algorithm: str + + +@dataclasses.dataclass(frozen=True) +class ReleaseAnnouncement: + """Contents of a release announcement.""" + + subject: str + body: str + + +# endregion +# region Utilities + + +SCRIPT_DIR = pathlib.Path(__file__).parent.resolve() +CHECKOUT_DIR = SCRIPT_DIR.parent + +ANSIBLE_LIB_DIR = CHECKOUT_DIR / "lib" +ANSIBLE_DIR = ANSIBLE_LIB_DIR / "ansible" +ANSIBLE_BIN_DIR = CHECKOUT_DIR / "bin" +ANSIBLE_RELEASE_FILE = ANSIBLE_DIR / "release.py" +ANSIBLE_REQUIREMENTS_FILE = CHECKOUT_DIR / "requirements.txt" + +DIST_DIR = CHECKOUT_DIR / "dist" +VENV_DIR = DIST_DIR / ".venv" / "release" + +CHANGELOGS_DIR = CHECKOUT_DIR / "changelogs" +CHANGELOGS_FRAGMENTS_DIR = CHANGELOGS_DIR / "fragments" + +ANSIBLE_VERSION_PATTERN = re.compile("^__version__ = '(?P<version>.*)'$", re.MULTILINE) +ANSIBLE_VERSION_FORMAT = "__version__ = '{version}'" + +DIGEST_ALGORITHM = "sha256" + +# These endpoint names match those defined as defaults in twine. +# See: https://github.com/pypa/twine/blob/9c2c0a1c535155931c3d879359330cb836950c6a/twine/utils.py#L82-L85 +PYPI_ENDPOINTS = dict( + pypi="https://pypi.org/pypi", + testpypi="https://test.pypi.org/pypi", +) + +PIP_ENV = dict( + PIP_REQUIRE_VIRTUALENV="yes", + PIP_DISABLE_PIP_VERSION_CHECK="yes", +) + + +class VersionMode(enum.Enum): + """How to handle the ansible-core version.""" + + DEFAULT = enum.auto() + """Do not allow development versions. Do not allow post release versions.""" + STRIP_POST = enum.auto() + """Do not allow development versions. Strip the post release from the version if present.""" + REQUIRE_POST = enum.auto() + """Do not allow development versions. Require a post release version.""" + REQUIRE_DEV_POST = enum.auto() + """Require a development or post release version.""" + ALLOW_DEV_POST = enum.auto() + """Allow development and post release versions.""" + + def apply(self, version: Version) -> Version: + """Apply the mode to the given version and return the result.""" + original_version = version + + release_component_count = 3 + + if len(version.release) != release_component_count: + raise ApplicationError(f"Version {version} contains {version.release} release components instead of {release_component_count}.") + + if version.epoch: + raise ApplicationError(f"Version {version} contains an epoch component: {version.epoch}") + + if version.local is not None: + raise ApplicationError(f"Version {version} contains a local component: {version.local}") + + if version.is_devrelease and version.is_postrelease: + raise ApplicationError(f"Version {version} is a development and post release version.") + + if self == VersionMode.ALLOW_DEV_POST: + return version + + if self == VersionMode.REQUIRE_DEV_POST: + if not version.is_devrelease and not version.is_postrelease: + raise ApplicationError(f"Version {version} is not a development or post release version.") + + return version + + if version.is_devrelease: + raise ApplicationError(f"Version {version} is a development release: {version.dev}") + + if self == VersionMode.STRIP_POST: + if version.is_postrelease: + version = Version(str(version).removesuffix(f".post{version.post}")) + display.warning(f"Using version {version} by stripping the post release suffix from version {original_version}.") + + return version + + if self == VersionMode.REQUIRE_POST: + if not version.is_postrelease: + raise ApplicationError(f"Version {version} is not a post release version.") + + return version + + if version.is_postrelease: + raise ApplicationError(f"Version {version} is a post release.") + + if self == VersionMode.DEFAULT: + return version + + raise NotImplementedError(self) + + +def git(*args: t.Any, capture_output: bool = False) -> CompletedProcess: + """Run the specified git command.""" + return run("git", *args, env=None, cwd=CHECKOUT_DIR, capture_output=capture_output) + + +def get_commit(rev: str | None = None) -> str: + """Return the commit associated with the given rev, or HEAD if no rev is given.""" + try: + return git("rev-parse", "--quiet", "--verify", "--end-of-options", f"{rev or 'HEAD'}^{{commit}}", capture_output=True).stdout.strip() + except CalledProcessError as ex: + if ex.status == 1 and not ex.stdout and not ex.stderr: + raise ApplicationError(f"Could not find commit: {rev}") from None + + raise + + +def prepare_pull_request(version: Version, branch: str, title: str, add: t.Iterable[pathlib.Path | str], allow_stale: bool) -> PullRequest: + """Return pull request parameters using the provided details.""" + git_state = get_git_state(version, allow_stale) + + if not git("status", "--porcelain", "--untracked-files=no", capture_output=True).stdout.strip(): + raise ApplicationError("There are no changes to commit. Did you skip a step?") + + upstream_branch = get_upstream_branch(version) + body = create_pull_request_body(title) + + git("checkout", "-b", branch) + git("add", *add) + git("commit", "-m", title) + git("push", "--set-upstream", git_state.remotes.fork.name, branch) + git("checkout", git_state.branch or git_state.commit) + git("branch", "-d", branch) + + pr = PullRequest( + upstream_user=git_state.remotes.upstream.user, + upstream_repo=git_state.remotes.upstream.repo, + upstream_branch=upstream_branch, + user=git_state.remotes.fork.user, + repo=git_state.remotes.fork.repo, + branch=branch, + title=title, + body=body, + ) + + return pr + + +def create_github_release(release: GitHubRelease) -> None: + """Open a browser tab for creating the given GitHub release.""" + # See: https://docs.github.com/en/repositories/releasing-projects-on-github/automation-for-release-forms-with-query-parameters + + params = dict( + tag=release.tag, + target=release.target, + title=release.title, + body=release.body, + prerelease=1 if release.pre_release else 0, + ) + + query_string = urllib.parse.urlencode(params) + url = f"https://github.com/{release.user}/{release.repo}/releases/new?{query_string}" + + display.show("Opening release creation page in new tab using default browser ...") + webbrowser.open_new_tab(url) + + +def create_pull_request(pr: PullRequest) -> None: + """Open a browser tab for creating the given pull request.""" + # See: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request # noqa + + params = dict( + quick_pull=1, + title=pr.title, + body=pr.body, + ) + + query_string = urllib.parse.urlencode(params) + url = f"https://github.com/{pr.upstream_user}/{pr.upstream_repo}/compare/{pr.upstream_branch}...{pr.user}:{pr.repo}:{pr.branch}?{query_string}" + + display.show("Opening pull request in new tab using default browser ...") + webbrowser.open_new_tab(url) + + +def create_pull_request_body(title: str) -> str: + """Return a simple pull request body created from the given title.""" + body = f""" +##### SUMMARY + +{title} + +##### ISSUE TYPE + +Feature Pull Request + +##### COMPONENT NAME + +ansible +""" + + return body.lstrip() + + +def get_remote(name: str, push: bool) -> Remote: + """Return details about the specified remote.""" + remote_url = git("remote", "get-url", *(["--push"] if push else []), name, capture_output=True).stdout.strip() + remote_match = re.search(r"[@/]github[.]com[:/](?P<user>[^/]+)/(?P<repo>[^.]+)(?:[.]git)?$", remote_url) + + if not remote_match: + raise RuntimeError(f"Unable to identify the user and repo in the '{name}' remote: {remote_url}") + + remote = Remote( + name=name, + user=remote_match.group("user"), + repo=remote_match.group("repo"), + ) + + return remote + + +@functools.cache +def get_remotes() -> Remotes: + """Return details about the remotes we need to use.""" + # assume the devel branch has its upstream remote pointing to the user's fork + fork_remote_name = git("branch", "--list", "devel", "--format=%(upstream:remotename)", capture_output=True).stdout.strip() + + if not fork_remote_name: + raise ApplicationError("Could not determine the remote for your fork of Ansible.") + + display.show(f"Detected '{fork_remote_name}' as the remote for your fork of Ansible.") + + # assume there is only one ansible org remote, which would allow release testing using another repo in the same org without special configuration + all_remotes = git("remote", "-v", capture_output=True).stdout.strip().splitlines() + ansible_remote_names = set(line.split()[0] for line in all_remotes if re.search(r"[@/]github[.]com[:/]ansible/", line)) + + if not ansible_remote_names: + raise ApplicationError(f"Could not determine the remote which '{fork_remote_name}' was forked from.") + + if len(ansible_remote_names) > 1: + raise ApplicationError(f"Found multiple candidates for the remote from which '{fork_remote_name}' was forked from: {', '.join(ansible_remote_names)}") + + upstream_remote_name = ansible_remote_names.pop() + + display.show(f"Detected '{upstream_remote_name}' as the remote from which '{fork_remote_name}' was forked from.") + + if fork_remote_name == upstream_remote_name: + raise ApplicationError("The remote for your fork of Ansible cannot be the same as the remote from which it was forked.") + + remotes = Remotes( + fork=get_remote(fork_remote_name, push=True), + upstream=get_remote(upstream_remote_name, push=False), + ) + + return remotes + + +def get_upstream_branch(version: Version) -> str: + """Return the upstream branch name for the given version.""" + return f"stable-{version.major}.{version.minor}" + + +def get_git_state(version: Version, allow_stale: bool) -> GitState: + """Return information about the current state of the git repository.""" + remotes = get_remotes() + upstream_branch = get_upstream_branch(version) + + git("fetch", remotes.upstream.name, upstream_branch) + + upstream_ref = f"{remotes.upstream.name}/{upstream_branch}" + upstream_commit = get_commit(upstream_ref) + + commit = get_commit() + + if commit != upstream_commit: + with suppress_when(allow_stale): + raise ApplicationError(f"The current commit ({commit}) does not match {upstream_ref} ({upstream_commit}).") + + branch = git("branch", "--show-current", capture_output=True).stdout.strip() or None + + state = GitState( + remotes=remotes, + branch=branch, + commit=commit, + ) + + return state + + +@functools.cache +def ensure_venv() -> dict[str, str]: + """Ensure the release venv is ready and return the env vars needed to use it.""" + + # TODO: consider freezing the ansible and release requirements along with their dependencies + + ansible_requirements = ANSIBLE_REQUIREMENTS_FILE.read_text() + + release_requirements = """ +build +twine +""" + + requirements_file = CHECKOUT_DIR / "test/sanity/code-smell/package-data.requirements.txt" + requirements_content = requirements_file.read_text() + requirements_content += ansible_requirements + requirements_content += release_requirements + + requirements_hash = hashlib.sha256(requirements_content.encode()).hexdigest()[:8] + + python_version = ".".join(map(str, sys.version_info[:2])) + + venv_dir = VENV_DIR / python_version / requirements_hash + venv_bin_dir = venv_dir / "bin" + venv_requirements_file = venv_dir / "requirements.txt" + venv_marker_file = venv_dir / "marker.txt" + + env = os.environ.copy() + env.pop("PYTHONPATH", None) # avoid interference from ansible being injected into the environment + env.update( + PATH=os.pathsep.join((str(venv_bin_dir), env["PATH"])), + ) + + if not venv_marker_file.exists(): + display.show(f"Creating a Python {python_version} virtual environment ({requirements_hash}) ...") + + if venv_dir.exists(): + shutil.rmtree(venv_dir) + + venv.create(venv_dir, with_pip=True) + + venv_requirements_file.write_text(requirements_content) + + run("pip", "install", "-r", venv_requirements_file, env=env | PIP_ENV, cwd=CHECKOUT_DIR) + + venv_marker_file.touch() + + return env + + +def get_ansible_version(version: str | None = None, /, commit: str | None = None, mode: VersionMode = VersionMode.DEFAULT) -> Version: + """Parse and return the current ansible-core version, the provided version or the version from the provided commit.""" + if version and commit: + raise ValueError("Specify only one of: version, commit") + + if version: + source = "" + else: + if commit: + current = git("show", f"{commit}:{ANSIBLE_RELEASE_FILE.relative_to(CHECKOUT_DIR)}", capture_output=True).stdout + else: + current = ANSIBLE_RELEASE_FILE.read_text() + + if not (match := ANSIBLE_VERSION_PATTERN.search(current)): + raise RuntimeError("Failed to get the ansible-core version.") + + version = match.group("version") + source = f" in '{ANSIBLE_RELEASE_FILE}'" + + try: + parsed_version = Version(version) + except InvalidVersion: + raise ApplicationError(f"Invalid version{source}: {version}") from None + + parsed_version = mode.apply(parsed_version) + + return parsed_version + + +def get_next_version(version: Version, /, final: bool = False, pre: str | None = None, mode: VersionMode = VersionMode.DEFAULT) -> Version: + """Return the next version after the specified version.""" + + # TODO: consider using development versions instead of post versions after a release is published + + pre = pre or "" + micro = version.micro + + if version.is_devrelease: + # The next version of a development release is the same version without the development component. + if final: + pre = "" + elif not pre and version.pre is not None: + pre = f"{version.pre[0]}{version.pre[1]}" + elif version.is_postrelease: + # The next version of a post release is the next pre-release *or* micro release component. + if final: + pre = "" + elif not pre and version.pre is not None: + pre = f"{version.pre[0]}{version.pre[1] + 1}" + + if version.pre is None: + micro = version.micro + 1 + else: + raise ApplicationError(f"Version {version} is not a development or post release version.") + + version = f"{version.major}.{version.minor}.{micro}{pre}" + + return get_ansible_version(version, mode=mode) + + +def check_ansible_version(current_version: Version, requested_version: Version) -> None: + """Verify the requested version is valid for the current version.""" + if requested_version.release[:2] != current_version.release[:2]: + raise ApplicationError(f"Version {requested_version} does not match the major and minor portion of the current version: {current_version}") + + if requested_version < current_version: + raise ApplicationError(f"Version {requested_version} is older than the current version: {current_version}") + + # TODO: consider additional checks to avoid mistakes when incrementing the release version + + +def set_ansible_version(current_version: Version, requested_version: Version) -> None: + """Set the current ansible-core version.""" + check_ansible_version(current_version, requested_version) + + if requested_version == current_version: + return + + display.show(f"Updating version {current_version} to {requested_version} ...") + + current = ANSIBLE_RELEASE_FILE.read_text() + updated = ANSIBLE_VERSION_PATTERN.sub(ANSIBLE_VERSION_FORMAT.format(version=requested_version), current) + + if current == updated: + raise RuntimeError("Failed to set the ansible-core version.") + + ANSIBLE_RELEASE_FILE.write_text(updated) + + +def create_reproducible_sdist(original_path: pathlib.Path, output_path: pathlib.Path, mtime: int) -> None: + """Read the specified sdist and write out a new copy with uniform file metadata at the specified location.""" + with tarfile.open(original_path) as original_archive: + with tempfile.TemporaryDirectory() as temp_dir: + tar_file = pathlib.Path(temp_dir) / "sdist.tar" + + with tarfile.open(tar_file, mode="w") as tar_archive: + for original_info in original_archive.getmembers(): # type: tarfile.TarInfo + tar_archive.addfile(create_reproducible_tar_info(original_info, mtime), original_archive.extractfile(original_info)) + + with tar_file.open("rb") as tar_archive: + with gzip.GzipFile(output_path, "wb", mtime=mtime) as output_archive: + shutil.copyfileobj(tar_archive, output_archive) + + +def create_reproducible_tar_info(original: tarfile.TarInfo, mtime: int) -> tarfile.TarInfo: + """Return a copy of the given TarInfo with uniform file metadata.""" + sanitized = tarfile.TarInfo() + sanitized.name = original.name + sanitized.size = original.size + sanitized.mtime = mtime + sanitized.mode = (original.mode & ~(stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)) | stat.S_IRUSR | stat.S_IRGRP | stat.S_IROTH | stat.S_IWUSR + sanitized.type = original.type + sanitized.linkname = original.linkname + sanitized.uid = 0 + sanitized.gid = 0 + sanitized.uname = "root" + sanitized.gname = "root" + + if original.mode & (stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH): + sanitized.mode |= stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH + + return sanitized + + +def test_built_artifact(path: pathlib.Path) -> None: + """Test the specified built artifact by installing it in a venv and running some basic commands.""" + with tempfile.TemporaryDirectory() as temp_dir_name: + temp_dir = pathlib.Path(temp_dir_name) + + venv_dir = temp_dir / "venv" + venv_bin_dir = venv_dir / "bin" + + venv.create(venv_dir, with_pip=True) + + env = os.environ.copy() + env.pop("PYTHONPATH", None) # avoid interference from ansible being injected into the environment + env.update( + PATH=os.pathsep.join((str(venv_bin_dir), env["PATH"])), + ) + + run("pip", "install", path, env=env | PIP_ENV, cwd=CHECKOUT_DIR) + + run("ansible", "--version", env=env, cwd=CHECKOUT_DIR) + run("ansible-test", "--version", env=env, cwd=CHECKOUT_DIR) + + +def get_sdist_path(version: Version, dist_dir: pathlib.Path = DIST_DIR) -> pathlib.Path: + """Return the path to the sdist file.""" + return dist_dir / f"ansible-core-{version}.tar.gz" + + +def get_wheel_path(version: Version, dist_dir: pathlib.Path = DIST_DIR) -> pathlib.Path: + """Return the path to the wheel file.""" + return dist_dir / f"ansible_core-{version}-py3-none-any.whl" + + +def calculate_digest(path: pathlib.Path) -> str: + """Return the digest for the specified file.""" + # TODO: use hashlib.file_digest once Python 3.11 is the minimum supported version + return hashlib.new(DIGEST_ALGORITHM, path.read_bytes()).hexdigest() + + +@functools.cache +def get_release_artifact_details(repository: str, version: Version, validate: bool) -> list[ReleaseArtifact]: + """Return information about the release artifacts hosted on PyPI.""" + endpoint = PYPI_ENDPOINTS[repository] + url = f"{endpoint}/ansible-core/{version}/json" + + opener = urllib.request.build_opener() + response: http.client.HTTPResponse + + try: + with opener.open(url) as response: + data = json.load(response) + except urllib.error.HTTPError as ex: + if ex.status == http.HTTPStatus.NOT_FOUND: + raise ApplicationError(f"Version {version} not found on PyPI.") from None + + raise RuntimeError(f"Failed to get {version} from PyPI: {ex}") from ex + + artifacts = [describe_release_artifact(version, item, validate) for item in data["urls"]] + + expected_artifact_types = {"bdist_wheel", "sdist"} + found_artifact_types = set(artifact.package_type for artifact in artifacts) + + if found_artifact_types != expected_artifact_types: + raise RuntimeError(f"Expected {expected_artifact_types} artifact types, but found {found_artifact_types} instead.") + + return artifacts + + +def describe_release_artifact(version: Version, item: dict[str, t.Any], validate: bool) -> ReleaseArtifact: + """Return release artifact details extracted from the given PyPI data.""" + package_type = item["packagetype"] + + # The artifact URL is documented as stable, so is safe to put in release notes and announcements. + # See: https://github.com/pypi/warehouse/blame/c95be4a1055f4b36a8852715eb80318c81fc00ca/docs/api-reference/integration-guide.rst#L86-L90 + url = item["url"] + + pypi_size = item["size"] + pypi_digest = item["digests"][DIGEST_ALGORITHM] + + if package_type == "bdist_wheel": + local_artifact_file = get_wheel_path(version) + package_label = "Built Distribution" + elif package_type == "sdist": + local_artifact_file = get_sdist_path(version) + package_label = "Source Distribution" + else: + raise NotImplementedError(f"Package type '{package_type}' is not supported.") + + if validate: + try: + local_size = local_artifact_file.stat().st_size + local_digest = calculate_digest(local_artifact_file) + except FileNotFoundError: + raise ApplicationError(f"Missing local artifact: {local_artifact_file.relative_to(CHECKOUT_DIR)}") from None + + if local_size != pypi_size: + raise ApplicationError(f"The {version} local {package_type} size {local_size} does not match the PyPI size {pypi_size}.") + + if local_digest != pypi_digest: + raise ApplicationError(f"The {version} local {package_type} digest '{local_digest}' does not match the PyPI digest '{pypi_digest}'.") + + return ReleaseArtifact( + package_type=package_type, + package_label=package_label, + url=url, + size=pypi_size, + digest=pypi_digest, + digest_algorithm=DIGEST_ALGORITHM.upper(), + ) + + +def get_next_release_date(start: datetime.date, step: int, after: datetime.date) -> datetime.date: + """Return the next release date.""" + if start > after: + raise ValueError(f"{start=} is greater than {after=}") + + current_delta = after - start + release_delta = datetime.timedelta(days=(math.floor(current_delta.days / step) + 1) * step) + + release = start + release_delta + + return release + + +def create_template_environment() -> jinja2.Environment: + """Create and return a jinja2 environment.""" + env = jinja2.Environment() + env.filters.update( + basename=os.path.basename, + ) + + return env + + +def create_github_release_notes(upstream: Remote, repository: str, version: Version, validate: bool) -> str: + """Create and return GitHub release notes.""" + env = create_template_environment() + template = env.from_string(GITHUB_RELEASE_NOTES_TEMPLATE) + + variables = dict( + version=version, + releases=get_release_artifact_details(repository, version, validate), + changelog=f"https://github.com/{upstream.user}/{upstream.repo}/blob/v{ version }/changelogs/CHANGELOG-v{ version.major }.{ version.minor }.rst", + ) + + release_notes = template.render(**variables).strip() + + return release_notes + + +def create_release_announcement(upstream: Remote, repository: str, version: Version, validate: bool) -> ReleaseAnnouncement: + """Create and return a release announcement message.""" + env = create_template_environment() + subject_template = env.from_string(RELEASE_ANNOUNCEMENT_SUBJECT_TEMPLATE) + body_template = env.from_string(RELEASE_ANNOUNCEMENT_BODY_TEMPLATE) + + today = datetime.datetime.now(tz=datetime.timezone.utc).date() + + variables = dict( + version=version, + info=dict( + name="ansible-core", + short=f"{version.major}.{version.minor}", + releases=get_release_artifact_details(repository, version, validate), + ), + next_rc=get_next_release_date(datetime.date(2021, 8, 9), 28, today), + next_ga=get_next_release_date(datetime.date(2021, 8, 16), 28, today), + rc=version.pre and version.pre[0] == "rc", + beta=version.pre and version.pre[0] == "b", + alpha=version.pre and version.pre[0] == "a", + major=version.micro == 0, + upstream=upstream, + ) + + if version.pre and version.pre[0] in ("a", "b"): + display.warning("The release announcement template does not populate the date for the next release.") + + subject = subject_template.render(**variables).strip() + body = body_template.render(**variables).strip() + + message = ReleaseAnnouncement( + subject=subject, + body=body, + ) + + return message + + +# endregion +# region Templates + + +FINAL_RELEASE_ANNOUNCEMENT_RECIPIENTS = [ + "ansible-announce@googlegroups.com", + "ansible-project@googlegroups.com", + "ansible-devel@googlegroups.com", +] + +PRE_RELEASE_ANNOUNCEMENT_RECIPIENTS = [ + "ansible-devel@googlegroups.com", +] + +GITHUB_RELEASE_NOTES_TEMPLATE = """ +# Changelog + +See the [full changelog]({{ changelog }}) for the changes included in this release. + +# Release Artifacts + +{%- for release in releases %} +* {{ release.package_label }}: [{{ release.url|basename }}]({{ release.url }}) - {{ release.size }} bytes + * {{ release.digest }} ({{ release.digest_algorithm }}) +{%- endfor %} +""" + +# These release templates were adapted from sivel's release announcement script. +# See: https://gist.github.com/sivel/937bc2862a9677d8db875f3b10744d8c + +RELEASE_ANNOUNCEMENT_SUBJECT_TEMPLATE = """ +New release{% if rc %} candidate{% elif beta %} beta{% elif alpha %} alpha{% endif %}: {{ info.name }} {{ version }} +""" + +# NOTE: Gmail will automatically wrap the plain text version when sending. +# There's no need to perform wrapping ahead of time for normal sentences. +# However, lines with special formatting should be kept short to avoid unwanted wrapping. +RELEASE_ANNOUNCEMENT_BODY_TEMPLATE = """ +Hi all- we're happy to announce the{{ " " }} +{%- if rc -%} +following release candidate +{%- elif beta -%} +beta release of +{%- elif alpha -%} +alpha release of +{%- else -%} +general release of +{%- endif -%}: + +{{ info.name }} {{ version }} + + +How to get it +------------- + +$ python3 -m pip install --user {{ info.name }}=={{ version }} + +The release artifacts can be found here: +{% for release in info.releases %} +# {{ release.package_label }}: {{ release.size }} bytes +# {{ release.digest_algorithm }}: {{ release.digest }} +{{ release.url }} +{%- endfor %} + + +What's new +---------- + +{% if major %} +This release is a major release. +{%- else -%} +This release is a maintenance release containing numerous bugfixes. +{% endif %} +The full changelog can be found here: + +https://github.com/{{ upstream.user }}/{{ upstream.repo }}/blob/v{{ version }}/changelogs/CHANGELOG-v{{ info.short }}.rst + + +Schedule for future releases +---------------------------- +{% if rc %} +The release candidate will become a general availability release on {{ next_ga.strftime('%-d %B %Y') }}. +{% elif beta %} +Subject to the need for additional beta releases, the first release candidate is scheduled for X. +{% elif alpha %} +Subject to the need for additional alpha releases, the first release beta is scheduled for X. +{% else %} +The next release candidate is planned to be released on {{ next_rc.strftime('%-d %B %Y') }}. The next general availability release will be one week after. +{% endif %} + +Porting help +------------ + +If you discover any errors or if any of your working playbooks break when you upgrade, please use the following link to report the regression: + +https://github.com/{{ upstream.user }}/{{ upstream.repo }}/issues/new/choose + +In your issue, be sure to mention the version that works and the one that doesn't. + +Thanks! +""" + +# endregion +# region Commands + +command = CommandFramework( + repository=dict(metavar="REPO", choices=tuple(PYPI_ENDPOINTS), default="pypi", help="PyPI repository to use: %(choices)s [%(default)s]"), + version=dict(exclusive="version", help="version to set"), + pre=dict(exclusive="version", help="increment version to the specified pre-release (aN, bN, rcN)"), + final=dict(exclusive="version", action="store_true", help="increment version to the next final release"), + commit=dict(help="commit to tag"), + mailto=dict(name="--no-mailto", action="store_false", help="write announcement to console instead of using a mailto: link"), + validate=dict(name="--no-validate", action="store_false", help="disable validation of PyPI artifacts against local ones"), + prompt=dict(name="--no-prompt", action="store_false", help="disable interactive prompt before publishing with twine"), + allow_tag=dict(action="store_true", help="allow an existing release tag (for testing)"), + allow_stale=dict(action="store_true", help="allow a stale checkout (for testing)"), + allow_dirty=dict(action="store_true", help="allow untracked files and files with changes (for testing)"), +) + + +@command +def instructions() -> None: + """Show instructions for the release process.""" + message = """ +Releases must be performed using an up-to-date checkout of a fork of the Ansible repository. + +1. Make sure your checkout is up-to-date. +2. Run the `prepare` command [1], then: + a. Submit the PR opened in the browser. + b. Wait for CI to pass. + c. Merge the PR. +3. Update your checkout to include the commit from the PR which was just merged. +4. Run the `complete` command [2], then: + a. Submit the GitHub release opened in the browser. + b. Submit the PR opened in the browser. + c. Send the release announcement opened in your browser. + d. Wait for CI to pass. + e. Merge the PR. + +[1] Use the `--final`, `--pre` or `--version` option for control over the version. +[2] During the `publish` step, `twine` may prompt for credentials. +""" + + display.show(message.strip()) + + +@command +def show_version(final: bool = False, pre: str | None = None) -> None: + """Show the current and next ansible-core version.""" + current_version = get_ansible_version(mode=VersionMode.ALLOW_DEV_POST) + display.show(f"Current version: {current_version}") + + try: + next_version = get_next_version(current_version, final=final, pre=pre) + except ApplicationError as ex: + display.show(f" Next version: Unknown - {ex}") + else: + display.show(f" Next version: {next_version}") + + check_ansible_version(current_version, next_version) + + +@command +def check_state(allow_stale: bool = False) -> None: + """Verify the git repository is in a usable state for creating a pull request.""" + get_git_state(get_ansible_version(), allow_stale) + + +# noinspection PyUnusedLocal +@command +def prepare(final: bool = False, pre: str | None = None, version: str | None = None) -> None: + """Prepare a release.""" + command.run( + update_version, + check_state, + generate_summary, + generate_changelog, + create_release_pr, + ) + + +@command +def update_version(final: bool = False, pre: str | None = None, version: str | None = None) -> None: + """Update the version embedded in the source code.""" + current_version = get_ansible_version(mode=VersionMode.REQUIRE_DEV_POST) + + if version: + requested_version = get_ansible_version(version) + else: + requested_version = get_next_version(current_version, final=final, pre=pre) + + set_ansible_version(current_version, requested_version) + + +@command +def generate_summary() -> None: + """Generate a summary changelog fragment for this release.""" + version = get_ansible_version() + release_date = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%d") + summary_path = CHANGELOGS_FRAGMENTS_DIR / f"{version}_summary.yaml" + major_minor = f"{version.major}.{version.minor}" + + content = f""" +release_summary: | + | Release Date: {release_date} + | `Porting Guide <https://docs.ansible.com/ansible-core/{major_minor}/porting_guides/porting_guide_core_{major_minor}.html>`__ +""" + + summary_path.write_text(content.lstrip()) + + +@command +def generate_changelog() -> None: + """Generate the changelog and validate the results.""" + env = ensure_venv() + env.update( + PATH=os.pathsep.join((str(ANSIBLE_BIN_DIR), env["PATH"])), + PYTHONPATH=ANSIBLE_LIB_DIR, + ) + + # TODO: consider switching back to the original changelog generator instead of using antsibull-changelog + + run("antsibull-changelog", "release", "-vv", "--use-ansible-doc", env=env, cwd=CHECKOUT_DIR) + run("antsibull-changelog", "generate", "-vv", "--use-ansible-doc", env=env, cwd=CHECKOUT_DIR) + + run("ansible-test", "sanity", CHANGELOGS_DIR, ANSIBLE_RELEASE_FILE, env=env, cwd=CHECKOUT_DIR) + + +@command +def create_release_pr(allow_stale: bool = False) -> None: + """Create a branch and open a browser tab for creating a release pull request.""" + version = get_ansible_version() + + pr = prepare_pull_request( + version=version, + branch=f"release-{version}-{secrets.token_hex(4)}", + title=f"New release v{version}", + add=( + CHANGELOGS_DIR, + ANSIBLE_RELEASE_FILE, + ), + allow_stale=allow_stale, + ) + + create_pull_request(pr) + + +# noinspection PyUnusedLocal +@command +def complete(repository: str, mailto: bool = True, allow_dirty: bool = False) -> None: + """Complete a release after the prepared changes have been merged.""" + command.run( + check_state, + build, + test, + publish, + tag_release, + post_version, + create_post_pr, + release_announcement, + ) + + +@command +def build(allow_dirty: bool = False) -> None: + """Build the sdist and wheel.""" + version = get_ansible_version(mode=VersionMode.ALLOW_DEV_POST) + env = ensure_venv() + + dirty = git("status", "--porcelain", "--untracked-files=all", capture_output=True).stdout.strip().splitlines() + + if dirty: + with suppress_when(allow_dirty): + raise ApplicationError(f"There are {len(dirty)} files which are untracked and/or have changes, which will be omitted from the build.") + + sdist_file = get_sdist_path(version) + wheel_file = get_wheel_path(version) + + with tempfile.TemporaryDirectory(dir=DIST_DIR, prefix=f"build-{version}-", suffix=".tmp") as temp_dir_name: + temp_dir = pathlib.Path(temp_dir_name) + dist_dir = temp_dir / "dist" + + commit_time = int(git("show", "-s", "--format=%ct", capture_output=True).stdout) + + env.update( + SOURCE_DATE_EPOCH=str(commit_time), + ) + + git("worktree", "add", "-d", temp_dir) + + try: + run("python", "-m", "build", "--config-setting=--build-manpages", env=env, cwd=temp_dir) + + create_reproducible_sdist(get_sdist_path(version, dist_dir), sdist_file, commit_time) + get_wheel_path(version, dist_dir).rename(wheel_file) + finally: + git("worktree", "remove", temp_dir) + + +@command +def test() -> None: + """Test the sdist and wheel.""" + command.run( + test_sdist, + test_wheel, + ) + + +@command +def test_sdist() -> None: + """Test the sdist.""" + version = get_ansible_version(mode=VersionMode.ALLOW_DEV_POST) + sdist_file = get_sdist_path(version) + + with tempfile.TemporaryDirectory() as temp_dir_name: + temp_dir = pathlib.Path(temp_dir_name) + + with contextlib.ExitStack() as stack: + try: + sdist = stack.enter_context(tarfile.open(sdist_file)) + except FileNotFoundError: + raise ApplicationError(f"Missing sdist: {sdist_file.relative_to(CHECKOUT_DIR)}") from None + + sdist.extractall(temp_dir) + + man1_dir = temp_dir / sdist_file.with_suffix("").with_suffix("").name / "docs" / "man" / "man1" + man1_pages = sorted(man1_dir.glob("*.1")) + + if not man1_pages: + raise ApplicationError(f"No man pages found in the sdist at: {man1_dir.relative_to(temp_dir)}") + + pyc_glob = "*.pyc*" + pyc_files = sorted(path.relative_to(temp_dir) for path in temp_dir.rglob(pyc_glob)) + + if pyc_files: + raise ApplicationError(f"Found {len(pyc_files)} '{pyc_glob}' file(s): {', '.join(map(str, pyc_files))}") + + display.show(f"Found man1 pages: {', '.join([path.name for path in man1_pages])}") + + test_built_artifact(sdist_file) + + +@command +def test_wheel() -> None: + """Test the wheel.""" + version = get_ansible_version(mode=VersionMode.ALLOW_DEV_POST) + wheel_file = get_wheel_path(version) + + with tempfile.TemporaryDirectory() as temp_dir_name: + temp_dir = pathlib.Path(temp_dir_name) + + with contextlib.ExitStack() as stack: + try: + wheel = stack.enter_context(zipfile.ZipFile(wheel_file)) + except FileNotFoundError: + raise ApplicationError(f"Missing wheel for version {version}: {wheel_file}") from None + + wheel.extractall(temp_dir) + + test_built_artifact(wheel_file) + + +@command +def publish(repository: str, prompt: bool = True) -> None: + """Publish to PyPI.""" + version = get_ansible_version() + sdist_file = get_sdist_path(version) + wheel_file = get_wheel_path(version) + env = ensure_venv() + + if prompt: + try: + while input(f"Do you want to publish {version} to the '{repository}' repository?\nEnter the repository name to confirm: ") != repository: + pass + except KeyboardInterrupt: + display.show("") + raise ApplicationError("Publishing was aborted by the user.") from None + + run("twine", "upload", "-r", repository, sdist_file, wheel_file, env=env, cwd=CHECKOUT_DIR) + + +@command +def tag_release(repository: str, commit: str | None = None, validate: bool = True, allow_tag: bool = False) -> None: + """Create a GitHub release using the current or specified commit.""" + upstream = get_remotes().upstream + + if commit: + git("fetch", upstream.name) # fetch upstream to make sure the commit can be found + + commit = get_commit(commit) + version = get_ansible_version(commit=commit) + tag = f"v{version}" + + if upstream_tag := git("ls-remote", "--tags", upstream.name, tag, capture_output=True).stdout.strip(): + with suppress_when(allow_tag): + raise ApplicationError(f"Version {version} has already been tagged: {upstream_tag}") + + upstream_branch = get_upstream_branch(version) + upstream_refs = git("branch", "-r", "--format=%(refname)", "--contains", commit, capture_output=True).stdout.strip().splitlines() + upstream_ref = f"refs/remotes/{upstream.name}/{upstream_branch}" + + if upstream_ref not in upstream_refs: + raise ApplicationError(f"Commit {upstream_ref} not found. Found {len(upstream_refs)} upstream ref(s): {', '.join(upstream_refs)}") + + body = create_github_release_notes(upstream, repository, version, validate) + + release = GitHubRelease( + user=upstream.user, + repo=upstream.repo, + target=commit, + tag=tag, + title=tag, + body=body, + pre_release=version.pre is not None, + ) + + create_github_release(release) + + +@command +def post_version() -> None: + """Set the post release version.""" + current_version = get_ansible_version() + requested_version = get_ansible_version(f"{current_version}.post0", mode=VersionMode.REQUIRE_POST) + + set_ansible_version(current_version, requested_version) + + +@command +def create_post_pr(allow_stale: bool = False) -> None: + """Create a branch and open a browser tab for creating a post release pull request.""" + version = get_ansible_version(mode=VersionMode.REQUIRE_POST) + + pr = prepare_pull_request( + version=version, + branch=f"release-{version}-{secrets.token_hex(4)}", + title=f"Update Ansible release version to v{version}.", + add=(ANSIBLE_RELEASE_FILE,), + allow_stale=allow_stale, + ) + + create_pull_request(pr) + + +@command +def release_announcement(repository: str, version: str | None = None, mailto: bool = True, validate: bool = True) -> None: + """Generate a release announcement for the current or specified version.""" + parsed_version = get_ansible_version(version, mode=VersionMode.STRIP_POST) + upstream = get_remotes().upstream + message = create_release_announcement(upstream, repository, parsed_version, validate) + recipient_list = PRE_RELEASE_ANNOUNCEMENT_RECIPIENTS if parsed_version.is_prerelease else FINAL_RELEASE_ANNOUNCEMENT_RECIPIENTS + recipients = ", ".join(recipient_list) + + if mailto: + to = urllib.parse.quote(recipients) + + params = dict( + subject=message.subject, + body=message.body, + ) + + query_string = urllib.parse.urlencode(params) + url = f"mailto:{to}?{query_string}" + + display.show("Opening email client through default web browser ...") + webbrowser.open(url) + else: + print(f"TO: {recipients}") + print(f"SUBJECT: {message.subject}") + print() + print(message.body) + + +# endregion + + +if __name__ == "__main__": + command.main() diff --git a/test/integration/targets/ansible-doc/collections/ansible_collections/testns/testcol/plugins/modules/randommodule.py b/test/integration/targets/ansible-doc/collections/ansible_collections/testns/testcol/plugins/modules/randommodule.py index f251a69f..79b7a704 100644 --- a/test/integration/targets/ansible-doc/collections/ansible_collections/testns/testcol/plugins/modules/randommodule.py +++ b/test/integration/targets/ansible-doc/collections/ansible_collections/testns/testcol/plugins/modules/randommodule.py @@ -48,6 +48,18 @@ options: version: '2.0.0' extends_documentation_fragment: - testns.testcol2.module +seealso: + - module: ansible.builtin.ping + - module: ansible.builtin.uri + description: Use this to fetch an URI + - module: testns.testcol.test + - module: testns.testcol.fakemodule + description: A fake module + - link: https://docs.ansible.com + name: Ansible docsite + description: See also the Ansible docsite. + - ref: foo_bar + description: Some foo bar. ''' EXAMPLES = ''' diff --git a/test/integration/targets/ansible-doc/fix-urls.py b/test/integration/targets/ansible-doc/fix-urls.py new file mode 100644 index 00000000..1379a4e4 --- /dev/null +++ b/test/integration/targets/ansible-doc/fix-urls.py @@ -0,0 +1,15 @@ +"""Unwrap URLs to docs.ansible.com and remove version""" + +import re +import sys + + +def main(): + data = sys.stdin.read() + data = re.sub('(https://docs\\.ansible\\.com/[^ ]+)\n +([^ ]+)\n', '\\1\\2\n', data, flags=re.MULTILINE) + data = re.sub('https://docs\\.ansible\\.com/ansible(|-core)/(?:[^/]+)/', 'https://docs.ansible.com/ansible\\1/devel/', data) + sys.stdout.write(data) + + +if __name__ == '__main__': + main() diff --git a/test/integration/targets/ansible-doc/randommodule-text.output b/test/integration/targets/ansible-doc/randommodule-text.output index 51d7930a..602d66ec 100644 --- a/test/integration/targets/ansible-doc/randommodule-text.output +++ b/test/integration/targets/ansible-doc/randommodule-text.output @@ -65,6 +65,25 @@ OPTIONS (= is mandatory): type: str +SEE ALSO: + * Module ansible.builtin.ping + The official documentation on the + ansible.builtin.ping module. + https://docs.ansible.com/ansible-core/devel/collections/ansible/builtin/ping_module.html + * Module ansible.builtin.uri + Use this to fetch an URI + https://docs.ansible.com/ansible-core/devel/collections/ansible/builtin/uri_module.html + * Module testns.testcol.test + * Module testns.testcol.fakemodule + A fake module + * Ansible docsite + See also the Ansible docsite. + https://docs.ansible.com + * Ansible documentation [foo_bar] + Some foo bar. + https://docs.ansible.com/ansible-core/devel/#stq=foo_bar&stp=1 + + AUTHOR: Ansible Core Team EXAMPLES: diff --git a/test/integration/targets/ansible-doc/randommodule.output b/test/integration/targets/ansible-doc/randommodule.output index 25f46c36..cf036000 100644 --- a/test/integration/targets/ansible-doc/randommodule.output +++ b/test/integration/targets/ansible-doc/randommodule.output @@ -70,6 +70,31 @@ "type": "str" } }, + "seealso": [ + { + "module": "ansible.builtin.ping" + }, + { + "description": "Use this to fetch an URI", + "module": "ansible.builtin.uri" + }, + { + "module": "testns.testcol.test" + }, + { + "description": "A fake module", + "module": "testns.testcol.fakemodule" + }, + { + "description": "See also the Ansible docsite.", + "link": "https://docs.ansible.com", + "name": "Ansible docsite" + }, + { + "description": "Some foo bar.", + "ref": "foo_bar" + } + ], "short_description": "A random module", "version_added": "1.0.0", "version_added_collection": "testns.testcol" diff --git a/test/integration/targets/ansible-doc/runme.sh b/test/integration/targets/ansible-doc/runme.sh index 887d3c41..f51fa8a4 100755 --- a/test/integration/targets/ansible-doc/runme.sh +++ b/test/integration/targets/ansible-doc/runme.sh @@ -19,8 +19,8 @@ current_out="$(ansible-doc --playbook-dir ./ testns.testcol.fakemodule | sed '1 expected_out="$(sed '1 s/\(^> TESTNS\.TESTCOL\.FAKEMODULE\).*(.*)$/\1/' fakemodule.output)" test "$current_out" == "$expected_out" -# we use sed to strip the module path from the first line -current_out="$(ansible-doc --playbook-dir ./ testns.testcol.randommodule | sed '1 s/\(^> TESTNS\.TESTCOL\.RANDOMMODULE\).*(.*)$/\1/')" +# we use sed to strip the plugin path from the first line, and fix-urls.py to unbreak and replace URLs from stable-X branches +current_out="$(ansible-doc --playbook-dir ./ testns.testcol.randommodule | sed '1 s/\(^> TESTNS\.TESTCOL\.RANDOMMODULE\).*(.*)$/\1/' | python fix-urls.py)" expected_out="$(sed '1 s/\(^> TESTNS\.TESTCOL\.RANDOMMODULE\).*(.*)$/\1/' randommodule-text.output)" test "$current_out" == "$expected_out" diff --git a/test/integration/targets/ansible-galaxy-collection/tasks/install.yml b/test/integration/targets/ansible-galaxy-collection/tasks/install.yml index 8916faf5..cca83c7b 100644 --- a/test/integration/targets/ansible-galaxy-collection/tasks/install.yml +++ b/test/integration/targets/ansible-galaxy-collection/tasks/install.yml @@ -5,7 +5,7 @@ state: directory - name: install simple collection from first accessible server - command: ansible-galaxy collection install namespace1.name1 {{ galaxy_verbosity }} + command: ansible-galaxy collection install namespace1.name1 -vvvv environment: ANSIBLE_COLLECTIONS_PATH: '{{ galaxy_dir }}/ansible_collections' register: from_first_good_server @@ -30,6 +30,7 @@ - install_normal_files.files[1].path | basename in ['MANIFEST.json', 'FILES.json', 'README.md'] - install_normal_files.files[2].path | basename in ['MANIFEST.json', 'FILES.json', 'README.md'] - (install_normal_manifest.content | b64decode | from_json).collection_info.version == '1.0.9' + - 'from_first_good_server.stdout|regex_findall("has not signed namespace1\.name1")|length == 1' - name: Remove the collection file: diff --git a/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/target-prefixes.something b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/target-prefixes.something new file mode 100644 index 00000000..b3065492 --- /dev/null +++ b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/target-prefixes.something @@ -0,0 +1,2 @@ +one-part +two_part diff --git a/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/one-part_test/aliases b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/one-part_test/aliases new file mode 100644 index 00000000..e69de29b --- /dev/null +++ b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/one-part_test/aliases diff --git a/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/two_part_test/aliases b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/two_part_test/aliases new file mode 100644 index 00000000..e69de29b --- /dev/null +++ b/test/integration/targets/ansible-test-integration-targets/ansible_collections/ns/col/tests/integration/targets/two_part_test/aliases diff --git a/test/integration/targets/ansible-test-integration-targets/test.py b/test/integration/targets/ansible-test-integration-targets/test.py index 443ed59d..8effb647 100755 --- a/test/integration/targets/ansible-test-integration-targets/test.py +++ b/test/integration/targets/ansible-test-integration-targets/test.py @@ -31,5 +31,17 @@ class OptionsTest(unittest.TestCase): raise Exception(f'{ex}:\n>>> Standard Output:\n{ex.stdout}\n>>> Standard Error:\n{ex.stderr}') from ex +class PrefixesTest(unittest.TestCase): + def test_prefixes(self): + try: + command = ['ansible-test', 'integration', '--list-targets'] + + something = subprocess.run([*command, 'something/'], text=True, capture_output=True, check=True) + + self.assertEqual(something.stdout.splitlines(), ['one-part_test', 'two_part_test']) + except subprocess.CalledProcessError as ex: + raise Exception(f'{ex}:\n>>> Standard Output:\n{ex.stdout}\n>>> Standard Error:\n{ex.stderr}') from ex + + if __name__ == '__main__': unittest.main() diff --git a/test/integration/targets/ansible-test-vendoring/aliases b/test/integration/targets/ansible-test-vendoring/aliases new file mode 100644 index 00000000..09cbf4b8 --- /dev/null +++ b/test/integration/targets/ansible-test-vendoring/aliases @@ -0,0 +1,5 @@ +shippable/posix/group3 # runs in the distro test containers +shippable/generic/group1 # runs in the default test container +context/controller +needs/target/collection +destructive # adds and then removes packages into lib/ansible/_vendor/ diff --git a/test/integration/targets/ansible-test-vendoring/ansible_collections/ns/col/tests/config.yml b/test/integration/targets/ansible-test-vendoring/ansible_collections/ns/col/tests/config.yml new file mode 100644 index 00000000..c73de69d --- /dev/null +++ b/test/integration/targets/ansible-test-vendoring/ansible_collections/ns/col/tests/config.yml @@ -0,0 +1,4 @@ +# This config file is included to cause ansible-test to import the `packaging` module. + +modules: + python_requires: default diff --git a/test/integration/targets/ansible-test-vendoring/runme.sh b/test/integration/targets/ansible-test-vendoring/runme.sh new file mode 100755 index 00000000..fa6f652a --- /dev/null +++ b/test/integration/targets/ansible-test-vendoring/runme.sh @@ -0,0 +1,33 @@ +#!/usr/bin/env bash + +set -eux + +# Run import sanity tests which require modifications to the source directory. + +vendor_dir="$(python -c 'import pathlib, ansible._vendor; print(pathlib.Path(ansible._vendor.__file__).parent)')" + +mkdir "${vendor_dir}/packaging/" # intended to fail if packaging is already present (to avoid deleting it later) + +cleanup() { + rm -rf "${vendor_dir}/packaging/" +} + +trap cleanup EXIT + +# Verify that packages installed in the vendor directory are loaded by ansible-test. +# This is done by injecting a broken `packaging` package, which should cause ansible-test to fail. + +echo 'raise Exception("intentional failure from ansible-test-vendoring integration test")' > "${vendor_dir}/packaging/__init__.py" + +if ansible-test sanity --test import --color --truncate 0 "${@}" > output.log 2>&1; then + echo "ansible-test did not exit with a non-zero status" + cat output.log + exit 1 +fi + +if ! grep '^Exception: intentional failure from ansible-test-vendoring integration test$' output.log; then + echo "ansible-test did not fail with the expected output" + cat output.log + exit 1 +fi + diff --git a/test/integration/targets/async/tasks/main.yml b/test/integration/targets/async/tasks/main.yml index 05c789e6..f5e5c992 100644 --- a/test/integration/targets/async/tasks/main.yml +++ b/test/integration/targets/async/tasks/main.yml @@ -122,7 +122,7 @@ - name: assert task failed correctly assert: that: - - async_result.ansible_job_id is match('\d+\.\d+') + - async_result.ansible_job_id is match('j\d+\.\d+') - async_result.finished == 1 - async_result is finished - async_result is not changed @@ -140,7 +140,7 @@ - name: validate response assert: that: - - async_result.ansible_job_id is match('\d+\.\d+') + - async_result.ansible_job_id is match('j\d+\.\d+') - async_result.finished == 1 - async_result is finished - async_result.changed == false @@ -159,7 +159,7 @@ - name: validate response assert: that: - - async_result.ansible_job_id is match('\d+\.\d+') + - async_result.ansible_job_id is match('j\d+\.\d+') - async_result.finished == 1 - async_result is finished - async_result.changed == true @@ -176,7 +176,7 @@ - name: validate response assert: that: - - async_result.ansible_job_id is match('\d+\.\d+') + - async_result.ansible_job_id is match('j\d+\.\d+') - async_result.finished == 1 - async_result is finished - async_result.changed == true diff --git a/test/integration/targets/async_fail/tasks/main.yml b/test/integration/targets/async_fail/tasks/main.yml index 40f72e10..24cea1d5 100644 --- a/test/integration/targets/async_fail/tasks/main.yml +++ b/test/integration/targets/async_fail/tasks/main.yml @@ -28,7 +28,7 @@ - name: validate that by the end of the retry interval, we succeeded assert: that: - - async_result.ansible_job_id is match('\d+\.\d+') + - async_result.ansible_job_id is match('j\d+\.\d+') - async_result.finished == 1 - async_result is finished - async_result is changed diff --git a/test/integration/targets/callback_default/runme.sh b/test/integration/targets/callback_default/runme.sh index 0ee4259d..a815132a 100755 --- a/test/integration/targets/callback_default/runme.sh +++ b/test/integration/targets/callback_default/runme.sh @@ -135,8 +135,8 @@ run_test default test.yml # Check for async output # NOTE: regex to match 1 or more digits works for both BSD and GNU grep ansible-playbook -i inventory test_async.yml 2>&1 | tee async_test.out -grep "ASYNC OK .* jid=[0-9]\{1,\}" async_test.out -grep "ASYNC FAILED .* jid=[0-9]\{1,\}" async_test.out +grep "ASYNC OK .* jid=j[0-9]\{1,\}" async_test.out +grep "ASYNC FAILED .* jid=j[0-9]\{1,\}" async_test.out rm -f async_test.out # Hide skipped diff --git a/test/integration/targets/canonical-pep517-self-packaging/aliases b/test/integration/targets/canonical-pep517-self-packaging/aliases new file mode 100644 index 00000000..4667aa4f --- /dev/null +++ b/test/integration/targets/canonical-pep517-self-packaging/aliases @@ -0,0 +1,3 @@ +shippable/posix/group3 +context/controller +packaging diff --git a/test/integration/targets/canonical-pep517-self-packaging/minimum-build-constraints.txt b/test/integration/targets/canonical-pep517-self-packaging/minimum-build-constraints.txt new file mode 100644 index 00000000..ea5d8084 --- /dev/null +++ b/test/integration/targets/canonical-pep517-self-packaging/minimum-build-constraints.txt @@ -0,0 +1,16 @@ +# Lowest supporting Python 3.9 and 3.10: +setuptools == 57.0.0; python_version == "3.9" or python_version == "3.10" + +# Lowest supporting Python 3.11: +setuptools == 60.0.0; python_version >= "3.11" + + +# An arbitrary old version that was released before Python 3.9.0: +wheel == 0.33.6 + +# Conditional dependencies: +docutils == 0.16 +Jinja2 == 3.0.0 +MarkupSafe == 2.0.0 +PyYAML == 5.3 +straight.plugin == 1.4.2 diff --git a/test/integration/targets/canonical-pep517-self-packaging/modernish-build-constraints.txt b/test/integration/targets/canonical-pep517-self-packaging/modernish-build-constraints.txt new file mode 100644 index 00000000..7f744afd --- /dev/null +++ b/test/integration/targets/canonical-pep517-self-packaging/modernish-build-constraints.txt @@ -0,0 +1,11 @@ +setuptools == 67.4.0 + +# Wheel-only build dependency +wheel == 0.38.4 + +# Conditional dependencies: +docutils == 0.19 +Jinja2 == 3.1.2 +MarkupSafe == 2.1.2 +PyYAML == 6.0 +straight.plugin == 1.5.0 # WARNING: v1.5.0 doesn't have a Git tag / src diff --git a/test/integration/targets/canonical-pep517-self-packaging/runme.sh b/test/integration/targets/canonical-pep517-self-packaging/runme.sh new file mode 100755 index 00000000..028348f8 --- /dev/null +++ b/test/integration/targets/canonical-pep517-self-packaging/runme.sh @@ -0,0 +1,31 @@ +#!/usr/bin/env bash + +if [[ "${ANSIBLE_DEBUG}" == true ]] # `ansible-test` invoked with `--debug` +then + PYTEST_VERY_VERBOSE_FLAG=-vvvvv + SET_DEBUG_MODE=-x +else + ANSIBLE_DEBUG=false + PYTEST_VERY_VERBOSE_FLAG= + SET_DEBUG_MODE=+x +fi + + +set -eEuo pipefail + +source virtualenv.sh + +set "${SET_DEBUG_MODE}" + +export PIP_DISABLE_PIP_VERSION_CHECK=true +export PIP_NO_PYTHON_VERSION_WARNING=true +export PIP_NO_WARN_SCRIPT_LOCATION=true + +python -Im pip install 'pytest ~= 7.2.0' +python -Im pytest ${PYTEST_VERY_VERBOSE_FLAG} \ + --basetemp="${OUTPUT_DIR}/pytest-tmp" \ + --color=yes \ + --showlocals \ + -p no:forked \ + -p no:mock \ + -ra diff --git a/test/integration/targets/canonical-pep517-self-packaging/runme_test.py b/test/integration/targets/canonical-pep517-self-packaging/runme_test.py new file mode 100644 index 00000000..86b0f753 --- /dev/null +++ b/test/integration/targets/canonical-pep517-self-packaging/runme_test.py @@ -0,0 +1,385 @@ +"""Smoke tests for the in-tree PEP 517 backend.""" + +from __future__ import annotations + +from filecmp import dircmp +from os import chdir, environ, PathLike +from pathlib import Path +from shutil import rmtree +from subprocess import check_call, check_output, PIPE +from sys import executable as current_interpreter, version_info +from tarfile import TarFile +import typing as t + +try: + from contextlib import chdir as _chdir_cm +except ImportError: + from contextlib import contextmanager as _contextmanager + + @_contextmanager + def _chdir_cm(path: PathLike) -> t.Iterator[None]: + original_wd = Path.cwd() + chdir(path) + try: + yield + finally: + chdir(original_wd) + +import pytest + + +DIST_NAME = 'ansible_core' +DIST_FILENAME_BASE = 'ansible-core' +OUTPUT_DIR = Path(environ['OUTPUT_DIR']).resolve().absolute() +SRC_ROOT_DIR = OUTPUT_DIR.parents[3] +GENERATED_MANPAGES_SUBDIR = SRC_ROOT_DIR / 'docs' / 'man' / 'man1' +LOWEST_SUPPORTED_BUILD_DEPS_FILE = ( + Path(__file__).parent / 'minimum-build-constraints.txt' +).resolve().absolute() +MODERNISH_BUILD_DEPS_FILE = ( + Path(__file__).parent / 'modernish-build-constraints.txt' +).resolve().absolute() +RELEASE_MODULE = SRC_ROOT_DIR / 'lib' / 'ansible' / 'release.py' +VERSION_LINE_PREFIX = "__version__ = '" +PKG_DIST_VERSION = next( + line[len(VERSION_LINE_PREFIX):-1] + for line in RELEASE_MODULE.read_text().splitlines() + if line.startswith(VERSION_LINE_PREFIX) +) +EXPECTED_SDIST_NAME_BASE = f'{DIST_FILENAME_BASE}-{PKG_DIST_VERSION}' +EXPECTED_SDIST_NAME = f'{EXPECTED_SDIST_NAME_BASE}.tar.gz' +EXPECTED_WHEEL_NAME = f'{DIST_NAME}-{PKG_DIST_VERSION}-py3-none-any.whl' + +IS_PYTHON310_PLUS = version_info[:2] >= (3, 10) + + +def wipe_generated_manpages() -> None: + """Ensure man1 pages aren't present in the source checkout.""" + # Cleaning up the gitignored manpages... + if not GENERATED_MANPAGES_SUBDIR.exists(): + return + + rmtree(GENERATED_MANPAGES_SUBDIR) + # Removed the generated manpages... + + +def contains_man1_pages(sdist_tarball: Path) -> Path: + """Check if the man1 pages are present in given tarball.""" + with sdist_tarball.open(mode='rb') as tarball_fd: + with TarFile.gzopen(fileobj=tarball_fd, name=None) as tarball: + try: + tarball.getmember( + name=f'{EXPECTED_SDIST_NAME_BASE}/docs/man/man1', + ) + except KeyError: + return False + + return True + + +def unpack_sdist(sdist_tarball: Path, target_directory: Path) -> Path: + """Unarchive given tarball. + + :returns: Path of the package source checkout. + """ + with sdist_tarball.open(mode='rb') as tarball_fd: + with TarFile.gzopen(fileobj=tarball_fd, name=None) as tarball: + tarball.extractall(path=target_directory) + return target_directory / EXPECTED_SDIST_NAME_BASE + + +def assert_dirs_equal(*dir_paths: t.List[Path]) -> None: + dir_comparison = dircmp(*dir_paths) + assert not dir_comparison.left_only + assert not dir_comparison.right_only + assert not dir_comparison.diff_files + assert not dir_comparison.funny_files + + +def normalize_unpacked_rebuilt_sdist(sdist_path: Path) -> None: + top_pkg_info_path = sdist_path / 'PKG-INFO' + nested_pkg_info_path = ( + sdist_path / 'lib' / f'{DIST_NAME}.egg-info' / 'PKG-INFO' + ) + entry_points_path = nested_pkg_info_path.parent / 'entry_points.txt' + + # setuptools v39 write out two trailing empty lines and an unknown platform + # while the recent don't + top_pkg_info_path.write_text( + top_pkg_info_path.read_text().replace( + 'Classifier: Development Status :: 5', + 'Platform: UNKNOWN\nClassifier: Development Status :: 5', + ) + '\n\n' + ) + nested_pkg_info_path.write_text( + nested_pkg_info_path.read_text().replace( + 'Classifier: Development Status :: 5', + 'Platform: UNKNOWN\nClassifier: Development Status :: 5', + ) + '\n\n' + ) + + # setuptools v39 write out one trailing empty line while the recent don't + entry_points_path.write_text(entry_points_path.read_text() + '\n') + + +@pytest.fixture +def venv_python_exe(tmp_path: Path) -> t.Iterator[Path]: + venv_path = tmp_path / 'pytest-managed-venv' + mkvenv_cmd = ( + current_interpreter, '-m', 'venv', str(venv_path), + ) + check_call(mkvenv_cmd, env={}, stderr=PIPE, stdout=PIPE) + yield venv_path / 'bin' / 'python' + rmtree(venv_path) + + +def run_with_venv_python( + python_exe: Path, *cli_args: t.Iterable[str], + env_vars: t.Dict[str, str] = None, +) -> str: + if env_vars is None: + env_vars = {} + full_cmd = str(python_exe), *cli_args + return check_output(full_cmd, env=env_vars, stderr=PIPE) + + +def build_dists( + python_exe: Path, *cli_args: t.Iterable[str], + env_vars: t.Dict[str, str], +) -> str: + return run_with_venv_python( + python_exe, '-m', 'build', + *cli_args, env_vars=env_vars, + ) + + +def pip_install( + python_exe: Path, *cli_args: t.Iterable[str], + env_vars: t.Dict[str, str] = None, +) -> str: + return run_with_venv_python( + python_exe, '-m', 'pip', 'install', + *cli_args, env_vars=env_vars, + ) + + +def test_installing_sdist_build_with_modern_deps_to_old_env( + venv_python_exe: Path, tmp_path: Path, +) -> None: + pip_install(venv_python_exe, 'build ~= 0.10.0') + tmp_dir_sdist_w_modern_tools = tmp_path / 'sdist-w-modern-tools' + build_dists( + venv_python_exe, '--sdist', + '--config-setting=--build-manpages', + f'--outdir={tmp_dir_sdist_w_modern_tools!s}', + str(SRC_ROOT_DIR), + env_vars={ + 'PIP_CONSTRAINT': str(MODERNISH_BUILD_DEPS_FILE), + }, + ) + tmp_path_sdist_w_modern_tools = ( + tmp_dir_sdist_w_modern_tools / EXPECTED_SDIST_NAME + ) + + # Downgrading pip, because v20+ supports in-tree build backends + pip_install(venv_python_exe, 'pip ~= 19.3.1') + + # Smoke test — installing an sdist with pip that does not support + # in-tree build backends. + pip_install( + venv_python_exe, str(tmp_path_sdist_w_modern_tools), '--no-deps', + ) + + # Downgrading pip, because versions that support PEP 517 don't allow + # disabling it with `--no-use-pep517` when `build-backend` is set in + # the `[build-system]` section of `pyproject.toml`, considering this + # an explicit opt-in. + if not IS_PYTHON310_PLUS: + pip_install(venv_python_exe, 'pip == 18.0') + + # Smoke test — installing an sdist with pip that does not support invoking + # PEP 517 interface at all. + # In this scenario, pip will run `setup.py install` since `wheel` is not in + # the environment. + if IS_PYTHON310_PLUS: + tmp_dir_unpacked_sdist_root = tmp_path / 'unpacked-sdist' + tmp_dir_unpacked_sdist_path = tmp_dir_unpacked_sdist_root / EXPECTED_SDIST_NAME_BASE + with TarFile.gzopen(tmp_path_sdist_w_modern_tools) as sdist_fd: + sdist_fd.extractall(path=tmp_dir_unpacked_sdist_root) + + pip_install( + venv_python_exe, 'setuptools', + env_vars={ + 'PIP_CONSTRAINT': str(LOWEST_SUPPORTED_BUILD_DEPS_FILE), + }, + ) + with _chdir_cm(tmp_dir_unpacked_sdist_path): + run_with_venv_python( + venv_python_exe, 'setup.py', 'sdist', + env_vars={'PATH': environ['PATH']}, + ) + else: + pip_install( + venv_python_exe, str(tmp_path_sdist_w_modern_tools), '--no-deps', + env_vars={ + 'PIP_CONSTRAINT': str(LOWEST_SUPPORTED_BUILD_DEPS_FILE), + }, + ) + + # Smoke test — installing an sdist with pip that does not support invoking + # PEP 517 interface at all. + # With `wheel` present, pip will run `setup.py bdist_wheel` and then, + # unpack the result. + pip_install(venv_python_exe, 'wheel') + if IS_PYTHON310_PLUS: + with _chdir_cm(tmp_dir_unpacked_sdist_path): + run_with_venv_python( + venv_python_exe, 'setup.py', 'bdist_wheel', + env_vars={'PATH': environ['PATH']}, + ) + else: + pip_install( + venv_python_exe, str(tmp_path_sdist_w_modern_tools), '--no-deps', + ) + + +def test_dist_rebuilds_with_manpages_premutations( + venv_python_exe: Path, tmp_path: Path, +) -> None: + """Test a series of sdist rebuilds under different conditions. + + This check builds sdists right from the Git checkout with and without + the manpages. It also does this using different versions of the setuptools + PEP 517 build backend being pinned. Finally, it builds a wheel out of one + of the rebuilt sdists. + As intermediate assertions, this test makes simple smoke tests along + the way. + """ + pip_install(venv_python_exe, 'build ~= 0.10.0') + + # Test building an sdist without manpages from the Git checkout + tmp_dir_sdist_without_manpages = tmp_path / 'sdist-without-manpages' + wipe_generated_manpages() + build_dists( + venv_python_exe, '--sdist', + f'--outdir={tmp_dir_sdist_without_manpages!s}', + str(SRC_ROOT_DIR), + env_vars={ + 'PIP_CONSTRAINT': str(MODERNISH_BUILD_DEPS_FILE), + }, + ) + tmp_path_sdist_without_manpages = ( + tmp_dir_sdist_without_manpages / EXPECTED_SDIST_NAME + ) + assert tmp_path_sdist_without_manpages.exists() + assert not contains_man1_pages(tmp_path_sdist_without_manpages) + sdist_without_manpages_path = unpack_sdist( + tmp_path_sdist_without_manpages, + tmp_dir_sdist_without_manpages / 'src', + ) + + # Test building an sdist with manpages from the Git checkout + # and lowest supported build deps + wipe_generated_manpages() + tmp_dir_sdist_with_manpages = tmp_path / 'sdist-with-manpages' + build_dists( + venv_python_exe, '--sdist', + '--config-setting=--build-manpages', + f'--outdir={tmp_dir_sdist_with_manpages!s}', + str(SRC_ROOT_DIR), + env_vars={ + 'PIP_CONSTRAINT': str(LOWEST_SUPPORTED_BUILD_DEPS_FILE), + }, + ) + tmp_path_sdist_with_manpages = ( + tmp_dir_sdist_with_manpages / EXPECTED_SDIST_NAME + ) + assert tmp_path_sdist_with_manpages.exists() + assert contains_man1_pages(tmp_path_sdist_with_manpages) + sdist_with_manpages_path = unpack_sdist( + tmp_path_sdist_with_manpages, + tmp_dir_sdist_with_manpages / 'src', + ) + + # Test re-building an sdist with manpages from the + # sdist contents that does not include the manpages + tmp_dir_rebuilt_sdist = tmp_path / 'rebuilt-sdist' + build_dists( + venv_python_exe, '--sdist', + '--config-setting=--build-manpages', + f'--outdir={tmp_dir_rebuilt_sdist!s}', + str(sdist_without_manpages_path), + env_vars={ + 'PIP_CONSTRAINT': str(MODERNISH_BUILD_DEPS_FILE), + }, + ) + tmp_path_rebuilt_sdist = tmp_dir_rebuilt_sdist / EXPECTED_SDIST_NAME + # Checking that the expected sdist got created + # from the previous unpacked sdist... + assert tmp_path_rebuilt_sdist.exists() + # NOTE: The following assertion is disabled due to the fact that, when + # NOTE: building an sdist from the original source checkout, the build + # NOTE: backend replaces itself with pure setuptools in the resulting + # NOTE: sdist, and the following rebuilds from that sdist are no longer + # NOTE: able to process the custom config settings that are implemented in + # NOTE: the in-tree build backend. It is expected that said + # NOTE: `pyproject.toml` mutation change will be reverted once all of the + # NOTE: supported `ansible-core` versions ship wheels, meaning that the + # NOTE: end-users won't be building the distribution from sdist on install. + # NOTE: Another case, when it can be reverted is declaring pip below v20 + # NOTE: unsupported — it is the first version to support in-tree build + # NOTE: backends natively. + # assert contains_man1_pages(tmp_path_rebuilt_sdist) # FIXME: See #80255 + rebuilt_sdist_path = unpack_sdist( + tmp_path_rebuilt_sdist, + tmp_dir_rebuilt_sdist / 'src', + ) + assert rebuilt_sdist_path.exists() + assert rebuilt_sdist_path.is_dir() + normalize_unpacked_rebuilt_sdist(rebuilt_sdist_path) + assert_dirs_equal(rebuilt_sdist_path, sdist_with_manpages_path) + + # Test building a wheel from the rebuilt sdist with manpages contents + # and lowest supported build deps + tmp_dir_rebuilt_wheel = tmp_path / 'rebuilt-wheel' + build_dists( + venv_python_exe, '--wheel', + f'--outdir={tmp_dir_rebuilt_wheel!s}', + str(sdist_with_manpages_path), + env_vars={ + 'PIP_CONSTRAINT': str(LOWEST_SUPPORTED_BUILD_DEPS_FILE), + }, + ) + tmp_path_rebuilt_wheel = tmp_dir_rebuilt_wheel / EXPECTED_WHEEL_NAME + # Checking that the expected wheel got created... + assert tmp_path_rebuilt_wheel.exists() + + +def test_pep660_editable_install_smoke(venv_python_exe: Path) -> None: + """Smoke-test PEP 660 editable install. + + This verifies that the in-tree build backend wrapper + does not break any required interfaces. + """ + pip_install(venv_python_exe, '-e', str(SRC_ROOT_DIR)) + + pip_show_cmd = ( + str(venv_python_exe), '-m', + 'pip', 'show', DIST_FILENAME_BASE, + ) + installed_ansible_meta = check_output( + pip_show_cmd, + env={}, stderr=PIPE, text=True, + ).splitlines() + assert f'Name: {DIST_FILENAME_BASE}' in installed_ansible_meta + assert f'Version: {PKG_DIST_VERSION}' in installed_ansible_meta + + pip_runtime_version_cmd = ( + str(venv_python_exe), '-c', + 'from ansible import __version__; print(__version__)', + ) + runtime_ansible_version = check_output( + pip_runtime_version_cmd, + env={}, stderr=PIPE, text=True, + ).strip() + assert runtime_ansible_version == PKG_DIST_VERSION diff --git a/test/integration/targets/copy/tasks/check_mode.yml b/test/integration/targets/copy/tasks/check_mode.yml index 5b405cc4..9702e070 100644 --- a/test/integration/targets/copy/tasks/check_mode.yml +++ b/test/integration/targets/copy/tasks/check_mode.yml @@ -113,8 +113,7 @@ - check_mode_subdir_first is changed - check_mode_trailing_slash_first is changed - # TODO: This is a legitimate bug - #- not check_mode_trailing_slash_first_stat.stat.exists + - not check_mode_trailing_slash_first_stat.stat.exists - check_mode_trailing_slash_real is changed - check_mode_trailing_slash_real_stat.stat.exists - check_mode_trailing_slash_second is not changed @@ -124,3 +123,41 @@ - check_mode_foo_real is changed - check_mode_foo_real_stat.stat.exists - check_mode_foo_second is not changed + + - name: check_mode - Do a basic copy to setup next test (without check mode) + copy: + src: foo.txt + dest: "{{ remote_dir }}/foo-check_mode.txt" + mode: 0444 + + - name: check_mode - Copy the same src with a different mode (check mode) + copy: + src: foo.txt + dest: "{{ remote_dir }}/foo-check_mode.txt" + mode: 0666 + check_mode: True + register: check_mode_file_attribute + + - name: stat the file to make sure the mode was not updated in check mode + stat: + path: "{{ remote_dir }}/foo-check_mode.txt" + register: check_mode_file_attribute_stat + + - name: check_mode - Copy the same src with a different mode (without check mode) + copy: + src: foo.txt + dest: "{{ remote_dir }}/foo-check_mode.txt" + mode: 0666 + register: real_file_attribute + + - name: stat the file to make sure the mode was updated without check mode + stat: + path: "{{ remote_dir }}/foo-check_mode.txt" + register: real_file_attribute_stat + + - assert: + that: + - check_mode_file_attribute is changed + - real_file_attribute is changed + - "check_mode_file_attribute_stat.stat.mode == '0444'" + - "real_file_attribute_stat.stat.mode == '0666'" diff --git a/test/integration/targets/entry_points/aliases b/test/integration/targets/entry_points/aliases index 9d967564..7f0ffcf0 100644 --- a/test/integration/targets/entry_points/aliases +++ b/test/integration/targets/entry_points/aliases @@ -1,2 +1,3 @@ context/controller shippable/posix/group4 +packaging diff --git a/test/integration/targets/include_import/roles/role_with_argspec/meta/argument_specs.yml b/test/integration/targets/include_import/roles/role_with_argspec/meta/argument_specs.yml new file mode 100644 index 00000000..e6d200c1 --- /dev/null +++ b/test/integration/targets/include_import/roles/role_with_argspec/meta/argument_specs.yml @@ -0,0 +1,7 @@ +argument_specs: + main: + short_description: The main entry point for dup_allowed_role + options: + optional_int: + type: int + description: An integer value diff --git a/test/integration/targets/include_import/roles/role_with_argspec/tasks/main.yml b/test/integration/targets/include_import/roles/role_with_argspec/tasks/main.yml new file mode 100644 index 00000000..23f52ef5 --- /dev/null +++ b/test/integration/targets/include_import/roles/role_with_argspec/tasks/main.yml @@ -0,0 +1 @@ +- debug: msg='Running role_with_argspec' diff --git a/test/integration/targets/include_import/runme.sh b/test/integration/targets/include_import/runme.sh index d384a12e..078f080b 100755 --- a/test/integration/targets/include_import/runme.sh +++ b/test/integration/targets/include_import/runme.sh @@ -121,6 +121,11 @@ ansible-playbook valid_include_keywords/playbook.yml "$@" ansible-playbook tasks/test_allow_single_role_dup.yml 2>&1 | tee test_allow_single_role_dup.out test "$(grep -c 'ok=3' test_allow_single_role_dup.out)" = 1 +# test templating public, allow_duplicates, and rolespec_validate +ansible-playbook tasks/test_templating_IncludeRole_FA.yml 2>&1 | tee IncludeRole_FA_template.out +test "$(grep -c 'ok=4' IncludeRole_FA_template.out)" = 1 +test "$(grep -c 'failed=0' IncludeRole_FA_template.out)" = 1 + # https://github.com/ansible/ansible/issues/66764 ANSIBLE_HOST_PATTERN_MISMATCH=error ansible-playbook empty_group_warning/playbook.yml diff --git a/test/integration/targets/include_import/tasks/test_templating_IncludeRole_FA.yml b/test/integration/targets/include_import/tasks/test_templating_IncludeRole_FA.yml new file mode 100644 index 00000000..cb67a9bb --- /dev/null +++ b/test/integration/targets/include_import/tasks/test_templating_IncludeRole_FA.yml @@ -0,0 +1,28 @@ +--- +- name: test templating allow_duplicates, public, and rolespec_validate + hosts: localhost + gather_facts: false + tasks: + - name: prevent duplicate roles with a templated value + block: + - import_role: + name: dup_allowed_role + allow_duplicates: "{{ False | bool }}" + - import_role: + name: dup_allowed_role + allow_duplicates: "{{ False | bool }}" + + - name: prevent leaky vars with a templated value + include_role: + name: role1 + public: "{{ False | bool }}" + - assert: + that: + - where_am_i_defined is undefined + + - name: skip role argspec validation with a templated value + include_role: + name: role_with_argspec + rolespec_validate: "{{ False | bool }}" + vars: + optional_int: wrong_type diff --git a/test/integration/targets/keyword_inheritance/dep_keyword_inheritance.yml b/test/integration/targets/keyword_inheritance/dep_keyword_inheritance.yml new file mode 100644 index 00000000..3d3b684a --- /dev/null +++ b/test/integration/targets/keyword_inheritance/dep_keyword_inheritance.yml @@ -0,0 +1,8 @@ +- hosts: localhost + gather_facts: false + tasks: + - include_role: + name: "{{ item }}" + loop: + - setup_test_user + - role-meta-inheritance diff --git a/test/integration/targets/keyword_inheritance/roles/role-meta-inheritance/meta/main.yml b/test/integration/targets/keyword_inheritance/roles/role-meta-inheritance/meta/main.yml new file mode 100644 index 00000000..b0af49fb --- /dev/null +++ b/test/integration/targets/keyword_inheritance/roles/role-meta-inheritance/meta/main.yml @@ -0,0 +1,4 @@ +dependencies: + - role: whoami + become: true + become_user: ansibletest0 diff --git a/test/integration/targets/keyword_inheritance/runme.sh b/test/integration/targets/keyword_inheritance/runme.sh index 6b78a06d..1f13ef85 100755 --- a/test/integration/targets/keyword_inheritance/runme.sh +++ b/test/integration/targets/keyword_inheritance/runme.sh @@ -3,3 +3,5 @@ set -eux ANSIBLE_ROLES_PATH=../ ansible-playbook -i ../../inventory test.yml "$@" + +ANSIBLE_ROLES_PATH=../ ansible-playbook -i ../../inventory dep_keyword_inheritance.yml "$@" diff --git a/test/integration/targets/lookup_url/tasks/main.yml b/test/integration/targets/lookup_url/tasks/main.yml index a7de5063..2fb227ad 100644 --- a/test/integration/targets/lookup_url/tasks/main.yml +++ b/test/integration/targets/lookup_url/tasks/main.yml @@ -1,11 +1,11 @@ - name: Test that retrieving a url works set_fact: - web_data: "{{ lookup('url', 'https://gist.githubusercontent.com/abadger/9858c22712f62a8effff/raw/43dd47ea691c90a5fa7827892c70241913351963/test') }}" + web_data: "{{ lookup('url', 'https://{{ httpbin_host }}/get?one') }}" - name: Assert that the url was retrieved assert: that: - - "'one' in web_data" + - "'one' in web_data.args" - name: Test that retrieving a url with invalid cert fails set_fact: diff --git a/test/integration/targets/module_utils_Ansible.Basic/library/ansible_basic_tests.ps1 b/test/integration/targets/module_utils_Ansible.Basic/library/ansible_basic_tests.ps1 index cfa73c60..6170f046 100644 --- a/test/integration/targets/module_utils_Ansible.Basic/library/ansible_basic_tests.ps1 +++ b/test/integration/targets/module_utils_Ansible.Basic/library/ansible_basic_tests.ps1 @@ -1747,6 +1747,168 @@ test_no_log - Invoked with: Remove-Item -LiteralPath $actual_tmpdir -Force -Recurse } + "Module tmpdir with symlinks" = { + $remote_tmp = Join-Path -Path $tmpdir -ChildPath "moduletmpdir-$(Get-Random)" + New-Item -Path $remote_tmp -ItemType Directory > $null + Set-Variable -Name complex_args -Scope Global -Value @{ + _ansible_remote_tmp = $remote_tmp.ToString() + } + $m = [Ansible.Basic.AnsibleModule]::Create(@(), @{}) + + $actual_tmpdir = $m.Tmpdir + + $dir1 = Join-Path $actual_tmpdir Dir1 + $dir2 = Join-Path $actual_tmpdir Dir2 + $dir1, $dir2 | New-Item -Path { $_ } -ItemType Directory > $null + + $file1 = Join-Path $dir1 test.txt + $file2 = Join-Path $dir2 test.txt + $file3 = Join-Path $actual_tmpdir test.txt + Set-Content -LiteralPath $file1 '' + Set-Content -LiteralPath $file2 '' + Set-Content -LiteralPath $file3 '' + + $outside_target = Join-Path -Path $tmpdir -ChildPath "moduleoutsidedir-$(Get-Random)" + $outside_file = Join-Path -Path $outside_target -ChildPath "file" + New-Item -Path $outside_target -ItemType Directory > $null + Set-Content -LiteralPath $outside_file '' + + cmd.exe /c mklink /d "$dir1\missing-dir-link" "$actual_tmpdir\fake" + cmd.exe /c mklink /d "$dir1\good-dir-link" "$dir2" + cmd.exe /c mklink /d "$dir1\recursive-target-link" "$dir1" + cmd.exe /c mklink "$dir1\missing-file-link" "$actual_tmpdir\fake" + cmd.exe /c mklink "$dir1\good-file-link" "$dir2\test.txt" + cmd.exe /c mklink /d "$actual_tmpdir\outside-dir" $outside_target + cmd.exe /c mklink "$actual_tmpdir\outside-file" $outside_file + + try { + $m.ExitJson() + } + catch [System.Management.Automation.RuntimeException] { + $output = [Ansible.Basic.AnsibleModule]::FromJson($_.Exception.InnerException.Output) + } + + $output.warnings.Count | Assert-Equal -Expected 0 + (Test-Path -LiteralPath $actual_tmpdir -PathType Container) | Assert-Equal -Expected $false + (Test-Path -LiteralPath $outside_target -PathType Container) | Assert-Equal -Expected $true + (Test-Path -LiteralPath $outside_file -PathType Leaf) | Assert-Equal -Expected $true + + Remove-Item -LiteralPath $remote_tmp -Force -Recurse + } + + "Module tmpdir with undeletable file" = { + $remote_tmp = Join-Path -Path $tmpdir -ChildPath "moduletmpdir-$(Get-Random)" + New-Item -Path $remote_tmp -ItemType Directory > $null + Set-Variable -Name complex_args -Scope Global -Value @{ + _ansible_remote_tmp = $remote_tmp.ToString() + } + $m = [Ansible.Basic.AnsibleModule]::Create(@(), @{}) + + $actual_tmpdir = $m.Tmpdir + + $dir1 = Join-Path $actual_tmpdir Dir1 + $dir2 = Join-Path $actual_tmpdir Dir2 + $dir1, $dir2 | New-Item -Path { $_ } -ItemType Directory > $null + + $file1 = Join-Path $dir1 test.txt + $file2 = Join-Path $dir2 test.txt + $file3 = Join-Path $actual_tmpdir test.txt + Set-Content -LiteralPath $file1 '' + Set-Content -LiteralPath $file2 '' + Set-Content -LiteralPath $file3 '' + + $fs = [System.IO.File]::Open($file1, "Open", "Read", "None") + try { + $m.ExitJson() + } + catch [System.Management.Automation.RuntimeException] { + $output = [Ansible.Basic.AnsibleModule]::FromJson($_.Exception.InnerException.Output) + } + + $expected_msg = "Failure cleaning temp path '$actual_tmpdir': IOException Directory contains files still open by other processes" + $output.warnings.Count | Assert-Equal -Expected 1 + $output.warnings[0] | Assert-Equal -Expected $expected_msg + + (Test-Path -LiteralPath $actual_tmpdir -PathType Container) | Assert-Equal -Expected $true + (Test-Path -LiteralPath $dir1 -PathType Container) | Assert-Equal -Expected $true + # Test-Path tries to open the file in a way that fails if it's marked as deleted + (Get-ChildItem -LiteralPath $dir1 -File).Count | Assert-Equal -Expected 1 + (Test-Path -LiteralPath $dir2 -PathType Container) | Assert-Equal -Expected $false + (Test-Path -LiteralPath $file3 -PathType Leaf) | Assert-Equal -Expected $false + + # Releasing the file handle releases the lock on the file but as the + # cleanup couldn't access the file to mark as delete on close it is + # still going to be present. + $fs.Dispose() + (Test-Path -LiteralPath $dir1 -PathType Container) | Assert-Equal -Expected $true + (Test-Path -LiteralPath $file1 -PathType Leaf) | Assert-Equal -Expected $true + + Remove-Item -LiteralPath $remote_tmp -Force -Recurse + } + + "Module tmpdir delete with locked handle" = { + $remote_tmp = Join-Path -Path $tmpdir -ChildPath "moduletmpdir-$(Get-Random)" + New-Item -Path $remote_tmp -ItemType Directory > $null + Set-Variable -Name complex_args -Scope Global -Value @{ + _ansible_remote_tmp = $remote_tmp.ToString() + } + $m = [Ansible.Basic.AnsibleModule]::Create(@(), @{}) + + $actual_tmpdir = $m.Tmpdir + + $dir1 = Join-Path $actual_tmpdir Dir1 + $dir2 = Join-Path $actual_tmpdir Dir2 + $dir1, $dir2 | New-Item -Path { $_ } -ItemType Directory > $null + + $file1 = Join-Path $dir1 test.txt + $file2 = Join-Path $dir2 test.txt + $file3 = Join-Path $actual_tmpdir test.txt + Set-Content -LiteralPath $file1 '' + Set-Content -LiteralPath $file2 '' + Set-Content -LiteralPath $file3 '' + + [System.IO.File]::SetAttributes($file1, "ReadOnly") + [System.IO.File]::SetAttributes($file2, "ReadOnly") + [System.IO.File]::SetAttributes($file3, "ReadOnly") + $fs = [System.IO.File]::Open($file1, "Open", "Read", "Delete") + try { + $m.ExitJson() + } + catch [System.Management.Automation.RuntimeException] { + $output = [Ansible.Basic.AnsibleModule]::FromJson($_.Exception.InnerException.Output) + } + + if ([System.Environment]::OSVersion.Version -lt [Version]'10.0') { + # Older hosts can only do delete on close. This means Dir1 and its + # file will still be present but Dir2 should be deleted. + $expected_msg = "Failure cleaning temp path '$actual_tmpdir': IOException Directory contains files still open by other processes" + $output.warnings.Count | Assert-Equal -Expected 1 + $output.warnings[0] | Assert-Equal -Expected $expected_msg + + (Test-Path -LiteralPath $actual_tmpdir -PathType Container) | Assert-Equal -Expected $true + (Test-Path -LiteralPath $dir1 -PathType Container) | Assert-Equal -Expected $true + # Test-Path tries to open the file in a way that fails if it's marked as deleted + (Get-ChildItem -LiteralPath $dir1 -File).Count | Assert-Equal -Expected 1 + (Test-Path -LiteralPath $dir2 -PathType Container) | Assert-Equal -Expected $false + (Test-Path -LiteralPath $file3 -PathType Leaf) | Assert-Equal -Expected $false + + # Releasing the file handle releases the lock on the file deleting + # it. Unfortunately the parent dir will still be present + $fs.Dispose() + (Test-Path -LiteralPath $dir1 -PathType Container) | Assert-Equal -Expected $true + (Test-Path -LiteralPath $file1 -PathType Leaf) | Assert-Equal -Expected $false + } + else { + # Server 2016+ can use the POSIX APIs which will delete it straight away + (Test-Path -LiteralPath $actual_tmpdir -PathType Container) | Assert-Equal -Expected $false + $output.warnings.Count | Assert-Equal -Expected 0 + + $fs.Dispose() + } + + Remove-Item -LiteralPath $remote_tmp -Force -Recurse + } + "Invalid argument spec key" = { $spec = @{ invalid = $true diff --git a/test/integration/targets/template_jinja2_non_native/macro_override.yml b/test/integration/targets/template_jinja2_non_native/macro_override.yml new file mode 100644 index 00000000..8a1cabd2 --- /dev/null +++ b/test/integration/targets/template_jinja2_non_native/macro_override.yml @@ -0,0 +1,15 @@ +- hosts: localhost + gather_facts: false + vars: + output_dir: "{{ lookup('env', 'OUTPUT_DIR') }}" + tasks: + - template: + src: macro_override.j2 + dest: "{{ output_dir }}/macro_override.out" + + - assert: + that: + - "'foobar' not in data" + - "'\"foo\" \"bar\"' in data" + vars: + data: "{{ lookup('file', '{{ output_dir }}/macro_override.out') }}" diff --git a/test/integration/targets/template_jinja2_non_native/runme.sh b/test/integration/targets/template_jinja2_non_native/runme.sh index fe9d495a..c02d6b33 100755 --- a/test/integration/targets/template_jinja2_non_native/runme.sh +++ b/test/integration/targets/template_jinja2_non_native/runme.sh @@ -4,4 +4,6 @@ set -eux export ANSIBLE_JINJA2_NATIVE=1 ansible-playbook 46169.yml -v "$@" +python -m pip install "Jinja2>=3.1.0" +ansible-playbook macro_override.yml -v "$@" unset ANSIBLE_JINJA2_NATIVE diff --git a/test/integration/targets/template_jinja2_non_native/templates/macro_override.j2 b/test/integration/targets/template_jinja2_non_native/templates/macro_override.j2 new file mode 100644 index 00000000..51908da0 --- /dev/null +++ b/test/integration/targets/template_jinja2_non_native/templates/macro_override.j2 @@ -0,0 +1,7 @@ +#jinja2: variable_start_string:'<<',variable_end_string:'>>' +Use a jinja2 override to trigger creating and using an environment overlay. + +{% macro m() %} +"foo" "bar" +{% endmacro %} +<< m() >> diff --git a/test/integration/targets/uri/tasks/main.yml b/test/integration/targets/uri/tasks/main.yml index d821f286..7fa687b4 100644 --- a/test/integration/targets/uri/tasks/main.yml +++ b/test/integration/targets/uri/tasks/main.yml @@ -305,7 +305,7 @@ environment: https_proxy: 'https://localhost:3456' uri: - url: 'https://httpbin.org/get' + url: 'https://{{ httpbin_host }}/get' register: result ignore_errors: true @@ -318,7 +318,7 @@ environment: https_proxy: 'https://localhost:3456' uri: - url: 'https://httpbin.org/get' + url: 'https://{{ httpbin_host }}/get' use_proxy: no # Ubuntu12.04 doesn't have python-urllib3, this makes handling required dependencies a pain across all variations diff --git a/test/integration/targets/win_async_wrapper/tasks/main.yml b/test/integration/targets/win_async_wrapper/tasks/main.yml index 91b45846..0fc64d8c 100644 --- a/test/integration/targets/win_async_wrapper/tasks/main.yml +++ b/test/integration/targets/win_async_wrapper/tasks/main.yml @@ -12,12 +12,12 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.started == 1 - asyncresult is started - asyncresult.finished == 0 - asyncresult is not finished - - asyncresult.results_file is search('\.ansible_async.+\d+\.\d+') + - asyncresult.results_file is search('\.ansible_async.+j\d+\.\d+') # ensure that async is actually async- this test will fail if # hosts > forks or if the target host is VERY slow - (lookup('pipe', 'date +%s') | int) - (start_timestamp | int) < 15 @@ -31,7 +31,7 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.finished == 1 - asyncresult is finished - asyncresult is changed @@ -69,7 +69,7 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.finished == 1 - asyncresult is finished - asyncresult is changed @@ -107,7 +107,7 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.finished == 1 - asyncresult is finished - asyncresult is not changed @@ -125,7 +125,7 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.finished == 1 - asyncresult is finished - asyncresult is changed @@ -143,7 +143,7 @@ - name: validate response assert: that: - - asyncresult.ansible_job_id is match('\d+\.\d+') + - asyncresult.ansible_job_id is match('j\d+\.\d+') - asyncresult.finished == 1 - asyncresult is finished - asyncresult is not changed @@ -231,7 +231,7 @@ # - item is finished # - item.slept_sec == 3 # - item is changed -# - item.ansible_job_id is match('\d+\.\d+') +# - item.ansible_job_id is match('j\d+\.\d+') # with_items: "{{ asyncout.results }}" # this part of the test is flaky- Windows PIDs are reused aggressively, so this occasionally fails due to a new process with the same ID diff --git a/test/lib/ansible_test/_internal/__init__.py b/test/lib/ansible_test/_internal/__init__.py index d218b561..ee24a852 100644 --- a/test/lib/ansible_test/_internal/__init__.py +++ b/test/lib/ansible_test/_internal/__init__.py @@ -18,6 +18,7 @@ from .constants import ( from .util import ( ApplicationError, HostConnectionError, + TimeoutExpiredError, display, report_locale, ) @@ -109,6 +110,9 @@ def main(cli_args: t.Optional[list[str]] = None) -> None: except ApplicationError as ex: display.fatal('%s' % ex) sys.exit(1) + except TimeoutExpiredError as ex: + display.fatal('%s' % ex) + sys.exit(1) except KeyboardInterrupt: sys.exit(2) except BrokenPipeError: diff --git a/test/lib/ansible_test/_internal/ansible_util.py b/test/lib/ansible_test/_internal/ansible_util.py index 9efcda26..9548d37c 100644 --- a/test/lib/ansible_test/_internal/ansible_util.py +++ b/test/lib/ansible_test/_internal/ansible_util.py @@ -114,27 +114,27 @@ def ansible_environment(args: CommonConfig, color: bool = True, ansible_config: # standard path injection is not effective for ansible-connection, instead the location must be configured # ansible-connection only requires the injector for code coverage # the correct python interpreter is already selected using the sys.executable used to invoke ansible - ansible.update(dict( + ansible.update( ANSIBLE_CONNECTION_PATH=os.path.join(get_injector_path(), 'ansible-connection'), - )) + ) if isinstance(args, PosixIntegrationConfig): - ansible.update(dict( + ansible.update( ANSIBLE_PYTHON_INTERPRETER='/set/ansible_python_interpreter/in/inventory', # force tests to set ansible_python_interpreter in inventory - )) + ) env.update(ansible) if args.debug: - env.update(dict( + env.update( ANSIBLE_DEBUG='true', ANSIBLE_LOG_PATH=os.path.join(ResultType.LOGS.name, 'debug.log'), - )) + ) if data_context().content.collection: - env.update(dict( + env.update( ANSIBLE_COLLECTIONS_PATH=data_context().content.collection.root, - )) + ) if data_context().content.is_ansible: env.update(configure_plugin_paths(args)) @@ -252,12 +252,14 @@ License: GPLv3+ class CollectionDetail: """Collection detail.""" + def __init__(self) -> None: self.version: t.Optional[str] = None class CollectionDetailError(ApplicationError): """An error occurred retrieving collection detail.""" + def __init__(self, reason: str) -> None: super().__init__('Error collecting collection detail: %s' % reason) self.reason = reason diff --git a/test/lib/ansible_test/_internal/become.py b/test/lib/ansible_test/_internal/become.py index e653959a..f8320b3b 100644 --- a/test/lib/ansible_test/_internal/become.py +++ b/test/lib/ansible_test/_internal/become.py @@ -11,6 +11,7 @@ from .util import ( class Become(metaclass=abc.ABCMeta): """Base class for become implementations.""" + @classmethod def name(cls) -> str: """The name of this plugin.""" @@ -28,6 +29,7 @@ class Become(metaclass=abc.ABCMeta): class Doas(Become): """Become using 'doas'.""" + @property def method(self) -> str: """The name of the Ansible become plugin that is equivalent to this.""" @@ -47,6 +49,7 @@ class Doas(Become): class DoasSudo(Doas): """Become using 'doas' in ansible-test and then after bootstrapping use 'sudo' for other ansible commands.""" + @classmethod def name(cls) -> str: """The name of this plugin.""" @@ -60,6 +63,7 @@ class DoasSudo(Doas): class Su(Become): """Become using 'su'.""" + @property def method(self) -> str: """The name of the Ansible become plugin that is equivalent to this.""" @@ -77,6 +81,7 @@ class Su(Become): class SuSudo(Su): """Become using 'su' in ansible-test and then after bootstrapping use 'sudo' for other ansible commands.""" + @classmethod def name(cls) -> str: """The name of this plugin.""" @@ -90,6 +95,7 @@ class SuSudo(Su): class Sudo(Become): """Become using 'sudo'.""" + @property def method(self) -> str: """The name of the Ansible become plugin that is equivalent to this.""" diff --git a/test/lib/ansible_test/_internal/bootstrap.py b/test/lib/ansible_test/_internal/bootstrap.py index 261ef59b..b0cfb601 100644 --- a/test/lib/ansible_test/_internal/bootstrap.py +++ b/test/lib/ansible_test/_internal/bootstrap.py @@ -26,6 +26,7 @@ from .core_ci import ( @dataclasses.dataclass class Bootstrap: """Base class for bootstrapping systems.""" + controller: bool python_versions: list[str] ssh_key: SshKey @@ -65,6 +66,7 @@ class Bootstrap: @dataclasses.dataclass class BootstrapDocker(Bootstrap): """Bootstrap docker instances.""" + def get_variables(self) -> dict[str, t.Union[str, list[str]]]: """The variables to template in the bootstrapping script.""" variables = super().get_variables() @@ -80,6 +82,7 @@ class BootstrapDocker(Bootstrap): @dataclasses.dataclass class BootstrapRemote(Bootstrap): """Bootstrap remote instances.""" + platform: str platform_version: str diff --git a/test/lib/ansible_test/_internal/cache.py b/test/lib/ansible_test/_internal/cache.py index 3afe422f..d291dcee 100644 --- a/test/lib/ansible_test/_internal/cache.py +++ b/test/lib/ansible_test/_internal/cache.py @@ -13,6 +13,7 @@ TValue = t.TypeVar('TValue') class CommonCache: """Common cache.""" + def __init__(self, args: CommonConfig) -> None: self.args = args diff --git a/test/lib/ansible_test/_internal/cgroup.py b/test/lib/ansible_test/_internal/cgroup.py index 977e359d..a08513a5 100644 --- a/test/lib/ansible_test/_internal/cgroup.py +++ b/test/lib/ansible_test/_internal/cgroup.py @@ -9,6 +9,7 @@ import re class CGroupPath: """Linux cgroup path constants.""" + ROOT = '/sys/fs/cgroup' SYSTEMD = '/sys/fs/cgroup/systemd' SYSTEMD_RELEASE_AGENT = '/sys/fs/cgroup/systemd/release_agent' @@ -16,6 +17,7 @@ class CGroupPath: class MountType: """Linux filesystem mount type constants.""" + TMPFS = 'tmpfs' CGROUP_V1 = 'cgroup' CGROUP_V2 = 'cgroup2' @@ -24,6 +26,7 @@ class MountType: @dataclasses.dataclass(frozen=True) class CGroupEntry: """A single cgroup entry parsed from '/proc/{pid}/cgroup' in the proc filesystem.""" + id: int subsystem: str path: pathlib.PurePosixPath @@ -46,7 +49,7 @@ class CGroupEntry: return cls( id=int(cid), subsystem=subsystem.removeprefix('name='), - path=pathlib.PurePosixPath(path) + path=pathlib.PurePosixPath(path), ) @classmethod @@ -58,6 +61,7 @@ class CGroupEntry: @dataclasses.dataclass(frozen=True) class MountEntry: """A single mount info entry parsed from '/proc/{pid}/mountinfo' in the proc filesystem.""" + mount_id: int parent_id: int device_major: int diff --git a/test/lib/ansible_test/_internal/ci/__init__.py b/test/lib/ansible_test/_internal/ci/__init__.py index 97e41dae..5e53b150 100644 --- a/test/lib/ansible_test/_internal/ci/__init__.py +++ b/test/lib/ansible_test/_internal/ci/__init__.py @@ -39,6 +39,7 @@ class ChangeDetectionNotSupported(ApplicationError): class CIProvider(metaclass=abc.ABCMeta): """Base class for CI provider plugins.""" + priority = 500 @staticmethod @@ -61,8 +62,8 @@ class CIProvider(metaclass=abc.ABCMeta): """Return a resource prefix specific to this CI provider.""" @abc.abstractmethod - def get_base_branch(self) -> str: - """Return the base branch or an empty string.""" + def get_base_commit(self, args: CommonConfig) -> str: + """Return the base commit or an empty string.""" @abc.abstractmethod def detect_changes(self, args: TestConfig) -> t.Optional[list[str]]: @@ -103,6 +104,7 @@ def get_ci_provider() -> CIProvider: class AuthHelper(metaclass=abc.ABCMeta): """Public key based authentication helper for Ansible Core CI.""" + def sign_request(self, request: dict[str, t.Any]) -> None: """Sign the given auth request and make the public key available.""" payload_bytes = to_bytes(json.dumps(request, sort_keys=True)) @@ -141,6 +143,7 @@ class AuthHelper(metaclass=abc.ABCMeta): class CryptographyAuthHelper(AuthHelper, metaclass=abc.ABCMeta): """Cryptography based public key based authentication helper for Ansible Core CI.""" + def sign_bytes(self, payload_bytes: bytes) -> bytes: """Sign the given payload and return the signature, initializing a new key pair if required.""" # import cryptography here to avoid overhead and failures in environments which do not use/provide it @@ -186,6 +189,7 @@ class CryptographyAuthHelper(AuthHelper, metaclass=abc.ABCMeta): class OpenSSLAuthHelper(AuthHelper, metaclass=abc.ABCMeta): """OpenSSL based public key based authentication helper for Ansible Core CI.""" + def sign_bytes(self, payload_bytes: bytes) -> bytes: """Sign the given payload and return the signature, initializing a new key pair if required.""" private_key_pem = self.initialize_private_key() diff --git a/test/lib/ansible_test/_internal/ci/azp.py b/test/lib/ansible_test/_internal/ci/azp.py index 9170dfec..404f8056 100644 --- a/test/lib/ansible_test/_internal/ci/azp.py +++ b/test/lib/ansible_test/_internal/ci/azp.py @@ -40,9 +40,12 @@ CODE = 'azp' class AzurePipelines(CIProvider): """CI provider implementation for Azure Pipelines.""" + def __init__(self) -> None: self.auth = AzurePipelinesAuthHelper() + self._changes: AzurePipelinesChanges | None = None + @staticmethod def is_supported() -> bool: """Return True if this provider is supported in the current running environment.""" @@ -71,18 +74,20 @@ class AzurePipelines(CIProvider): return prefix - def get_base_branch(self) -> str: - """Return the base branch or an empty string.""" - base_branch = os.environ.get('SYSTEM_PULLREQUEST_TARGETBRANCH') or os.environ.get('BUILD_SOURCEBRANCHNAME') + def get_base_commit(self, args: CommonConfig) -> str: + """Return the base commit or an empty string.""" + return self._get_changes(args).base_commit or '' - if base_branch: - base_branch = 'origin/%s' % base_branch + def _get_changes(self, args: CommonConfig) -> AzurePipelinesChanges: + """Return an AzurePipelinesChanges instance, which will be created on first use.""" + if not self._changes: + self._changes = AzurePipelinesChanges(args) - return base_branch or '' + return self._changes def detect_changes(self, args: TestConfig) -> t.Optional[list[str]]: """Initialize change detection.""" - result = AzurePipelinesChanges(args) + result = self._get_changes(args) if result.is_pr: job_type = 'pull request' @@ -128,7 +133,7 @@ class AzurePipelines(CIProvider): def get_git_details(self, args: CommonConfig) -> t.Optional[dict[str, t.Any]]: """Return details about git in the current environment.""" - changes = AzurePipelinesChanges(args) + changes = self._get_changes(args) details = dict( base_commit=changes.base_commit, @@ -143,6 +148,7 @@ class AzurePipelinesAuthHelper(CryptographyAuthHelper): Authentication helper for Azure Pipelines. Based on cryptography since it is provided by the default Azure Pipelines environment. """ + def publish_public_key(self, public_key_pem: str) -> None: """Publish the given public key.""" try: @@ -162,6 +168,7 @@ class AzurePipelinesAuthHelper(CryptographyAuthHelper): class AzurePipelinesChanges: """Change information for an Azure Pipelines build.""" + def __init__(self, args: CommonConfig) -> None: self.args = args self.git = Git() diff --git a/test/lib/ansible_test/_internal/ci/local.py b/test/lib/ansible_test/_internal/ci/local.py index ec031944..4b9ab13e 100644 --- a/test/lib/ansible_test/_internal/ci/local.py +++ b/test/lib/ansible_test/_internal/ci/local.py @@ -36,6 +36,7 @@ CODE = '' # not really a CI provider, so use an empty string for the code class Local(CIProvider): """CI provider implementation when not using CI.""" + priority = 1000 @staticmethod @@ -62,8 +63,8 @@ class Local(CIProvider): return prefix - def get_base_branch(self) -> str: - """Return the base branch or an empty string.""" + def get_base_commit(self, args: CommonConfig) -> str: + """Return the base commit or an empty string.""" return '' def detect_changes(self, args: TestConfig) -> t.Optional[list[str]]: @@ -149,6 +150,7 @@ class Local(CIProvider): class InvalidBranch(ApplicationError): """Exception for invalid branch specification.""" + def __init__(self, branch: str, reason: str) -> None: message = 'Invalid branch: %s\n%s' % (branch, reason) @@ -159,6 +161,7 @@ class InvalidBranch(ApplicationError): class LocalChanges: """Change information for local work.""" + def __init__(self, args: TestConfig) -> None: self.args = args self.git = Git() diff --git a/test/lib/ansible_test/_internal/classification/__init__.py b/test/lib/ansible_test/_internal/classification/__init__.py index aacc2ca9..bca02403 100644 --- a/test/lib/ansible_test/_internal/classification/__init__.py +++ b/test/lib/ansible_test/_internal/classification/__init__.py @@ -176,6 +176,7 @@ def categorize_changes(args: TestConfig, paths: list[str], verbose_command: t.Op class PathMapper: """Map file paths to test commands and targets.""" + def __init__(self, args: TestConfig) -> None: self.args = args self.integration_all_target = get_integration_all_target(self.args) @@ -661,21 +662,58 @@ class PathMapper: def _classify_ansible(self, path: str) -> t.Optional[dict[str, str]]: """Return the classification for the given path using rules specific to Ansible.""" + dirname = os.path.dirname(path) + filename = os.path.basename(path) + name, ext = os.path.splitext(filename) + + minimal: dict[str, str] = {} + + packaging = { + 'integration': 'packaging/', + } + + # Early classification that needs to occur before common classification belongs here. + if path.startswith('test/units/compat/'): return { 'units': 'test/units/', } + if dirname == '.azure-pipelines/commands': + test_map = { + 'cloud.sh': 'integration:cloud/', + 'linux.sh': 'integration:all', + 'network.sh': 'network-integration:all', + 'remote.sh': 'integration:all', + 'sanity.sh': 'sanity:all', + 'units.sh': 'units:all', + 'windows.sh': 'windows-integration:all', + } + + test_match = test_map.get(filename) + + if test_match: + test_command, test_target = test_match.split(':') + + return { + test_command: test_target, + } + + cloud_target = f'cloud/{name}/' + + if cloud_target in self.integration_targets_by_alias: + return { + 'integration': cloud_target, + } + + # Classification common to both ansible and collections. + result = self._classify_common(path) if result is not None: return result - dirname = os.path.dirname(path) - filename = os.path.basename(path) - name, ext = os.path.splitext(filename) - - minimal: dict[str, str] = {} + # Classification here is specific to ansible, and runs after common classification. if path.startswith('bin/'): return all_tests(self.args) # broad impact, run all tests @@ -715,6 +753,9 @@ class PathMapper: return minimal if path.startswith('packaging/'): + if path.startswith('packaging/pep517_backend/'): + return packaging + return minimal if path.startswith('test/ansible_test/'): @@ -791,39 +832,6 @@ class PathMapper: if path.startswith('test/support/'): return all_tests(self.args) # test infrastructure, run all tests - if path.startswith('test/utils/shippable/'): - if dirname == 'test/utils/shippable': - test_map = { - 'cloud.sh': 'integration:cloud/', - 'linux.sh': 'integration:all', - 'network.sh': 'network-integration:all', - 'remote.sh': 'integration:all', - 'sanity.sh': 'sanity:all', - 'units.sh': 'units:all', - 'windows.sh': 'windows-integration:all', - } - - test_match = test_map.get(filename) - - if test_match: - test_command, test_target = test_match.split(':') - - return { - test_command: test_target, - } - - cloud_target = 'cloud/%s/' % name - - if cloud_target in self.integration_targets_by_alias: - return { - 'integration': cloud_target, - } - - return all_tests(self.args) # test infrastructure, run all tests - - if path.startswith('test/utils/'): - return minimal - if '/' not in path: if path in ( '.gitattributes', @@ -835,16 +843,17 @@ class PathMapper: return minimal if path in ( - 'setup.py', + 'MANIFEST.in', + 'pyproject.toml', + 'requirements.txt', + 'setup.cfg', + 'setup.py', ): - return all_tests(self.args) # broad impact, run all tests + return packaging if ext in ( - '.in', '.md', '.rst', - '.toml', - '.txt', ): return minimal diff --git a/test/lib/ansible_test/_internal/classification/python.py b/test/lib/ansible_test/_internal/classification/python.py index 77ffeacf..7036de1a 100644 --- a/test/lib/ansible_test/_internal/classification/python.py +++ b/test/lib/ansible_test/_internal/classification/python.py @@ -231,6 +231,7 @@ def relative_to_absolute(name: str, level: int, module: str, path: str, lineno: class ModuleUtilFinder(ast.NodeVisitor): """AST visitor to find valid module_utils imports.""" + def __init__(self, path: str, module_utils: set[str]) -> None: self.path = path self.module_utils = module_utils diff --git a/test/lib/ansible_test/_internal/cli/actions.py b/test/lib/ansible_test/_internal/cli/actions.py index 3359a848..9e1b7b44 100644 --- a/test/lib/ansible_test/_internal/cli/actions.py +++ b/test/lib/ansible_test/_internal/cli/actions.py @@ -22,6 +22,7 @@ from .parsers import ( class OriginControllerAction(CompositeAction): """Composite action parser for the controller when the only option is `origin`.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return OriginControllerParser() @@ -29,6 +30,7 @@ class OriginControllerAction(CompositeAction): class DelegatedControllerAction(CompositeAction): """Composite action parser for the controller when delegation is supported.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return DelegatedControllerParser() @@ -36,6 +38,7 @@ class DelegatedControllerAction(CompositeAction): class PosixTargetAction(CompositeAction): """Composite action parser for a POSIX target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return PosixTargetParser() @@ -43,6 +46,7 @@ class PosixTargetAction(CompositeAction): class WindowsTargetAction(CompositeAction): """Composite action parser for a Windows target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return WindowsTargetParser() @@ -50,6 +54,7 @@ class WindowsTargetAction(CompositeAction): class NetworkTargetAction(CompositeAction): """Composite action parser for a network target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return NetworkTargetParser() @@ -57,6 +62,7 @@ class NetworkTargetAction(CompositeAction): class SanityPythonTargetAction(CompositeAction): """Composite action parser for a sanity target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return SanityPythonTargetParser() @@ -64,6 +70,7 @@ class SanityPythonTargetAction(CompositeAction): class UnitsPythonTargetAction(CompositeAction): """Composite action parser for a units target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return UnitsPythonTargetParser() @@ -71,6 +78,7 @@ class UnitsPythonTargetAction(CompositeAction): class PosixSshTargetAction(CompositeAction): """Composite action parser for a POSIX SSH target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return PosixSshTargetParser() @@ -78,6 +86,7 @@ class PosixSshTargetAction(CompositeAction): class WindowsSshTargetAction(CompositeAction): """Composite action parser for a Windows SSH target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return WindowsSshTargetParser() @@ -85,6 +94,7 @@ class WindowsSshTargetAction(CompositeAction): class NetworkSshTargetAction(CompositeAction): """Composite action parser for a network SSH target.""" + def create_parser(self) -> NamespaceParser: """Return a namespace parser to parse the argument associated with this action.""" return NetworkSshTargetParser() diff --git a/test/lib/ansible_test/_internal/cli/argparsing/__init__.py b/test/lib/ansible_test/_internal/cli/argparsing/__init__.py index 540cf552..4ee845f7 100644 --- a/test/lib/ansible_test/_internal/cli/argparsing/__init__.py +++ b/test/lib/ansible_test/_internal/cli/argparsing/__init__.py @@ -34,6 +34,7 @@ class RegisteredCompletionFinder(OptionCompletionFinder): These registered completions, if provided, are used to filter the final completion results. This works around a known bug: https://github.com/kislyuk/argcomplete/issues/221 """ + def __init__(self, *args, **kwargs) -> None: super().__init__(*args, **kwargs) @@ -86,6 +87,7 @@ class RegisteredCompletionFinder(OptionCompletionFinder): class CompositeAction(argparse.Action, metaclass=abc.ABCMeta): """Base class for actions that parse composite arguments.""" + documentation_state: dict[t.Type[CompositeAction], DocumentationState] = {} def __init__( @@ -134,6 +136,7 @@ class CompositeAction(argparse.Action, metaclass=abc.ABCMeta): class CompositeActionCompletionFinder(RegisteredCompletionFinder): """Completion finder with support for composite argument parsing.""" + def get_completions( self, prefix: str, @@ -255,7 +258,7 @@ def complete( list_mode=True, # abuse list mode to enable preservation of the literal results consumed='', continuation='', - matches=['completion', 'invalid'] + matches=['completion', 'invalid'], ) else: answer = ex diff --git a/test/lib/ansible_test/_internal/cli/argparsing/actions.py b/test/lib/ansible_test/_internal/cli/argparsing/actions.py index 2bcf982c..7399fe9c 100644 --- a/test/lib/ansible_test/_internal/cli/argparsing/actions.py +++ b/test/lib/ansible_test/_internal/cli/argparsing/actions.py @@ -8,6 +8,7 @@ import typing as t class EnumAction(argparse.Action): """Parse an enum using the lowercase enum names.""" + def __init__(self, **kwargs: t.Any) -> None: self.enum_type: t.Type[enum.Enum] = kwargs.pop('type', None) kwargs.setdefault('choices', tuple(e.name.lower() for e in self.enum_type)) diff --git a/test/lib/ansible_test/_internal/cli/argparsing/argcompletion.py b/test/lib/ansible_test/_internal/cli/argparsing/argcompletion.py index cf5776da..26abcf82 100644 --- a/test/lib/ansible_test/_internal/cli/argparsing/argcompletion.py +++ b/test/lib/ansible_test/_internal/cli/argparsing/argcompletion.py @@ -9,6 +9,7 @@ import typing as t class Substitute: """Substitute for missing class which accepts all arguments.""" + def __init__(self, *args, **kwargs) -> None: pass @@ -16,10 +17,19 @@ class Substitute: try: import argcomplete - from argcomplete import ( - CompletionFinder, - default_validator, - ) + try: + # argcomplete 3+ + # see: https://github.com/kislyuk/argcomplete/commit/bd781cb08512b94966312377186ebc5550f46ae0 + from argcomplete.finders import ( + CompletionFinder, + default_validator, + ) + except ImportError: + # argcomplete <3 + from argcomplete import ( + CompletionFinder, + default_validator, + ) warn = argcomplete.warn # pylint: disable=invalid-name except ImportError: @@ -35,6 +45,7 @@ class CompType(enum.Enum): Bash COMP_TYPE argument completion types. For documentation, see: https://www.gnu.org/software/bash/manual/html_node/Bash-Variables.html#index-COMP_005fTYPE """ + COMPLETION = '\t' """ Standard completion, typically triggered by a single tab. @@ -70,7 +81,13 @@ class CompType(enum.Enum): def register_safe_action(action_type: t.Type[argparse.Action]) -> None: """Register the given action as a safe action for argcomplete to use during completion if it is not already registered.""" if argcomplete and action_type not in argcomplete.safe_actions: - argcomplete.safe_actions += (action_type,) + if isinstance(argcomplete.safe_actions, set): + # argcomplete 3+ + # see: https://github.com/kislyuk/argcomplete/commit/bd781cb08512b94966312377186ebc5550f46ae0 + argcomplete.safe_actions.add(action_type) + else: + # argcomplete <3 + argcomplete.safe_actions += (action_type,) def get_comp_type() -> t.Optional[CompType]: @@ -85,6 +102,7 @@ class OptionCompletionFinder(CompletionFinder): Custom completion finder for argcomplete. It provides support for running completion in list mode, which argcomplete natively handles the same as standard completion. """ + enabled = bool(argcomplete) def __init__(self, *args, validator=None, **kwargs) -> None: diff --git a/test/lib/ansible_test/_internal/cli/argparsing/parsers.py b/test/lib/ansible_test/_internal/cli/argparsing/parsers.py index d07e03cb..00fa97e8 100644 --- a/test/lib/ansible_test/_internal/cli/argparsing/parsers.py +++ b/test/lib/ansible_test/_internal/cli/argparsing/parsers.py @@ -32,18 +32,21 @@ class Completion(Exception): @dataclasses.dataclass class CompletionUnavailable(Completion): """Argument completion unavailable.""" + message: str = 'No completions available.' @dataclasses.dataclass class CompletionError(Completion): """Argument completion error.""" + message: t.Optional[str] = None @dataclasses.dataclass class CompletionSuccess(Completion): """Successful argument completion result.""" + list_mode: bool consumed: str continuation: str @@ -72,6 +75,7 @@ class CompletionSuccess(Completion): class ParserMode(enum.Enum): """Mode the parser is operating in.""" + PARSE = enum.auto() COMPLETE = enum.auto() LIST = enum.auto() @@ -84,6 +88,7 @@ class ParserError(Exception): @dataclasses.dataclass class ParserBoundary: """Boundary details for parsing composite input.""" + delimiters: str required: bool match: t.Optional[str] = None @@ -93,6 +98,7 @@ class ParserBoundary: @dataclasses.dataclass class ParserState: """State of the composite argument parser.""" + mode: ParserMode remainder: str = '' consumed: str = '' @@ -194,11 +200,13 @@ class ParserState: @dataclasses.dataclass class DocumentationState: """State of the composite argument parser's generated documentation.""" + sections: dict[str, str] = dataclasses.field(default_factory=dict) class Parser(metaclass=abc.ABCMeta): """Base class for all composite argument parsers.""" + @abc.abstractmethod def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" @@ -210,6 +218,7 @@ class Parser(metaclass=abc.ABCMeta): class MatchConditions(enum.Flag): """Acceptable condition(s) for matching user input to available choices.""" + CHOICE = enum.auto() """Match any choice.""" ANY = enum.auto() @@ -220,6 +229,7 @@ class MatchConditions(enum.Flag): class DynamicChoicesParser(Parser, metaclass=abc.ABCMeta): """Base class for composite argument parsers which use a list of choices that can be generated during completion.""" + def __init__(self, conditions: MatchConditions = MatchConditions.CHOICE) -> None: self.conditions = conditions @@ -275,6 +285,7 @@ class DynamicChoicesParser(Parser, metaclass=abc.ABCMeta): class ChoicesParser(DynamicChoicesParser): """Composite argument parser which relies on a static list of choices.""" + def __init__(self, choices: list[str], conditions: MatchConditions = MatchConditions.CHOICE) -> None: self.choices = choices @@ -291,6 +302,7 @@ class ChoicesParser(DynamicChoicesParser): class EnumValueChoicesParser(ChoicesParser): """Composite argument parser which relies on a static list of choices derived from the values of an enum.""" + def __init__(self, enum_type: t.Type[enum.Enum], conditions: MatchConditions = MatchConditions.CHOICE) -> None: self.enum_type = enum_type @@ -304,6 +316,7 @@ class EnumValueChoicesParser(ChoicesParser): class IntegerParser(DynamicChoicesParser): """Composite argument parser for integers.""" + PATTERN = re.compile('^[1-9][0-9]*$') def __init__(self, maximum: t.Optional[int] = None) -> None: @@ -341,6 +354,7 @@ class IntegerParser(DynamicChoicesParser): class BooleanParser(ChoicesParser): """Composite argument parser for boolean (yes/no) values.""" + def __init__(self) -> None: super().__init__(['yes', 'no']) @@ -352,6 +366,7 @@ class BooleanParser(ChoicesParser): class AnyParser(ChoicesParser): """Composite argument parser which accepts any input value.""" + def __init__(self, nothing: bool = False, no_match_message: t.Optional[str] = None) -> None: self.no_match_message = no_match_message @@ -379,6 +394,7 @@ class AnyParser(ChoicesParser): class RelativePathNameParser(DynamicChoicesParser): """Composite argument parser for relative path names.""" + RELATIVE_NAMES = ['.', '..'] def __init__(self, choices: list[str]) -> None: @@ -400,6 +416,7 @@ class RelativePathNameParser(DynamicChoicesParser): class FileParser(Parser): """Composite argument parser for absolute or relative file paths.""" + def parse(self, state: ParserState) -> str: """Parse the input from the given state and return the result.""" if state.mode == ParserMode.PARSE: @@ -432,6 +449,7 @@ class FileParser(Parser): class AbsolutePathParser(Parser): """Composite argument parser for absolute file paths. Paths are only verified for proper syntax, not for existence.""" + def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" path = '' @@ -443,13 +461,14 @@ class AbsolutePathParser(Parser): else: path += ChoicesParser([PATH_DELIMITER]).parse(state) - path += (boundary.match or '') + path += boundary.match or '' return path class NamespaceParser(Parser, metaclass=abc.ABCMeta): """Base class for composite argument parsers that store their results in a namespace.""" + def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" namespace = state.current_namespace @@ -496,6 +515,7 @@ class NamespaceParser(Parser, metaclass=abc.ABCMeta): class NamespaceWrappedParser(NamespaceParser): """Composite argument parser that wraps a non-namespace parser and stores the result in a namespace.""" + def __init__(self, dest: str, parser: Parser) -> None: self._dest = dest self.parser = parser @@ -512,6 +532,7 @@ class NamespaceWrappedParser(NamespaceParser): class KeyValueParser(Parser, metaclass=abc.ABCMeta): """Base class for key/value composite argument parsers.""" + @abc.abstractmethod def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" @@ -538,6 +559,7 @@ class KeyValueParser(Parser, metaclass=abc.ABCMeta): class PairParser(Parser, metaclass=abc.ABCMeta): """Base class for composite argument parsers consisting of a left and right argument parser, with input separated by a delimiter.""" + def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" namespace = self.create_namespace() @@ -577,6 +599,7 @@ class PairParser(Parser, metaclass=abc.ABCMeta): class TypeParser(Parser, metaclass=abc.ABCMeta): """Base class for composite argument parsers which parse a type name, a colon and then parse results based on the type given by the type name.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: # pylint: disable=unused-argument """Return a dictionary of type names and type parsers.""" return self.get_stateless_parsers() diff --git a/test/lib/ansible_test/_internal/cli/commands/env.py b/test/lib/ansible_test/_internal/cli/commands/env.py index 0cd21145..8b56e4f1 100644 --- a/test/lib/ansible_test/_internal/cli/commands/env.py +++ b/test/lib/ansible_test/_internal/cli/commands/env.py @@ -55,7 +55,7 @@ def do_env( env.add_argument( '--timeout', - type=int, + type=float, metavar='MINUTES', help='timeout for future ansible-test commands (0 clears)', ) diff --git a/test/lib/ansible_test/_internal/cli/commands/integration/network.py b/test/lib/ansible_test/_internal/cli/commands/integration/network.py index a05985b5..a42ba919 100644 --- a/test/lib/ansible_test/_internal/cli/commands/integration/network.py +++ b/test/lib/ansible_test/_internal/cli/commands/integration/network.py @@ -50,7 +50,8 @@ def do_network_integration( parser.set_defaults( func=command_network_integration, targets_func=walk_network_integration_targets, - config=NetworkIntegrationConfig) + config=NetworkIntegrationConfig, + ) network_integration = t.cast(argparse.ArgumentParser, parser.add_argument_group(title='network integration test arguments')) diff --git a/test/lib/ansible_test/_internal/cli/commands/sanity.py b/test/lib/ansible_test/_internal/cli/commands/sanity.py index 8b4a9ae5..c4f0c0a0 100644 --- a/test/lib/ansible_test/_internal/cli/commands/sanity.py +++ b/test/lib/ansible_test/_internal/cli/commands/sanity.py @@ -16,10 +16,6 @@ from ...target import ( walk_sanity_targets, ) -from ...data import ( - data_context, -) - from ..environments import ( CompositeActionCompletionFinder, ControllerMode, @@ -43,7 +39,8 @@ def do_sanity( parser.set_defaults( func=command_sanity, targets_func=walk_sanity_targets, - config=SanityConfig) + config=SanityConfig, + ) sanity = parser.add_argument_group(title='sanity test arguments') @@ -81,17 +78,6 @@ def do_sanity( help='enable optional errors', ) - if data_context().content.is_ansible: - sanity.add_argument( - '--keep-git', - action='store_true', - help='transfer git related files to the remote host/container', - ) - else: - sanity.set_defaults( - keep_git=False, - ) - sanity.add_argument( '--lint', action='store_true', @@ -113,7 +99,7 @@ def do_sanity( sanity.add_argument( '--prime-venvs', action='store_true', - help='prepare virtual environments without running tests' + help='prepare virtual environments without running tests', ) add_environments(parser, completer, ControllerMode.DELEGATED, TargetMode.SANITY) # sanity diff --git a/test/lib/ansible_test/_internal/cli/compat.py b/test/lib/ansible_test/_internal/cli/compat.py index 93006d5c..19996faf 100644 --- a/test/lib/ansible_test/_internal/cli/compat.py +++ b/test/lib/ansible_test/_internal/cli/compat.py @@ -84,24 +84,28 @@ def get_option_name(name: str) -> str: class PythonVersionUnsupportedError(ApplicationError): """A Python version was requested for a context which does not support that version.""" + def __init__(self, context: str, version: str, versions: c.Iterable[str]) -> None: super().__init__(f'Python {version} is not supported by environment `{context}`. Supported Python version(s) are: {", ".join(versions)}') class PythonVersionUnspecifiedError(ApplicationError): """A Python version was not specified for a context which is unknown, thus the Python version is unknown.""" + def __init__(self, context: str) -> None: super().__init__(f'A Python version was not specified for environment `{context}`. Use the `--python` option to specify a Python version.') class ControllerNotSupportedError(ApplicationError): """Option(s) were specified which do not provide support for the controller and would be ignored because they are irrelevant for the target.""" + def __init__(self, context: str) -> None: super().__init__(f'Environment `{context}` does not provide a Python version supported by the controller.') class OptionsConflictError(ApplicationError): """Option(s) were specified which conflict with other options.""" + def __init__(self, first: c.Iterable[str], second: c.Iterable[str]) -> None: super().__init__(f'Options `{" ".join(first)}` cannot be combined with options `{" ".join(second)}`.') @@ -109,6 +113,7 @@ class OptionsConflictError(ApplicationError): @dataclasses.dataclass(frozen=True) class LegacyHostOptions: """Legacy host options used prior to the availability of separate controller and target host configuration.""" + python: t.Optional[str] = None python_interpreter: t.Optional[str] = None local: t.Optional[bool] = None @@ -161,6 +166,7 @@ class LegacyHostOptions: class TargetMode(enum.Enum): """Type of provisioning to use for the targets.""" + WINDOWS_INTEGRATION = enum.auto() # windows-integration NETWORK_INTEGRATION = enum.auto() # network-integration POSIX_INTEGRATION = enum.auto() # integration diff --git a/test/lib/ansible_test/_internal/cli/environments.py b/test/lib/ansible_test/_internal/cli/environments.py index 5063715a..94cafae3 100644 --- a/test/lib/ansible_test/_internal/cli/environments.py +++ b/test/lib/ansible_test/_internal/cli/environments.py @@ -75,6 +75,7 @@ from ..ci import ( class ControllerMode(enum.Enum): """Type of provisioning to use for the controller.""" + NO_DELEGATION = enum.auto() ORIGIN = enum.auto() DELEGATED = enum.auto() @@ -252,7 +253,8 @@ def add_legacy_environment_options( ): """Add legacy options for controlling the test environment.""" environment: argparse.ArgumentParser = parser.add_argument_group( # type: ignore[assignment] # real type private - title='environment arguments (mutually exclusive with "composite environment arguments" below)') + title='environment arguments (mutually exclusive with "composite environment arguments" below)', + ) add_environments_python(environment, target_mode) add_environments_host(environment, controller_mode, target_mode) @@ -383,7 +385,8 @@ def add_environment_venv( environments_parser.add_argument( '--venv-system-site-packages', action='store_true', - help='enable system site packages') + help='enable system site packages', + ) def add_global_docker( diff --git a/test/lib/ansible_test/_internal/cli/parsers/__init__.py b/test/lib/ansible_test/_internal/cli/parsers/__init__.py index 1aedf630..93ead807 100644 --- a/test/lib/ansible_test/_internal/cli/parsers/__init__.py +++ b/test/lib/ansible_test/_internal/cli/parsers/__init__.py @@ -53,6 +53,7 @@ from .base_argument_parsers import ( class OriginControllerParser(ControllerNamespaceParser, TypeParser): """Composite argument parser for the controller when delegation is not supported.""" + def get_stateless_parsers(self) -> dict[str, Parser]: """Return a dictionary of type names and type parsers.""" return dict( @@ -71,6 +72,7 @@ class OriginControllerParser(ControllerNamespaceParser, TypeParser): class DelegatedControllerParser(ControllerNamespaceParser, TypeParser): """Composite argument parser for the controller when delegation is supported.""" + def get_stateless_parsers(self) -> dict[str, Parser]: """Return a dictionary of type names and type parsers.""" parsers: dict[str, Parser] = dict( @@ -97,6 +99,7 @@ class DelegatedControllerParser(ControllerNamespaceParser, TypeParser): class PosixTargetParser(TargetNamespaceParser, TypeParser): """Composite argument parser for a POSIX target.""" + def get_stateless_parsers(self) -> dict[str, Parser]: """Return a dictionary of type names and type parsers.""" parsers: dict[str, Parser] = dict( @@ -127,6 +130,7 @@ class PosixTargetParser(TargetNamespaceParser, TypeParser): class WindowsTargetParser(TargetsNamespaceParser, TypeParser): """Composite argument parser for a Windows target.""" + @property def allow_inventory(self) -> bool: """True if inventory is allowed, otherwise False.""" @@ -169,6 +173,7 @@ class WindowsTargetParser(TargetsNamespaceParser, TypeParser): class NetworkTargetParser(TargetsNamespaceParser, TypeParser): """Composite argument parser for a network target.""" + @property def allow_inventory(self) -> bool: """True if inventory is allowed, otherwise False.""" @@ -211,6 +216,7 @@ class NetworkTargetParser(TargetsNamespaceParser, TypeParser): class PythonTargetParser(TargetsNamespaceParser, Parser): """Composite argument parser for a Python target.""" + def __init__(self, allow_venv: bool) -> None: super().__init__() @@ -249,18 +255,21 @@ class PythonTargetParser(TargetsNamespaceParser, Parser): class SanityPythonTargetParser(PythonTargetParser): """Composite argument parser for a sanity Python target.""" + def __init__(self) -> None: super().__init__(allow_venv=False) class UnitsPythonTargetParser(PythonTargetParser): """Composite argument parser for a units Python target.""" + def __init__(self) -> None: super().__init__(allow_venv=True) class PosixSshTargetParser(PosixTargetParser): """Composite argument parser for a POSIX SSH target.""" + @property def option_name(self) -> str: """The option name used for this parser.""" @@ -269,6 +278,7 @@ class PosixSshTargetParser(PosixTargetParser): class WindowsSshTargetParser(WindowsTargetParser): """Composite argument parser for a Windows SSH target.""" + @property def option_name(self) -> str: """The option name used for this parser.""" @@ -287,6 +297,7 @@ class WindowsSshTargetParser(WindowsTargetParser): class NetworkSshTargetParser(NetworkTargetParser): """Composite argument parser for a network SSH target.""" + @property def option_name(self) -> str: """The option name used for this parser.""" diff --git a/test/lib/ansible_test/_internal/cli/parsers/base_argument_parsers.py b/test/lib/ansible_test/_internal/cli/parsers/base_argument_parsers.py index aac7a694..d0124cf5 100644 --- a/test/lib/ansible_test/_internal/cli/parsers/base_argument_parsers.py +++ b/test/lib/ansible_test/_internal/cli/parsers/base_argument_parsers.py @@ -13,6 +13,7 @@ from ..argparsing.parsers import ( class ControllerNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): """Base class for controller namespace parsers.""" + @property def dest(self) -> str: """The name of the attribute where the value should be stored.""" @@ -28,6 +29,7 @@ class ControllerNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): class TargetNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): """Base class for target namespace parsers involving a single target.""" + @property def option_name(self) -> str: """The option name used for this parser.""" @@ -51,6 +53,7 @@ class TargetNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): class TargetsNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): """Base class for controller namespace parsers involving multiple targets.""" + @property def option_name(self) -> str: """The option name used for this parser.""" @@ -69,5 +72,6 @@ class TargetsNamespaceParser(NamespaceParser, metaclass=abc.ABCMeta): class ControllerRequiredFirstError(CompletionError): """Exception raised when controller and target options are specified out-of-order.""" + def __init__(self) -> None: super().__init__('The `--controller` option must be specified before `--target` option(s).') diff --git a/test/lib/ansible_test/_internal/cli/parsers/host_config_parsers.py b/test/lib/ansible_test/_internal/cli/parsers/host_config_parsers.py index ee6f146c..a90a59ac 100644 --- a/test/lib/ansible_test/_internal/cli/parsers/host_config_parsers.py +++ b/test/lib/ansible_test/_internal/cli/parsers/host_config_parsers.py @@ -63,6 +63,7 @@ from .helpers import ( class OriginParser(Parser): """Composite argument parser for the origin.""" + def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" namespace = OriginConfig() @@ -81,6 +82,7 @@ class OriginParser(Parser): class ControllerParser(Parser): """Composite argument parser for the controller.""" + def parse(self, state: ParserState) -> t.Any: """Parse the input from the given state and return the result.""" namespace = ControllerConfig() @@ -99,6 +101,7 @@ class ControllerParser(Parser): class DockerParser(PairParser): """Composite argument parser for a docker host.""" + def __init__(self, controller: bool) -> None: self.controller = controller @@ -142,6 +145,7 @@ class DockerParser(PairParser): class PosixRemoteParser(PairParser): """Composite argument parser for a POSIX remote host.""" + def __init__(self, controller: bool) -> None: self.controller = controller @@ -184,6 +188,7 @@ class PosixRemoteParser(PairParser): class WindowsRemoteParser(PairParser): """Composite argument parser for a Windows remote host.""" + def create_namespace(self) -> t.Any: """Create and return a namespace.""" return WindowsRemoteConfig() @@ -217,6 +222,7 @@ class WindowsRemoteParser(PairParser): class NetworkRemoteParser(PairParser): """Composite argument parser for a network remote host.""" + def create_namespace(self) -> t.Any: """Create and return a namespace.""" return NetworkRemoteConfig() @@ -250,6 +256,7 @@ class NetworkRemoteParser(PairParser): class WindowsInventoryParser(PairParser): """Composite argument parser for a Windows inventory.""" + def create_namespace(self) -> t.Any: """Create and return a namespace.""" return WindowsInventoryConfig() @@ -269,6 +276,7 @@ class WindowsInventoryParser(PairParser): class NetworkInventoryParser(PairParser): """Composite argument parser for a network inventory.""" + def create_namespace(self) -> t.Any: """Create and return a namespace.""" return NetworkInventoryConfig() @@ -288,6 +296,7 @@ class NetworkInventoryParser(PairParser): class PosixSshParser(PairParser): """Composite argument parser for a POSIX SSH host.""" + def create_namespace(self) -> t.Any: """Create and return a namespace.""" return PosixSshConfig() diff --git a/test/lib/ansible_test/_internal/cli/parsers/key_value_parsers.py b/test/lib/ansible_test/_internal/cli/parsers/key_value_parsers.py index 049b71ee..a046e51a 100644 --- a/test/lib/ansible_test/_internal/cli/parsers/key_value_parsers.py +++ b/test/lib/ansible_test/_internal/cli/parsers/key_value_parsers.py @@ -52,6 +52,7 @@ from .helpers import ( class OriginKeyValueParser(KeyValueParser): """Composite argument parser for origin key/value pairs.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" versions = CONTROLLER_PYTHON_VERSIONS @@ -75,6 +76,7 @@ class OriginKeyValueParser(KeyValueParser): class ControllerKeyValueParser(KeyValueParser): """Composite argument parser for controller key/value pairs.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" versions = get_controller_pythons(state.root_namespace.controller, False) @@ -99,6 +101,7 @@ class ControllerKeyValueParser(KeyValueParser): class DockerKeyValueParser(KeyValueParser): """Composite argument parser for docker key/value pairs.""" + def __init__(self, image: str, controller: bool) -> None: self.controller = controller self.versions = get_docker_pythons(image, controller, False) @@ -135,6 +138,7 @@ class DockerKeyValueParser(KeyValueParser): class PosixRemoteKeyValueParser(KeyValueParser): """Composite argument parser for POSIX remote key/value pairs.""" + def __init__(self, name: str, controller: bool) -> None: self.controller = controller self.versions = get_remote_pythons(name, controller, False) @@ -167,6 +171,7 @@ class PosixRemoteKeyValueParser(KeyValueParser): class WindowsRemoteKeyValueParser(KeyValueParser): """Composite argument parser for Windows remote key/value pairs.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" return dict( @@ -188,6 +193,7 @@ class WindowsRemoteKeyValueParser(KeyValueParser): class NetworkRemoteKeyValueParser(KeyValueParser): """Composite argument parser for network remote key/value pairs.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" return dict( @@ -213,6 +219,7 @@ class NetworkRemoteKeyValueParser(KeyValueParser): class PosixSshKeyValueParser(KeyValueParser): """Composite argument parser for POSIX SSH host key/value pairs.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" return dict( @@ -234,6 +241,7 @@ class PosixSshKeyValueParser(KeyValueParser): class EmptyKeyValueParser(KeyValueParser): """Composite argument parser when a key/value parser is required but there are no keys available.""" + def get_parsers(self, state: ParserState) -> dict[str, Parser]: """Return a dictionary of key names and value parsers.""" return {} diff --git a/test/lib/ansible_test/_internal/cli/parsers/value_parsers.py b/test/lib/ansible_test/_internal/cli/parsers/value_parsers.py index 9453b760..f416281e 100644 --- a/test/lib/ansible_test/_internal/cli/parsers/value_parsers.py +++ b/test/lib/ansible_test/_internal/cli/parsers/value_parsers.py @@ -60,12 +60,14 @@ class PythonParser(Parser): Known docker/remote environments limit the available Python versions to configured values known to be valid. The origin host and unknown environments assume all relevant Python versions are available. """ - def __init__(self, - versions: c.Sequence[str], - *, - allow_default: bool, - allow_venv: bool, - ): + + def __init__( + self, + versions: c.Sequence[str], + *, + allow_default: bool, + allow_venv: bool, + ): version_choices = list(versions) if allow_default: @@ -134,6 +136,7 @@ class PythonParser(Parser): class PlatformParser(ChoicesParser): """Composite argument parser for "{platform}/{version}" formatted choices.""" + def __init__(self, choices: list[str]) -> None: super().__init__(choices, conditions=MatchConditions.CHOICE | MatchConditions.ANY) @@ -152,6 +155,7 @@ class SshConnectionParser(Parser): Composite argument parser for connecting to a host using SSH. Format: user@host[:port] """ + EXPECTED_FORMAT = '{user}@{host}[:{port}]' def parse(self, state: ParserState) -> t.Any: diff --git a/test/lib/ansible_test/_internal/commands/coverage/__init__.py b/test/lib/ansible_test/_internal/commands/coverage/__init__.py index 139cf3c6..c4c5f09e 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/__init__.py +++ b/test/lib/ansible_test/_internal/commands/coverage/__init__.py @@ -68,6 +68,7 @@ COVERAGE_OUTPUT_FILE_NAME = 'coverage' class CoverageConfig(EnvironmentConfig): """Configuration for the coverage command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'coverage') @@ -96,7 +97,7 @@ def initialize_coverage(args: CoverageConfig, host_state: HostState) -> coverage def run_coverage(args: CoverageConfig, host_state: HostState, output_file: str, command: str, cmd: list[str]) -> None: """Run the coverage cli tool with the specified options.""" env = common_environment() - env.update(dict(COVERAGE_FILE=output_file)) + env.update(COVERAGE_FILE=output_file) cmd = ['python', '-m', 'coverage.__main__', command, '--rcfile', COVERAGE_CONFIG_PATH] + cmd @@ -340,6 +341,7 @@ def sanitize_filename( class PathChecker: """Checks code coverage paths to verify they are valid and reports on the findings.""" + def __init__(self, args: CoverageConfig, collection_search_re: t.Optional[t.Pattern] = None) -> None: self.args = args self.collection_search_re = collection_search_re diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/__init__.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/__init__.py index 37859e8f..2029d7be 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/__init__.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/__init__.py @@ -9,6 +9,7 @@ from .. import ( class CoverageAnalyzeConfig(CoverageConfig): """Configuration for the `coverage analyze` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/combine.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/combine.py index e3782cee..0bbb2873 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/combine.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/combine.py @@ -28,6 +28,7 @@ from . import ( class CoverageAnalyzeTargetsCombineConfig(CoverageAnalyzeTargetsConfig): """Configuration for the `coverage analyze targets combine` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/expand.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/expand.py index ba903878..93197543 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/expand.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/expand.py @@ -26,6 +26,7 @@ from . import ( class CoverageAnalyzeTargetsExpandConfig(CoverageAnalyzeTargetsConfig): """Configuration for the `coverage analyze targets expand` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/filter.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/filter.py index 29a8ee5b..ccedae7d 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/filter.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/filter.py @@ -31,6 +31,7 @@ from . import ( class CoverageAnalyzeTargetsFilterConfig(CoverageAnalyzeTargetsConfig): """Configuration for the `coverage analyze targets filter` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/generate.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/generate.py index 127b5b7f..0f0da5de 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/generate.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/generate.py @@ -52,6 +52,7 @@ from . import ( class CoverageAnalyzeTargetsGenerateConfig(CoverageAnalyzeTargetsConfig): """Configuration for the `coverage analyze targets generate` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/missing.py b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/missing.py index c1c77e75..0a756643 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/missing.py +++ b/test/lib/ansible_test/_internal/commands/coverage/analyze/targets/missing.py @@ -32,6 +32,7 @@ from . import ( class CoverageAnalyzeTargetsMissingConfig(CoverageAnalyzeTargetsConfig): """Configuration for the `coverage analyze targets missing` command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/combine.py b/test/lib/ansible_test/_internal/commands/coverage/combine.py index 66210c73..12cb54e2 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/combine.py +++ b/test/lib/ansible_test/_internal/commands/coverage/combine.py @@ -34,6 +34,7 @@ from ...executor import ( from ...data import ( data_context, + PayloadConfig, ) from ...host_configs import ( @@ -82,9 +83,10 @@ def combine_coverage_files(args: CoverageCombineConfig, host_state: HostState) - pairs = [(path, os.path.relpath(path, data_context().content.root)) for path in exported_paths] - def coverage_callback(files: list[tuple[str, str]]) -> None: + def coverage_callback(payload_config: PayloadConfig) -> None: """Add the coverage files to the payload file list.""" display.info('Including %d exported coverage file(s) in payload.' % len(pairs), verbosity=1) + files = payload_config.files files.extend(pairs) data_context().register_payload_callback(coverage_callback) @@ -101,11 +103,13 @@ def combine_coverage_files(args: CoverageCombineConfig, host_state: HostState) - class ExportedCoverageDataNotFound(ApplicationError): """Exception when no combined coverage data is present yet is required.""" + def __init__(self) -> None: super().__init__( 'Coverage data must be exported before processing with the `--docker` or `--remote` option.\n' 'Export coverage with `ansible-test coverage combine` using the `--export` option.\n' - 'The exported files must be in the directory: %s/' % ResultType.COVERAGE.relative_path) + 'The exported files must be in the directory: %s/' % ResultType.COVERAGE.relative_path + ) def _command_coverage_combine_python(args: CoverageCombineConfig, host_state: HostState) -> list[str]: @@ -351,6 +355,7 @@ def get_coverage_group(args: CoverageCombineConfig, coverage_file: str) -> t.Opt class CoverageCombineConfig(CoverageConfig): """Configuration for the coverage combine command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/coverage/report.py b/test/lib/ansible_test/_internal/commands/coverage/report.py index fadc13f3..c0f40186 100644 --- a/test/lib/ansible_test/_internal/commands/coverage/report.py +++ b/test/lib/ansible_test/_internal/commands/coverage/report.py @@ -144,6 +144,7 @@ def _generate_powershell_output_report(args: CoverageReportConfig, coverage_file class CoverageReportConfig(CoverageCombineConfig): """Configuration for the coverage report command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args) diff --git a/test/lib/ansible_test/_internal/commands/env/__init__.py b/test/lib/ansible_test/_internal/commands/env/__init__.py index 44f229f8..92d2c973 100644 --- a/test/lib/ansible_test/_internal/commands/env/__init__.py +++ b/test/lib/ansible_test/_internal/commands/env/__init__.py @@ -42,16 +42,20 @@ from ...ci import ( get_ci_provider, ) +from ...timeout import ( + TimeoutDetail, +) + class EnvConfig(CommonConfig): """Configuration for the `env` command.""" def __init__(self, args: t.Any) -> None: super().__init__(args, 'env') - self.show = args.show - self.dump = args.dump - self.timeout = args.timeout - self.list_files = args.list_files + self.show: bool = args.show + self.dump: bool = args.dump + self.timeout: int | float | None = args.timeout + self.list_files: bool = args.list_files if not self.show and not self.dump and self.timeout is None and not self.list_files: # default to --show if no options were given @@ -85,7 +89,7 @@ def show_dump_env(args: EnvConfig) -> None: ), git=get_ci_provider().get_git_details(args), platform=dict( - datetime=datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ'), + datetime=datetime.datetime.now(tz=datetime.timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ'), platform=platform.platform(), uname=platform.uname(), ), @@ -124,25 +128,18 @@ def set_timeout(args: EnvConfig) -> None: if args.timeout is None: return - if args.timeout: - deadline = (datetime.datetime.utcnow() + datetime.timedelta(minutes=args.timeout)).strftime('%Y-%m-%dT%H:%M:%SZ') + timeout = TimeoutDetail.create(args.timeout) - display.info('Setting a %d minute test timeout which will end at: %s' % (args.timeout, deadline), verbosity=1) + if timeout: + display.info(f'Setting a {timeout.duration} minute test timeout which will end at: {timeout.deadline}', verbosity=1) else: - deadline = None - display.info('Clearing existing test timeout.', verbosity=1) if args.explain: return - if deadline: - data = dict( - duration=args.timeout, - deadline=deadline, - ) - - write_json_file(TIMEOUT_PATH, data) + if timeout: + write_json_file(TIMEOUT_PATH, timeout.to_dict()) elif os.path.exists(TIMEOUT_PATH): os.remove(TIMEOUT_PATH) diff --git a/test/lib/ansible_test/_internal/commands/integration/__init__.py b/test/lib/ansible_test/_internal/commands/integration/__init__.py index 8864d2ee..5bd04407 100644 --- a/test/lib/ansible_test/_internal/commands/integration/__init__.py +++ b/test/lib/ansible_test/_internal/commands/integration/__init__.py @@ -90,6 +90,7 @@ from .cloud import ( from ...data import ( data_context, + PayloadConfig, ) from ...host_configs import ( @@ -214,11 +215,13 @@ def delegate_inventory(args: IntegrationConfig, inventory_path_src: str) -> None if isinstance(args, PosixIntegrationConfig): return - def inventory_callback(files: list[tuple[str, str]]) -> None: + def inventory_callback(payload_config: PayloadConfig) -> None: """ Add the inventory file to the payload file list. This will preserve the file during delegation even if it is ignored or is outside the content and install roots. """ + files = payload_config.files + inventory_path = get_inventory_relative_path(args) inventory_tuple = inventory_path_src, inventory_path @@ -311,7 +314,7 @@ def integration_test_environment( directory_copies = [ ( os.path.join(integration_targets_relative_path, target.relative_path), - os.path.join(temp_dir, integration_targets_relative_path, target.relative_path) + os.path.join(temp_dir, integration_targets_relative_path, target.relative_path), ) for target in target_dependencies ] @@ -354,12 +357,12 @@ def integration_test_config_file( config_vars = (env_config.ansible_vars or {}).copy() - config_vars.update(dict( + config_vars.update( ansible_test=dict( environment=env_config.env_vars, module_defaults=env_config.module_defaults, ) - )) + ) config_file = json.dumps(config_vars, indent=4, sort_keys=True) @@ -563,7 +566,7 @@ def command_integration_filtered( coverage_manager.teardown() result_name = '%s-%s.json' % ( - args.command, re.sub(r'[^0-9]', '-', str(datetime.datetime.utcnow().replace(microsecond=0)))) + args.command, re.sub(r'[^0-9]', '-', str(datetime.datetime.now(tz=datetime.timezone.utc).replace(microsecond=0, tzinfo=None)))) data = dict( targets=results, @@ -612,10 +615,10 @@ def command_integration_script( env = integration_environment(args, target, test_dir, test_env.inventory_path, test_env.ansible_config, env_config, test_env) cwd = os.path.join(test_env.targets_dir, target.relative_path) - env.update(dict( + env.update( # support use of adhoc ansible commands in collections without specifying the fully qualified collection name ANSIBLE_PLAYBOOK_DIR=cwd, - )) + ) if env_config and env_config.env_vars: env.update(env_config.env_vars) @@ -650,9 +653,9 @@ def command_integration_role( if isinstance(args, WindowsIntegrationConfig): hosts = 'windows' gather_facts = False - variables.update(dict( + variables.update( win_output_dir=r'C:\ansible_testing', - )) + ) elif isinstance(args, NetworkIntegrationConfig): hosts = target.network_platform gather_facts = False @@ -697,10 +700,10 @@ def command_integration_role( if env_config.ansible_vars: variables.update(env_config.ansible_vars) - play.update(dict( + play.update( environment=env_config.env_vars, module_defaults=env_config.module_defaults, - )) + ) playbook = json.dumps([play], indent=4, sort_keys=True) @@ -733,10 +736,10 @@ def command_integration_role( env = integration_environment(args, target, test_dir, test_env.inventory_path, test_env.ansible_config, env_config, test_env) cwd = test_env.integration_dir - env.update(dict( + env.update( # support use of adhoc ansible commands in collections without specifying the fully qualified collection name ANSIBLE_PLAYBOOK_DIR=cwd, - )) + ) if env_config and env_config.env_vars: env.update(env_config.env_vars) @@ -804,13 +807,13 @@ def integration_environment( ) if args.debug_strategy: - env.update(dict(ANSIBLE_STRATEGY='debug')) + env.update(ANSIBLE_STRATEGY='debug') if 'non_local/' in target.aliases: if args.coverage: display.warning('Skipping coverage reporting on Ansible modules for non-local test: %s' % target.name) - env.update(dict(ANSIBLE_TEST_REMOTE_INTERPRETER='')) + env.update(ANSIBLE_TEST_REMOTE_INTERPRETER='') env.update(integration) @@ -819,6 +822,7 @@ def integration_environment( class IntegrationEnvironment: """Details about the integration environment.""" + def __init__(self, test_dir: str, integration_dir: str, targets_dir: str, inventory_path: str, ansible_config: str, vars_file: str) -> None: self.test_dir = test_dir self.integration_dir = integration_dir @@ -830,6 +834,7 @@ class IntegrationEnvironment: class IntegrationCache(CommonCache): """Integration cache.""" + @property def integration_targets(self) -> list[IntegrationTarget]: """The list of integration test targets.""" @@ -897,9 +902,10 @@ If necessary, context can be controlled by adding entries to the "aliases" file return exclude -def command_integration_filter(args: TIntegrationConfig, - targets: c.Iterable[TIntegrationTarget], - ) -> tuple[HostState, tuple[TIntegrationTarget, ...]]: +def command_integration_filter( + args: TIntegrationConfig, + targets: c.Iterable[TIntegrationTarget], +) -> tuple[HostState, tuple[TIntegrationTarget, ...]]: """Filter the given integration test targets.""" targets = tuple(target for target in targets if 'hidden/' not in target.aliases) changes = get_changes_filter(args) @@ -937,11 +943,13 @@ def command_integration_filter(args: TIntegrationConfig, vars_file_src = os.path.join(data_context().content.root, data_context().content.integration_vars_path) if os.path.exists(vars_file_src): - def integration_config_callback(files: list[tuple[str, str]]) -> None: + + def integration_config_callback(payload_config: PayloadConfig) -> None: """ Add the integration config vars file to the payload file list. This will preserve the file during delegation even if the file is ignored by source control. """ + files = payload_config.files files.append((vars_file_src, data_context().content.integration_vars_path)) data_context().register_payload_callback(integration_config_callback) diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/__init__.py b/test/lib/ansible_test/_internal/commands/integration/cloud/__init__.py index 0c078b98..eac9265a 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/__init__.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/__init__.py @@ -47,6 +47,7 @@ from ....ci import ( from ....data import ( data_context, + PayloadConfig, ) from ....docker_util import ( @@ -169,7 +170,7 @@ def cloud_init(args: IntegrationConfig, targets: tuple[IntegrationTarget, ...]) if not args.explain and results: result_name = '%s-%s.json' % ( - args.command, re.sub(r'[^0-9]', '-', str(datetime.datetime.utcnow().replace(microsecond=0)))) + args.command, re.sub(r'[^0-9]', '-', str(datetime.datetime.now(tz=datetime.timezone.utc).replace(microsecond=0, tzinfo=None)))) data = dict( clouds=results, @@ -180,6 +181,7 @@ def cloud_init(args: IntegrationConfig, targets: tuple[IntegrationTarget, ...]) class CloudBase(metaclass=abc.ABCMeta): """Base class for cloud plugins.""" + _CONFIG_PATH = 'config_path' _RESOURCE_PREFIX = 'resource_prefix' _MANAGED = 'managed' @@ -189,13 +191,14 @@ class CloudBase(metaclass=abc.ABCMeta): self.args = args self.platform = self.__module__.rsplit('.', 1)[-1] - def config_callback(files: list[tuple[str, str]]) -> None: + def config_callback(payload_config: PayloadConfig) -> None: """Add the config file to the payload file list.""" if self.platform not in self.args.metadata.cloud_config: return # platform was initialized, but not used -- such as being skipped due to all tests being disabled if self._get_cloud_config(self._CONFIG_PATH, ''): pair = (self.config_path, os.path.relpath(self.config_path, data_context().content.root)) + files = payload_config.files if pair not in files: display.info('Including %s config: %s -> %s' % (self.platform, pair[0], pair[1]), verbosity=3) @@ -257,6 +260,7 @@ class CloudBase(metaclass=abc.ABCMeta): class CloudProvider(CloudBase): """Base class for cloud provider plugins. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig, config_extension: str = '.ini') -> None: super().__init__(args) @@ -356,6 +360,7 @@ class CloudProvider(CloudBase): class CloudEnvironment(CloudBase): """Base class for cloud environment plugins. Updates integration test environment after delegation.""" + def setup_once(self) -> None: """Run setup if it has not already been run.""" if self.setup_executed: @@ -377,12 +382,14 @@ class CloudEnvironment(CloudBase): class CloudEnvironmentConfig: """Configuration for the environment.""" - def __init__(self, - env_vars: t.Optional[dict[str, str]] = None, - ansible_vars: t.Optional[dict[str, t.Any]] = None, - module_defaults: t.Optional[dict[str, dict[str, t.Any]]] = None, - callback_plugins: t.Optional[list[str]] = None, - ): + + def __init__( + self, + env_vars: t.Optional[dict[str, str]] = None, + ansible_vars: t.Optional[dict[str, t.Any]] = None, + module_defaults: t.Optional[dict[str, dict[str, t.Any]]] = None, + callback_plugins: t.Optional[list[str]] = None, + ): self.env_vars = env_vars self.ansible_vars = ansible_vars self.module_defaults = module_defaults diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/acme.py b/test/lib/ansible_test/_internal/commands/integration/cloud/acme.py index 007d383c..e8020ca9 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/acme.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/acme.py @@ -21,6 +21,7 @@ from . import ( class ACMEProvider(CloudProvider): """ACME plugin. Sets up cloud resources for tests.""" + DOCKER_SIMULATOR_NAME = 'acme-simulator' def __init__(self, args: IntegrationConfig) -> None: @@ -68,6 +69,7 @@ class ACMEProvider(CloudProvider): class ACMEEnvironment(CloudEnvironment): """ACME environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" ansible_vars = dict( diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/aws.py b/test/lib/ansible_test/_internal/commands/integration/cloud/aws.py index 234f3112..470f3be5 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/aws.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/aws.py @@ -37,6 +37,7 @@ from . import ( class AwsCloudProvider(CloudProvider): """AWS cloud provider plugin. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -97,6 +98,7 @@ class AwsCloudProvider(CloudProvider): class AwsCloudEnvironment(CloudEnvironment): """AWS cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/azure.py b/test/lib/ansible_test/_internal/commands/integration/cloud/azure.py index dc5136ac..4225f8f4 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/azure.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/azure.py @@ -31,6 +31,7 @@ from . import ( class AzureCloudProvider(CloudProvider): """Azure cloud provider plugin. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -103,6 +104,7 @@ class AzureCloudProvider(CloudProvider): class AzureCloudEnvironment(CloudEnvironment): """Azure cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" env_vars = get_config(self.config_path) diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/cloudscale.py b/test/lib/ansible_test/_internal/commands/integration/cloud/cloudscale.py index f453ef3e..cbc80997 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/cloudscale.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/cloudscale.py @@ -25,6 +25,7 @@ from . import ( class CloudscaleCloudProvider(CloudProvider): """Cloudscale cloud provider plugin. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -39,6 +40,7 @@ class CloudscaleCloudProvider(CloudProvider): class CloudscaleCloudEnvironment(CloudEnvironment): """Cloudscale cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/cs.py b/test/lib/ansible_test/_internal/commands/integration/cloud/cs.py index 0037b423..8588df7d 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/cs.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/cs.py @@ -35,6 +35,7 @@ from . import ( class CsCloudProvider(CloudProvider): """CloudStack cloud provider plugin. Sets up cloud resources before delegation.""" + DOCKER_SIMULATOR_NAME = 'cloudstack-sim' def __init__(self, args: IntegrationConfig) -> None: @@ -131,6 +132,7 @@ class CsCloudProvider(CloudProvider): def _get_credentials(self, container_name: str) -> dict[str, t.Any]: """Wait for the CloudStack simulator to return credentials.""" + def check(value) -> bool: """Return True if the given configuration is valid JSON, otherwise return False.""" # noinspection PyBroadException @@ -148,6 +150,7 @@ class CsCloudProvider(CloudProvider): class CsCloudEnvironment(CloudEnvironment): """CloudStack cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/digitalocean.py b/test/lib/ansible_test/_internal/commands/integration/cloud/digitalocean.py index a46bf70e..1a15a98d 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/digitalocean.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/digitalocean.py @@ -20,6 +20,7 @@ from . import ( class DigitalOceanCloudProvider(CloudProvider): """Checks if a configuration file has been passed or fixtures are going to be used for testing""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -34,6 +35,7 @@ class DigitalOceanCloudProvider(CloudProvider): class DigitalOceanCloudEnvironment(CloudEnvironment): """Updates integration test environment after delegation. Will setup the config file as parameter.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/foreman.py b/test/lib/ansible_test/_internal/commands/integration/cloud/foreman.py index c2413ee8..9e919cd8 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/foreman.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/foreman.py @@ -21,6 +21,7 @@ from . import ( class ForemanProvider(CloudProvider): """Foreman plugin. Sets up Foreman stub server for tests.""" + DOCKER_SIMULATOR_NAME = 'foreman-stub' # Default image to run Foreman stub from. @@ -82,6 +83,7 @@ class ForemanProvider(CloudProvider): class ForemanEnvironment(CloudEnvironment): """Foreman environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" env_vars = dict( diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/galaxy.py b/test/lib/ansible_test/_internal/commands/integration/cloud/galaxy.py index e180a024..1391cd84 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/galaxy.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/galaxy.py @@ -77,6 +77,7 @@ class GalaxyProvider(CloudProvider): Galaxy plugin. Sets up pulp (ansible-galaxy) servers for tests. The pulp source itself resides at: https://github.com/pulp/pulp-oci-images """ + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -143,6 +144,7 @@ class GalaxyProvider(CloudProvider): class GalaxyEnvironment(CloudEnvironment): """Galaxy environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" pulp_user = str(self._get_cloud_config('PULP_USER')) diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/gcp.py b/test/lib/ansible_test/_internal/commands/integration/cloud/gcp.py index 28ffb7b6..e3cd1df2 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/gcp.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/gcp.py @@ -22,6 +22,7 @@ from . import ( class GcpCloudProvider(CloudProvider): """GCP cloud provider plugin. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -39,6 +40,7 @@ class GcpCloudProvider(CloudProvider): class GcpCloudEnvironment(CloudEnvironment): """GCP cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/hcloud.py b/test/lib/ansible_test/_internal/commands/integration/cloud/hcloud.py index 4d75f221..04d6f7c6 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/hcloud.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/hcloud.py @@ -29,6 +29,7 @@ from . import ( class HcloudCloudProvider(CloudProvider): """Hetzner Cloud provider plugin. Sets up cloud resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -83,6 +84,7 @@ class HcloudCloudProvider(CloudProvider): class HcloudCloudEnvironment(CloudEnvironment): """Hetzner Cloud cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/httptester.py b/test/lib/ansible_test/_internal/commands/integration/cloud/httptester.py index e250eed7..85065d6f 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/httptester.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/httptester.py @@ -28,6 +28,7 @@ KRB5_PASSWORD_ENV = 'KRB5_PASSWORD' class HttptesterProvider(CloudProvider): """HTTP Tester provider plugin. Sets up resources before delegation.""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -82,6 +83,7 @@ class HttptesterProvider(CloudProvider): class HttptesterEnvironment(CloudEnvironment): """HTTP Tester environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" return CloudEnvironmentConfig( diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/nios.py b/test/lib/ansible_test/_internal/commands/integration/cloud/nios.py index df0ebb0e..5bed8340 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/nios.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/nios.py @@ -21,6 +21,7 @@ from . import ( class NiosProvider(CloudProvider): """Nios plugin. Sets up NIOS mock server for tests.""" + DOCKER_SIMULATOR_NAME = 'nios-simulator' # Default image to run the nios simulator. @@ -82,6 +83,7 @@ class NiosProvider(CloudProvider): class NiosEnvironment(CloudEnvironment): """NIOS environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" ansible_vars = dict( diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/opennebula.py b/test/lib/ansible_test/_internal/commands/integration/cloud/opennebula.py index d005a3ca..836cb22c 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/opennebula.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/opennebula.py @@ -16,6 +16,7 @@ from . import ( class OpenNebulaCloudProvider(CloudProvider): """Checks if a configuration file has been passed or fixtures are going to be used for testing""" + def setup(self) -> None: """Setup the cloud resource before delegation and register a cleanup callback.""" super().setup() @@ -42,6 +43,7 @@ class OpenNebulaCloudProvider(CloudProvider): class OpenNebulaCloudEnvironment(CloudEnvironment): """Updates integration test environment after delegation. Will setup the config file as parameter.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/openshift.py b/test/lib/ansible_test/_internal/commands/integration/cloud/openshift.py index da930c01..ddd434a8 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/openshift.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/openshift.py @@ -30,6 +30,7 @@ from . import ( class OpenShiftCloudProvider(CloudProvider): """OpenShift cloud provider plugin. Sets up cloud resources before delegation.""" + DOCKER_CONTAINER_NAME = 'openshift-origin' def __init__(self, args: IntegrationConfig) -> None: @@ -103,6 +104,7 @@ class OpenShiftCloudProvider(CloudProvider): class OpenShiftCloudEnvironment(CloudEnvironment): """OpenShift cloud environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" env_vars = dict( diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/scaleway.py b/test/lib/ansible_test/_internal/commands/integration/cloud/scaleway.py index 04c2d89b..69df093e 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/scaleway.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/scaleway.py @@ -20,6 +20,7 @@ from . import ( class ScalewayCloudProvider(CloudProvider): """Checks if a configuration file has been passed or fixtures are going to be used for testing""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -34,6 +35,7 @@ class ScalewayCloudProvider(CloudProvider): class ScalewayCloudEnvironment(CloudEnvironment): """Updates integration test environment after delegation. Will setup the config file as parameter.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() @@ -41,7 +43,7 @@ class ScalewayCloudEnvironment(CloudEnvironment): env_vars = dict( SCW_API_KEY=parser.get('default', 'key'), - SCW_ORG=parser.get('default', 'org') + SCW_ORG=parser.get('default', 'org'), ) display.sensitive.add(env_vars['SCW_API_KEY']) diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/vcenter.py b/test/lib/ansible_test/_internal/commands/integration/cloud/vcenter.py index df1651f9..242b0204 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/vcenter.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/vcenter.py @@ -27,6 +27,7 @@ from . import ( class VcenterProvider(CloudProvider): """VMware vcenter/esx plugin. Sets up cloud resources for tests.""" + DOCKER_SIMULATOR_NAME = 'vcenter-simulator' def __init__(self, args: IntegrationConfig) -> None: @@ -92,6 +93,7 @@ class VcenterProvider(CloudProvider): class VcenterEnvironment(CloudEnvironment): """VMware vcenter/esx environment plugin. Updates integration test environment after delegation.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" try: diff --git a/test/lib/ansible_test/_internal/commands/integration/cloud/vultr.py b/test/lib/ansible_test/_internal/commands/integration/cloud/vultr.py index 1993cdab..57e4fca7 100644 --- a/test/lib/ansible_test/_internal/commands/integration/cloud/vultr.py +++ b/test/lib/ansible_test/_internal/commands/integration/cloud/vultr.py @@ -20,6 +20,7 @@ from . import ( class VultrCloudProvider(CloudProvider): """Checks if a configuration file has been passed or fixtures are going to be used for testing""" + def __init__(self, args: IntegrationConfig) -> None: super().__init__(args) @@ -34,6 +35,7 @@ class VultrCloudProvider(CloudProvider): class VultrCloudEnvironment(CloudEnvironment): """Updates integration test environment after delegation. Will setup the config file as parameter.""" + def get_environment_config(self) -> CloudEnvironmentConfig: """Return environment configuration for use in the test environment after delegation.""" parser = configparser.ConfigParser() diff --git a/test/lib/ansible_test/_internal/commands/integration/coverage.py b/test/lib/ansible_test/_internal/commands/integration/coverage.py index 5a486e93..ed072052 100644 --- a/test/lib/ansible_test/_internal/commands/integration/coverage.py +++ b/test/lib/ansible_test/_internal/commands/integration/coverage.py @@ -82,6 +82,7 @@ THostConfig = t.TypeVar('THostConfig', bound=HostConfig) class CoverageHandler(t.Generic[THostConfig], metaclass=abc.ABCMeta): """Base class for configuring hosts for integration test code coverage.""" + def __init__(self, args: IntegrationConfig, host_state: HostState, inventory_path: str) -> None: self.args = args self.host_state = host_state @@ -124,6 +125,7 @@ class CoverageHandler(t.Generic[THostConfig], metaclass=abc.ABCMeta): class PosixCoverageHandler(CoverageHandler[PosixConfig]): """Configure integration test code coverage for POSIX hosts.""" + def __init__(self, args: IntegrationConfig, host_state: HostState, inventory_path: str) -> None: super().__init__(args, host_state, inventory_path) @@ -263,6 +265,7 @@ class PosixCoverageHandler(CoverageHandler[PosixConfig]): class WindowsCoverageHandler(CoverageHandler[WindowsConfig]): """Configure integration test code coverage for Windows hosts.""" + def __init__(self, args: IntegrationConfig, host_state: HostState, inventory_path: str) -> None: super().__init__(args, host_state, inventory_path) @@ -334,6 +337,7 @@ class WindowsCoverageHandler(CoverageHandler[WindowsConfig]): class CoverageManager: """Manager for code coverage configuration and state.""" + def __init__(self, args: IntegrationConfig, host_state: HostState, inventory_path: str) -> None: self.args = args self.host_state = host_state diff --git a/test/lib/ansible_test/_internal/commands/integration/filters.py b/test/lib/ansible_test/_internal/commands/integration/filters.py index be03d7f4..571c8163 100644 --- a/test/lib/ansible_test/_internal/commands/integration/filters.py +++ b/test/lib/ansible_test/_internal/commands/integration/filters.py @@ -47,6 +47,7 @@ THostProfile = t.TypeVar('THostProfile', bound=HostProfile) class TargetFilter(t.Generic[THostConfig], metaclass=abc.ABCMeta): """Base class for target filters.""" + def __init__(self, args: IntegrationConfig, configs: list[THostConfig], controller: bool) -> None: self.args = args self.configs = configs @@ -138,6 +139,7 @@ class TargetFilter(t.Generic[THostConfig], metaclass=abc.ABCMeta): class PosixTargetFilter(TargetFilter[TPosixConfig]): """Target filter for POSIX hosts.""" + def filter_targets(self, targets: list[IntegrationTarget], exclude: set[str]) -> None: """Filter the list of targets, adding any which this host profile cannot support to the provided exclude list.""" super().filter_targets(targets, exclude) @@ -151,6 +153,7 @@ class PosixTargetFilter(TargetFilter[TPosixConfig]): class DockerTargetFilter(PosixTargetFilter[DockerConfig]): """Target filter for docker hosts.""" + def filter_targets(self, targets: list[IntegrationTarget], exclude: set[str]) -> None: """Filter the list of targets, adding any which this host profile cannot support to the provided exclude list.""" super().filter_targets(targets, exclude) @@ -167,6 +170,7 @@ class PosixSshTargetFilter(PosixTargetFilter[PosixSshConfig]): class RemoteTargetFilter(TargetFilter[TRemoteConfig]): """Target filter for remote Ansible Core CI managed hosts.""" + def filter_profiles(self, profiles: list[THostProfile], target: IntegrationTarget) -> list[THostProfile]: """Filter the list of profiles, returning only those which are not skipped for the given target.""" profiles = super().filter_profiles(profiles, target) @@ -224,6 +228,7 @@ class NetworkInventoryTargetFilter(TargetFilter[NetworkInventoryConfig]): class OriginTargetFilter(PosixTargetFilter[OriginConfig]): """Target filter for localhost.""" + def filter_targets(self, targets: list[IntegrationTarget], exclude: set[str]) -> None: """Filter the list of targets, adding any which this host profile cannot support to the provided exclude list.""" super().filter_targets(targets, exclude) diff --git a/test/lib/ansible_test/_internal/commands/sanity/__init__.py b/test/lib/ansible_test/_internal/commands/sanity/__init__.py index 00b30310..f399f2ad 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/__init__.py +++ b/test/lib/ansible_test/_internal/commands/sanity/__init__.py @@ -160,6 +160,10 @@ def command_sanity(args: SanityConfig) -> None: if args.skip_test: tests = [target for target in tests if target.name not in args.skip_test] + if not args.host_path: + for test in tests: + test.origin_hook(args) + targets_use_pypi = any(isinstance(test, SanityMultipleVersion) and test.needs_pypi for test in tests) and not args.list_tests host_state = prepare_profiles(args, targets_use_pypi=targets_use_pypi) # sanity @@ -325,6 +329,7 @@ def collect_code_smell_tests() -> tuple[SanityTest, ...]: class SanityIgnoreParser: """Parser for the consolidated sanity test ignore file.""" + NO_CODE = '_' def __init__(self, args: SanityConfig) -> None: @@ -526,11 +531,13 @@ class SanityIgnoreParser: class SanityIgnoreProcessor: """Processor for sanity test ignores for a single run of one sanity test.""" - def __init__(self, - args: SanityConfig, - test: SanityTest, - python_version: t.Optional[str], - ) -> None: + + def __init__( + self, + args: SanityConfig, + test: SanityTest, + python_version: t.Optional[str], + ) -> None: name = test.name code = test.error_code @@ -618,18 +625,21 @@ class SanityIgnoreProcessor: class SanitySuccess(TestSuccess): """Sanity test success.""" + def __init__(self, test: str, python_version: t.Optional[str] = None) -> None: super().__init__(COMMAND, test, python_version) class SanitySkipped(TestSkipped): """Sanity test skipped.""" + def __init__(self, test: str, python_version: t.Optional[str] = None) -> None: super().__init__(COMMAND, test, python_version) class SanityFailure(TestFailure): """Sanity test failure.""" + def __init__( self, test: str, @@ -646,6 +656,7 @@ class SanityMessage(TestMessage): class SanityTargets: """Sanity test target information.""" + def __init__(self, targets: tuple[TestTarget, ...], include: tuple[TestTarget, ...]) -> None: self.targets = targets self.include = include @@ -695,6 +706,7 @@ class SanityTargets: class SanityTest(metaclass=abc.ABCMeta): """Sanity test base class.""" + ansible_only = False def __init__(self, name: t.Optional[str] = None) -> None: @@ -757,6 +769,9 @@ class SanityTest(metaclass=abc.ABCMeta): """A tuple of supported Python versions or None if the test does not depend on specific Python versions.""" return CONTROLLER_PYTHON_VERSIONS + def origin_hook(self, args: SanityConfig) -> None: + """This method is called on the origin, before the test runs or delegation occurs.""" + def filter_targets(self, targets: list[TestTarget]) -> list[TestTarget]: # pylint: disable=unused-argument """Return the given list of test targets, filtered to include only those relevant for the test.""" if self.no_targets: @@ -811,6 +826,7 @@ class SanityTest(metaclass=abc.ABCMeta): class SanitySingleVersion(SanityTest, metaclass=abc.ABCMeta): """Base class for sanity test plugins which should run on a single python version.""" + @property def require_libyaml(self) -> bool: """True if the test requires PyYAML to have libyaml support.""" @@ -827,6 +843,7 @@ class SanitySingleVersion(SanityTest, metaclass=abc.ABCMeta): class SanityCodeSmellTest(SanitySingleVersion): """Sanity test script.""" + def __init__(self, path) -> None: name = os.path.splitext(os.path.basename(path))[0] config_path = os.path.splitext(path)[0] + '.json' @@ -1030,6 +1047,7 @@ class SanityCodeSmellTest(SanitySingleVersion): class SanityVersionNeutral(SanityTest, metaclass=abc.ABCMeta): """Base class for sanity test plugins which are idependent of the python version being used.""" + @abc.abstractmethod def test(self, args: SanityConfig, targets: SanityTargets) -> TestResult: """Run the sanity test and return the result.""" @@ -1046,6 +1064,7 @@ class SanityVersionNeutral(SanityTest, metaclass=abc.ABCMeta): class SanityMultipleVersion(SanityTest, metaclass=abc.ABCMeta): """Base class for sanity test plugins which should run on multiple python versions.""" + @abc.abstractmethod def test(self, args: SanityConfig, targets: SanityTargets, python: PythonConfig) -> TestResult: """Run the sanity test and return the result.""" diff --git a/test/lib/ansible_test/_internal/commands/sanity/ansible_doc.py b/test/lib/ansible_test/_internal/commands/sanity/ansible_doc.py index 6815f884..04080f60 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/ansible_doc.py +++ b/test/lib/ansible_test/_internal/commands/sanity/ansible_doc.py @@ -48,6 +48,7 @@ from ...host_configs import ( class AnsibleDocTest(SanitySingleVersion): """Sanity test for ansible-doc.""" + def filter_targets(self, targets: list[TestTarget]) -> list[TestTarget]: """Return the given list of test targets, filtered to include only those relevant for the test.""" plugin_paths = [plugin_path for plugin_type, plugin_path in data_context().content.plugin_paths.items() if plugin_type in DOCUMENTABLE_PLUGINS] diff --git a/test/lib/ansible_test/_internal/commands/sanity/compile.py b/test/lib/ansible_test/_internal/commands/sanity/compile.py index 45053383..a0f599f1 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/compile.py +++ b/test/lib/ansible_test/_internal/commands/sanity/compile.py @@ -43,6 +43,7 @@ from ...host_configs import ( class CompileTest(SanityMultipleVersion): """Sanity test for proper python syntax.""" + def filter_targets(self, targets: list[TestTarget]) -> list[TestTarget]: """Return the given list of test targets, filtered to include only those relevant for the test.""" return [target for target in targets if os.path.splitext(target.path)[1] == '.py' or is_subdir(target.path, 'bin')] diff --git a/test/lib/ansible_test/_internal/commands/sanity/ignores.py b/test/lib/ansible_test/_internal/commands/sanity/ignores.py index 6d9837d0..251f8326 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/ignores.py +++ b/test/lib/ansible_test/_internal/commands/sanity/ignores.py @@ -25,6 +25,7 @@ from ...config import ( class IgnoresTest(SanityVersionNeutral): """Sanity test for sanity test ignore entries.""" + @property def can_ignore(self) -> bool: """True if the test supports ignore entries.""" diff --git a/test/lib/ansible_test/_internal/commands/sanity/import.py b/test/lib/ansible_test/_internal/commands/sanity/import.py index 8511d7ac..b8083324 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/import.py +++ b/test/lib/ansible_test/_internal/commands/sanity/import.py @@ -84,6 +84,7 @@ def _get_module_test(module_restrictions: bool) -> c.Callable[[str], bool]: class ImportTest(SanityMultipleVersion): """Sanity test for proper import exception handling.""" + def filter_targets(self, targets: list[TestTarget]) -> list[TestTarget]: """Return the given list of test targets, filtered to include only those relevant for the test.""" if data_context().content.is_ansible: diff --git a/test/lib/ansible_test/_internal/commands/sanity/mypy.py b/test/lib/ansible_test/_internal/commands/sanity/mypy.py index cb8ed12c..57ce1277 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/mypy.py +++ b/test/lib/ansible_test/_internal/commands/sanity/mypy.py @@ -58,6 +58,7 @@ from ...host_configs import ( class MypyTest(SanityMultipleVersion): """Sanity test which executes mypy.""" + ansible_only = True vendored_paths = ( @@ -221,7 +222,7 @@ class MypyTest(SanityMultipleVersion): # Below are context specific arguments. # They are primarily useful for listing individual 'ignore_missing_imports' entries instead of using a global ignore. '--config-file', config_path, - ] + ] # fmt: skip cmd.extend(context_paths) @@ -254,6 +255,7 @@ class MypyTest(SanityMultipleVersion): @dataclasses.dataclass(frozen=True) class MyPyContext: """Context details for a single run of mypy.""" + name: str paths: list[str] python_versions: tuple[str, ...] diff --git a/test/lib/ansible_test/_internal/commands/sanity/pep8.py b/test/lib/ansible_test/_internal/commands/sanity/pep8.py index 5df9ace7..610dbd64 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/pep8.py +++ b/test/lib/ansible_test/_internal/commands/sanity/pep8.py @@ -43,6 +43,7 @@ from ...host_configs import ( class Pep8Test(SanitySingleVersion): """Sanity test for PEP 8 style guidelines using pycodestyle.""" + @property def error_code(self) -> t.Optional[str]: """Error code for ansible-test matching the format used by the underlying test program, or None if the program does not use error codes.""" @@ -66,7 +67,7 @@ class Pep8Test(SanitySingleVersion): '--max-line-length', '160', '--config', '/dev/null', '--ignore', ','.join(sorted(current_ignore)), - ] + paths + ] + paths # fmt: skip if paths: try: diff --git a/test/lib/ansible_test/_internal/commands/sanity/pslint.py b/test/lib/ansible_test/_internal/commands/sanity/pslint.py index 9136d51c..1694488d 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/pslint.py +++ b/test/lib/ansible_test/_internal/commands/sanity/pslint.py @@ -45,6 +45,7 @@ from ...data import ( class PslintTest(SanityVersionNeutral): """Sanity test using PSScriptAnalyzer.""" + @property def error_code(self) -> t.Optional[str]: """Error code for ansible-test matching the format used by the underlying test program, or None if the program does not use error codes.""" diff --git a/test/lib/ansible_test/_internal/commands/sanity/pylint.py b/test/lib/ansible_test/_internal/commands/sanity/pylint.py index 86f287ab..c089f834 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/pylint.py +++ b/test/lib/ansible_test/_internal/commands/sanity/pylint.py @@ -18,6 +18,10 @@ from . import ( SANITY_ROOT, ) +from ...io import ( + make_dirs, +) + from ...test import ( TestResult, ) @@ -41,6 +45,7 @@ from ...ansible_util import ( get_collection_detail, CollectionDetail, CollectionDetailError, + ResultType, ) from ...config import ( @@ -58,6 +63,7 @@ from ...host_configs import ( class PylintTest(SanitySingleVersion): """Sanity test using pylint.""" + def __init__(self) -> None: super().__init__() self.optional_error_codes.update([ @@ -106,6 +112,7 @@ class PylintTest(SanitySingleVersion): def filter_path(path_filter: str = None) -> c.Callable[[str], bool]: """Return a function that filters out paths which are not a subdirectory of the given path.""" + def context_filter(path_to_filter: str) -> bool: """Return true if the given path matches, otherwise return False.""" return is_subdir(path_to_filter, path_filter) @@ -149,19 +156,19 @@ class PylintTest(SanitySingleVersion): except CollectionDetailError as ex: display.warning('Skipping pylint collection version checks since collection detail loading failed: %s' % ex.reason) - test_start = datetime.datetime.utcnow() + test_start = datetime.datetime.now(tz=datetime.timezone.utc) for context, context_paths in sorted(contexts): if not context_paths: continue - context_start = datetime.datetime.utcnow() + context_start = datetime.datetime.now(tz=datetime.timezone.utc) messages += self.pylint(args, context, context_paths, plugin_dir, plugin_names, python, collection_detail) - context_end = datetime.datetime.utcnow() + context_end = datetime.datetime.now(tz=datetime.timezone.utc) context_times.append('%s: %d (%s)' % (context, len(context_paths), context_end - context_start)) - test_end = datetime.datetime.utcnow() + test_end = datetime.datetime.now(tz=datetime.timezone.utc) for context_time in context_times: display.info(context_time, verbosity=4) @@ -227,7 +234,7 @@ class PylintTest(SanitySingleVersion): '--rcfile', rcfile, '--output-format', 'json', '--load-plugins', ','.join(sorted(load_plugins)), - ] + paths + ] + paths # fmt: skip if data_context().content.collection: cmd.extend(['--collection-name', data_context().content.collection.full_name]) @@ -246,6 +253,12 @@ class PylintTest(SanitySingleVersion): # expose plugin paths for use in custom plugins env.update(dict(('ANSIBLE_TEST_%s_PATH' % k.upper(), os.path.abspath(v) + os.path.sep) for k, v in data_context().content.plugin_paths.items())) + # Set PYLINTHOME to prevent pylint from checking for an obsolete directory, which can result in a test failure due to stderr output. + # See: https://github.com/PyCQA/pylint/blob/e6c6bf5dfd61511d64779f54264b27a368c43100/pylint/constants.py#L148 + pylint_home = os.path.join(ResultType.TMP.path, 'pylint') + make_dirs(pylint_home) + env.update(PYLINTHOME=pylint_home) + if paths: display.info('Checking %d file(s) in context "%s" with config: %s' % (len(paths), context, rcfile), verbosity=1) diff --git a/test/lib/ansible_test/_internal/commands/sanity/sanity_docs.py b/test/lib/ansible_test/_internal/commands/sanity/sanity_docs.py index 4f14a3a2..48f1b0b1 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/sanity_docs.py +++ b/test/lib/ansible_test/_internal/commands/sanity/sanity_docs.py @@ -27,6 +27,7 @@ from ...data import ( class SanityDocsTest(SanityVersionNeutral): """Sanity test for documentation of sanity tests.""" + ansible_only = True @property diff --git a/test/lib/ansible_test/_internal/commands/sanity/shellcheck.py b/test/lib/ansible_test/_internal/commands/sanity/shellcheck.py index 7de0bdae..4576622c 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/shellcheck.py +++ b/test/lib/ansible_test/_internal/commands/sanity/shellcheck.py @@ -44,6 +44,7 @@ from ...config import ( class ShellcheckTest(SanityVersionNeutral): """Sanity test using shellcheck.""" + @property def error_code(self) -> t.Optional[str]: """Error code for ansible-test matching the format used by the underlying test program, or None if the program does not use error codes.""" @@ -68,7 +69,7 @@ class ShellcheckTest(SanityVersionNeutral): 'shellcheck', '-e', ','.join(sorted(exclude)), '--format', 'checkstyle', - ] + paths + ] + paths # fmt: skip try: stdout, stderr = run_command(args, cmd, capture=True) diff --git a/test/lib/ansible_test/_internal/commands/sanity/validate_modules.py b/test/lib/ansible_test/_internal/commands/sanity/validate_modules.py index e1dacb7c..ab7dd93c 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/validate_modules.py +++ b/test/lib/ansible_test/_internal/commands/sanity/validate_modules.py @@ -1,9 +1,12 @@ """Sanity test using validate-modules.""" from __future__ import annotations +import atexit import collections +import contextlib import json import os +import tarfile import typing as t from . import ( @@ -16,6 +19,10 @@ from . import ( SANITY_ROOT, ) +from ...io import ( + make_dirs, +) + from ...test import ( TestResult, ) @@ -30,7 +37,9 @@ from ...util import ( ) from ...util_common import ( + process_scoped_temporary_directory, run_command, + ResultType, ) from ...ansible_util import ( @@ -49,12 +58,21 @@ from ...ci import ( from ...data import ( data_context, + PayloadConfig, ) from ...host_configs import ( PythonConfig, ) +from ...git import ( + Git, +) + +from ...provider.source import ( + SourceProvider as GitSourceProvider, +) + class ValidateModulesTest(SanitySingleVersion): """Sanity test using validate-modules.""" @@ -115,7 +133,7 @@ class ValidateModulesTest(SanitySingleVersion): os.path.join(SANITY_ROOT, 'validate-modules', 'validate.py'), '--format', 'json', '--arg-spec', - ] + ] # fmt: skip if data_context().content.collection: cmd.extend(['--collection', data_context().content.collection.directory]) @@ -130,14 +148,17 @@ class ValidateModulesTest(SanitySingleVersion): except CollectionDetailError as ex: display.warning('Skipping validate-modules collection version checks since collection detail loading failed: %s' % ex.reason) else: - base_branch = args.base_branch or get_ci_provider().get_base_branch() + path = self.get_archive_path(args) + + if os.path.exists(path): + temp_dir = process_scoped_temporary_directory(args) + + with tarfile.open(path) as file: + file.extractall(temp_dir) - if base_branch: cmd.extend([ - '--base-branch', base_branch, + '--original-plugins', temp_dir, ]) - else: - display.warning('Cannot perform module comparison against the base branch because the base branch was not detected.') errors = [] @@ -188,3 +209,43 @@ class ValidateModulesTest(SanitySingleVersion): return SanityFailure(self.name, messages=all_errors) return SanitySuccess(self.name) + + def origin_hook(self, args: SanityConfig) -> None: + """This method is called on the origin, before the test runs or delegation occurs.""" + if not data_context().content.is_ansible: + return + + if not isinstance(data_context().source_provider, GitSourceProvider): + display.warning('The validate-modules sanity test cannot compare against the base commit because git is not being used.') + return + + base_commit = args.base_branch or get_ci_provider().get_base_commit(args) + + if not base_commit: + display.warning('The validate-modules sanity test cannot compare against the base commit because it was not detected.') + return + + path = self.get_archive_path(args) + + def cleanup() -> None: + """Cleanup callback called when the process exits.""" + with contextlib.suppress(FileNotFoundError): + os.unlink(path) + + def git_callback(payload_config: PayloadConfig) -> None: + """Include the previous plugin content archive in the payload.""" + files = payload_config.files + files.append((path, os.path.relpath(path, data_context().content.root))) + + atexit.register(cleanup) + data_context().register_payload_callback(git_callback) + + make_dirs(os.path.dirname(path)) + + git = Git() + git.run_git(['archive', '--output', path, base_commit, 'lib/ansible/modules/', 'lib/ansible/plugins/']) + + @staticmethod + def get_archive_path(args: SanityConfig) -> str: + """Return the path to the original plugin content archive.""" + return os.path.join(ResultType.TMP.path, f'validate-modules-{args.metadata.session_id}.tar') diff --git a/test/lib/ansible_test/_internal/commands/sanity/yamllint.py b/test/lib/ansible_test/_internal/commands/sanity/yamllint.py index a0d859f0..0af8d65e 100644 --- a/test/lib/ansible_test/_internal/commands/sanity/yamllint.py +++ b/test/lib/ansible_test/_internal/commands/sanity/yamllint.py @@ -47,6 +47,7 @@ from ...host_configs import ( class YamllintTest(SanitySingleVersion): """Sanity test using yamllint.""" + @property def error_code(self) -> t.Optional[str]: """Error code for ansible-test matching the format used by the underlying test program, or None if the program does not use error codes.""" diff --git a/test/lib/ansible_test/_internal/commands/shell/__init__.py b/test/lib/ansible_test/_internal/commands/shell/__init__.py index 5e8c101a..4ddce297 100644 --- a/test/lib/ansible_test/_internal/commands/shell/__init__.py +++ b/test/lib/ansible_test/_internal/commands/shell/__init__.py @@ -124,9 +124,11 @@ def command_shell(args: ShellConfig) -> None: # 255 indicates SSH itself failed, rather than a command run on the remote host. # In this case, report a host connection error so additional troubleshooting output is provided. if not args.delegate and not args.host_path: + def callback() -> None: """Callback to run during error display.""" target_profile.on_target_failure() # when the controller is not delegated, report failures immediately + else: callback = None diff --git a/test/lib/ansible_test/_internal/commands/units/__init__.py b/test/lib/ansible_test/_internal/commands/units/__init__.py index f666d418..7d192e1b 100644 --- a/test/lib/ansible_test/_internal/commands/units/__init__.py +++ b/test/lib/ansible_test/_internal/commands/units/__init__.py @@ -88,6 +88,7 @@ from ...host_profiles import ( class TestContext: """Contexts that unit tests run in based on the type of content.""" + controller = 'controller' modules = 'modules' module_utils = 'module_utils' @@ -255,14 +256,13 @@ def command_units(args: UnitsConfig) -> None: '--forked', '-r', 'a', '-n', str(args.num_workers) if args.num_workers else 'auto', - '--color', - 'yes' if args.color else 'no', + '--color', 'yes' if args.color else 'no', '-p', 'no:cacheprovider', '-c', os.path.join(ANSIBLE_TEST_DATA_ROOT, 'pytest', 'config', config_name), '--junit-xml', os.path.join(ResultType.JUNIT.path, 'python%s-%s-units.xml' % (python.version, test_context)), '--strict-markers', # added in pytest 4.5.0 '--rootdir', data_context().content.root, - ] + ] # fmt:skip if not data_context().content.collection: cmd.append('--durations=25') diff --git a/test/lib/ansible_test/_internal/compat/yaml.py b/test/lib/ansible_test/_internal/compat/yaml.py index 4b471365..fc338e21 100644 --- a/test/lib/ansible_test/_internal/compat/yaml.py +++ b/test/lib/ansible_test/_internal/compat/yaml.py @@ -9,6 +9,7 @@ from functools import ( try: import yaml as _yaml + YAML_IMPORT_ERROR = None except ImportError as ex: yaml_load = None # pylint: disable=invalid-name diff --git a/test/lib/ansible_test/_internal/completion.py b/test/lib/ansible_test/_internal/completion.py index f443181c..31f89087 100644 --- a/test/lib/ansible_test/_internal/completion.py +++ b/test/lib/ansible_test/_internal/completion.py @@ -29,6 +29,7 @@ from .become import ( class CGroupVersion(enum.Enum): """The control group version(s) required by a container.""" + NONE = 'none' V1_ONLY = 'v1-only' V2_ONLY = 'v2-only' @@ -40,6 +41,7 @@ class CGroupVersion(enum.Enum): class AuditMode(enum.Enum): """The audit requirements of a container.""" + NONE = 'none' REQUIRED = 'required' @@ -50,6 +52,7 @@ class AuditMode(enum.Enum): @dataclasses.dataclass(frozen=True) class CompletionConfig(metaclass=abc.ABCMeta): """Base class for completion configuration.""" + name: str @property @@ -61,6 +64,7 @@ class CompletionConfig(metaclass=abc.ABCMeta): @dataclasses.dataclass(frozen=True) class PosixCompletionConfig(CompletionConfig, metaclass=abc.ABCMeta): """Base class for completion configuration of POSIX environments.""" + @property @abc.abstractmethod def supported_pythons(self) -> list[str]: @@ -85,6 +89,7 @@ class PosixCompletionConfig(CompletionConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass(frozen=True) class PythonCompletionConfig(PosixCompletionConfig, metaclass=abc.ABCMeta): """Base class for completion configuration of Python environments.""" + python: str = '' python_dir: str = '/usr/bin' @@ -103,6 +108,7 @@ class PythonCompletionConfig(PosixCompletionConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass(frozen=True) class RemoteCompletionConfig(CompletionConfig): """Base class for completion configuration of remote environments provisioned through Ansible Core CI.""" + provider: t.Optional[str] = None arch: t.Optional[str] = None @@ -132,6 +138,7 @@ class RemoteCompletionConfig(CompletionConfig): @dataclasses.dataclass(frozen=True) class InventoryCompletionConfig(CompletionConfig): """Configuration for inventory files.""" + def __init__(self) -> None: super().__init__(name='inventory') @@ -144,6 +151,7 @@ class InventoryCompletionConfig(CompletionConfig): @dataclasses.dataclass(frozen=True) class PosixSshCompletionConfig(PythonCompletionConfig): """Configuration for a POSIX host reachable over SSH.""" + def __init__(self, user: str, host: str) -> None: super().__init__( name=f'{user}@{host}', @@ -159,6 +167,7 @@ class PosixSshCompletionConfig(PythonCompletionConfig): @dataclasses.dataclass(frozen=True) class DockerCompletionConfig(PythonCompletionConfig): """Configuration for Docker containers.""" + image: str = '' seccomp: str = 'default' cgroup: str = CGroupVersion.V1_V2.value @@ -201,6 +210,7 @@ class DockerCompletionConfig(PythonCompletionConfig): @dataclasses.dataclass(frozen=True) class NetworkRemoteCompletionConfig(RemoteCompletionConfig): """Configuration for remote network platforms.""" + collection: str = '' connection: str = '' placeholder: bool = False @@ -213,6 +223,7 @@ class NetworkRemoteCompletionConfig(RemoteCompletionConfig): @dataclasses.dataclass(frozen=True) class PosixRemoteCompletionConfig(RemoteCompletionConfig, PythonCompletionConfig): """Configuration for remote POSIX platforms.""" + become: t.Optional[str] = None placeholder: bool = False diff --git a/test/lib/ansible_test/_internal/config.py b/test/lib/ansible_test/_internal/config.py index 372c23ab..4e697933 100644 --- a/test/lib/ansible_test/_internal/config.py +++ b/test/lib/ansible_test/_internal/config.py @@ -24,6 +24,7 @@ from .metadata import ( from .data import ( data_context, + PayloadConfig, ) from .host_configs import ( @@ -41,6 +42,7 @@ THostConfig = t.TypeVar('THostConfig', bound=HostConfig) class TerminateMode(enum.Enum): """When to terminate instances.""" + ALWAYS = enum.auto() NEVER = enum.auto() SUCCESS = enum.auto() @@ -52,6 +54,7 @@ class TerminateMode(enum.Enum): @dataclasses.dataclass(frozen=True) class ModulesConfig: """Configuration for modules.""" + python_requires: str python_versions: tuple[str, ...] controller_only: bool @@ -60,6 +63,7 @@ class ModulesConfig: @dataclasses.dataclass(frozen=True) class ContentConfig: """Configuration for all content.""" + modules: ModulesConfig python_versions: tuple[str, ...] py2_support: bool @@ -67,6 +71,7 @@ class ContentConfig: class EnvironmentConfig(CommonConfig): """Configuration common to all commands which execute in an environment.""" + def __init__(self, args: t.Any, command: str) -> None: super().__init__(args, command) @@ -114,7 +119,7 @@ class EnvironmentConfig(CommonConfig): self.dev_systemd_debug: bool = args.dev_systemd_debug self.dev_probe_cgroups: t.Optional[str] = args.dev_probe_cgroups - def host_callback(files: list[tuple[str, str]]) -> None: + def host_callback(payload_config: PayloadConfig) -> None: """Add the host files to the payload file list.""" config = self @@ -123,6 +128,8 @@ class EnvironmentConfig(CommonConfig): state_path = os.path.join(config.host_path, 'state.dat') config_path = os.path.join(config.host_path, 'config.dat') + files = payload_config.files + files.append((os.path.abspath(settings_path), settings_path)) files.append((os.path.abspath(state_path), state_path)) files.append((os.path.abspath(config_path), config_path)) @@ -196,6 +203,7 @@ class EnvironmentConfig(CommonConfig): class TestConfig(EnvironmentConfig): """Configuration common to all test commands.""" + def __init__(self, args: t.Any, command: str) -> None: super().__init__(args, command) @@ -225,9 +233,10 @@ class TestConfig(EnvironmentConfig): if self.coverage_check: self.coverage = True - def metadata_callback(files: list[tuple[str, str]]) -> None: + def metadata_callback(payload_config: PayloadConfig) -> None: """Add the metadata file to the payload file list.""" config = self + files = payload_config.files if config.metadata_path: files.append((os.path.abspath(config.metadata_path), config.metadata_path)) @@ -237,6 +246,7 @@ class TestConfig(EnvironmentConfig): class ShellConfig(EnvironmentConfig): """Configuration for the shell command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'shell') @@ -250,6 +260,7 @@ class ShellConfig(EnvironmentConfig): class SanityConfig(TestConfig): """Configuration for the sanity command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'sanity') @@ -258,23 +269,14 @@ class SanityConfig(TestConfig): self.list_tests: bool = args.list_tests self.allow_disabled: bool = args.allow_disabled self.enable_optional_errors: bool = args.enable_optional_errors - self.keep_git: bool = args.keep_git self.prime_venvs: bool = args.prime_venvs self.display_stderr = self.lint or self.list_tests - if self.keep_git: - def git_callback(files: list[tuple[str, str]]) -> None: - """Add files from the content root .git directory to the payload file list.""" - for dirpath, _dirnames, filenames in os.walk(os.path.join(data_context().content.root, '.git')): - paths = [os.path.join(dirpath, filename) for filename in filenames] - files.extend((path, os.path.relpath(path, data_context().content.root)) for path in paths) - - data_context().register_payload_callback(git_callback) - class IntegrationConfig(TestConfig): """Configuration for the integration command.""" + def __init__(self, args: t.Any, command: str) -> None: super().__init__(args, command) @@ -319,18 +321,21 @@ TIntegrationConfig = t.TypeVar('TIntegrationConfig', bound=IntegrationConfig) class PosixIntegrationConfig(IntegrationConfig): """Configuration for the posix integration command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'integration') class WindowsIntegrationConfig(IntegrationConfig): """Configuration for the windows integration command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'windows-integration') class NetworkIntegrationConfig(IntegrationConfig): """Configuration for the network integration command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'network-integration') @@ -339,6 +344,7 @@ class NetworkIntegrationConfig(IntegrationConfig): class UnitsConfig(TestConfig): """Configuration for the units command.""" + def __init__(self, args: t.Any) -> None: super().__init__(args, 'units') diff --git a/test/lib/ansible_test/_internal/connections.py b/test/lib/ansible_test/_internal/connections.py index 4823b1a4..84dc84b2 100644 --- a/test/lib/ansible_test/_internal/connections.py +++ b/test/lib/ansible_test/_internal/connections.py @@ -44,33 +44,37 @@ from .become import ( class Connection(metaclass=abc.ABCMeta): """Base class for connecting to a host.""" + @abc.abstractmethod - def run(self, - command: list[str], - capture: bool, - interactive: bool = False, - data: t.Optional[str] = None, - stdin: t.Optional[t.IO[bytes]] = None, - stdout: t.Optional[t.IO[bytes]] = None, - output_stream: t.Optional[OutputStream] = None, - ) -> tuple[t.Optional[str], t.Optional[str]]: + def run( + self, + command: list[str], + capture: bool, + interactive: bool = False, + data: t.Optional[str] = None, + stdin: t.Optional[t.IO[bytes]] = None, + stdout: t.Optional[t.IO[bytes]] = None, + output_stream: t.Optional[OutputStream] = None, + ) -> tuple[t.Optional[str], t.Optional[str]]: """Run the specified command and return the result.""" - def extract_archive(self, - chdir: str, - src: t.IO[bytes], - ): + def extract_archive( + self, + chdir: str, + src: t.IO[bytes], + ): """Extract the given archive file stream in the specified directory.""" tar_cmd = ['tar', 'oxzf', '-', '-C', chdir] retry(lambda: self.run(tar_cmd, stdin=src, capture=True)) - def create_archive(self, - chdir: str, - name: str, - dst: t.IO[bytes], - exclude: t.Optional[str] = None, - ): + def create_archive( + self, + chdir: str, + name: str, + dst: t.IO[bytes], + exclude: t.Optional[str] = None, + ): """Create the specified archive file stream from the specified directory, including the given name and optionally excluding the given name.""" tar_cmd = ['tar', 'cf', '-', '-C', chdir] gzip_cmd = ['gzip'] @@ -90,18 +94,20 @@ class Connection(metaclass=abc.ABCMeta): class LocalConnection(Connection): """Connect to localhost.""" + def __init__(self, args: EnvironmentConfig) -> None: self.args = args - def run(self, - command: list[str], - capture: bool, - interactive: bool = False, - data: t.Optional[str] = None, - stdin: t.Optional[t.IO[bytes]] = None, - stdout: t.Optional[t.IO[bytes]] = None, - output_stream: t.Optional[OutputStream] = None, - ) -> tuple[t.Optional[str], t.Optional[str]]: + def run( + self, + command: list[str], + capture: bool, + interactive: bool = False, + data: t.Optional[str] = None, + stdin: t.Optional[t.IO[bytes]] = None, + stdout: t.Optional[t.IO[bytes]] = None, + output_stream: t.Optional[OutputStream] = None, + ) -> tuple[t.Optional[str], t.Optional[str]]: """Run the specified command and return the result.""" return run_command( args=self.args, @@ -117,6 +123,7 @@ class LocalConnection(Connection): class SshConnection(Connection): """Connect to a host using SSH.""" + def __init__(self, args: EnvironmentConfig, settings: SshConnectionDetail, become: t.Optional[Become] = None) -> None: self.args = args self.settings = settings @@ -136,15 +143,16 @@ class SshConnection(Connection): self.options.extend(ssh_options_to_list(ssh_options)) - def run(self, - command: list[str], - capture: bool, - interactive: bool = False, - data: t.Optional[str] = None, - stdin: t.Optional[t.IO[bytes]] = None, - stdout: t.Optional[t.IO[bytes]] = None, - output_stream: t.Optional[OutputStream] = None, - ) -> tuple[t.Optional[str], t.Optional[str]]: + def run( + self, + command: list[str], + capture: bool, + interactive: bool = False, + data: t.Optional[str] = None, + stdin: t.Optional[t.IO[bytes]] = None, + stdout: t.Optional[t.IO[bytes]] = None, + output_stream: t.Optional[OutputStream] = None, + ) -> tuple[t.Optional[str], t.Optional[str]]: """Run the specified command and return the result.""" options = list(self.options) @@ -213,20 +221,22 @@ class SshConnection(Connection): class DockerConnection(Connection): """Connect to a host using Docker.""" + def __init__(self, args: EnvironmentConfig, container_id: str, user: t.Optional[str] = None) -> None: self.args = args self.container_id = container_id self.user: t.Optional[str] = user - def run(self, - command: list[str], - capture: bool, - interactive: bool = False, - data: t.Optional[str] = None, - stdin: t.Optional[t.IO[bytes]] = None, - stdout: t.Optional[t.IO[bytes]] = None, - output_stream: t.Optional[OutputStream] = None, - ) -> tuple[t.Optional[str], t.Optional[str]]: + def run( + self, + command: list[str], + capture: bool, + interactive: bool = False, + data: t.Optional[str] = None, + stdin: t.Optional[t.IO[bytes]] = None, + stdout: t.Optional[t.IO[bytes]] = None, + output_stream: t.Optional[OutputStream] = None, + ) -> tuple[t.Optional[str], t.Optional[str]]: """Run the specified command and return the result.""" options = [] diff --git a/test/lib/ansible_test/_internal/containers.py b/test/lib/ansible_test/_internal/containers.py index a581ecf2..bfc36434 100644 --- a/test/lib/ansible_test/_internal/containers.py +++ b/test/lib/ansible_test/_internal/containers.py @@ -95,6 +95,7 @@ support_containers_mutex = threading.Lock() class HostType: """Enum representing the types of hosts involved in running tests.""" + origin = 'origin' control = 'control' managed = 'managed' @@ -102,6 +103,7 @@ class HostType: class CleanupMode(enum.Enum): """How container cleanup should be handled.""" + YES = enum.auto() NO = enum.auto() INFO = enum.auto() @@ -146,7 +148,7 @@ def run_support_container( if current_container_id: publish_ports = False # publishing ports is pointless if already running in a docker container - options = (options or []) + options = options or [] if start: options.append('-dt') # the -t option is required to cause systemd in the container to log output to the console @@ -378,6 +380,7 @@ def get_container_database(args: EnvironmentConfig) -> ContainerDatabase: class ContainerAccess: """Information needed for one test host to access a single container supporting tests.""" + def __init__(self, host_ip: str, names: list[str], ports: t.Optional[list[int]], forwards: t.Optional[dict[int, int]]) -> None: # if forwards is set # this is where forwards are sent (it is the host that provides an indirect connection to the containers on alternate ports) @@ -437,6 +440,7 @@ class ContainerAccess: class ContainerDatabase: """Database of running containers used to support tests.""" + def __init__(self, data: dict[str, dict[str, dict[str, ContainerAccess]]]) -> None: self.data = data @@ -576,6 +580,7 @@ def create_container_database(args: EnvironmentConfig) -> ContainerDatabase: class SupportContainerContext: """Context object for tracking information relating to access of support containers.""" + def __init__(self, containers: ContainerDatabase, process: t.Optional[SshProcess]) -> None: self.containers = containers self.process = process @@ -678,19 +683,21 @@ def create_support_container_context( class ContainerDescriptor: """Information about a support container.""" - def __init__(self, - image: str, - context: str, - name: str, - container_id: str, - ports: list[int], - aliases: list[str], - publish_ports: bool, - running: bool, - existing: bool, - cleanup: CleanupMode, - env: t.Optional[dict[str, str]], - ) -> None: + + def __init__( + self, + image: str, + context: str, + name: str, + container_id: str, + ports: list[int], + aliases: list[str], + publish_ports: bool, + running: bool, + existing: bool, + cleanup: CleanupMode, + env: t.Optional[dict[str, str]], + ) -> None: self.image = image self.context = context self.name = name @@ -757,23 +764,26 @@ class ContainerDescriptor: class SupportContainer: """Information about a running support container available for use by tests.""" - def __init__(self, - container: DockerInspect, - container_ip: str, - published_ports: dict[int, int], - ) -> None: + + def __init__( + self, + container: DockerInspect, + container_ip: str, + published_ports: dict[int, int], + ) -> None: self.container = container self.container_ip = container_ip self.published_ports = published_ports -def wait_for_file(args: EnvironmentConfig, - container_name: str, - path: str, - sleep: int, - tries: int, - check: t.Optional[c.Callable[[str], bool]] = None, - ) -> str: +def wait_for_file( + args: EnvironmentConfig, + container_name: str, + path: str, + sleep: int, + tries: int, + check: t.Optional[c.Callable[[str], bool]] = None, +) -> str: """Wait for the specified file to become available in the requested container and return its contents.""" display.info('Waiting for container "%s" to provide file: %s' % (container_name, path)) @@ -853,6 +863,7 @@ def create_container_hooks( """Clean up previously configured SSH port forwarding which was required by the specified target.""" cleanup_ssh_ports(args, control_connections, '%s_hosts_restore.yml' % control_type, control_state, target, HostType.control) cleanup_ssh_ports(args, managed_connections, '%s_hosts_restore.yml' % managed_type, managed_state, target, HostType.managed) + else: pre_target, post_target = None, None diff --git a/test/lib/ansible_test/_internal/core_ci.py b/test/lib/ansible_test/_internal/core_ci.py index d62b9039..6e44b3d9 100644 --- a/test/lib/ansible_test/_internal/core_ci.py +++ b/test/lib/ansible_test/_internal/core_ci.py @@ -6,6 +6,7 @@ import dataclasses import json import os import re +import stat import traceback import uuid import time @@ -46,12 +47,14 @@ from .ci import ( from .data import ( data_context, + PayloadConfig, ) @dataclasses.dataclass(frozen=True) class Resource(metaclass=abc.ABCMeta): """Base class for Ansible Core CI resources.""" + @abc.abstractmethod def as_tuple(self) -> tuple[str, str, str, str]: """Return the resource as a tuple of platform, version, architecture and provider.""" @@ -69,6 +72,7 @@ class Resource(metaclass=abc.ABCMeta): @dataclasses.dataclass(frozen=True) class VmResource(Resource): """Details needed to request a VM from Ansible Core CI.""" + platform: str version: str architecture: str @@ -92,6 +96,7 @@ class VmResource(Resource): @dataclasses.dataclass(frozen=True) class CloudResource(Resource): """Details needed to request cloud credentials from Ansible Core CI.""" + platform: str def as_tuple(self) -> tuple[str, str, str, str]: @@ -110,6 +115,7 @@ class CloudResource(Resource): class AnsibleCoreCI: """Client for Ansible Core CI services.""" + DEFAULT_ENDPOINT = 'https://ansible-core-ci.testing.ansible.com' def __init__( @@ -301,7 +307,7 @@ class AnsibleCoreCI: ) ) - data.update(dict(auth=auth)) + data.update(auth=auth) headers = { 'Content-Type': 'application/json', @@ -418,6 +424,7 @@ class AnsibleCoreCI: class CoreHttpError(HttpError): """HTTP response as an error.""" + def __init__(self, status: int, remote_message: str, remote_stack_trace: str) -> None: super().__init__(status, f'{remote_message}{remote_stack_trace}') @@ -427,6 +434,7 @@ class CoreHttpError(HttpError): class SshKey: """Container for SSH key used to connect to remote instances.""" + KEY_TYPE = 'rsa' # RSA is used to maintain compatibility with paramiko and EC2 KEY_NAME = f'id_{KEY_TYPE}' PUB_NAME = f'{KEY_NAME}.pub' @@ -441,14 +449,19 @@ class SshKey: key, pub = key_pair key_dst, pub_dst = self.get_in_tree_key_pair_paths() - def ssh_key_callback(files: list[tuple[str, str]]) -> None: + def ssh_key_callback(payload_config: PayloadConfig) -> None: """ Add the SSH keys to the payload file list. They are either outside the source tree or in the cache dir which is ignored by default. """ + files = payload_config.files + permissions = payload_config.permissions + files.append((key, os.path.relpath(key_dst, data_context().content.root))) files.append((pub, os.path.relpath(pub_dst, data_context().content.root))) + permissions[os.path.relpath(key_dst, data_context().content.root)] = stat.S_IRUSR | stat.S_IWUSR + data_context().register_payload_callback(ssh_key_callback) self.key, self.pub = key, pub @@ -525,14 +538,16 @@ class SshKey: class InstanceConnection: """Container for remote instance status and connection details.""" - def __init__(self, - running: bool, - hostname: t.Optional[str] = None, - port: t.Optional[int] = None, - username: t.Optional[str] = None, - password: t.Optional[str] = None, - response_json: t.Optional[dict[str, t.Any]] = None, - ) -> None: + + def __init__( + self, + running: bool, + hostname: t.Optional[str] = None, + port: t.Optional[int] = None, + username: t.Optional[str] = None, + password: t.Optional[str] = None, + response_json: t.Optional[dict[str, t.Any]] = None, + ) -> None: self.running = running self.hostname = hostname self.port = port diff --git a/test/lib/ansible_test/_internal/coverage_util.py b/test/lib/ansible_test/_internal/coverage_util.py index 0f445059..0af1cac4 100644 --- a/test/lib/ansible_test/_internal/coverage_util.py +++ b/test/lib/ansible_test/_internal/coverage_util.py @@ -60,6 +60,7 @@ from .thread import ( @dataclasses.dataclass(frozen=True) class CoverageVersion: """Details about a coverage version and its supported Python versions.""" + coverage_version: str schema_version: int min_python: tuple[int, int] @@ -81,6 +82,7 @@ CONTROLLER_COVERAGE_VERSION = COVERAGE_VERSIONS[0] class CoverageError(ApplicationError): """Exception caused while attempting to read a coverage file.""" + def __init__(self, path: str, message: str) -> None: self.path = path self.message = message diff --git a/test/lib/ansible_test/_internal/data.py b/test/lib/ansible_test/_internal/data.py index 635b0c32..379ee7b0 100644 --- a/test/lib/ansible_test/_internal/data.py +++ b/test/lib/ansible_test/_internal/data.py @@ -50,8 +50,17 @@ from .provider.layout.unsupported import ( ) +@dataclasses.dataclass(frozen=True) +class PayloadConfig: + """Configuration required to build a source tree payload for delegation.""" + + files: list[tuple[str, str]] + permissions: dict[str, int] + + class DataContext: """Data context providing details about the current execution environment for ansible-test.""" + def __init__(self) -> None: content_path = os.environ.get('ANSIBLE_TEST_CONTENT_ROOT') current_path = os.getcwd() @@ -63,16 +72,17 @@ class DataContext: self.__source_providers = source_providers self.__ansible_source: t.Optional[tuple[tuple[str, str], ...]] = None - self.payload_callbacks: list[c.Callable[[list[tuple[str, str]]], None]] = [] + self.payload_callbacks: list[c.Callable[[PayloadConfig], None]] = [] if content_path: - content = self.__create_content_layout(layout_providers, source_providers, content_path, False) + content, source_provider = self.__create_content_layout(layout_providers, source_providers, content_path, False) elif ANSIBLE_SOURCE_ROOT and is_subdir(current_path, ANSIBLE_SOURCE_ROOT): - content = self.__create_content_layout(layout_providers, source_providers, ANSIBLE_SOURCE_ROOT, False) + content, source_provider = self.__create_content_layout(layout_providers, source_providers, ANSIBLE_SOURCE_ROOT, False) else: - content = self.__create_content_layout(layout_providers, source_providers, current_path, True) + content, source_provider = self.__create_content_layout(layout_providers, source_providers, current_path, True) self.content: ContentLayout = content + self.source_provider = source_provider def create_collection_layouts(self) -> list[ContentLayout]: """ @@ -100,7 +110,7 @@ class DataContext: if collection_path == os.path.join(collection.root, collection.directory): collection_layout = layout else: - collection_layout = self.__create_content_layout(self.__layout_providers, self.__source_providers, collection_path, False) + collection_layout = self.__create_content_layout(self.__layout_providers, self.__source_providers, collection_path, False)[0] file_count = len(collection_layout.all_files()) @@ -113,11 +123,12 @@ class DataContext: return collections @staticmethod - def __create_content_layout(layout_providers: list[t.Type[LayoutProvider]], - source_providers: list[t.Type[SourceProvider]], - root: str, - walk: bool, - ) -> ContentLayout: + def __create_content_layout( + layout_providers: list[t.Type[LayoutProvider]], + source_providers: list[t.Type[SourceProvider]], + root: str, + walk: bool, + ) -> t.Tuple[ContentLayout, SourceProvider]: """Create a content layout using the given providers and root path.""" try: layout_provider = find_path_provider(LayoutProvider, layout_providers, root, walk) @@ -138,7 +149,7 @@ class DataContext: layout = layout_provider.create(layout_provider.root, source_provider.get_paths(layout_provider.root)) - return layout + return layout, source_provider def __create_ansible_source(self): """Return a tuple of Ansible source files with both absolute and relative paths.""" @@ -173,7 +184,7 @@ class DataContext: return self.__ansible_source - def register_payload_callback(self, callback: c.Callable[[list[tuple[str, str]]], None]) -> None: + def register_payload_callback(self, callback: c.Callable[[PayloadConfig], None]) -> None: """Register the given payload callback.""" self.payload_callbacks.append(callback) @@ -239,6 +250,7 @@ def data_context() -> DataContext: @dataclasses.dataclass(frozen=True) class PluginInfo: """Information about an Ansible plugin.""" + plugin_type: str name: str paths: list[str] diff --git a/test/lib/ansible_test/_internal/delegation.py b/test/lib/ansible_test/_internal/delegation.py index 0f181a23..7114f2ab 100644 --- a/test/lib/ansible_test/_internal/delegation.py +++ b/test/lib/ansible_test/_internal/delegation.py @@ -177,7 +177,6 @@ def delegate_command(args: EnvironmentConfig, host_state: HostState, exclude: li con.run(['mkdir', '-p'] + writable_dirs, capture=True) con.run(['chmod', '777'] + writable_dirs, capture=True) con.run(['chmod', '755', working_directory], capture=True) - con.run(['chmod', '644', os.path.join(content_root, args.metadata_path)], capture=True) con.run(['useradd', pytest_user, '--create-home'], capture=True) con.run(insert_options(command, options + ['--requirements-mode', 'only']), capture=False) @@ -347,7 +346,7 @@ def filter_options( ('--metadata', 1, args.metadata_path), ('--exclude', 1, exclude), ('--require', 1, require), - ('--base-branch', 1, args.base_branch or get_ci_provider().get_base_branch()), + ('--base-branch', 1, False), ]) pass_through_args: list[str] = [] diff --git a/test/lib/ansible_test/_internal/dev/container_probe.py b/test/lib/ansible_test/_internal/dev/container_probe.py index be22e01c..fcbfbe4f 100644 --- a/test/lib/ansible_test/_internal/dev/container_probe.py +++ b/test/lib/ansible_test/_internal/dev/container_probe.py @@ -45,6 +45,7 @@ from ..cgroup import ( class CGroupState(enum.Enum): """The expected state of a cgroup related mount point.""" + HOST = enum.auto() PRIVATE = enum.auto() SHADOWED = enum.auto() @@ -53,6 +54,7 @@ class CGroupState(enum.Enum): @dataclasses.dataclass(frozen=True) class CGroupMount: """Details on a cgroup mount point that is expected to be present in the container.""" + path: str type: t.Optional[str] writable: t.Optional[bool] diff --git a/test/lib/ansible_test/_internal/diff.py b/test/lib/ansible_test/_internal/diff.py index edaf6c5f..2ddc2ff9 100644 --- a/test/lib/ansible_test/_internal/diff.py +++ b/test/lib/ansible_test/_internal/diff.py @@ -18,6 +18,7 @@ def parse_diff(lines: list[str]) -> list[FileDiff]: class FileDiff: """Parsed diff for a single file.""" + def __init__(self, old_path: str, new_path: str) -> None: self.old = DiffSide(old_path, new=False) self.new = DiffSide(new_path, new=True) @@ -36,6 +37,7 @@ class FileDiff: class DiffSide: """Parsed diff for a single 'side' of a single file.""" + def __init__(self, path: str, new: bool) -> None: self.path = path self.new = new @@ -109,6 +111,7 @@ class DiffSide: class DiffParser: """Parse diff lines.""" + def __init__(self, lines: list[str]) -> None: self.lines = lines self.files: list[FileDiff] = [] diff --git a/test/lib/ansible_test/_internal/docker_util.py b/test/lib/ansible_test/_internal/docker_util.py index 6c38ddbd..06f383b5 100644 --- a/test/lib/ansible_test/_internal/docker_util.py +++ b/test/lib/ansible_test/_internal/docker_util.py @@ -243,6 +243,7 @@ def get_docker_info(args: CommonConfig) -> DockerInfo: class SystemdControlGroupV1Status(enum.Enum): """The state of the cgroup v1 systemd hierarchy on the container host.""" + SUBSYSTEM_MISSING = 'The systemd cgroup subsystem was not found.' FILESYSTEM_NOT_MOUNTED = 'The "/sys/fs/cgroup/systemd" filesystem is not mounted.' MOUNT_TYPE_NOT_CORRECT = 'The "/sys/fs/cgroup/systemd" mount type is not correct.' @@ -252,6 +253,7 @@ class SystemdControlGroupV1Status(enum.Enum): @dataclasses.dataclass(frozen=True) class ContainerHostProperties: """Container host properties detected at run time.""" + audit_code: str max_open_files: int loginuid: t.Optional[int] @@ -411,7 +413,7 @@ def run_utility_container( options = options + [ '--name', name, '--rm', - ] + ] # fmt: skip if data: options.append('-i') @@ -423,6 +425,7 @@ def run_utility_container( class DockerCommand: """Details about the available docker command.""" + def __init__(self, command: str, executable: str, version: str) -> None: self.command = command self.executable = executable @@ -720,6 +723,7 @@ class DockerError(Exception): class ContainerNotFoundError(DockerError): """The container identified by `identifier` was not found.""" + def __init__(self, identifier: str) -> None: super().__init__('The container "%s" was not found.' % identifier) @@ -728,6 +732,7 @@ class ContainerNotFoundError(DockerError): class DockerInspect: """The results of `docker inspect` for a single container.""" + def __init__(self, args: CommonConfig, inspection: dict[str, t.Any]) -> None: self.args = args self.inspection = inspection @@ -847,6 +852,7 @@ def docker_network_disconnect(args: CommonConfig, container_id: str, network: st class DockerImageInspect: """The results of `docker image inspect` for a single image.""" + def __init__(self, args: CommonConfig, inspection: dict[str, t.Any]) -> None: self.args = args self.inspection = inspection @@ -909,6 +915,7 @@ def docker_image_inspect(args: CommonConfig, image: str, always: bool = False) - class DockerNetworkInspect: """The results of `docker network inspect` for a single network.""" + def __init__(self, args: CommonConfig, inspection: dict[str, t.Any]) -> None: self.args = args self.inspection = inspection @@ -961,8 +968,16 @@ def docker_exec( if data or stdin or stdout: options.append('-i') - return docker_command(args, ['exec'] + options + [container_id] + cmd, capture=capture, stdin=stdin, stdout=stdout, interactive=interactive, - output_stream=output_stream, data=data) + return docker_command( + args, + ['exec'] + options + [container_id] + cmd, + capture=capture, + stdin=stdin, + stdout=stdout, + interactive=interactive, + output_stream=output_stream, + data=data, + ) def docker_command( @@ -983,8 +998,18 @@ def docker_command( if command[0] == 'podman' and get_podman_remote(): command.append('--remote') - return run_command(args, command + cmd, env=env, capture=capture, stdin=stdin, stdout=stdout, interactive=interactive, always=always, - output_stream=output_stream, data=data) + return run_command( + args, + command + cmd, + env=env, + capture=capture, + stdin=stdin, + stdout=stdout, + interactive=interactive, + always=always, + output_stream=output_stream, + data=data, + ) def docker_environment() -> dict[str, str]: diff --git a/test/lib/ansible_test/_internal/executor.py b/test/lib/ansible_test/_internal/executor.py index 0c94cf3b..d7d6f1a8 100644 --- a/test/lib/ansible_test/_internal/executor.py +++ b/test/lib/ansible_test/_internal/executor.py @@ -81,18 +81,21 @@ def detect_changes(args: TestConfig) -> t.Optional[list[str]]: class NoChangesDetected(ApplicationWarning): """Exception when change detection was performed, but no changes were found.""" + def __init__(self) -> None: super().__init__('No changes detected.') class NoTestsForChanges(ApplicationWarning): """Exception when changes detected, but no tests trigger as a result.""" + def __init__(self) -> None: super().__init__('No tests found for detected changes.') class Delegate(Exception): """Trigger command delegation.""" + def __init__(self, host_state: HostState, exclude: list[str] = None, require: list[str] = None) -> None: super().__init__() @@ -103,6 +106,7 @@ class Delegate(Exception): class ListTargets(Exception): """List integration test targets instead of executing them.""" + def __init__(self, target_names: list[str]) -> None: super().__init__() @@ -111,5 +115,6 @@ class ListTargets(Exception): class AllTargetsSkipped(ApplicationWarning): """All targets skipped.""" + def __init__(self) -> None: super().__init__('All targets skipped.') diff --git a/test/lib/ansible_test/_internal/git.py b/test/lib/ansible_test/_internal/git.py index c1909f08..4685f1d2 100644 --- a/test/lib/ansible_test/_internal/git.py +++ b/test/lib/ansible_test/_internal/git.py @@ -12,6 +12,7 @@ from .util import ( class Git: """Wrapper around git command-line tools.""" + def __init__(self, root: t.Optional[str] = None) -> None: self.git = 'git' self.root = root diff --git a/test/lib/ansible_test/_internal/host_configs.py b/test/lib/ansible_test/_internal/host_configs.py index 48d5fd31..ddc4727c 100644 --- a/test/lib/ansible_test/_internal/host_configs.py +++ b/test/lib/ansible_test/_internal/host_configs.py @@ -48,6 +48,7 @@ from .util import ( @dataclasses.dataclass(frozen=True) class OriginCompletionConfig(PosixCompletionConfig): """Pseudo completion config for the origin.""" + def __init__(self) -> None: super().__init__(name='origin') @@ -73,6 +74,7 @@ class OriginCompletionConfig(PosixCompletionConfig): @dataclasses.dataclass(frozen=True) class HostContext: """Context used when getting and applying defaults for host configurations.""" + controller_config: t.Optional['PosixConfig'] @property @@ -84,6 +86,7 @@ class HostContext: @dataclasses.dataclass class HostConfig(metaclass=abc.ABCMeta): """Base class for host configuration.""" + @abc.abstractmethod def get_defaults(self, context: HostContext) -> CompletionConfig: """Return the default settings.""" @@ -104,6 +107,7 @@ class HostConfig(metaclass=abc.ABCMeta): @dataclasses.dataclass class PythonConfig(metaclass=abc.ABCMeta): """Configuration for Python.""" + version: t.Optional[str] = None path: t.Optional[str] = None @@ -142,6 +146,7 @@ class PythonConfig(metaclass=abc.ABCMeta): @dataclasses.dataclass class NativePythonConfig(PythonConfig): """Configuration for native Python.""" + @property def is_managed(self) -> bool: """ @@ -154,6 +159,7 @@ class NativePythonConfig(PythonConfig): @dataclasses.dataclass class VirtualPythonConfig(PythonConfig): """Configuration for Python in a virtual environment.""" + system_site_packages: t.Optional[bool] = None def apply_defaults(self, context: HostContext, defaults: PosixCompletionConfig) -> None: @@ -175,6 +181,7 @@ class VirtualPythonConfig(PythonConfig): @dataclasses.dataclass class PosixConfig(HostConfig, metaclass=abc.ABCMeta): """Base class for POSIX host configuration.""" + python: t.Optional[PythonConfig] = None @property @@ -199,6 +206,7 @@ class PosixConfig(HostConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass class ControllerHostConfig(PosixConfig, metaclass=abc.ABCMeta): """Base class for host configurations which support the controller.""" + @abc.abstractmethod def get_default_targets(self, context: HostContext) -> list[ControllerConfig]: """Return the default targets for this host config.""" @@ -207,6 +215,7 @@ class ControllerHostConfig(PosixConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass class RemoteConfig(HostConfig, metaclass=abc.ABCMeta): """Base class for remote host configuration.""" + name: t.Optional[str] = None provider: t.Optional[str] = None arch: t.Optional[str] = None @@ -245,6 +254,7 @@ class RemoteConfig(HostConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass class PosixSshConfig(PosixConfig): """Configuration for a POSIX SSH host.""" + user: t.Optional[str] = None host: t.Optional[str] = None port: t.Optional[int] = None @@ -265,6 +275,7 @@ class PosixSshConfig(PosixConfig): @dataclasses.dataclass class InventoryConfig(HostConfig): """Configuration using inventory.""" + path: t.Optional[str] = None def get_defaults(self, context: HostContext) -> InventoryCompletionConfig: @@ -279,6 +290,7 @@ class InventoryConfig(HostConfig): @dataclasses.dataclass class DockerConfig(ControllerHostConfig, PosixConfig): """Configuration for a docker host.""" + name: t.Optional[str] = None image: t.Optional[str] = None memory: t.Optional[int] = None @@ -343,6 +355,7 @@ class DockerConfig(ControllerHostConfig, PosixConfig): @dataclasses.dataclass class PosixRemoteConfig(RemoteConfig, ControllerHostConfig, PosixConfig): """Configuration for a POSIX remote host.""" + become: t.Optional[str] = None def get_defaults(self, context: HostContext) -> PosixRemoteCompletionConfig: @@ -385,6 +398,7 @@ class WindowsConfig(HostConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass class WindowsRemoteConfig(RemoteConfig, WindowsConfig): """Configuration for a remote Windows host.""" + def get_defaults(self, context: HostContext) -> WindowsRemoteCompletionConfig: """Return the default settings.""" return filter_completion(windows_completion()).get(self.name) or windows_completion().get(self.platform) @@ -403,6 +417,7 @@ class NetworkConfig(HostConfig, metaclass=abc.ABCMeta): @dataclasses.dataclass class NetworkRemoteConfig(RemoteConfig, NetworkConfig): """Configuration for a remote network host.""" + collection: t.Optional[str] = None connection: t.Optional[str] = None @@ -431,6 +446,7 @@ class NetworkInventoryConfig(InventoryConfig, NetworkConfig): @dataclasses.dataclass class OriginConfig(ControllerHostConfig, PosixConfig): """Configuration for the origin host.""" + def get_defaults(self, context: HostContext) -> OriginCompletionConfig: """Return the default settings.""" return OriginCompletionConfig() @@ -448,6 +464,7 @@ class OriginConfig(ControllerHostConfig, PosixConfig): @dataclasses.dataclass class ControllerConfig(PosixConfig): """Configuration for the controller host.""" + controller: t.Optional[PosixConfig] = None def get_defaults(self, context: HostContext) -> PosixCompletionConfig: @@ -482,6 +499,7 @@ class ControllerConfig(PosixConfig): class FallbackReason(enum.Enum): """Reason fallback was performed.""" + ENVIRONMENT = enum.auto() PYTHON = enum.auto() @@ -489,6 +507,7 @@ class FallbackReason(enum.Enum): @dataclasses.dataclass(frozen=True) class FallbackDetail: """Details about controller fallback behavior.""" + reason: FallbackReason message: str @@ -496,6 +515,7 @@ class FallbackDetail: @dataclasses.dataclass(frozen=True) class HostSettings: """Host settings for the controller and targets.""" + controller: ControllerHostConfig targets: list[HostConfig] skipped_python_versions: list[str] diff --git a/test/lib/ansible_test/_internal/host_profiles.py b/test/lib/ansible_test/_internal/host_profiles.py index 0abc9961..a51eb693 100644 --- a/test/lib/ansible_test/_internal/host_profiles.py +++ b/test/lib/ansible_test/_internal/host_profiles.py @@ -139,6 +139,7 @@ TRemoteConfig = t.TypeVar('TRemoteConfig', bound=RemoteConfig) class ControlGroupError(ApplicationError): """Raised when the container host does not have the necessary cgroup support to run a container.""" + def __init__(self, args: CommonConfig, reason: str) -> None: engine = require_docker().command dd_wsl2 = get_docker_info(args).docker_desktop_wsl2 @@ -181,6 +182,7 @@ NOTE: These changes must be applied each time the container host is rebooted. @dataclasses.dataclass(frozen=True) class Inventory: """Simple representation of an Ansible inventory.""" + host_groups: dict[str, dict[str, dict[str, t.Union[str, int]]]] extra_groups: t.Optional[dict[str, list[str]]] = None @@ -226,12 +228,14 @@ class Inventory: class HostProfile(t.Generic[THostConfig], metaclass=abc.ABCMeta): """Base class for host profiles.""" - def __init__(self, - *, - args: EnvironmentConfig, - config: THostConfig, - targets: t.Optional[list[HostConfig]], - ) -> None: + + def __init__( + self, + *, + args: EnvironmentConfig, + config: THostConfig, + targets: t.Optional[list[HostConfig]], + ) -> None: self.args = args self.config = config self.controller = bool(targets) @@ -272,6 +276,7 @@ class HostProfile(t.Generic[THostConfig], metaclass=abc.ABCMeta): class PosixProfile(HostProfile[TPosixConfig], metaclass=abc.ABCMeta): """Base class for POSIX host profiles.""" + @property def python(self) -> PythonConfig: """ @@ -293,6 +298,7 @@ class PosixProfile(HostProfile[TPosixConfig], metaclass=abc.ABCMeta): class ControllerHostProfile(PosixProfile[TControllerHostConfig], metaclass=abc.ABCMeta): """Base class for profiles usable as a controller.""" + @abc.abstractmethod def get_origin_controller_connection(self) -> Connection: """Return a connection for accessing the host as a controller from the origin.""" @@ -304,6 +310,7 @@ class ControllerHostProfile(PosixProfile[TControllerHostConfig], metaclass=abc.A class SshTargetHostProfile(HostProfile[THostConfig], metaclass=abc.ABCMeta): """Base class for profiles offering SSH connectivity.""" + @abc.abstractmethod def get_controller_target_connections(self) -> list[SshConnection]: """Return SSH connection(s) for accessing the host as a target from the controller.""" @@ -311,6 +318,7 @@ class SshTargetHostProfile(HostProfile[THostConfig], metaclass=abc.ABCMeta): class RemoteProfile(SshTargetHostProfile[TRemoteConfig], metaclass=abc.ABCMeta): """Base class for remote instance profiles.""" + @property def core_ci_state(self) -> t.Optional[dict[str, str]]: """The saved Ansible Core CI state.""" @@ -387,6 +395,7 @@ class RemoteProfile(SshTargetHostProfile[TRemoteConfig], metaclass=abc.ABCMeta): class ControllerProfile(SshTargetHostProfile[ControllerConfig], PosixProfile[ControllerConfig]): """Host profile for the controller as a target.""" + def get_controller_target_connections(self) -> list[SshConnection]: """Return SSH connection(s) for accessing the host as a target from the controller.""" settings = SshConnectionDetail( @@ -409,6 +418,7 @@ class DockerProfile(ControllerHostProfile[DockerConfig], SshTargetHostProfile[Do @dataclasses.dataclass(frozen=True) class InitConfig: """Configuration details required to run the container init.""" + options: list[str] command: str command_privileged: bool @@ -1003,9 +1013,11 @@ class DockerProfile(ControllerHostProfile[DockerConfig], SshTargetHostProfile[Do display.info(last_error) if not self.args.delegate and not self.args.host_path: + def callback() -> None: """Callback to run during error display.""" self.on_target_failure() # when the controller is not delegated, report failures immediately + else: callback = None @@ -1105,6 +1117,7 @@ class NetworkInventoryProfile(HostProfile[NetworkInventoryConfig]): class NetworkRemoteProfile(RemoteProfile[NetworkRemoteConfig]): """Host profile for a network remote instance.""" + def wait(self) -> None: """Wait for the instance to be ready. Executed before delegation for the controller and after delegation for targets.""" self.wait_until_ready() @@ -1181,6 +1194,7 @@ class NetworkRemoteProfile(RemoteProfile[NetworkRemoteConfig]): class OriginProfile(ControllerHostProfile[OriginConfig]): """Host profile for origin.""" + def get_origin_controller_connection(self) -> LocalConnection: """Return a connection for accessing the host as a controller from the origin.""" return LocalConnection(self.args) @@ -1192,6 +1206,7 @@ class OriginProfile(ControllerHostProfile[OriginConfig]): class PosixRemoteProfile(ControllerHostProfile[PosixRemoteConfig], RemoteProfile[PosixRemoteConfig]): """Host profile for a POSIX remote instance.""" + def wait(self) -> None: """Wait for the instance to be ready. Executed before delegation for the controller and after delegation for targets.""" self.wait_until_ready() @@ -1298,6 +1313,7 @@ class PosixRemoteProfile(ControllerHostProfile[PosixRemoteConfig], RemoteProfile class PosixSshProfile(SshTargetHostProfile[PosixSshConfig], PosixProfile[PosixSshConfig]): """Host profile for a POSIX SSH instance.""" + def get_controller_target_connections(self) -> list[SshConnection]: """Return SSH connection(s) for accessing the host as a target from the controller.""" settings = SshConnectionDetail( @@ -1314,6 +1330,7 @@ class PosixSshProfile(SshTargetHostProfile[PosixSshConfig], PosixProfile[PosixSs class WindowsInventoryProfile(SshTargetHostProfile[WindowsInventoryConfig]): """Host profile for a Windows inventory.""" + def get_controller_target_connections(self) -> list[SshConnection]: """Return SSH connection(s) for accessing the host as a target from the controller.""" inventory = parse_inventory(self.args, self.config.path) @@ -1338,6 +1355,7 @@ class WindowsInventoryProfile(SshTargetHostProfile[WindowsInventoryConfig]): class WindowsRemoteProfile(RemoteProfile[WindowsRemoteConfig]): """Host profile for a Windows remote instance.""" + def wait(self) -> None: """Wait for the instance to be ready. Executed before delegation for the controller and after delegation for targets.""" self.wait_until_ready() diff --git a/test/lib/ansible_test/_internal/http.py b/test/lib/ansible_test/_internal/http.py index ca514470..8b4154bf 100644 --- a/test/lib/ansible_test/_internal/http.py +++ b/test/lib/ansible_test/_internal/http.py @@ -22,6 +22,7 @@ from .util_common import ( class HttpClient: """Make HTTP requests via curl.""" + def __init__(self, args: CommonConfig, always: bool = False, insecure: bool = False, proxy: t.Optional[str] = None) -> None: self.args = args self.always = always @@ -113,6 +114,7 @@ class HttpClient: class HttpResponse: """HTTP response from curl.""" + def __init__(self, method: str, url: str, status_code: int, response: str) -> None: self.method = method self.url = url @@ -129,6 +131,7 @@ class HttpResponse: class HttpError(ApplicationError): """HTTP response as an error.""" + def __init__(self, status: int, message: str) -> None: super().__init__('%s: %s' % (status, message)) self.status = status diff --git a/test/lib/ansible_test/_internal/io.py b/test/lib/ansible_test/_internal/io.py index 80d47699..eb745be4 100644 --- a/test/lib/ansible_test/_internal/io.py +++ b/test/lib/ansible_test/_internal/io.py @@ -34,12 +34,13 @@ def make_dirs(path: str) -> None: os.makedirs(to_bytes(path), exist_ok=True) -def write_json_file(path: str, - content: t.Any, - create_directories: bool = False, - formatted: bool = True, - encoder: t.Optional[t.Type[json.JSONEncoder]] = None, - ) -> str: +def write_json_file( + path: str, + content: t.Any, + create_directories: bool = False, + formatted: bool = True, + encoder: t.Optional[t.Type[json.JSONEncoder]] = None, +) -> str: """Write the given json content to the specified path, optionally creating missing directories.""" text_content = json.dumps(content, sort_keys=formatted, @@ -80,6 +81,7 @@ def open_binary_file(path: str, mode: str = 'rb') -> t.IO[bytes]: class SortedSetEncoder(json.JSONEncoder): """Encode sets as sorted lists.""" + def default(self, o: t.Any) -> t.Any: """Return a serialized version of the `o` object.""" if isinstance(o, set): diff --git a/test/lib/ansible_test/_internal/junit_xml.py b/test/lib/ansible_test/_internal/junit_xml.py index 3b958672..76c8878b 100644 --- a/test/lib/ansible_test/_internal/junit_xml.py +++ b/test/lib/ansible_test/_internal/junit_xml.py @@ -10,6 +10,7 @@ import datetime import decimal from xml.dom import minidom + # noinspection PyPep8Naming from xml.etree import ElementTree as ET @@ -17,6 +18,7 @@ from xml.etree import ElementTree as ET @dataclasses.dataclass # type: ignore[misc] # https://github.com/python/mypy/issues/5374 class TestResult(metaclass=abc.ABCMeta): """Base class for the result of a test case.""" + output: str | None = None message: str | None = None type: str | None = None @@ -48,6 +50,7 @@ class TestResult(metaclass=abc.ABCMeta): @dataclasses.dataclass class TestFailure(TestResult): """Failure info for a test case.""" + @property def tag(self) -> str: """Tag name for the XML element created by this result type.""" @@ -57,6 +60,7 @@ class TestFailure(TestResult): @dataclasses.dataclass class TestError(TestResult): """Error info for a test case.""" + @property def tag(self) -> str: """Tag name for the XML element created by this result type.""" @@ -66,6 +70,7 @@ class TestError(TestResult): @dataclasses.dataclass class TestCase: """An individual test case.""" + name: str assertions: int | None = None classname: str | None = None @@ -127,6 +132,7 @@ class TestCase: @dataclasses.dataclass class TestSuite: """A collection of test cases.""" + name: str hostname: str | None = None id: str | None = None @@ -138,6 +144,10 @@ class TestSuite: system_out: str | None = None system_err: str | None = None + def __post_init__(self): + if self.timestamp and self.timestamp.tzinfo != datetime.timezone.utc: + raise ValueError(f'timestamp.tzinfo must be {datetime.timezone.utc!r}') + @property def disabled(self) -> int: """The number of disabled test cases.""" @@ -181,7 +191,7 @@ class TestSuite: skipped=self.skipped, tests=self.tests, time=self.time, - timestamp=self.timestamp.isoformat(timespec='seconds') if self.timestamp else None, + timestamp=self.timestamp.replace(tzinfo=None).isoformat(timespec='seconds') if self.timestamp else None, ) def get_xml_element(self) -> ET.Element: @@ -205,6 +215,7 @@ class TestSuite: @dataclasses.dataclass class TestSuites: """A collection of test suites.""" + name: str | None = None suites: list[TestSuite] = dataclasses.field(default_factory=list) diff --git a/test/lib/ansible_test/_internal/locale_util.py b/test/lib/ansible_test/_internal/locale_util.py index 3fb74ad5..22ccce75 100644 --- a/test/lib/ansible_test/_internal/locale_util.py +++ b/test/lib/ansible_test/_internal/locale_util.py @@ -21,6 +21,7 @@ It was not needed in previous ansible-core releases since they do not verify the class LocaleError(SystemExit): """Exception to raise when locale related errors occur.""" + def __init__(self, message: str) -> None: super().__init__(f'ERROR: {message}') diff --git a/test/lib/ansible_test/_internal/metadata.py b/test/lib/ansible_test/_internal/metadata.py index 94bbc34a..b8b598e8 100644 --- a/test/lib/ansible_test/_internal/metadata.py +++ b/test/lib/ansible_test/_internal/metadata.py @@ -4,6 +4,7 @@ import typing as t from .util import ( display, + generate_name, ) from .io import ( @@ -19,12 +20,14 @@ from .diff import ( class Metadata: """Metadata object for passing data to delegated tests.""" + def __init__(self) -> None: """Initialize metadata.""" self.changes: dict[str, tuple[tuple[int, int], ...]] = {} self.cloud_config: t.Optional[dict[str, dict[str, t.Union[int, str, bool]]]] = None self.change_description: t.Optional[ChangeDescription] = None self.ci_provider: t.Optional[str] = None + self.session_id = generate_name() def populate_changes(self, diff: t.Optional[list[str]]) -> None: """Populate the changeset using the given diff.""" @@ -52,6 +55,7 @@ class Metadata: cloud_config=self.cloud_config, ci_provider=self.ci_provider, change_description=self.change_description.to_dict(), + session_id=self.session_id, ) def to_file(self, path: str) -> None: @@ -76,12 +80,14 @@ class Metadata: metadata.cloud_config = data['cloud_config'] metadata.ci_provider = data['ci_provider'] metadata.change_description = ChangeDescription.from_dict(data['change_description']) + metadata.session_id = data['session_id'] return metadata class ChangeDescription: """Description of changes.""" + def __init__(self) -> None: self.command: str = '' self.changed_paths: list[str] = [] diff --git a/test/lib/ansible_test/_internal/payload.py b/test/lib/ansible_test/_internal/payload.py index 94150cb4..10dde7b8 100644 --- a/test/lib/ansible_test/_internal/payload.py +++ b/test/lib/ansible_test/_internal/payload.py @@ -27,6 +27,7 @@ from .util import ( from .data import ( data_context, + PayloadConfig, ) from .util_common import ( @@ -44,11 +45,74 @@ def create_payload(args: CommonConfig, dst_path: str) -> None: return files = list(data_context().ansible_source) - filters = {} + permissions: dict[str, int] = {} + filters: dict[str, t.Callable[[tarfile.TarInfo], t.Optional[tarfile.TarInfo]]] = {} + + # Exclude vendored files from the payload. + # They may not be compatible with the delegated environment. + files = [ + (abs_path, rel_path) for abs_path, rel_path in files + if not rel_path.startswith('lib/ansible/_vendor/') + or rel_path == 'lib/ansible/_vendor/__init__.py' + ] + + def apply_permissions(tar_info: tarfile.TarInfo, mode: int) -> t.Optional[tarfile.TarInfo]: + """ + Apply the specified permissions to the given file. + Existing file type bits are preserved. + """ + tar_info.mode &= ~(stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO) + tar_info.mode |= mode + + return tar_info def make_executable(tar_info: tarfile.TarInfo) -> t.Optional[tarfile.TarInfo]: - """Make the given file executable.""" - tar_info.mode |= stat.S_IXUSR | stat.S_IXOTH | stat.S_IXGRP + """ + Make the given file executable and readable by all, and writeable by the owner. + Existing file type bits are preserved. + This ensures consistency of test results when using unprivileged users. + """ + return apply_permissions( + tar_info, + stat.S_IRUSR | stat.S_IRGRP | stat.S_IROTH | + stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH | + stat.S_IWUSR + ) # fmt: skip + + def make_non_executable(tar_info: tarfile.TarInfo) -> t.Optional[tarfile.TarInfo]: + """ + Make the given file readable by all, and writeable by the owner. + Existing file type bits are preserved. + This ensures consistency of test results when using unprivileged users. + """ + return apply_permissions( + tar_info, + stat.S_IRUSR | stat.S_IRGRP | stat.S_IROTH | + stat.S_IWUSR + ) # fmt: skip + + def detect_permissions(tar_info: tarfile.TarInfo) -> t.Optional[tarfile.TarInfo]: + """ + Detect and apply the appropriate permissions for a file. + Existing file type bits are preserved. + This ensures consistency of test results when using unprivileged users. + """ + if tar_info.path.startswith('ansible/'): + mode = permissions.get(os.path.relpath(tar_info.path, 'ansible')) + elif data_context().content.collection and is_subdir(tar_info.path, data_context().content.collection.directory): + mode = permissions.get(os.path.relpath(tar_info.path, data_context().content.collection.directory)) + else: + mode = None + + if mode: + tar_info = apply_permissions(tar_info, mode) + elif tar_info.mode & (stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH): + # If any execute bit is set, treat the file as executable. + # This ensures that sanity tests which check execute bits behave correctly. + tar_info = make_executable(tar_info) + else: + tar_info = make_non_executable(tar_info) + return tar_info if not ANSIBLE_SOURCE_ROOT: @@ -85,10 +149,15 @@ def create_payload(args: CommonConfig, dst_path: str) -> None: # there are no extra files when testing ansible itself extra_files = [] + payload_config = PayloadConfig( + files=content_files, + permissions=permissions, + ) + for callback in data_context().payload_callbacks: # execute callbacks only on the content paths # this is done before placing them in the appropriate subdirectory (see below) - callback(content_files) + callback(payload_config) # place ansible source files under the 'ansible' directory on the delegated host files = [(src, os.path.join('ansible', dst)) for src, dst in files] @@ -109,7 +178,7 @@ def create_payload(args: CommonConfig, dst_path: str) -> None: with tarfile.open(dst_path, mode='w:gz', compresslevel=4, format=tarfile.GNU_FORMAT) as tar: for src, dst in files: display.info('%s -> %s' % (src, dst), verbosity=4) - tar.add(src, dst, filter=filters.get(dst)) + tar.add(src, dst, filter=filters.get(dst, detect_permissions)) duration = time.time() - start payload_size_bytes = os.path.getsize(dst_path) diff --git a/test/lib/ansible_test/_internal/provider/__init__.py b/test/lib/ansible_test/_internal/provider/__init__.py index 61d7baf9..9b73ae72 100644 --- a/test/lib/ansible_test/_internal/provider/__init__.py +++ b/test/lib/ansible_test/_internal/provider/__init__.py @@ -16,11 +16,12 @@ def get_path_provider_classes(provider_type: t.Type[TPathProvider]) -> list[t.Ty return sorted(get_subclasses(provider_type), key=lambda subclass: (subclass.priority, subclass.__name__)) -def find_path_provider(provider_type: t.Type[TPathProvider], - provider_classes: list[t.Type[TPathProvider]], - path: str, - walk: bool, - ) -> TPathProvider: +def find_path_provider( + provider_type: t.Type[TPathProvider], + provider_classes: list[t.Type[TPathProvider]], + path: str, + walk: bool, +) -> TPathProvider: """Return the first found path provider of the given type for the given path.""" sequences = sorted(set(pc.sequence for pc in provider_classes if pc.sequence > 0)) @@ -48,6 +49,7 @@ def find_path_provider(provider_type: t.Type[TPathProvider], class ProviderNotFoundForPath(ApplicationError): """Exception generated when a path based provider cannot be found for a given path.""" + def __init__(self, provider_type: t.Type, path: str) -> None: super().__init__('No %s found for path: %s' % (provider_type.__name__, path)) @@ -57,6 +59,7 @@ class ProviderNotFoundForPath(ApplicationError): class PathProvider(metaclass=abc.ABCMeta): """Base class for provider plugins that are path based.""" + sequence = 500 priority = 500 diff --git a/test/lib/ansible_test/_internal/provider/layout/__init__.py b/test/lib/ansible_test/_internal/provider/layout/__init__.py index aa6693f0..4eca05ce 100644 --- a/test/lib/ansible_test/_internal/provider/layout/__init__.py +++ b/test/lib/ansible_test/_internal/provider/layout/__init__.py @@ -17,10 +17,12 @@ from .. import ( class Layout: """Description of content locations and helper methods to access content.""" - def __init__(self, - root: str, - paths: list[str], - ) -> None: + + def __init__( + self, + root: str, + paths: list[str], + ) -> None: self.root = root self.__paths = paths # contains both file paths and symlinked directory paths (ending with os.path.sep) @@ -74,25 +76,27 @@ class Layout: class ContentLayout(Layout): """Information about the current Ansible content being tested.""" - def __init__(self, - root: str, - paths: list[str], - plugin_paths: dict[str, str], - collection: t.Optional[CollectionDetail], - test_path: str, - results_path: str, - sanity_path: str, - sanity_messages: t.Optional[LayoutMessages], - integration_path: str, - integration_targets_path: str, - integration_vars_path: str, - integration_messages: t.Optional[LayoutMessages], - unit_path: str, - unit_module_path: str, - unit_module_utils_path: str, - unit_messages: t.Optional[LayoutMessages], - unsupported: bool = False, - ) -> None: + + def __init__( + self, + root: str, + paths: list[str], + plugin_paths: dict[str, str], + collection: t.Optional[CollectionDetail], + test_path: str, + results_path: str, + sanity_path: str, + sanity_messages: t.Optional[LayoutMessages], + integration_path: str, + integration_targets_path: str, + integration_vars_path: str, + integration_messages: t.Optional[LayoutMessages], + unit_path: str, + unit_module_path: str, + unit_module_utils_path: str, + unit_messages: t.Optional[LayoutMessages], + unsupported: bool = False, + ) -> None: super().__init__(root, paths) self.plugin_paths = plugin_paths @@ -150,6 +154,7 @@ class ContentLayout(Layout): class LayoutMessages: """Messages generated during layout creation that should be deferred for later display.""" + def __init__(self) -> None: self.info: list[str] = [] self.warning: list[str] = [] @@ -158,11 +163,13 @@ class LayoutMessages: class CollectionDetail: """Details about the layout of the current collection.""" - def __init__(self, - name: str, - namespace: str, - root: str, - ) -> None: + + def __init__( + self, + name: str, + namespace: str, + root: str, + ) -> None: self.name = name self.namespace = namespace self.root = root @@ -173,6 +180,7 @@ class CollectionDetail: class LayoutProvider(PathProvider): """Base class for layout providers.""" + PLUGIN_TYPES = ( 'action', 'become', diff --git a/test/lib/ansible_test/_internal/provider/layout/ansible.py b/test/lib/ansible_test/_internal/provider/layout/ansible.py index e8d01919..d2f8cc81 100644 --- a/test/lib/ansible_test/_internal/provider/layout/ansible.py +++ b/test/lib/ansible_test/_internal/provider/layout/ansible.py @@ -11,6 +11,7 @@ from . import ( class AnsibleLayout(LayoutProvider): """Layout provider for Ansible source.""" + @staticmethod def is_content_root(path: str) -> bool: """Return True if the given path is a content root for this provider.""" @@ -20,25 +21,26 @@ class AnsibleLayout(LayoutProvider): """Create a Layout using the given root and paths.""" plugin_paths = dict((p, os.path.join('lib/ansible/plugins', p)) for p in self.PLUGIN_TYPES) - plugin_paths.update(dict( + plugin_paths.update( modules='lib/ansible/modules', module_utils='lib/ansible/module_utils', - )) - - return ContentLayout(root, - paths, - plugin_paths=plugin_paths, - collection=None, - test_path='test', - results_path='test/results', - sanity_path='test/sanity', - sanity_messages=None, - integration_path='test/integration', - integration_targets_path='test/integration/targets', - integration_vars_path='test/integration/integration_config.yml', - integration_messages=None, - unit_path='test/units', - unit_module_path='test/units/modules', - unit_module_utils_path='test/units/module_utils', - unit_messages=None, - ) + ) + + return ContentLayout( + root, + paths, + plugin_paths=plugin_paths, + collection=None, + test_path='test', + results_path='test/results', + sanity_path='test/sanity', + sanity_messages=None, + integration_path='test/integration', + integration_targets_path='test/integration/targets', + integration_vars_path='test/integration/integration_config.yml', + integration_messages=None, + unit_path='test/units', + unit_module_path='test/units/modules', + unit_module_utils_path='test/units/module_utils', + unit_messages=None, + ) diff --git a/test/lib/ansible_test/_internal/provider/layout/collection.py b/test/lib/ansible_test/_internal/provider/layout/collection.py index 299d0bc6..d747f31f 100644 --- a/test/lib/ansible_test/_internal/provider/layout/collection.py +++ b/test/lib/ansible_test/_internal/provider/layout/collection.py @@ -17,6 +17,7 @@ from ...util import ( class CollectionLayout(LayoutProvider): """Layout provider for Ansible collections.""" + @staticmethod def is_content_root(path: str) -> bool: """Return True if the given path is a content root for this provider.""" @@ -52,28 +53,29 @@ class CollectionLayout(LayoutProvider): integration_targets_path = self.__check_integration_path(paths, integration_messages) self.__check_unit_path(paths, unit_messages) - return ContentLayout(root, - paths, - plugin_paths=plugin_paths, - collection=CollectionDetail( - name=collection_name, - namespace=collection_namespace, - root=collection_root, - ), - test_path='tests', - results_path='tests/output', - sanity_path='tests/sanity', - sanity_messages=sanity_messages, - integration_path='tests/integration', - integration_targets_path=integration_targets_path.rstrip(os.path.sep), - integration_vars_path='tests/integration/integration_config.yml', - integration_messages=integration_messages, - unit_path='tests/unit', - unit_module_path='tests/unit/plugins/modules', - unit_module_utils_path='tests/unit/plugins/module_utils', - unit_messages=unit_messages, - unsupported=not (is_valid_identifier(collection_namespace) and is_valid_identifier(collection_name)), - ) + return ContentLayout( + root, + paths, + plugin_paths=plugin_paths, + collection=CollectionDetail( + name=collection_name, + namespace=collection_namespace, + root=collection_root, + ), + test_path='tests', + results_path='tests/output', + sanity_path='tests/sanity', + sanity_messages=sanity_messages, + integration_path='tests/integration', + integration_targets_path=integration_targets_path.rstrip(os.path.sep), + integration_vars_path='tests/integration/integration_config.yml', + integration_messages=integration_messages, + unit_path='tests/unit', + unit_module_path='tests/unit/plugins/modules', + unit_module_utils_path='tests/unit/plugins/module_utils', + unit_messages=unit_messages, + unsupported=not (is_valid_identifier(collection_namespace) and is_valid_identifier(collection_name)), + ) @staticmethod def __check_test_path(paths: list[str], messages: LayoutMessages) -> None: diff --git a/test/lib/ansible_test/_internal/provider/layout/unsupported.py b/test/lib/ansible_test/_internal/provider/layout/unsupported.py index 16aa254c..e3d81e63 100644 --- a/test/lib/ansible_test/_internal/provider/layout/unsupported.py +++ b/test/lib/ansible_test/_internal/provider/layout/unsupported.py @@ -9,6 +9,7 @@ from . import ( class UnsupportedLayout(LayoutProvider): """Layout provider for an unsupported directory layout.""" + sequence = 0 # disable automatic detection @staticmethod @@ -20,21 +21,22 @@ class UnsupportedLayout(LayoutProvider): """Create a Layout using the given root and paths.""" plugin_paths = dict((p, p) for p in self.PLUGIN_TYPES) - return ContentLayout(root, - paths, - plugin_paths=plugin_paths, - collection=None, - test_path='', - results_path='', - sanity_path='', - sanity_messages=None, - integration_path='', - integration_targets_path='', - integration_vars_path='', - integration_messages=None, - unit_path='', - unit_module_path='', - unit_module_utils_path='', - unit_messages=None, - unsupported=True, - ) + return ContentLayout( + root, + paths, + plugin_paths=plugin_paths, + collection=None, + test_path='', + results_path='', + sanity_path='', + sanity_messages=None, + integration_path='', + integration_targets_path='', + integration_vars_path='', + integration_messages=None, + unit_path='', + unit_module_path='', + unit_module_utils_path='', + unit_messages=None, + unsupported=True, + ) diff --git a/test/lib/ansible_test/_internal/provider/source/__init__.py b/test/lib/ansible_test/_internal/provider/source/__init__.py index aa8ca47f..68fe380f 100644 --- a/test/lib/ansible_test/_internal/provider/source/__init__.py +++ b/test/lib/ansible_test/_internal/provider/source/__init__.py @@ -10,6 +10,7 @@ from .. import ( class SourceProvider(PathProvider): """Base class for source providers.""" + @abc.abstractmethod def get_paths(self, path: str) -> list[str]: """Return the list of available content paths under the given path.""" diff --git a/test/lib/ansible_test/_internal/provider/source/git.py b/test/lib/ansible_test/_internal/provider/source/git.py index 37f16bfa..f8637edd 100644 --- a/test/lib/ansible_test/_internal/provider/source/git.py +++ b/test/lib/ansible_test/_internal/provider/source/git.py @@ -22,6 +22,7 @@ from . import ( class GitSource(SourceProvider): """Source provider for a content root managed by git version control.""" + @staticmethod def is_content_root(path: str) -> bool: """Return True if the given path is a content root for this provider.""" diff --git a/test/lib/ansible_test/_internal/provider/source/installed.py b/test/lib/ansible_test/_internal/provider/source/installed.py index 6b821888..1e5a6ba2 100644 --- a/test/lib/ansible_test/_internal/provider/source/installed.py +++ b/test/lib/ansible_test/_internal/provider/source/installed.py @@ -10,6 +10,7 @@ from . import ( class InstalledSource(SourceProvider): """Source provider for content which has been installed.""" + sequence = 0 # disable automatic detection @staticmethod diff --git a/test/lib/ansible_test/_internal/provider/source/unsupported.py b/test/lib/ansible_test/_internal/provider/source/unsupported.py index e2f8953e..caa49941 100644 --- a/test/lib/ansible_test/_internal/provider/source/unsupported.py +++ b/test/lib/ansible_test/_internal/provider/source/unsupported.py @@ -8,6 +8,7 @@ from . import ( class UnsupportedSource(SourceProvider): """Source provider to use when the layout is unsupported.""" + sequence = 0 # disable automatic detection @staticmethod diff --git a/test/lib/ansible_test/_internal/provider/source/unversioned.py b/test/lib/ansible_test/_internal/provider/source/unversioned.py index d8eff5d1..699de889 100644 --- a/test/lib/ansible_test/_internal/provider/source/unversioned.py +++ b/test/lib/ansible_test/_internal/provider/source/unversioned.py @@ -18,6 +18,7 @@ from . import ( class UnversionedSource(SourceProvider): """Fallback source provider when no other provider matches the content root.""" + sequence = 0 # disable automatic detection @staticmethod diff --git a/test/lib/ansible_test/_internal/provisioning.py b/test/lib/ansible_test/_internal/provisioning.py index 7547a302..e7f0fd31 100644 --- a/test/lib/ansible_test/_internal/provisioning.py +++ b/test/lib/ansible_test/_internal/provisioning.py @@ -55,6 +55,7 @@ class PrimeContainers(ApplicationError): @dataclasses.dataclass(frozen=True) class HostState: """State of hosts and profiles to be passed to ansible-test during delegation.""" + controller_profile: ControllerHostProfile target_profiles: list[HostProfile] diff --git a/test/lib/ansible_test/_internal/python_requirements.py b/test/lib/ansible_test/_internal/python_requirements.py index e3733a5c..fc88b637 100644 --- a/test/lib/ansible_test/_internal/python_requirements.py +++ b/test/lib/ansible_test/_internal/python_requirements.py @@ -48,6 +48,7 @@ from .data import ( from .host_configs import ( PosixConfig, PythonConfig, + VirtualPythonConfig, ) from .connections import ( @@ -70,13 +71,14 @@ VIRTUALENV_VERSION = '16.7.12' class PipUnavailableError(ApplicationError): """Exception raised when pip is not available.""" + def __init__(self, python: PythonConfig) -> None: super().__init__(f'Python {python.version} at "{python.path}" does not have pip available.') @dataclasses.dataclass(frozen=True) class PipCommand: - """Base class for pip commands.""""" + """Base class for pip commands.""" def serialize(self) -> tuple[str, dict[str, t.Any]]: """Return a serialized representation of this command.""" @@ -87,6 +89,7 @@ class PipCommand: @dataclasses.dataclass(frozen=True) class PipInstall(PipCommand): """Details required to perform a pip install.""" + requirements: list[tuple[str, str]] constraints: list[tuple[str, str]] packages: list[str] @@ -102,6 +105,7 @@ class PipInstall(PipCommand): @dataclasses.dataclass(frozen=True) class PipUninstall(PipCommand): """Details required to perform a pip uninstall.""" + packages: list[str] ignore_errors: bool @@ -114,6 +118,7 @@ class PipVersion(PipCommand): @dataclasses.dataclass(frozen=True) class PipBootstrap(PipCommand): """Details required to bootstrap pip.""" + pip_version: str packages: list[str] @@ -261,6 +266,20 @@ def run_pip( connection = connection or LocalConnection(args) script = prepare_pip_script(commands) + if isinstance(args, IntegrationConfig): + # Integration tests can involve two hosts (controller and target). + # The connection type can be used to disambiguate between the two. + context = " (controller)" if isinstance(connection, LocalConnection) else " (target)" + else: + context = "" + + if isinstance(python, VirtualPythonConfig): + context += " [venv]" + + # The interpreter path is not included below. + # It can be seen by running ansible-test with increased verbosity (showing all commands executed). + display.info(f'Installing requirements for Python {python.version}{context}') + if not args.explain: try: connection.run([python.path], data=script, capture=False) diff --git a/test/lib/ansible_test/_internal/ssh.py b/test/lib/ansible_test/_internal/ssh.py index 840edf62..b2a26787 100644 --- a/test/lib/ansible_test/_internal/ssh.py +++ b/test/lib/ansible_test/_internal/ssh.py @@ -32,6 +32,7 @@ from .config import ( @dataclasses.dataclass class SshConnectionDetail: """Information needed to establish an SSH connection to a host.""" + name: str host: str port: t.Optional[int] @@ -56,7 +57,7 @@ class SshConnectionDetail: # See: https://www.openssh.com/txt/release-8.8 algorithms = '+ssh-rsa' # append the algorithm to the default list, requires OpenSSH 7.0 or later - options.update(dict( + options.update( # Host key signature algorithms that the client wants to use. # Available options can be found with `ssh -Q HostKeyAlgorithms` or `ssh -Q key` on older clients. # This option was updated in OpenSSH 7.0, released on 2015-08-11, to support the "+" prefix. @@ -69,13 +70,14 @@ class SshConnectionDetail: # This option is an alias for PubkeyAcceptedAlgorithms, which was added in OpenSSH 8.5. # See: https://www.openssh.com/txt/release-8.5 PubkeyAcceptedKeyTypes=algorithms, - )) + ) return options class SshProcess: """Wrapper around an SSH process.""" + def __init__(self, process: t.Optional[subprocess.Popen]) -> None: self._process = process self.pending_forwards: t.Optional[list[tuple[str, int]]] = None @@ -161,7 +163,7 @@ def create_ssh_command( 'ssh', '-n', # prevent reading from stdin '-i', ssh.identity_file, # file from which the identity for public key authentication is read - ] + ] # fmt: skip if not command: cmd.append('-N') # do not execute a remote command diff --git a/test/lib/ansible_test/_internal/target.py b/test/lib/ansible_test/_internal/target.py index 80411483..a6fa3bf2 100644 --- a/test/lib/ansible_test/_internal/target.py +++ b/test/lib/ansible_test/_internal/target.py @@ -86,11 +86,12 @@ def walk_internal_targets( return tuple(sorted(internal_targets, key=lambda sort_target: sort_target.name)) -def filter_targets(targets: c.Iterable[TCompletionTarget], - patterns: list[str], - include: bool = True, - errors: bool = True, - ) -> c.Iterable[TCompletionTarget]: +def filter_targets( + targets: c.Iterable[TCompletionTarget], + patterns: list[str], + include: bool = True, + errors: bool = True, +) -> c.Iterable[TCompletionTarget]: """Iterate over the given targets and filter them based on the supplied arguments.""" unmatched = set(patterns or ()) compiled_patterns = dict((p, re.compile('^%s$' % p)) for p in patterns) if patterns else None @@ -401,6 +402,7 @@ def analyze_integration_target_dependencies(integration_targets: list[Integratio class CompletionTarget(metaclass=abc.ABCMeta): """Command-line argument completion target base class.""" + def __init__(self) -> None: self.name = '' self.path = '' @@ -435,6 +437,7 @@ class CompletionTarget(metaclass=abc.ABCMeta): class TestTarget(CompletionTarget): """Generic test target.""" + def __init__( self, path: str, @@ -476,6 +479,7 @@ class TestTarget(CompletionTarget): class IntegrationTargetType(enum.Enum): """Type of integration test target.""" + CONTROLLER = enum.auto() TARGET = enum.auto() UNKNOWN = enum.auto() @@ -606,13 +610,9 @@ class IntegrationTarget(CompletionTarget): if 'needs/httptester' in groups: groups.append('cloud/httptester') # backwards compatibility for when it was not a cloud plugin - if '_' in self.name: - prefix = self.name[:self.name.find('_')] - else: - prefix = None - - if prefix in prefixes: - group = prefixes[prefix] + for prefix, group in prefixes.items(): + if not self.name.startswith(f'{prefix}_'): + continue if group != prefix: group = '%s/%s' % (group, prefix) @@ -692,6 +692,7 @@ class IntegrationTarget(CompletionTarget): class TargetPatternsNotMatched(ApplicationError): """One or more targets were not matched when a match was required.""" + def __init__(self, patterns: set[str]) -> None: self.patterns = sorted(patterns) diff --git a/test/lib/ansible_test/_internal/test.py b/test/lib/ansible_test/_internal/test.py index 211635c5..c36d17e2 100644 --- a/test/lib/ansible_test/_internal/test.py +++ b/test/lib/ansible_test/_internal/test.py @@ -47,7 +47,7 @@ def calculate_confidence(path: str, line: int, metadata: Metadata) -> int: return 0 # changes were made to the same file and line - if any(r[0] <= line <= r[1] in r for r in ranges): + if any(r[0] <= line <= r[1] for r in ranges): return 100 # changes were made to the same file and the line number is unknown @@ -60,6 +60,7 @@ def calculate_confidence(path: str, line: int, metadata: Metadata) -> int: class TestResult: """Base class for test results.""" + def __init__(self, command: str, test: str, python_version: t.Optional[str] = None) -> None: self.command = command self.test = test @@ -113,7 +114,7 @@ class TestResult: junit_xml.TestSuite( name='ansible-test', cases=[test_case], - timestamp=datetime.datetime.utcnow(), + timestamp=datetime.datetime.now(tz=datetime.timezone.utc), ), ], ) @@ -128,7 +129,8 @@ class TestResult: class TestTimeout(TestResult): """Test timeout.""" - def __init__(self, timeout_duration: int) -> None: + + def __init__(self, timeout_duration: int | float) -> None: super().__init__(command='timeout', test='') self.timeout_duration = timeout_duration @@ -151,13 +153,11 @@ One or more of the following situations may be responsible: output += '\n\nConsult the console log for additional details on where the timeout occurred.' - timestamp = datetime.datetime.utcnow() - suites = junit_xml.TestSuites( suites=[ junit_xml.TestSuite( name='ansible-test', - timestamp=timestamp, + timestamp=datetime.datetime.now(tz=datetime.timezone.utc), cases=[ junit_xml.TestCase( name='timeout', @@ -180,6 +180,7 @@ One or more of the following situations may be responsible: class TestSuccess(TestResult): """Test success.""" + def write_junit(self, args: TestConfig) -> None: """Write results to a junit XML file.""" test_case = junit_xml.TestCase(classname=self.command, name=self.name) @@ -189,6 +190,7 @@ class TestSuccess(TestResult): class TestSkipped(TestResult): """Test skipped.""" + def __init__(self, command: str, test: str, python_version: t.Optional[str] = None) -> None: super().__init__(command, test, python_version) @@ -214,6 +216,7 @@ class TestSkipped(TestResult): class TestFailure(TestResult): """Test failure.""" + def __init__( self, command: str, @@ -378,6 +381,7 @@ class TestFailure(TestResult): class TestMessage: """Single test message for one file.""" + def __init__( self, message: str, diff --git a/test/lib/ansible_test/_internal/thread.py b/test/lib/ansible_test/_internal/thread.py index edaf1b5c..c4574377 100644 --- a/test/lib/ansible_test/_internal/thread.py +++ b/test/lib/ansible_test/_internal/thread.py @@ -15,6 +15,7 @@ TCallable = t.TypeVar('TCallable', bound=t.Callable[..., t.Any]) class WrappedThread(threading.Thread): """Wrapper around Thread which captures results and exceptions.""" + def __init__(self, action: c.Callable[[], t.Any]) -> None: super().__init__() self._result: queue.Queue[t.Any] = queue.Queue() diff --git a/test/lib/ansible_test/_internal/timeout.py b/test/lib/ansible_test/_internal/timeout.py index 90ba5835..2c57d4cf 100644 --- a/test/lib/ansible_test/_internal/timeout.py +++ b/test/lib/ansible_test/_internal/timeout.py @@ -1,6 +1,7 @@ """Timeout management for tests.""" from __future__ import annotations +import dataclasses import datetime import functools import os @@ -19,7 +20,7 @@ from .config import ( from .util import ( display, - ApplicationError, + TimeoutExpiredError, ) from .thread import ( @@ -35,15 +36,56 @@ from .test import ( ) -def get_timeout() -> t.Optional[dict[str, t.Any]]: - """Return details about the currently set timeout, if any, otherwise return None.""" - if not os.path.exists(TIMEOUT_PATH): - return None +@dataclasses.dataclass(frozen=True) +class TimeoutDetail: + """Details required to enforce a timeout on test execution.""" + + _DEADLINE_FORMAT = '%Y-%m-%dT%H:%M:%SZ' # format used to maintain backwards compatibility with previous versions of ansible-test + + deadline: datetime.datetime + duration: int | float # minutes + + @property + def remaining(self) -> datetime.timedelta: + """The amount of time remaining before the timeout occurs. If the timeout has passed, this will be a negative duration.""" + return self.deadline - datetime.datetime.now(tz=datetime.timezone.utc).replace(microsecond=0) + + def to_dict(self) -> dict[str, t.Any]: + """Return timeout details as a dictionary suitable for JSON serialization.""" + return dict( + deadline=self.deadline.strftime(self._DEADLINE_FORMAT), + duration=self.duration, + ) - data = read_json_file(TIMEOUT_PATH) - data['deadline'] = datetime.datetime.strptime(data['deadline'], '%Y-%m-%dT%H:%M:%SZ') + @staticmethod + def from_dict(value: dict[str, t.Any]) -> TimeoutDetail: + """Return a TimeoutDetail instance using the value previously returned by to_dict.""" + return TimeoutDetail( + deadline=datetime.datetime.strptime(value['deadline'], TimeoutDetail._DEADLINE_FORMAT).replace(tzinfo=datetime.timezone.utc), + duration=value['duration'], + ) - return data + @staticmethod + def create(duration: int | float) -> TimeoutDetail | None: + """Return a new TimeoutDetail instance for the specified duration (in minutes), or None if the duration is zero.""" + if not duration: + return None + + if duration == int(duration): + duration = int(duration) + + return TimeoutDetail( + deadline=datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0) + datetime.timedelta(seconds=int(duration * 60)), + duration=duration, + ) + + +def get_timeout() -> TimeoutDetail | None: + """Return details about the currently set timeout, if any, otherwise return None.""" + try: + return TimeoutDetail.from_dict(read_json_file(TIMEOUT_PATH)) + except FileNotFoundError: + return None def configure_timeout(args: CommonConfig) -> None: @@ -59,27 +101,22 @@ def configure_test_timeout(args: TestConfig) -> None: if not timeout: return - timeout_start = datetime.datetime.utcnow() - timeout_duration = timeout['duration'] - timeout_deadline = timeout['deadline'] - timeout_remaining = timeout_deadline - timeout_start + timeout_remaining = timeout.remaining - test_timeout = TestTimeout(timeout_duration) + test_timeout = TestTimeout(timeout.duration) if timeout_remaining <= datetime.timedelta(): test_timeout.write(args) - raise ApplicationError('The %d minute test timeout expired %s ago at %s.' % ( - timeout_duration, timeout_remaining * -1, timeout_deadline)) + raise TimeoutExpiredError(f'The {timeout.duration} minute test timeout expired {timeout_remaining * -1} ago at {timeout.deadline}.') - display.info('The %d minute test timeout expires in %s at %s.' % ( - timeout_duration, timeout_remaining, timeout_deadline), verbosity=1) + display.info(f'The {timeout.duration} minute test timeout expires in {timeout_remaining} at {timeout.deadline}.', verbosity=1) def timeout_handler(_dummy1: t.Any, _dummy2: t.Any) -> None: """Runs when SIGUSR1 is received.""" test_timeout.write(args) - raise ApplicationError('Tests aborted after exceeding the %d minute time limit.' % timeout_duration) + raise TimeoutExpiredError(f'Tests aborted after exceeding the {timeout.duration} minute time limit.') def timeout_waiter(timeout_seconds: int) -> None: """Background thread which will kill the current process if the timeout elapses.""" @@ -88,6 +125,6 @@ def configure_test_timeout(args: TestConfig) -> None: signal.signal(signal.SIGUSR1, timeout_handler) - instance = WrappedThread(functools.partial(timeout_waiter, timeout_remaining.seconds)) + instance = WrappedThread(functools.partial(timeout_waiter, timeout_remaining.total_seconds())) instance.daemon = True instance.start() diff --git a/test/lib/ansible_test/_internal/util.py b/test/lib/ansible_test/_internal/util.py index ec485a2b..a5a9faba 100644 --- a/test/lib/ansible_test/_internal/util.py +++ b/test/lib/ansible_test/_internal/util.py @@ -23,10 +23,14 @@ import time import functools import shlex import typing as t +import warnings from struct import unpack, pack from termios import TIOCGWINSZ +# CAUTION: Avoid third-party imports in this module whenever possible. +# Any third-party imports occurring here will result in an error if they are vendored by ansible-core. + try: from typing_extensions import TypeGuard # TypeGuard was added in Python 3.10 except ImportError: @@ -129,6 +133,7 @@ class Architecture: Normalized architecture names. These are the architectures supported by ansible-test, such as when provisioning remote instances. """ + X86_64 = 'x86_64' AARCH64 = 'aarch64' @@ -338,6 +343,17 @@ def get_ansible_version() -> str: return ansible_version +def _enable_vendoring() -> None: + """Enable support for loading Python packages vendored by ansible-core.""" + # Load the vendoring code by file path, since ansible may not be in our sys.path. + # Convert warnings into errors, to avoid problems from surfacing later. + + with warnings.catch_warnings(): + warnings.filterwarnings('error') + + load_module(os.path.join(ANSIBLE_LIB_ROOT, '_vendor', '__init__.py'), 'ansible_vendor') + + @cache def get_available_python_versions() -> dict[str, str]: """Return a dictionary indicating which supported Python versions are available.""" @@ -553,6 +569,7 @@ def communicate_with_process( class WriterThread(WrappedThread): """Thread to write data to stdin of a subprocess.""" + def __init__(self, handle: t.IO[bytes], data: bytes) -> None: super().__init__(self._run) @@ -570,6 +587,7 @@ class WriterThread(WrappedThread): class ReaderThread(WrappedThread, metaclass=abc.ABCMeta): """Thread to read stdout from a subprocess.""" + def __init__(self, handle: t.IO[bytes], buffer: t.BinaryIO) -> None: super().__init__(self._run) @@ -584,6 +602,7 @@ class ReaderThread(WrappedThread, metaclass=abc.ABCMeta): class CaptureThread(ReaderThread): """Thread to capture stdout from a subprocess into a buffer.""" + def _run(self) -> None: """Workload to run on a thread.""" src = self.handle @@ -598,6 +617,7 @@ class CaptureThread(ReaderThread): class OutputThread(ReaderThread): """Thread to pass stdout from a subprocess to stdout.""" + def _run(self) -> None: """Workload to run on a thread.""" src = self.handle @@ -778,6 +798,7 @@ def generate_password() -> str: class Display: """Manages color console output.""" + clear = '\033[0m' red = '\033[31m' green = '\033[32m' @@ -886,6 +907,7 @@ class Display: class InternalError(Exception): """An unhandled internal error indicating a bug in the code.""" + def __init__(self, message: str) -> None: super().__init__(f'An internal error has occurred in ansible-test: {message}') @@ -898,8 +920,13 @@ class ApplicationWarning(Exception): """General application warning which interrupts normal program flow.""" +class TimeoutExpiredError(SystemExit): + """Error raised when the test timeout has been reached or exceeded.""" + + class SubprocessError(ApplicationError): """Error resulting from failed subprocess execution.""" + def __init__( self, cmd: list[str], @@ -936,6 +963,7 @@ class SubprocessError(ApplicationError): class MissingEnvironmentVariable(ApplicationError): """Error caused by missing environment variable.""" + def __init__(self, name: str) -> None: super().__init__('Missing environment variable: %s' % name) @@ -948,6 +976,7 @@ class HostConnectionError(ApplicationError): Raised by provisioning code when one or more provisioning threads raise this exception. Also raised when an SSH connection fails for the shell command. """ + def __init__(self, message: str, callback: t.Callable[[], None] = None) -> None: super().__init__(message) @@ -1144,3 +1173,5 @@ def type_guard(sequence: c.Sequence[t.Any], guard_type: t.Type[C]) -> TypeGuard[ display = Display() # pylint: disable=locally-disabled, invalid-name + +_enable_vendoring() diff --git a/test/lib/ansible_test/_internal/util_common.py b/test/lib/ansible_test/_internal/util_common.py index 1dfc7f38..79ff6c03 100644 --- a/test/lib/ansible_test/_internal/util_common.py +++ b/test/lib/ansible_test/_internal/util_common.py @@ -66,6 +66,7 @@ CHECK_YAML_VERSIONS: dict[str, t.Any] = {} class ShellScriptTemplate: """A simple substitution template for shell scripts.""" + def __init__(self, template: str) -> None: self.template = template @@ -87,6 +88,7 @@ class ShellScriptTemplate: class ResultType: """Test result type.""" + BOT: ResultType = None COVERAGE: ResultType = None DATA: ResultType = None @@ -128,6 +130,7 @@ ResultType._populate() # pylint: disable=protected-access class CommonConfig: """Configuration common to all commands.""" + def __init__(self, args: t.Any, command: str) -> None: self.command = command self.interactive = False @@ -237,12 +240,13 @@ def named_temporary_file(args: CommonConfig, prefix: str, suffix: str, directory yield tempfile_fd.name -def write_json_test_results(category: ResultType, - name: str, - content: t.Union[list[t.Any], dict[str, t.Any]], - formatted: bool = True, - encoder: t.Optional[t.Type[json.JSONEncoder]] = None, - ) -> None: +def write_json_test_results( + category: ResultType, + name: str, + content: t.Union[list[t.Any], dict[str, t.Any]], + formatted: bool = True, + encoder: t.Optional[t.Type[json.JSONEncoder]] = None, +) -> None: """Write the given json content to the specified test results path, creating directories as needed.""" path = os.path.join(category.path, name) write_json_file(path, content, create_directories=True, formatted=formatted, encoder=encoder) @@ -445,8 +449,21 @@ def run_command( ) -> tuple[t.Optional[str], t.Optional[str]]: """Run the specified command and return stdout and stderr as a tuple.""" explain = args.explain and not always - return raw_command(cmd, capture=capture, env=env, data=data, cwd=cwd, explain=explain, stdin=stdin, stdout=stdout, interactive=interactive, - output_stream=output_stream, cmd_verbosity=cmd_verbosity, str_errors=str_errors, error_callback=error_callback) + return raw_command( + cmd, + capture=capture, + env=env, + data=data, + cwd=cwd, + explain=explain, + stdin=stdin, + stdout=stdout, + interactive=interactive, + output_stream=output_stream, + cmd_verbosity=cmd_verbosity, + str_errors=str_errors, + error_callback=error_callback, + ) def yamlcheck(python: PythonConfig) -> t.Optional[bool]: diff --git a/test/lib/ansible_test/_internal/venv.py b/test/lib/ansible_test/_internal/venv.py index ec498ed9..a83fc8b9 100644 --- a/test/lib/ansible_test/_internal/venv.py +++ b/test/lib/ansible_test/_internal/venv.py @@ -78,12 +78,13 @@ def get_virtual_python( return virtual_environment_python -def create_virtual_environment(args: EnvironmentConfig, - python: PythonConfig, - path: str, - system_site_packages: bool = False, - pip: bool = False, - ) -> bool: +def create_virtual_environment( + args: EnvironmentConfig, + python: PythonConfig, + path: str, + system_site_packages: bool = False, + pip: bool = False, +) -> bool: """Create a virtual environment using venv or virtualenv for the requested Python version.""" if not os.path.exists(python.path): # the requested python version could not be found @@ -180,12 +181,13 @@ def get_python_real_prefix(python_path: str) -> t.Optional[str]: return real_prefix -def run_venv(args: EnvironmentConfig, - run_python: str, - system_site_packages: bool, - pip: bool, - path: str, - ) -> bool: +def run_venv( + args: EnvironmentConfig, + run_python: str, + system_site_packages: bool, + pip: bool, + path: str, +) -> bool: """Create a virtual environment using the 'venv' module. Not available on Python 2.x.""" cmd = [run_python, '-m', 'venv'] @@ -210,13 +212,14 @@ def run_venv(args: EnvironmentConfig, return True -def run_virtualenv(args: EnvironmentConfig, - run_python: str, - env_python: str, - system_site_packages: bool, - pip: bool, - path: str, - ) -> bool: +def run_virtualenv( + args: EnvironmentConfig, + run_python: str, + env_python: str, + system_site_packages: bool, + pip: bool, + path: str, +) -> bool: """Create a virtual environment using the 'virtualenv' module.""" # always specify which interpreter to use to guarantee the desired interpreter is provided # otherwise virtualenv may select a different interpreter than the one running virtualenv diff --git a/test/lib/ansible_test/_util/controller/sanity/mypy/ansible-test.ini b/test/lib/ansible_test/_util/controller/sanity/mypy/ansible-test.ini index 190e9529..55738f87 100644 --- a/test/lib/ansible_test/_util/controller/sanity/mypy/ansible-test.ini +++ b/test/lib/ansible_test/_util/controller/sanity/mypy/ansible-test.ini @@ -14,6 +14,9 @@ disable_error_code = misc [mypy-argcomplete] ignore_missing_imports = True +[mypy-argcomplete.finders] +ignore_missing_imports = True + [mypy-coverage] ignore_missing_imports = True diff --git a/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py b/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py index 270c9f44..25c61798 100644 --- a/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py +++ b/test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py @@ -24,9 +24,7 @@ import datetime import json import os import re -import subprocess import sys -import tempfile import traceback import warnings @@ -301,8 +299,8 @@ class ModuleValidator(Validator): ACCEPTLIST_FUTURE_IMPORTS = frozenset(('absolute_import', 'division', 'print_function')) - def __init__(self, path, analyze_arg_spec=False, collection=None, collection_version=None, - base_branch=None, git_cache=None, reporter=None, routing=None, plugin_type='module'): + def __init__(self, path, git_cache: GitCache, analyze_arg_spec=False, collection=None, collection_version=None, + reporter=None, routing=None, plugin_type='module'): super(ModuleValidator, self).__init__(reporter=reporter or Reporter()) self.path = path @@ -328,8 +326,8 @@ class ModuleValidator(Validator): self.collection_version_str = collection_version self.collection_version = SemanticVersion(collection_version) - self.base_branch = base_branch - self.git_cache = git_cache or GitCache() + self.git_cache = git_cache + self.base_module = self.git_cache.get_original_path(self.path) self._python_module_override = False @@ -341,11 +339,6 @@ class ModuleValidator(Validator): except Exception: self.ast = None - if base_branch: - self.base_module = self._get_base_file() - else: - self.base_module = None - def _create_version(self, v, collection_name=None): if not v: raise ValueError('Empty string is not a valid version') @@ -368,13 +361,7 @@ class ModuleValidator(Validator): return self def __exit__(self, exc_type, exc_value, traceback): - if not self.base_module: - return - - try: - os.remove(self.base_module) - except Exception: - pass + pass @property def object_name(self): @@ -426,36 +413,9 @@ class ModuleValidator(Validator): except AttributeError: return False - def _get_base_branch_module_path(self): - """List all paths within lib/ansible/modules to try and match a moved module""" - return self.git_cache.base_module_paths.get(self.object_name) - - def _has_alias(self): - """Return true if the module has any aliases.""" - return self.object_name in self.git_cache.head_aliased_modules - - def _get_base_file(self): - # In case of module moves, look for the original location - base_path = self._get_base_branch_module_path() - ext = os.path.splitext(base_path or self.path)[1] - - command = ['git', 'show', '%s:%s' % (self.base_branch, base_path or self.path)] - p = subprocess.run(command, stdin=subprocess.DEVNULL, capture_output=True, check=False) - - if int(p.returncode) != 0: - return None - - t = tempfile.NamedTemporaryFile(delete=False, suffix=ext) - t.write(p.stdout) - t.close() - - return t.name - - def _is_new_module(self): - if self._has_alias(): - return False - - return not self.object_name.startswith('_') and bool(self.base_branch) and not bool(self.base_module) + def _is_new_module(self) -> bool | None: + """Return True if the content is new, False if it is not and None if the information is not available.""" + return self.git_cache.is_new(self.path) def _check_interpreter(self, powershell=False): if powershell: @@ -2050,7 +2010,7 @@ class ModuleValidator(Validator): ) def _check_for_new_args(self, doc): - if not self.base_branch or self._is_new_module(): + if not self.base_module: return with CaptureStd(): @@ -2284,7 +2244,7 @@ class ModuleValidator(Validator): # We can only validate PowerShell arg spec if it is using the new Ansible.Basic.AnsibleModule util pattern = r'(?im)^#\s*ansiblerequires\s+\-csharputil\s*Ansible\.Basic' if re.search(pattern, self.text) and self.object_name not in self.PS_ARG_VALIDATE_REJECTLIST: - with ModuleValidator(docs_path, base_branch=self.base_branch, git_cache=self.git_cache) as docs_mv: + with ModuleValidator(docs_path, git_cache=self.git_cache) as docs_mv: docs = docs_mv._validate_docs()[1] self._validate_ansible_module_call(docs) @@ -2329,6 +2289,84 @@ class PythonPackageValidator(Validator): ) +class GitCache(metaclass=abc.ABCMeta): + """Base class for access to original files.""" + @abc.abstractmethod + def get_original_path(self, path: str) -> str | None: + """Return the path to the original version of the specified file, or None if there isn't one.""" + + @abc.abstractmethod + def is_new(self, path: str) -> bool | None: + """Return True if the content is new, False if it is not and None if the information is not available.""" + + @staticmethod + def create(original_plugins: str | None, plugin_type: str) -> GitCache: + return CoreGitCache(original_plugins, plugin_type) if original_plugins else NoOpGitCache() + + +class CoreGitCache(GitCache): + """Provides access to original files when testing core.""" + def __init__(self, original_plugins: str | None, plugin_type: str) -> None: + super().__init__() + + self.original_plugins = original_plugins + + rel_path = 'lib/ansible/modules/' if plugin_type == 'module' else f'lib/ansible/plugins/{plugin_type}/' + head_tree = self._find_files(rel_path) + + head_aliased_modules = set() + + for path in head_tree: + filename = os.path.basename(path) + + if filename.startswith('_') and filename != '__init__.py': + if os.path.islink(path): + head_aliased_modules.add(os.path.basename(os.path.realpath(path))) + + self._head_aliased_modules = head_aliased_modules + + def get_original_path(self, path: str) -> str | None: + """Return the path to the original version of the specified file, or None if there isn't one.""" + path = os.path.join(self.original_plugins, path) + + if not os.path.exists(path): + path = None + + return path + + def is_new(self, path: str) -> bool | None: + """Return True if the content is new, False if it is not and None if the information is not available.""" + if os.path.basename(path).startswith('_'): + return False + + if os.path.basename(path) in self._head_aliased_modules: + return False + + return not self.get_original_path(path) + + @staticmethod + def _find_files(path: str) -> list[str]: + """Return a list of files found in the specified directory.""" + paths = [] + + for (dir_path, dir_names, file_names) in os.walk(path): + for file_name in file_names: + paths.append(os.path.join(dir_path, file_name)) + + return sorted(paths) + + +class NoOpGitCache(GitCache): + """Provides a no-op interface for access to original files.""" + def get_original_path(self, path: str) -> str | None: + """Return the path to the original version of the specified file, or None if there isn't one.""" + return None + + def is_new(self, path: str) -> bool | None: + """Return True if the content is new, False if it is not and None if the information is not available.""" + return None + + def re_compile(value): """ Argparse expects things to raise TypeError, re.compile raises an re.error @@ -2354,8 +2392,6 @@ def run(): type=re_compile) parser.add_argument('--arg-spec', help='Analyze module argument spec', action='store_true', default=False) - parser.add_argument('--base-branch', default=None, - help='Used in determining if new options were added') parser.add_argument('--format', choices=['json', 'plain'], default='plain', help='Output format. Default: "%(default)s"') parser.add_argument('--output', default='-', @@ -2372,13 +2408,14 @@ def run(): parser.add_argument('--plugin-type', default='module', help='The plugin type to validate. Defaults to %(default)s') + parser.add_argument('--original-plugins') args = parser.parse_args() args.plugins = [m.rstrip('/') for m in args.plugins] reporter = Reporter() - git_cache = GitCache(args.base_branch, args.plugin_type) + git_cache = GitCache.create(args.original_plugins, args.plugin_type) check_dirs = set() @@ -2403,7 +2440,7 @@ def run(): if ModuleValidator.is_on_rejectlist(path): continue with ModuleValidator(path, collection=args.collection, collection_version=args.collection_version, - analyze_arg_spec=args.arg_spec, base_branch=args.base_branch, + analyze_arg_spec=args.arg_spec, git_cache=git_cache, reporter=reporter, routing=routing, plugin_type=args.plugin_type) as mv1: mv1.validate() @@ -2428,7 +2465,7 @@ def run(): if ModuleValidator.is_on_rejectlist(path): continue with ModuleValidator(path, collection=args.collection, collection_version=args.collection_version, - analyze_arg_spec=args.arg_spec, base_branch=args.base_branch, + analyze_arg_spec=args.arg_spec, git_cache=git_cache, reporter=reporter, routing=routing, plugin_type=args.plugin_type) as mv2: mv2.validate() @@ -2444,75 +2481,6 @@ def run(): sys.exit(reporter.json(warnings=args.warnings, output=args.output)) -class GitCache: - def __init__(self, base_branch, plugin_type): - self.base_branch = base_branch - self.plugin_type = plugin_type - - self.rel_path = 'lib/ansible/modules/' - if plugin_type != 'module': - self.rel_path = 'lib/ansible/plugins/%s/' % plugin_type - - if self.base_branch: - self.base_tree = self._git(['ls-tree', '-r', '--name-only', self.base_branch, self.rel_path]) - else: - self.base_tree = [] - - try: - self.head_tree = self._git(['ls-tree', '-r', '--name-only', 'HEAD', self.rel_path]) - except GitError as ex: - if ex.status == 128: - # fallback when there is no .git directory - self.head_tree = self._get_module_files() - else: - raise - except FileNotFoundError: - # fallback when git is not installed - self.head_tree = self._get_module_files() - - allowed_exts = ('.py', '.ps1') - if plugin_type != 'module': - allowed_exts = ('.py', ) - self.base_module_paths = dict((os.path.basename(p), p) for p in self.base_tree if os.path.splitext(p)[1] in allowed_exts) - - self.base_module_paths.pop('__init__.py', None) - - self.head_aliased_modules = set() - - for path in self.head_tree: - filename = os.path.basename(path) - - if filename.startswith('_') and filename != '__init__.py': - if os.path.islink(path): - self.head_aliased_modules.add(os.path.basename(os.path.realpath(path))) - - def _get_module_files(self): - module_files = [] - - for (dir_path, dir_names, file_names) in os.walk(self.rel_path): - for file_name in file_names: - module_files.append(os.path.join(dir_path, file_name)) - - return module_files - - @staticmethod - def _git(args): - cmd = ['git'] + args - p = subprocess.run(cmd, stdin=subprocess.DEVNULL, capture_output=True, text=True, check=False) - - if p.returncode != 0: - raise GitError(p.stderr, p.returncode) - - return p.stdout.splitlines() - - -class GitError(Exception): - def __init__(self, message, status): - super(GitError, self).__init__(message) - - self.status = status - - def main(): try: run() diff --git a/test/lib/ansible_test/_util/target/setup/bootstrap.sh b/test/lib/ansible_test/_util/target/setup/bootstrap.sh index 732c122a..f2e82fbc 100644 --- a/test/lib/ansible_test/_util/target/setup/bootstrap.sh +++ b/test/lib/ansible_test/_util/target/setup/bootstrap.sh @@ -148,6 +148,7 @@ bootstrap_remote_freebsd() packages=" python${python_package_version} py${python_package_version}-sqlite3 + py${python_package_version}-setuptools bash curl gtar diff --git a/test/sanity/code-smell/package-data.py b/test/sanity/code-smell/package-data.py index 0c6e7613..fc894a77 100644 --- a/test/sanity/code-smell/package-data.py +++ b/test/sanity/code-smell/package-data.py @@ -29,9 +29,6 @@ def assemble_files_to_ship(complete_file_list): 'hacking/ticket_stubs/*', 'test/sanity/code-smell/botmeta.*', 'test/sanity/code-smell/release-names.*', - 'test/utils/*', - 'test/utils/*/*', - 'test/utils/*/*/*', 'test/results/.tmp/*', 'test/results/.tmp/*/*', 'test/results/.tmp/*/*/*', @@ -54,7 +51,6 @@ def assemble_files_to_ship(complete_file_list): 'hacking/report.py', 'hacking/return_skeleton_generator.py', 'hacking/test-module', - 'test/support/README.md', 'test/lib/ansible_test/_internal/commands/sanity/bin_symlinks.py', 'test/lib/ansible_test/_internal/commands/sanity/integration_aliases.py', '.cherry_picker.toml', diff --git a/test/support/README.md b/test/support/README.md new file mode 100644 index 00000000..850bc921 --- /dev/null +++ b/test/support/README.md @@ -0,0 +1,11 @@ +# IMPORTANT! + +Files under this directory are not actual plugins and modules used by Ansible +and as such should **not be modified**. They are used for testing purposes +only (and are temporary). + +In almost every case, pull requests affecting files under this directory +will be closed. + +**You are likely looking for something under +https://github.com/ansible-collections/ instead.** diff --git a/test/units/plugins/lookup/test_password.py b/test/units/plugins/lookup/test_password.py index 15207b2f..318bc10b 100644 --- a/test/units/plugins/lookup/test_password.py +++ b/test/units/plugins/lookup/test_password.py @@ -330,23 +330,34 @@ class TestRandomPassword(unittest.TestCase): class TestParseContent(unittest.TestCase): def test_empty_password_file(self): - plaintext_password, salt = password._parse_content(u'') + plaintext_password, salt, ident = password._parse_content(u'') self.assertEqual(plaintext_password, u'') self.assertEqual(salt, None) + self.assertEqual(ident, None) def test(self): expected_content = u'12345678' file_content = expected_content - plaintext_password, salt = password._parse_content(file_content) + plaintext_password, salt, ident = password._parse_content(file_content) self.assertEqual(plaintext_password, expected_content) self.assertEqual(salt, None) + self.assertEqual(ident, None) def test_with_salt(self): expected_content = u'12345678 salt=87654321' file_content = expected_content - plaintext_password, salt = password._parse_content(file_content) + plaintext_password, salt, ident = password._parse_content(file_content) self.assertEqual(plaintext_password, u'12345678') self.assertEqual(salt, u'87654321') + self.assertEqual(ident, None) + + def test_with_salt_and_ident(self): + expected_content = u'12345678 salt=87654321 ident=2a' + file_content = expected_content + plaintext_password, salt, ident = password._parse_content(file_content) + self.assertEqual(plaintext_password, u'12345678') + self.assertEqual(salt, u'87654321') + self.assertEqual(ident, u'2a') class TestFormatContent(unittest.TestCase): |