This collection has been tested against Ansible versions >=2.15,<=2.17 and Python versions >=3.9,<=3.12.
+This collection has been tested against Ansible versions >=2.15,<=2.18 and Python versions >=3.9,<=3.13.
See the Ansible core support matrix for supported combinations.
Prefix to use for cache plugin files/tables
+Prefix to use for cache plugin files/tables.
Default: "ansible_inventory_"
Configuration:
Cache duration in seconds
+Cache duration in seconds.
Default: 3600
Configuration:
The key from input dictionary used to generate groups
+The key from input dictionary used to generate groups.
parent group for keyed group
+parent group for keyed group.
A keyed group name will start with this prefix
+A keyed group name will start with this prefix.
Default: ""
separator used to build the keyed group name
+separator used to build the keyed group name.
Default: "_"
Set this option to False to omit the keyed_groups[].separator after the host variable when the value is an empty string.
Set this option to false to omit the keyed_groups[].separator after the host variable when the value is an empty string.
This option is mutually exclusive with keyed_groups[].default_value.
Choices:
Use in conjunction with keyed_groups.
+Use in conjunction with keyed_groups.
By default, a keyed group that does not have a prefix or a separator provided will have a name that starts with an underscore.
-This is because the default prefix is "" and the default separator is "_".
-Set this option to False to omit the leading underscore (or other separator) if no prefix is given.
+This is because the default prefix is "" and the default separator is "_".
Set this option to false to omit the leading underscore (or other separator) if no prefix is given.
If the group name is derived from a mapping the separator is still used to concatenate the items.
To not use a separator in the group name at all, set the separator for the keyed group to an empty string instead.
Choices:
diff --git a/main/plugins/kubevirt.html b/main/plugins/kubevirt.html index d0ac015..4a77684 100644 --- a/main/plugins/kubevirt.html +++ b/main/plugins/kubevirt.html @@ -347,7 +347,7 @@ see -Prefix to use for cache plugin files/tables
+Prefix to use for cache plugin files/tables.
Default: "ansible_inventory_"
Configuration:
The key from input dictionary used to generate groups
+The key from input dictionary used to generate groups.
parent group for keyed group
+parent group for keyed group.
A keyed group name will start with this prefix
+A keyed group name will start with this prefix.
Default: ""
separator used to build the keyed group name
+separator used to build the keyed group name.
Default: "_"
Set this option to False to omit the keyed_groups[].separator after the host variable when the value is an empty string.
Set this option to false to omit the keyed_groups[].separator after the host variable when the value is an empty string.
This option is mutually exclusive with keyed_groups[].default_value.
Choices:
Use in conjunction with keyed_groups.
+Use in conjunction with keyed_groups.
By default, a keyed group that does not have a prefix or a separator provided will have a name that starts with an underscore.
-This is because the default prefix is "" and the default separator is "_".
-Set this option to False to omit the leading underscore (or other separator) if no prefix is given.
+This is because the default prefix is "" and the default separator is "_".
Set this option to false to omit the leading underscore (or other separator) if no prefix is given.
If the group name is derived from a mapping the separator is still used to concatenate the items.
To not use a separator in the group name at all, set the separator for the keyed group to an empty string instead.
Choices:
diff --git a/main/searchindex.js b/main/searchindex.js index 89c6495..bd53216 100644 --- a/main/searchindex.js +++ b/main/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles": {"A typographical error was fixed in the documentation for a collection": [[10, "a-typographical-error-was-fixed-in-the-documentation-for-a-collection"]], "Ansible and Python version compatibility": [[2, "ansible-and-python-version-compatibility"]], "Ansible collections": [[2, "ansible-collections"]], "Authors": [[6, "authors"], [7, "authors"], [8, "authors"], [9, "authors"]], "Breaking Changes / Porting Guide": [[0, "breaking-changes-porting-guide"]], "Breaking change to any content within a collection": [[10, "breaking-change-to-any-content-within-a-collection"]], "Bug fix or security fix to existing content within a collection": [[10, "bug-fix-or-security-fix-to-existing-content-within-a-collection"]], "Bugfixes": [[0, "bugfixes"], [0, "id19"], [0, "id27"], [0, "id35"]], "Build and install locally": [[2, "build-and-install-locally"]], "Code of Conduct": [[2, "code-of-conduct"]], "Collection Versioning Strategy": [[10, null]], "Collection maintenance": [[2, "collection-maintenance"]], "Content removed from a collection": [[10, "content-removed-from-a-collection"]], "Continuous integration": [[12, "continuous-integration"]], "Contributing": [[1, null]], "Contributing to this collection": [[2, "contributing-to-this-collection"]], "Contributor\u2019s Guidelines": [[3, null]], "Dependencies": [[2, "dependencies"]], "Developer documentation": [[4, null]], "Development environment": [[3, "development-environment"]], "Documentation added/removed/modified within a collection": [[10, "documentation-added-removed-modified-within-a-collection"]], "Example config and playbooks": [[12, "example-config-and-playbooks"]], "Examples": [[6, "examples"], [7, "examples"], [8, "examples"], [9, "examples"]], "General": [[4, null]], "Governance": [[2, "governance"]], "Included content": [[2, "included-content"]], "Installing the Collection from Ansible Galaxy": [[2, "installing-the-collection-from-ansible-galaxy"]], "Integration tests": [[12, "integration-tests"]], "KubeVirt Collection for Ansible Release Notes": [[0, null]], "Lean Ansible bindings for KubeVirt": [[2, null]], "Licensing": [[2, "licensing"]], "Major Changes": [[0, "major-changes"]], "Minor Changes": [[0, "minor-changes"], [0, "id4"], [0, "id13"], [0, "id22"], [0, "id32"], [0, "id43"]], "New content is added to an existing collection": [[10, "new-content-is-added-to-an-existing-collection"]], "New feature to existing plugin or role within a collection (backwards compatible)": [[10, "new-feature-to-existing-plugin-or-role-within-a-collection-backwards-compatible"]], "Notes": [[6, "notes"], [7, "notes"], [8, "notes"], [9, "notes"]], "Parameters": [[6, "parameters"], [7, "parameters"], [8, "parameters"], [9, "parameters"]], "Plugin Index": [[5, null]], "Plugins": [[2, "plugins"]], "Python libraries": [[2, "python-libraries"]], "Release Summary": [[0, "release-summary"], [0, "id3"], [0, "id10"], [0, "id21"], [0, "id30"], [0, "id31"], [0, "id39"], [0, "id40"], [0, "id41"], [0, "id42"], [0, "id44"]], "Release automation": [[10, "release-automation"]], "Release policy": [[2, "release-policy"]], "Requirements": [[6, "requirements"], [7, "requirements"], [8, "requirements"], [9, "requirements"]], "Return Values": [[7, "return-values"], [8, "return-values"], [9, "return-values"]], "Role Index": [[11, null]], "Running integration tests with ansible test": [[12, "running-integration-tests-with-ansible-test"]], "Running tests with ansible-test": [[12, "running-tests-with-ansible-test"]], "Running tests with coverage analysis": [[12, "running-tests-with-coverage-analysis"]], "Running tests with tox-ansible": [[12, "running-tests-with-tox-ansible"]], "Sanity and unit tests": [[12, "sanity-and-unit-tests"]], "Synopsis": [[6, "synopsis"], [7, "synopsis"], [8, "synopsis"], [9, "synopsis"]], "Testing": [[12, null]], "Topics": [[0, "topics"]], "User documentation": [[4, null]], "Using this collection": [[2, "using-this-collection"]], "Virtualenv for development": [[3, "virtualenv-for-development"]], "Welcome to kubevirt.core Collection documentation": [[4, null]], "inventory plugins": [[5, null]], "kubevirt \u2013 Inventory source for KubeVirt VirtualMachines and VirtualMachineInstances": [[6, null]], "kubevirt_vm \u2013 Create or delete KubeVirt VirtualMachines": [[7, null]], "kubevirt_vm_info \u2013 Describe KubeVirt VirtualMachines": [[8, null]], "kubevirt_vmi_info \u2013 Describe KubeVirt VirtualMachineInstances": [[9, null]], "modules plugins": [[5, null]], "v1.0.0": [[0, "v1-0-0"]], "v1.1.0": [[0, "v1-1-0"]], "v1.2.0": [[0, "v1-2-0"]], "v1.2.1": [[0, "v1-2-1"]], "v1.2.2": [[0, "v1-2-2"]], "v1.2.3": [[0, "v1-2-3"]], "v1.3.0": [[0, "v1-3-0"]], "v1.3.1": [[0, "v1-3-1"]], "v1.3.2": [[0, "v1-3-2"]], "v1.4.0": [[0, "v1-4-0"]], "v1.5.0": [[0, "v1-5-0"]], "v2.0.0": [[0, "v2-0-0"]], "v2.1.0": [[0, "v2-1-0"]]}, "docnames": ["CHANGELOG", "CONTRIBUTING", "README", "developing", "index", "plugins/index", "plugins/kubevirt", "plugins/kubevirt_vm", "plugins/kubevirt_vm_info", "plugins/kubevirt_vmi_info", "releasing", "roles/index", "testing"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1}, "filenames": ["CHANGELOG.rst", "CONTRIBUTING.md", "README.md", "developing.md", "index.rst", "plugins/index.rst", "plugins/kubevirt.rst", "plugins/kubevirt_vm.rst", "plugins/kubevirt_vm_info.rst", "plugins/kubevirt_vmi_info.rst", "releasing.md", "roles/index.rst", "testing.md"], "indexentries": {}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [2, 4, 6, 7, 8, 9, 12], "0": [2, 4, 6, 7, 8, 9, 10], "1": [2, 4, 6, 7, 8, 9, 10, 12], "10": [0, 6, 7, 8, 9], "100": 0, "103": 0, "105": 0, "106": 0, "108": 0, "109": 0, "11": [2, 6, 7, 8, 9], "111": 0, "114": 0, "115": 0, "117": 0, "119": 0, "12": [2, 6, 7, 8, 9], "120": [7, 8, 9], "122": 0, "124": 0, "125": 0, "127": [6, 7, 8, 9], "129": 0, "130": 0, "15": [0, 2, 6, 7, 8, 9], "16": [6, 7, 8, 9], "168": [6, 7, 8, 9], "17": [2, 6, 7, 8, 9], "172": [6, 7, 8, 9], "19": [6, 7, 8, 9], "192": [6, 7, 8, 9], "2": [2, 3, 4, 6, 7, 10], "28": [2, 6, 7, 8, 9], "3": [2, 4, 6, 7, 8, 9], "34": [6, 7, 8, 9], "3600": 6, "4": [4, 6, 8], "48": 7, "5": [4, 6, 7, 8, 9], "5gi": 7, "6": [0, 2], "64": 6, "70": 0, "72": 0, "73": 0, "75": 0, "76": 0, "8": [6, 7, 8, 9], "8443": 6, "88": 0, "89": 0, "9": [2, 6, 7, 8, 9], "90": 0, "91": 0, "95": 0, "A": [4, 6], "By": [6, 8, 9, 10], "For": [6, 12], "If": [2, 6, 7, 8, 9, 12], "In": [6, 12], "It": [6, 7, 8, 9, 12], "No": 0, "Not": 0, "Or": 12, "The": [0, 2, 3, 6, 7, 8, 9, 10, 12], "To": [2, 3, 6, 7, 8, 9, 12], "Will": 7, "_": 6, "_v1_datavolumetemplatespec": 7, "_v1_virtualmachineinstancespec": 7, "aaaa": 7, "abl": [6, 7, 8, 9], "about": 12, "abov": [10, 12], "absent": 7, "accept": 2, "access": [6, 7, 8, 9, 12], "accessmod": 7, "across": 7, "activ": [2, 6], "ad": [0, 4, 6, 7, 8], "add": [0, 6], "addit": [0, 10], "address": 6, "affect": 8, "after": [0, 6, 10], "against": 2, "agent": [6, 7, 8, 9], "alias": [6, 7, 8, 9], "all": [2, 3, 6, 8, 9, 10], "allow": [0, 10, 12], "alreadi": 7, "also": [6, 7, 8, 9], "alwai": [6, 7, 8, 9], "among": 2, "an": [0, 2, 4, 6, 7, 8, 9], "ani": [2, 4, 6, 7, 8, 9], "annot": [7, 8, 9, 10], "ansibl": [3, 4, 6, 7, 8, 9, 10], "ansible_cache_plugin": 6, "ansible_cache_plugin_connect": 6, "ansible_cache_plugin_prefix": 6, "ansible_cache_plugin_timeout": 6, "ansible_collect": 12, "ansible_connect": 0, "ansible_inventory_": 6, "ansible_inventory_cach": 6, "ansible_inventory_cache_connect": 6, "ansible_inventory_cache_plugin": 6, "ansible_inventory_cache_plugin_prefix": 6, "ansible_inventory_cache_timeout": 6, "ansible_inventory_use_extra_var": 6, "ansible_port": 0, "ansible_test_prefer_podman": 12, "apach": 2, "api": [6, 7, 8, 9, 10], "api_found": [8, 9], "api_kei": [6, 7, 8, 9], "api_vers": [6, 7, 8, 9], "app": [6, 7, 8, 9], "append": 6, "append_base_domain": [0, 6], "applic": [6, 7, 8, 9], "ar": [2, 3, 6, 7, 8, 9, 10, 12], "argspec": 10, "argument": [3, 7, 8, 9], "argument_spec": 3, "around": 3, "artifact": 10, "assert": 0, "assign": 6, "assum": 10, "attach": 6, "attempt": [6, 7, 8, 9], "attribut": [7, 8, 9], "auth": [6, 7, 8, 9], "authent": [6, 7, 8, 9], "author": 5, "autom": [0, 2, 3, 4], "automat": 7, "avail": [6, 10], "avoid": [0, 3, 6, 7, 8, 9], "awx": 6, "background": 7, "backward": [0, 4], "bar": 3, "base": [0, 2, 6, 8, 9], "base_domain": 6, "basi": 7, "basic": [6, 7, 8, 9], "basic_auth": [6, 7, 8, 9], "becaus": 6, "becom": 2, "been": 2, "befor": 2, "begin": 10, "behavior": [7, 8], "below": [6, 7, 8, 9, 10], "better": [2, 12], "between": [7, 8, 9], "bind": [4, 12], "boolean": [6, 7, 8, 9], "both": 12, "branch": 2, "break": 4, "bridg": [6, 7], "bug": 4, "build": [0, 3, 6, 10, 12], "built": [0, 10], "bump": 0, "ca": [6, 7, 8, 9], "ca_cert": [6, 7, 8, 9], "cach": [0, 6], "cache_connect": 6, "cache_plugin": 6, "cache_prefix": 6, "cache_timeout": 6, "can": [2, 3, 6, 7, 8, 9, 12], "case": [6, 7], "cd": 12, "cert_fil": [6, 7, 8, 9], "certif": [6, 7, 8, 9], "cfg": 10, "chain": [6, 7, 8, 9], "chang": [3, 4, 7, 12], "changelog": [0, 4], "charact": 7, "check": [6, 7, 8, 9, 12], "checkout": 2, "choic": [6, 7, 8, 9], "choosen": 12, "chore": 0, "ci": 12, "cidr": [6, 7, 8, 9], "cleanup": [0, 12], "client": [6, 7, 8, 9], "client_cert": [6, 7, 8, 9], "client_kei": [6, 7, 8, 9], "clone": [2, 12], "cloud": 7, "cloudinit": 7, "cloudinitnocloud": 7, "cluster": [0, 6, 7, 8, 9, 12], "code": [0, 4, 12], "collabor": 2, "collect": [6, 7, 8, 9, 12], "colon": [6, 7, 8, 9], "com": [6, 7, 8, 9, 12], "combin": 2, "comma": [6, 7, 8, 9], "command": [2, 3], "comment": [6, 7, 8, 9], "common": [7, 8, 9], "commun": 2, "compat": [0, 3, 4, 12], "complex": [7, 8, 9], "compos": 6, "composit": 6, "concaten": [3, 6], "condit": [6, 7, 8], "conduct": 4, "config": [4, 6, 7, 8, 9], "configur": [0, 6, 7, 8, 9, 12], "conjunct": 6, "connect": [0, 6, 7, 8, 9, 10], "consensu": 2, "consid": 10, "construct": 6, "contain": [3, 10, 12], "containerdisk": 7, "content": 4, "context": [6, 7, 8, 9], "continu": [0, 6], "contribut": 4, "contributor": [2, 4], "control": [0, 6, 7], "convent": 3, "core": [0, 2, 6, 7, 8, 9, 12], "correct": [6, 7, 8, 9, 10], "cover": 12, "creat": [2, 4, 5, 6, 10, 12], "create_group": 6, "creation": [0, 6], "credenti": [6, 7, 8, 9], "ctrl": 3, "current": [2, 8, 9, 10], "custom": 6, "dash": 3, "data": 6, "data_volume_templ": 7, "datavolum": 7, "debug": 12, "decis": 2, "dedic": [2, 10], "default": [3, 6, 7, 8, 9, 10], "default_testvm": 8, "default_testvmi": 9, "default_valu": 6, "defin": [3, 6], "definit": 7, "delet": [2, 4, 5, 10, 12], "delete_opt": 7, "dep": 12, "depend": [0, 7, 12], "deprec": [0, 6, 10], "deriv": 6, "describ": [0, 2, 4, 5], "descript": [6, 7, 8, 9], "detail": [2, 6, 7, 8, 9], "determin": 7, "dev": 12, "develop": [2, 6, 10, 12], "devic": 7, "dictionari": [6, 7, 8, 9], "did": 12, "differ": 7, "directori": [3, 12], "disabl": [6, 7, 8, 9], "discuss": [2, 6, 7, 8, 9], "do": 3, "doc": [0, 2], "docker": [7, 12], "docsit": 0, "document": [0, 6, 7, 8, 9], "doe": [6, 7, 8, 9, 10], "domain": [6, 7, 8, 9], "don": [2, 3], "done": 12, "down": 12, "downstream": 0, "drop": 0, "due": 0, "durat": [6, 7], "dv": 7, "e": [3, 6, 7, 8, 9], "e2": [0, 12], "each": [3, 6, 10], "earli": 0, "ed25519": 7, "either": [7, 8, 9, 10], "elaps": 7, "element": [6, 7, 8, 9], "elimin": 10, "empti": [0, 6, 7], "en": [6, 7, 8, 9], "enabl": 6, "end": [6, 7, 8, 9], "enhanc": 0, "ensur": [0, 6, 12], "entri": [6, 10], "environ": [4, 6, 7, 8, 9, 12], "error": [4, 6, 7, 8, 9], "establish": 6, "etc": [8, 9], "even": [6, 7, 8, 9], "everi": 2, "exampl": [3, 4, 5, 10], "except": 3, "exclus": [6, 7], "execut": [6, 7, 8, 9], "exist": [0, 4, 6, 7, 8, 9], "expir": [6, 7, 8, 9], "explic": 0, "explicitli": 10, "express": 6, "extens": [3, 10], "extra": 6, "fact": 6, "fact_cach": 6, "fact_caching_connect": 6, "fact_caching_prefix": 6, "fact_caching_timeout": 6, "fail": [6, 7, 8, 9], "fals": [6, 7, 8, 9], "fatal": 6, "feat": 0, "featur": [4, 6, 7, 8, 9], "fedora": 7, "feel": 2, "fetch": 6, "field": [7, 8, 9], "field_selector": [8, 9], "file": [0, 2, 3, 6, 7, 8, 9], "filenam": 6, "filter": [8, 9, 10], "find": [2, 8, 9], "fip": 0, "first": 10, "fix": [0, 4], "flag": [6, 7, 8, 9], "focus": 3, "follow": [2, 3, 7, 8, 9, 10, 12], "foo": [3, 6, 7, 8, 9], "forc": 7, "foreground": 7, "format": [6, 10, 12], "found": [2, 6, 7, 8, 9], "fragment": 0, "free": 2, "from": [0, 3, 4, 6, 7, 8, 9], "full": [2, 6, 7, 8, 9], "function": [0, 10], "further": [6, 7, 8, 9], "g": [3, 6, 7, 8, 9], "galaxi": [6, 7, 8, 9, 10, 12], "gcloud": [6, 7, 8, 9], "gener": [6, 7, 10], "generate_nam": 7, "get": [8, 9], "git": [10, 12], "github": [10, 12], "give": 0, "given": [6, 10], "gke": [6, 7, 8, 9], "go": [3, 6, 7, 8, 9], "govern": 4, "group": [0, 6, 7, 8, 9], "group1": [6, 7, 8, 9], "group2": [6, 7, 8, 9], "gt": [6, 7, 8, 9], "guid": 2, "guidelin": [1, 2, 4], "gz": 2, "ha": 2, "hack": 12, "halt": 7, "have": [2, 3, 6], "header": [6, 7, 8, 9], "help": 2, "here": [6, 7, 8, 9], "high": 6, "higher": [0, 6], "highest": 6, "highlight": [6, 7, 8, 9], "host": [0, 2, 6, 7, 8, 9], "host_format": 6, "hotfix": 0, "how": [2, 7, 8, 9, 10], "html": [6, 7, 8, 9, 12], "http": [6, 7, 8, 9, 10, 12], "http_proxi": [6, 7, 8, 9], "hub": [0, 10], "i": [0, 2, 4, 6, 7, 8, 9, 12], "ie": 3, "ignor": [6, 7, 8, 9], "imag": 7, "imperson": [6, 7, 8, 9], "impersonate_group": [6, 7, 8, 9], "impersonate_us": [6, 7, 8, 9], "import": 2, "improv": 0, "inbound": 10, "includ": [0, 3, 4, 6, 7, 8, 9, 10], "incompat": 10, "increas": 10, "increment": 10, "indent": 3, "index": [4, 12], "indic": 10, "individu": 2, "ini": 6, "initi": 0, "input": 6, "instal": [3, 6, 7, 8, 9, 12], "instancetyp": 7, "instead": 6, "integ": [6, 7, 8, 9], "integr": [0, 4], "interfac": [0, 6, 7], "interface_nam": 6, "intern": 3, "interpol": 3, "interpret": 3, "introduc": 10, "invalid": 6, "inventori": [0, 2, 4, 10, 12], "inventory_plugin": 6, "io": [6, 7, 8, 9], "ip": [6, 7, 8, 9], "issu": [0, 2, 12], "item": 6, "its": 7, "jinja": 3, "jinja2": 6, "jsonpatch": [2, 7], "k8": [0, 6, 7, 8, 9], "k8s_auth_api_kei": [6, 7, 8, 9], "k8s_auth_cert_fil": [6, 7, 8, 9], "k8s_auth_context": [6, 7, 8, 9], "k8s_auth_host": [6, 7, 8, 9], "k8s_auth_impersonate_group": [6, 7, 8, 9], "k8s_auth_impersonate_us": [6, 7, 8, 9], "k8s_auth_key_fil": [6, 7, 8, 9], "k8s_auth_kubeconfig": [6, 7, 8, 9], "k8s_auth_no_proxi": [6, 7, 8, 9], "k8s_auth_password": [6, 7, 8, 9], "k8s_auth_persist_config": [6, 7, 8, 9], "k8s_auth_proxi": [6, 7, 8, 9], "k8s_auth_proxy_headers_basic_auth": [6, 7, 8, 9], "k8s_auth_proxy_headers_proxy_basic_auth": [6, 7, 8, 9], "k8s_auth_proxy_headers_user_ag": [6, 7, 8, 9], "k8s_auth_ssl_ca_cert": [6, 7, 8, 9], "k8s_auth_usernam": [6, 7, 8, 9], "k8s_auth_verify_ssl": [6, 7, 8, 9], "keep": [0, 3], "kei": [0, 6, 7, 8, 9], "key_fil": [6, 7, 8, 9], "keyed_group": 6, "kind": [2, 8, 9, 12], "kindexgw": 7, "know": 2, "kube": [6, 7, 8, 9], "kube_secondary_dn": 6, "kubeconfig": [6, 7, 8, 9], "kubectl": 12, "kubernet": [0, 2, 6, 7, 8, 9], "kubesecondarydn": 6, "kubevirt": [1, 5, 12], "kubevirt_vm": [0, 2, 4, 5], "kubevirt_vm_info": [0, 2, 4, 5, 9], "kubevirt_vmi_info": [0, 4, 5], "label": [6, 7, 8, 9, 10], "label_selector": [6, 8, 9], "latest": [6, 7, 8, 9], "lead": 6, "leading_separ": 6, "lean": 4, "learn": 2, "less": [6, 7, 8, 9], "let": 2, "level": 6, "librari": [6, 7, 8, 9], "licens": 4, "like": [2, 3, 6, 7, 8, 9, 12], "limit": 10, "line": 2, "link": 0, "list": [0, 2, 3, 6, 7, 8, 9], "load": [0, 6, 7, 8, 9], "local": [6, 7, 8, 9, 12], "localhost": [6, 7, 8, 9], "locat": 12, "long": [7, 8, 9], "low": 6, "lower": 6, "lowercas": 3, "machin": [2, 3, 6, 12], "made": [2, 10], "mai": [7, 10], "main": [2, 7], "maintain": [2, 10], "mainten": 4, "major": 10, "make": [0, 2, 3, 6, 10, 12], "make_head": [6, 7, 8, 9], "mani": 0, "manner": 10, "manual": 7, "map": [6, 8, 9], "markup": 0, "masquerad": 7, "matcher": 7, "matrix": [2, 10], "md": 2, "medium": 7, "memori": 6, "mention": 2, "merg": 6, "met": 7, "meta": 3, "metadata": [7, 8, 9, 10], "method": 7, "might": [6, 7, 8, 9], "min": 12, "mind": 2, "minor": 10, "mkdir": 12, "mode": [0, 7, 8, 9], "modifi": [4, 8], "modul": [0, 6, 7, 8, 9, 10], "more": [0, 2, 3, 6], "mostli": 0, "mount": 12, "move": 6, "multipl": [0, 6, 7, 8, 9, 12], "multu": 7, "must": [6, 7, 8, 9], "mutual": [6, 7], "my": 3, "my_path": 3, "my_playbook": 3, "my_rol": 3, "name": [3, 6, 7, 8, 9, 10], "namespac": [0, 6, 7, 8, 9], "namespace_vmis_group": 0, "necessari": 12, "need": [2, 3, 6, 7, 8, 9, 10, 12], "network": [6, 7], "network_nam": 6, "networknam": 7, "new": [2, 4, 6, 7, 8, 9], "newli": 10, "next": [6, 7, 8, 9, 10], "no_proxi": [6, 7, 8, 9], "node": 6, "nodeport": 6, "nor": 10, "note": [5, 10], "noth": 3, "now": 0, "number": [7, 8, 9, 10], "object": [7, 8, 9], "oidc": [6, 7, 8, 9], "old": [6, 7, 8, 9], "omit": 6, "onc": 7, "one": 6, "onli": [0, 6, 7, 10], "oper": [2, 6, 7, 8, 9], "option": [0, 6, 7, 8, 9], "order": [6, 12], "org": 10, "orphan": 7, "other": [3, 6, 7, 8, 9], "otherwis": 6, "our": 2, "out": 12, "outcom": 10, "output": 12, "over": [0, 3], "overrid": [3, 6], "overridden": 3, "owner": 2, "p": [3, 12], "page": 10, "paramet": [0, 5, 10], "parent": 6, "parent_group": 6, "part": [6, 7, 8, 9], "particip": 2, "pass": [0, 7, 8, 9], "password": [6, 7, 8, 9], "patch": [7, 10], "path": [3, 6, 7, 8, 9, 12], "payload": 10, "peopl": 2, "perform": [7, 8, 9], "persist_config": [6, 7, 8, 9], "pick": [2, 6, 7, 8, 9], "pip": [2, 3, 12], "plai": [3, 12], "plain": 12, "plane": 0, "platform": [3, 6, 7, 8, 9], "playbook": [3, 4, 6, 7, 8, 9, 10], "pleas": [6, 7, 8, 9, 10], "plugin": [4, 6, 12], "pod": 7, "podman": 12, "polici": [4, 7], "port": 6, "possibl": [3, 6], "post_task": 3, "pre": 10, "pre_task": 3, "preced": 6, "precondit": 7, "prefer": 7, "prefix": 6, "present": 7, "previou": 10, "primari": 6, "prior": 10, "prioriti": [0, 6], "proce": 7, "process": [0, 2], "produc": 12, "project": [6, 7, 8, 9, 12], "project_dir": 12, "propagationpolici": 7, "proper": 0, "propos": 2, "provid": [0, 2, 6, 7, 8, 9, 12], "proxi": [6, 7, 8, 9], "proxy_basic_auth": [6, 7, 8, 9], "proxy_head": [6, 7, 8, 9], "publish": 10, "purpos": [3, 12], "python": [3, 4, 6, 7, 8, 9, 12], "pyyaml": [2, 6, 7, 8, 9], "quai": 7, "question": 2, "r": [2, 12], "random": [0, 7], "read": [6, 7, 8, 9], "readi": [7, 8, 9, 10], "readm": 10, "readthedoc": [6, 7, 8, 9], "readwriteonc": 7, "recommend": 12, "reduc": 0, "redund": 0, "refer": [1, 2, 6, 7, 8, 9], "refresh": [6, 7, 8, 9], "regist": [8, 9], "registri": 7, "releas": 4, "reli": 12, "remain": 0, "remov": [4, 6, 12], "replac": 7, "report": 12, "repositori": [2, 12], "repres": [6, 7, 8, 9], "represent": [8, 9], "reproduc": 12, "request": 7, "requir": [2, 3, 5, 10, 12], "rerunonfailur": 7, "resourc": [7, 8, 9], "resourcevers": 7, "rest": [8, 9], "result": [3, 7, 8, 9], "retrigg": 0, "return": [0, 5, 6, 10], "review_checklist": 2, "revis": 10, "rework": 0, "robust": 0, "role": [3, 4], "rsa": 0, "run": [0, 3, 6, 7, 8, 9], "run_strategi": 7, "runstrategi": [0, 7], "same": 3, "sampl": [7, 12], "saniti": 4, "save": [6, 7, 8, 9], "scenario": 10, "schema": [8, 9], "script": 12, "search": [8, 9], "second": [6, 7, 8, 9], "secondari": [0, 6], "section": [10, 12], "secur": 4, "see": [2, 6, 7, 8, 9, 10], "select": [3, 6], "selector": [6, 8, 9], "self": 3, "semant": 10, "semver": 10, "separ": [3, 6, 7, 8, 9], "server": [6, 7, 8, 9], "servic": [0, 6], "set": [0, 6, 7, 8, 9], "setup": [6, 12], "sever": 0, "sh": 12, "shall": 10, "shape": 10, "shift": 3, "ship": 0, "should": [3, 6, 7, 8, 10], "shouldn": [6, 7, 8, 9], "shown": 12, "sinc": 6, "singl": 0, "skip": 6, "slash": 3, "sleep": [7, 8, 9], "small": 0, "smaller": 10, "so": [6, 7, 8, 9, 12], "softwar": [0, 2], "some": 0, "someth": 2, "sourc": [0, 2, 4, 5, 7, 12], "space": 3, "spec": [7, 8, 9], "specif": [3, 6, 8, 9], "specifi": [6, 7, 8, 9], "split": 6, "ssh": [0, 6, 7], "ssh_authorized_kei": 7, "ssl": [6, 7, 8, 9], "ssl_ca_cert": [6, 7, 8, 9], "standard": [8, 9], "start": [2, 3, 6], "state": [7, 8, 9, 10], "statu": [8, 9], "step": 12, "still": 6, "stop": [0, 8], "storag": 7, "strategi": 4, "strict": [6, 10], "string": [6, 7, 8, 9], "structur": 10, "subset": 6, "success": [7, 8, 9], "successfulli": [8, 9], "sudo": 12, "suit": 12, "support": [0, 2, 7, 8, 9, 10, 12], "symlink": 3, "sync": 0, "synopsi": 5, "t": [2, 3, 6, 7, 8, 9], "tabl": 6, "tag": [2, 10], "tar": 2, "tarbal": 0, "target": [7, 8, 9], "task": [3, 7], "tell": [6, 7, 8, 9], "templat": 7, "termin": 12, "test": [0, 2, 3, 4, 6, 7, 8, 9, 10], "testdv": 7, "testvm": [7, 8, 9], "testvmi": 9, "text": [2, 12], "than": [3, 6, 7, 8, 9], "thei": [6, 12], "them": 2, "therefor": 10, "thi": [0, 4, 6, 7, 8, 9, 10, 12], "those": [3, 6, 7], "through": [2, 6, 7, 8, 9], "time": [7, 10], "toggl": 6, "token": [6, 7, 8, 9], "tool": 2, "top": 6, "tox": 3, "trail": 3, "trailing_separ": 6, "trigger": 10, "true": [6, 7, 8, 9], "two": 12, "txt": [2, 12], "type": [0, 6, 7], "typic": [6, 7, 8, 9], "typograph": 4, "u1": 7, "uid": [6, 7], "under": 3, "underscor": [3, 6], "uniqu": [7, 8, 9], "unit": [0, 4], "until": [8, 9], "up": [6, 7, 8, 9, 12], "updat": [0, 10], "url": [6, 7, 8, 9], "urllib3": [6, 7, 8, 9], "us": [0, 3, 4, 6, 7, 8, 9, 12], "use_extra_var": 6, "use_servic": 6, "user": [3, 6, 7, 8, 9, 10], "user_ag": [6, 7, 8, 9], "userdata": 7, "usernam": [6, 7, 8, 9], "util": [6, 7, 8, 9], "v": 3, "v1": [4, 6, 7, 8, 9], "v2": 4, "valid": [3, 6, 7, 8, 9], "validate_cert": [6, 7, 8, 9], "valu": [5, 6], "var": [3, 6], "vari": [7, 8, 9], "variabl": [3, 6, 7, 8, 9], "vendor": 0, "venv": 3, "veri": 2, "verif": 12, "verifi": [0, 6, 7, 8, 9], "verify_ssl": [6, 7, 8, 9], "version": [0, 4, 6, 7, 8, 9], "via": [6, 7, 8, 9], "virtual": [2, 6, 12], "virtualenv": 4, "virtualmachin": [0, 2, 4, 5], "virtualmachineinst": [4, 5], "virtualmachineinstac": 9, "virtualmachinesinst": 9, "vm": 0, "vm_list": 8, "vmi_list": 9, "voic": 2, "volum": 7, "vscode": 3, "wa": [0, 4, 6, 7], "wai": 12, "wait": [7, 8, 9], "wait_condit": 0, "wait_sleep": [7, 8, 9], "wait_timeout": [7, 8, 9], "want": [2, 6, 7, 8, 9], "we": [2, 6, 10], "welcom": 2, "were": [8, 9], "when": [3, 6, 7, 8, 9, 10], "where": 3, "whether": [6, 7, 8, 9], "which": [0, 2, 3, 6, 12], "while": 10, "window": [0, 6, 7, 8, 9], "winrm": 0, "within": 4, "work": [0, 6, 12], "world": 2, "would": [3, 10], "x27": [6, 7, 8, 9], "xml": 12, "xxxxxxxxxxxxxxxx": 6, "yaml": [0, 3, 6], "ye": [6, 7, 8, 9], "yml": [0, 2, 3, 6, 12], "you": [2, 3, 6, 7, 8, 9, 12], "your": [2, 3, 6, 12]}, "titles": ["KubeVirt Collection for Ansible Release Notes", "Contributing", "Lean Ansible bindings for KubeVirt", "Contributor\u2019s Guidelines", "Welcome to kubevirt.core Collection documentation", "Plugin Index", "kubevirt \u2013 Inventory source for KubeVirt VirtualMachines and VirtualMachineInstances", "kubevirt_vm \u2013 Create or delete KubeVirt VirtualMachines", "kubevirt_vm_info \u2013 Describe KubeVirt VirtualMachines", "kubevirt_vmi_info \u2013 Describe KubeVirt VirtualMachineInstances", "Collection Versioning Strategy", "Role Index", "Testing"], "titleterms": {"": 3, "0": 0, "1": 0, "2": 0, "3": 0, "4": 0, "5": 0, "A": 10, "ad": 10, "an": 10, "analysi": 12, "ani": 10, "ansibl": [0, 2, 12], "author": [6, 7, 8, 9], "autom": 10, "backward": 10, "bind": 2, "break": [0, 10], "bug": 10, "bugfix": 0, "build": 2, "chang": [0, 10], "code": 2, "collect": [0, 2, 4, 10], "compat": [2, 10], "conduct": 2, "config": 12, "content": [2, 10], "continu": 12, "contribut": [1, 2], "contributor": 3, "core": 4, "coverag": 12, "creat": 7, "delet": 7, "depend": 2, "describ": [8, 9], "develop": [3, 4], "document": [4, 10], "environ": 3, "error": 10, "exampl": [6, 7, 8, 9, 12], "exist": 10, "featur": 10, "fix": 10, "from": [2, 10], "galaxi": 2, "gener": 4, "govern": 2, "guid": 0, "guidelin": 3, "i": 10, "includ": 2, "index": [5, 11], "instal": 2, "integr": 12, "inventori": [5, 6], "kubevirt": [0, 2, 4, 6, 7, 8, 9], "kubevirt_vm": 7, "kubevirt_vm_info": 8, "kubevirt_vmi_info": 9, "lean": 2, "librari": 2, "licens": 2, "local": 2, "mainten": 2, "major": 0, "minor": 0, "modifi": 10, "modul": 5, "new": 10, "note": [0, 6, 7, 8, 9], "paramet": [6, 7, 8, 9], "playbook": 12, "plugin": [2, 5, 10], "polici": 2, "port": 0, "python": 2, "releas": [0, 2, 10], "remov": 10, "requir": [6, 7, 8, 9], "return": [7, 8, 9], "role": [10, 11], "run": 12, "saniti": 12, "secur": 10, "sourc": 6, "strategi": 10, "summari": 0, "synopsi": [6, 7, 8, 9], "test": 12, "thi": 2, "topic": 0, "tox": 12, "typograph": 10, "unit": 12, "us": 2, "user": 4, "v1": 0, "v2": 0, "valu": [7, 8, 9], "version": [2, 10], "virtualenv": 3, "virtualmachin": [6, 7, 8], "virtualmachineinst": [6, 9], "wa": 10, "welcom": 4, "within": 10}}) \ No newline at end of file +Search.setIndex({"alltitles": {"A typographical error was fixed in the documentation for a collection": [[10, "a-typographical-error-was-fixed-in-the-documentation-for-a-collection"]], "Ansible and Python version compatibility": [[2, "ansible-and-python-version-compatibility"]], "Ansible collections": [[2, "ansible-collections"]], "Authors": [[6, "authors"], [7, "authors"], [8, "authors"], [9, "authors"]], "Breaking Changes / Porting Guide": [[0, "breaking-changes-porting-guide"]], "Breaking change to any content within a collection": [[10, "breaking-change-to-any-content-within-a-collection"]], "Bug fix or security fix to existing content within a collection": [[10, "bug-fix-or-security-fix-to-existing-content-within-a-collection"]], "Bugfixes": [[0, "bugfixes"], [0, "id19"], [0, "id27"], [0, "id35"]], "Build and install locally": [[2, "build-and-install-locally"]], "Code of Conduct": [[2, "code-of-conduct"]], "Collection Versioning Strategy": [[10, null]], "Collection maintenance": [[2, "collection-maintenance"]], "Content removed from a collection": [[10, "content-removed-from-a-collection"]], "Continuous integration": [[12, "continuous-integration"]], "Contributing": [[1, null]], "Contributing to this collection": [[2, "contributing-to-this-collection"]], "Contributor\u2019s Guidelines": [[3, null]], "Dependencies": [[2, "dependencies"]], "Developer documentation": [[4, null]], "Development environment": [[3, "development-environment"]], "Documentation added/removed/modified within a collection": [[10, "documentation-added-removed-modified-within-a-collection"]], "Example config and playbooks": [[12, "example-config-and-playbooks"]], "Examples": [[6, "examples"], [7, "examples"], [8, "examples"], [9, "examples"]], "General": [[4, null]], "Governance": [[2, "governance"]], "Included content": [[2, "included-content"]], "Installing the Collection from Ansible Galaxy": [[2, "installing-the-collection-from-ansible-galaxy"]], "Integration tests": [[12, "integration-tests"]], "KubeVirt Collection for Ansible Release Notes": [[0, null]], "Lean Ansible bindings for KubeVirt": [[2, null]], "Licensing": [[2, "licensing"]], "Major Changes": [[0, "major-changes"]], "Minor Changes": [[0, "minor-changes"], [0, "id4"], [0, "id13"], [0, "id22"], [0, "id32"], [0, "id43"]], "New content is added to an existing collection": [[10, "new-content-is-added-to-an-existing-collection"]], "New feature to existing plugin or role within a collection (backwards compatible)": [[10, "new-feature-to-existing-plugin-or-role-within-a-collection-backwards-compatible"]], "Notes": [[6, "notes"], [7, "notes"], [8, "notes"], [9, "notes"]], "Parameters": [[6, "parameters"], [7, "parameters"], [8, "parameters"], [9, "parameters"]], "Plugin Index": [[5, null]], "Plugins": [[2, "plugins"]], "Python libraries": [[2, "python-libraries"]], "Release Summary": [[0, "release-summary"], [0, "id3"], [0, "id10"], [0, "id21"], [0, "id30"], [0, "id31"], [0, "id39"], [0, "id40"], [0, "id41"], [0, "id42"], [0, "id44"]], "Release automation": [[10, "release-automation"]], "Release policy": [[2, "release-policy"]], "Requirements": [[6, "requirements"], [7, "requirements"], [8, "requirements"], [9, "requirements"]], "Return Values": [[7, "return-values"], [8, "return-values"], [9, "return-values"]], "Role Index": [[11, null]], "Running integration tests with ansible test": [[12, "running-integration-tests-with-ansible-test"]], "Running tests with ansible-test": [[12, "running-tests-with-ansible-test"]], "Running tests with coverage analysis": [[12, "running-tests-with-coverage-analysis"]], "Running tests with tox-ansible": [[12, "running-tests-with-tox-ansible"]], "Sanity and unit tests": [[12, "sanity-and-unit-tests"]], "Synopsis": [[6, "synopsis"], [7, "synopsis"], [8, "synopsis"], [9, "synopsis"]], "Testing": [[12, null]], "Topics": [[0, "topics"]], "User documentation": [[4, null]], "Using this collection": [[2, "using-this-collection"]], "Virtualenv for development": [[3, "virtualenv-for-development"]], "Welcome to kubevirt.core Collection documentation": [[4, null]], "inventory plugins": [[5, null]], "kubevirt \u2013 Inventory source for KubeVirt VirtualMachines and VirtualMachineInstances": [[6, null]], "kubevirt_vm \u2013 Create or delete KubeVirt VirtualMachines": [[7, null]], "kubevirt_vm_info \u2013 Describe KubeVirt VirtualMachines": [[8, null]], "kubevirt_vmi_info \u2013 Describe KubeVirt VirtualMachineInstances": [[9, null]], "modules plugins": [[5, null]], "v1.0.0": [[0, "v1-0-0"]], "v1.1.0": [[0, "v1-1-0"]], "v1.2.0": [[0, "v1-2-0"]], "v1.2.1": [[0, "v1-2-1"]], "v1.2.2": [[0, "v1-2-2"]], "v1.2.3": [[0, "v1-2-3"]], "v1.3.0": [[0, "v1-3-0"]], "v1.3.1": [[0, "v1-3-1"]], "v1.3.2": [[0, "v1-3-2"]], "v1.4.0": [[0, "v1-4-0"]], "v1.5.0": [[0, "v1-5-0"]], "v2.0.0": [[0, "v2-0-0"]], "v2.1.0": [[0, "v2-1-0"]]}, "docnames": ["CHANGELOG", "CONTRIBUTING", "README", "developing", "index", "plugins/index", "plugins/kubevirt", "plugins/kubevirt_vm", "plugins/kubevirt_vm_info", "plugins/kubevirt_vmi_info", "releasing", "roles/index", "testing"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1}, "filenames": ["CHANGELOG.rst", "CONTRIBUTING.md", "README.md", "developing.md", "index.rst", "plugins/index.rst", "plugins/kubevirt.rst", "plugins/kubevirt_vm.rst", "plugins/kubevirt_vm_info.rst", "plugins/kubevirt_vmi_info.rst", "releasing.md", "roles/index.rst", "testing.md"], "indexentries": {}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [2, 4, 6, 7, 8, 9, 12], "0": [2, 4, 6, 7, 8, 9, 10], "1": [2, 4, 6, 7, 8, 9, 10, 12], "10": [0, 6, 7, 8, 9], "100": 0, "103": 0, "105": 0, "106": 0, "108": 0, "109": 0, "11": [2, 6, 7, 8, 9], "111": 0, "114": 0, "115": 0, "117": 0, "119": 0, "12": [6, 7, 8, 9], "120": [7, 8, 9], "122": 0, "124": 0, "125": 0, "127": [6, 7, 8, 9], "129": 0, "13": 2, "130": 0, "15": [0, 2, 6, 7, 8, 9], "16": [6, 7, 8, 9], "168": [6, 7, 8, 9], "17": [6, 7, 8, 9], "172": [6, 7, 8, 9], "18": 2, "19": [6, 7, 8, 9], "192": [6, 7, 8, 9], "2": [2, 3, 4, 6, 7, 10], "28": [2, 6, 7, 8, 9], "3": [2, 4, 6, 7, 8, 9], "34": [6, 7, 8, 9], "3600": 6, "4": [4, 6, 8], "48": 7, "5": [4, 6, 7, 8, 9], "5gi": 7, "6": [0, 2], "64": 6, "70": 0, "72": 0, "73": 0, "75": 0, "76": 0, "8": [6, 7, 8, 9], "8443": 6, "88": 0, "89": 0, "9": [2, 6, 7, 8, 9], "90": 0, "91": 0, "95": 0, "A": [4, 6], "By": [6, 8, 9, 10], "For": [6, 12], "If": [2, 6, 7, 8, 9, 12], "In": [6, 12], "It": [6, 7, 8, 9, 12], "No": 0, "Not": 0, "Or": 12, "The": [0, 2, 3, 6, 7, 8, 9, 10, 12], "To": [2, 3, 6, 7, 8, 9, 12], "Will": 7, "_": 6, "_v1_datavolumetemplatespec": 7, "_v1_virtualmachineinstancespec": 7, "aaaa": 7, "abl": [6, 7, 8, 9], "about": 12, "abov": [10, 12], "absent": 7, "accept": 2, "access": [6, 7, 8, 9, 12], "accessmod": 7, "across": 7, "activ": [2, 6], "ad": [0, 4, 6, 7, 8], "add": [0, 6], "addit": [0, 10], "address": 6, "affect": 8, "after": [0, 6, 10], "against": 2, "agent": [6, 7, 8, 9], "alias": [6, 7, 8, 9], "all": [2, 3, 6, 8, 9, 10], "allow": [0, 10, 12], "alreadi": 7, "also": [6, 7, 8, 9], "alwai": [6, 7, 8, 9], "among": 2, "an": [0, 2, 4, 6, 7, 8, 9], "ani": [2, 4, 6, 7, 8, 9], "annot": [7, 8, 9, 10], "ansibl": [3, 4, 6, 7, 8, 9, 10], "ansible_cache_plugin": 6, "ansible_cache_plugin_connect": 6, "ansible_cache_plugin_prefix": 6, "ansible_cache_plugin_timeout": 6, "ansible_collect": 12, "ansible_connect": 0, "ansible_inventory_": 6, "ansible_inventory_cach": 6, "ansible_inventory_cache_connect": 6, "ansible_inventory_cache_plugin": 6, "ansible_inventory_cache_plugin_prefix": 6, "ansible_inventory_cache_timeout": 6, "ansible_inventory_use_extra_var": 6, "ansible_port": 0, "ansible_test_prefer_podman": 12, "apach": 2, "api": [6, 7, 8, 9, 10], "api_found": [8, 9], "api_kei": [6, 7, 8, 9], "api_vers": [6, 7, 8, 9], "app": [6, 7, 8, 9], "append": 6, "append_base_domain": [0, 6], "applic": [6, 7, 8, 9], "ar": [2, 3, 6, 7, 8, 9, 10, 12], "argspec": 10, "argument": [3, 7, 8, 9], "argument_spec": 3, "around": 3, "artifact": 10, "assert": 0, "assign": 6, "assum": 10, "attach": 6, "attempt": [6, 7, 8, 9], "attribut": [7, 8, 9], "auth": [6, 7, 8, 9], "authent": [6, 7, 8, 9], "author": 5, "autom": [0, 2, 3, 4], "automat": 7, "avail": [6, 10], "avoid": [0, 3, 6, 7, 8, 9], "awx": 6, "background": 7, "backward": [0, 4], "bar": 3, "base": [0, 2, 6, 8, 9], "base_domain": 6, "basi": 7, "basic": [6, 7, 8, 9], "basic_auth": [6, 7, 8, 9], "becaus": 6, "becom": 2, "been": 2, "befor": 2, "begin": 10, "behavior": [7, 8], "below": [6, 7, 8, 9, 10], "better": [2, 12], "between": [7, 8, 9], "bind": [4, 12], "boolean": [6, 7, 8, 9], "both": 12, "branch": 2, "break": 4, "bridg": [6, 7], "bug": 4, "build": [0, 3, 6, 10, 12], "built": [0, 10], "bump": 0, "ca": [6, 7, 8, 9], "ca_cert": [6, 7, 8, 9], "cach": [0, 6], "cache_connect": 6, "cache_plugin": 6, "cache_prefix": 6, "cache_timeout": 6, "can": [2, 3, 6, 7, 8, 9, 12], "case": [6, 7], "cd": 12, "cert_fil": [6, 7, 8, 9], "certif": [6, 7, 8, 9], "cfg": 10, "chain": [6, 7, 8, 9], "chang": [3, 4, 7, 12], "changelog": [0, 4], "charact": 7, "check": [6, 7, 8, 9, 12], "checkout": 2, "choic": [6, 7, 8, 9], "choosen": 12, "chore": 0, "ci": 12, "cidr": [6, 7, 8, 9], "cleanup": [0, 12], "client": [6, 7, 8, 9], "client_cert": [6, 7, 8, 9], "client_kei": [6, 7, 8, 9], "clone": [2, 12], "cloud": 7, "cloudinit": 7, "cloudinitnocloud": 7, "cluster": [0, 6, 7, 8, 9, 12], "code": [0, 4, 12], "collabor": 2, "collect": [6, 7, 8, 9, 12], "colon": [6, 7, 8, 9], "com": [6, 7, 8, 9, 12], "combin": 2, "comma": [6, 7, 8, 9], "command": [2, 3], "comment": [6, 7, 8, 9], "common": [7, 8, 9], "commun": 2, "compat": [0, 3, 4, 12], "complex": [7, 8, 9], "compos": 6, "composit": 6, "concaten": [3, 6], "condit": [6, 7, 8], "conduct": 4, "config": [4, 6, 7, 8, 9], "configur": [0, 6, 7, 8, 9, 12], "conjunct": 6, "connect": [0, 6, 7, 8, 9, 10], "consensu": 2, "consid": 10, "construct": 6, "contain": [3, 10, 12], "containerdisk": 7, "content": 4, "context": [6, 7, 8, 9], "continu": [0, 6], "contribut": 4, "contributor": [2, 4], "control": [0, 6, 7], "convent": 3, "core": [0, 2, 6, 7, 8, 9, 12], "correct": [6, 7, 8, 9, 10], "cover": 12, "creat": [2, 4, 5, 6, 10, 12], "create_group": 6, "creation": [0, 6], "credenti": [6, 7, 8, 9], "ctrl": 3, "current": [2, 8, 9, 10], "custom": 6, "dash": 3, "data": 6, "data_volume_templ": 7, "datavolum": 7, "debug": 12, "decis": 2, "dedic": [2, 10], "default": [3, 6, 7, 8, 9, 10], "default_testvm": 8, "default_testvmi": 9, "default_valu": 6, "defin": [3, 6], "definit": 7, "delet": [2, 4, 5, 10, 12], "delete_opt": 7, "dep": 12, "depend": [0, 7, 12], "deprec": [0, 6, 10], "deriv": 6, "describ": [0, 2, 4, 5], "descript": [6, 7, 8, 9], "detail": [2, 6, 7, 8, 9], "determin": 7, "dev": 12, "develop": [2, 6, 10, 12], "devic": 7, "dictionari": [6, 7, 8, 9], "did": 12, "differ": 7, "directori": [3, 12], "disabl": [6, 7, 8, 9], "discuss": [2, 6, 7, 8, 9], "do": 3, "doc": [0, 2], "docker": [7, 12], "docsit": 0, "document": [0, 6, 7, 8, 9], "doe": [6, 7, 8, 9, 10], "domain": [6, 7, 8, 9], "don": [2, 3], "done": 12, "down": 12, "downstream": 0, "drop": 0, "due": 0, "durat": [6, 7], "dv": 7, "e": [3, 6, 7, 8, 9], "e2": [0, 12], "each": [3, 6, 10], "earli": 0, "ed25519": 7, "either": [7, 8, 9, 10], "elaps": 7, "element": [6, 7, 8, 9], "elimin": 10, "empti": [0, 6, 7], "en": [6, 7, 8, 9], "enabl": 6, "end": [6, 7, 8, 9], "enhanc": 0, "ensur": [0, 6, 12], "entri": [6, 10], "environ": [4, 6, 7, 8, 9, 12], "error": [4, 6, 7, 8, 9], "establish": 6, "etc": [8, 9], "even": [6, 7, 8, 9], "everi": 2, "exampl": [3, 4, 5, 10], "except": 3, "exclus": [6, 7], "execut": [6, 7, 8, 9], "exist": [0, 4, 6, 7, 8, 9], "expir": [6, 7, 8, 9], "explic": 0, "explicitli": 10, "express": 6, "extens": [3, 10], "extra": 6, "fact": 6, "fact_cach": 6, "fact_caching_connect": 6, "fact_caching_prefix": 6, "fact_caching_timeout": 6, "fail": [6, 7, 8, 9], "fals": [6, 7, 8, 9], "fatal": 6, "feat": 0, "featur": [4, 6, 7, 8, 9], "fedora": 7, "feel": 2, "fetch": 6, "field": [7, 8, 9], "field_selector": [8, 9], "file": [0, 2, 3, 6, 7, 8, 9], "filenam": 6, "filter": [8, 9, 10], "find": [2, 8, 9], "fip": 0, "first": 10, "fix": [0, 4], "flag": [6, 7, 8, 9], "focus": 3, "follow": [2, 3, 7, 8, 9, 10, 12], "foo": [3, 6, 7, 8, 9], "forc": 7, "foreground": 7, "format": [6, 10, 12], "found": [2, 6, 7, 8, 9], "fragment": 0, "free": 2, "from": [0, 3, 4, 6, 7, 8, 9], "full": [2, 6, 7, 8, 9], "function": [0, 10], "further": [6, 7, 8, 9], "g": [3, 6, 7, 8, 9], "galaxi": [6, 7, 8, 9, 10, 12], "gcloud": [6, 7, 8, 9], "gener": [6, 7, 10], "generate_nam": 7, "get": [8, 9], "git": [10, 12], "github": [10, 12], "give": 0, "given": [6, 10], "gke": [6, 7, 8, 9], "go": [3, 6, 7, 8, 9], "govern": 4, "group": [0, 6, 7, 8, 9], "group1": [6, 7, 8, 9], "group2": [6, 7, 8, 9], "gt": [6, 7, 8, 9], "guid": 2, "guidelin": [1, 2, 4], "gz": 2, "ha": 2, "hack": 12, "halt": 7, "have": [2, 3, 6], "header": [6, 7, 8, 9], "help": 2, "here": [6, 7, 8, 9], "high": 6, "higher": [0, 6], "highest": 6, "highlight": [6, 7, 8, 9], "host": [0, 2, 6, 7, 8, 9], "host_format": 6, "hotfix": 0, "how": [2, 7, 8, 9, 10], "html": [6, 7, 8, 9, 12], "http": [6, 7, 8, 9, 10, 12], "http_proxi": [6, 7, 8, 9], "hub": [0, 10], "i": [0, 2, 4, 6, 7, 8, 9, 12], "ie": 3, "ignor": [6, 7, 8, 9], "imag": 7, "imperson": [6, 7, 8, 9], "impersonate_group": [6, 7, 8, 9], "impersonate_us": [6, 7, 8, 9], "import": 2, "improv": 0, "inbound": 10, "includ": [0, 3, 4, 6, 7, 8, 9, 10], "incompat": 10, "increas": 10, "increment": 10, "indent": 3, "index": [4, 12], "indic": 10, "individu": 2, "ini": 6, "initi": 0, "input": 6, "instal": [3, 6, 7, 8, 9, 12], "instancetyp": 7, "instead": 6, "integ": [6, 7, 8, 9], "integr": [0, 4], "interfac": [0, 6, 7], "interface_nam": 6, "intern": 3, "interpol": 3, "interpret": 3, "introduc": 10, "invalid": 6, "inventori": [0, 2, 4, 10, 12], "inventory_plugin": 6, "io": [6, 7, 8, 9], "ip": [6, 7, 8, 9], "issu": [0, 2, 12], "item": 6, "its": 7, "jinja": 3, "jinja2": 6, "jsonpatch": [2, 7], "k8": [0, 6, 7, 8, 9], "k8s_auth_api_kei": [6, 7, 8, 9], "k8s_auth_cert_fil": [6, 7, 8, 9], "k8s_auth_context": [6, 7, 8, 9], "k8s_auth_host": [6, 7, 8, 9], "k8s_auth_impersonate_group": [6, 7, 8, 9], "k8s_auth_impersonate_us": [6, 7, 8, 9], "k8s_auth_key_fil": [6, 7, 8, 9], "k8s_auth_kubeconfig": [6, 7, 8, 9], "k8s_auth_no_proxi": [6, 7, 8, 9], "k8s_auth_password": [6, 7, 8, 9], "k8s_auth_persist_config": [6, 7, 8, 9], "k8s_auth_proxi": [6, 7, 8, 9], "k8s_auth_proxy_headers_basic_auth": [6, 7, 8, 9], "k8s_auth_proxy_headers_proxy_basic_auth": [6, 7, 8, 9], "k8s_auth_proxy_headers_user_ag": [6, 7, 8, 9], "k8s_auth_ssl_ca_cert": [6, 7, 8, 9], "k8s_auth_usernam": [6, 7, 8, 9], "k8s_auth_verify_ssl": [6, 7, 8, 9], "keep": [0, 3], "kei": [0, 6, 7, 8, 9], "key_fil": [6, 7, 8, 9], "keyed_group": 6, "kind": [2, 8, 9, 12], "kindexgw": 7, "know": 2, "kube": [6, 7, 8, 9], "kube_secondary_dn": 6, "kubeconfig": [6, 7, 8, 9], "kubectl": 12, "kubernet": [0, 2, 6, 7, 8, 9], "kubesecondarydn": 6, "kubevirt": [1, 5, 12], "kubevirt_vm": [0, 2, 4, 5], "kubevirt_vm_info": [0, 2, 4, 5, 9], "kubevirt_vmi_info": [0, 4, 5], "label": [6, 7, 8, 9, 10], "label_selector": [6, 8, 9], "latest": [6, 7, 8, 9], "lead": 6, "leading_separ": 6, "lean": 4, "learn": 2, "less": [6, 7, 8, 9], "let": 2, "level": 6, "librari": [6, 7, 8, 9], "licens": 4, "like": [2, 3, 6, 7, 8, 9, 12], "limit": 10, "line": 2, "link": 0, "list": [0, 2, 3, 6, 7, 8, 9], "load": [0, 6, 7, 8, 9], "local": [6, 7, 8, 9, 12], "localhost": [6, 7, 8, 9], "locat": 12, "long": [7, 8, 9], "low": 6, "lower": 6, "lowercas": 3, "machin": [2, 3, 6, 12], "made": [2, 10], "mai": [7, 10], "main": [2, 7], "maintain": [2, 10], "mainten": 4, "major": 10, "make": [0, 2, 3, 6, 10, 12], "make_head": [6, 7, 8, 9], "mani": 0, "manner": 10, "manual": 7, "map": [6, 8, 9], "markup": 0, "masquerad": 7, "matcher": 7, "matrix": [2, 10], "md": 2, "medium": 7, "memori": 6, "mention": 2, "merg": 6, "met": 7, "meta": 3, "metadata": [7, 8, 9, 10], "method": 7, "might": [6, 7, 8, 9], "min": 12, "mind": 2, "minor": 10, "mkdir": 12, "mode": [0, 7, 8, 9], "modifi": [4, 8], "modul": [0, 6, 7, 8, 9, 10], "more": [0, 2, 3, 6], "mostli": 0, "mount": 12, "move": 6, "multipl": [0, 6, 7, 8, 9, 12], "multu": 7, "must": [6, 7, 8, 9], "mutual": [6, 7], "my": 3, "my_path": 3, "my_playbook": 3, "my_rol": 3, "name": [3, 6, 7, 8, 9, 10], "namespac": [0, 6, 7, 8, 9], "namespace_vmis_group": 0, "necessari": 12, "need": [2, 3, 6, 7, 8, 9, 10, 12], "network": [6, 7], "network_nam": 6, "networknam": 7, "new": [2, 4, 6, 7, 8, 9], "newli": 10, "next": [6, 7, 8, 9, 10], "no_proxi": [6, 7, 8, 9], "node": 6, "nodeport": 6, "nor": 10, "note": [5, 10], "noth": 3, "now": 0, "number": [7, 8, 9, 10], "object": [7, 8, 9], "oidc": [6, 7, 8, 9], "old": [6, 7, 8, 9], "omit": 6, "onc": 7, "one": 6, "onli": [0, 6, 7, 10], "oper": [2, 6, 7, 8, 9], "option": [0, 6, 7, 8, 9], "order": [6, 12], "org": 10, "orphan": 7, "other": [3, 6, 7, 8, 9], "otherwis": 6, "our": 2, "out": 12, "outcom": 10, "output": 12, "over": [0, 3], "overrid": [3, 6], "overridden": 3, "owner": 2, "p": [3, 12], "page": 10, "paramet": [0, 5, 10], "parent": 6, "parent_group": 6, "part": [6, 7, 8, 9], "particip": 2, "pass": [0, 7, 8, 9], "password": [6, 7, 8, 9], "patch": [7, 10], "path": [3, 6, 7, 8, 9, 12], "payload": 10, "peopl": 2, "perform": [7, 8, 9], "persist_config": [6, 7, 8, 9], "pick": [2, 6, 7, 8, 9], "pip": [2, 3, 12], "plai": [3, 12], "plain": 12, "plane": 0, "platform": [3, 6, 7, 8, 9], "playbook": [3, 4, 6, 7, 8, 9, 10], "pleas": [6, 7, 8, 9, 10], "plugin": [4, 6, 12], "pod": 7, "podman": 12, "polici": [4, 7], "port": 6, "possibl": [3, 6], "post_task": 3, "pre": 10, "pre_task": 3, "preced": 6, "precondit": 7, "prefer": 7, "prefix": 6, "present": 7, "previou": 10, "primari": 6, "prior": 10, "prioriti": [0, 6], "proce": 7, "process": [0, 2], "produc": 12, "project": [6, 7, 8, 9, 12], "project_dir": 12, "propagationpolici": 7, "proper": 0, "propos": 2, "provid": [0, 2, 6, 7, 8, 9, 12], "proxi": [6, 7, 8, 9], "proxy_basic_auth": [6, 7, 8, 9], "proxy_head": [6, 7, 8, 9], "publish": 10, "purpos": [3, 12], "python": [3, 4, 6, 7, 8, 9, 12], "pyyaml": [2, 6, 7, 8, 9], "quai": 7, "question": 2, "r": [2, 12], "random": [0, 7], "read": [6, 7, 8, 9], "readi": [7, 8, 9, 10], "readm": 10, "readthedoc": [6, 7, 8, 9], "readwriteonc": 7, "recommend": 12, "reduc": 0, "redund": 0, "refer": [1, 2, 6, 7, 8, 9], "refresh": [6, 7, 8, 9], "regist": [8, 9], "registri": 7, "releas": 4, "reli": 12, "remain": 0, "remov": [4, 6, 12], "replac": 7, "report": 12, "repositori": [2, 12], "repres": [6, 7, 8, 9], "represent": [8, 9], "reproduc": 12, "request": 7, "requir": [2, 3, 5, 10, 12], "rerunonfailur": 7, "resourc": [7, 8, 9], "resourcevers": 7, "rest": [8, 9], "result": [3, 7, 8, 9], "retrigg": 0, "return": [0, 5, 6, 10], "review_checklist": 2, "revis": 10, "rework": 0, "robust": 0, "role": [3, 4], "rsa": 0, "run": [0, 3, 6, 7, 8, 9], "run_strategi": 7, "runstrategi": [0, 7], "same": 3, "sampl": [7, 12], "saniti": 4, "save": [6, 7, 8, 9], "scenario": 10, "schema": [8, 9], "script": 12, "search": [8, 9], "second": [6, 7, 8, 9], "secondari": [0, 6], "section": [10, 12], "secur": 4, "see": [2, 6, 7, 8, 9, 10], "select": [3, 6], "selector": [6, 8, 9], "self": 3, "semant": 10, "semver": 10, "separ": [3, 6, 7, 8, 9], "server": [6, 7, 8, 9], "servic": [0, 6], "set": [0, 6, 7, 8, 9], "setup": [6, 12], "sever": 0, "sh": 12, "shall": 10, "shape": 10, "shift": 3, "ship": 0, "should": [3, 6, 7, 8, 10], "shouldn": [6, 7, 8, 9], "shown": 12, "sinc": 6, "singl": 0, "skip": 6, "slash": 3, "sleep": [7, 8, 9], "small": 0, "smaller": 10, "so": [6, 7, 8, 9, 12], "softwar": [0, 2], "some": 0, "someth": 2, "sourc": [0, 2, 4, 5, 7, 12], "space": 3, "spec": [7, 8, 9], "specif": [3, 6, 8, 9], "specifi": [6, 7, 8, 9], "split": 6, "ssh": [0, 6, 7], "ssh_authorized_kei": 7, "ssl": [6, 7, 8, 9], "ssl_ca_cert": [6, 7, 8, 9], "standard": [8, 9], "start": [2, 3, 6], "state": [7, 8, 9, 10], "statu": [8, 9], "step": 12, "still": 6, "stop": [0, 8], "storag": 7, "strategi": 4, "strict": [6, 10], "string": [6, 7, 8, 9], "structur": 10, "subset": 6, "success": [7, 8, 9], "successfulli": [8, 9], "sudo": 12, "suit": 12, "support": [0, 2, 7, 8, 9, 10, 12], "symlink": 3, "sync": 0, "synopsi": 5, "t": [2, 3, 6, 7, 8, 9], "tabl": 6, "tag": [2, 10], "tar": 2, "tarbal": 0, "target": [7, 8, 9], "task": [3, 7], "tell": [6, 7, 8, 9], "templat": 7, "termin": 12, "test": [0, 2, 3, 4, 6, 7, 8, 9, 10], "testdv": 7, "testvm": [7, 8, 9], "testvmi": 9, "text": [2, 12], "than": [3, 6, 7, 8, 9], "thei": [6, 12], "them": 2, "therefor": 10, "thi": [0, 4, 6, 7, 8, 9, 10, 12], "those": [3, 6, 7], "through": [2, 6, 7, 8, 9], "time": [7, 10], "toggl": 6, "token": [6, 7, 8, 9], "tool": 2, "top": 6, "tox": 3, "trail": 3, "trailing_separ": 6, "trigger": 10, "true": [6, 7, 8, 9], "two": 12, "txt": [2, 12], "type": [0, 6, 7], "typic": [6, 7, 8, 9], "typograph": 4, "u1": 7, "uid": [6, 7], "under": 3, "underscor": [3, 6], "uniqu": [7, 8, 9], "unit": [0, 4], "until": [8, 9], "up": [6, 7, 8, 9, 12], "updat": [0, 10], "url": [6, 7, 8, 9], "urllib3": [6, 7, 8, 9], "us": [0, 3, 4, 6, 7, 8, 9, 12], "use_extra_var": 6, "use_servic": 6, "user": [3, 6, 7, 8, 9, 10], "user_ag": [6, 7, 8, 9], "userdata": 7, "usernam": [6, 7, 8, 9], "util": [6, 7, 8, 9], "v": 3, "v1": [4, 6, 7, 8, 9], "v2": 4, "valid": [3, 6, 7, 8, 9], "validate_cert": [6, 7, 8, 9], "valu": [5, 6], "var": [3, 6], "vari": [7, 8, 9], "variabl": [3, 6, 7, 8, 9], "vendor": 0, "venv": 3, "veri": 2, "verif": 12, "verifi": [0, 6, 7, 8, 9], "verify_ssl": [6, 7, 8, 9], "version": [0, 4, 6, 7, 8, 9], "via": [6, 7, 8, 9], "virtual": [2, 6, 12], "virtualenv": 4, "virtualmachin": [0, 2, 4, 5], "virtualmachineinst": [4, 5], "virtualmachineinstac": 9, "virtualmachinesinst": 9, "vm": 0, "vm_list": 8, "vmi_list": 9, "voic": 2, "volum": 7, "vscode": 3, "wa": [0, 4, 6, 7], "wai": 12, "wait": [7, 8, 9], "wait_condit": 0, "wait_sleep": [7, 8, 9], "wait_timeout": [7, 8, 9], "want": [2, 6, 7, 8, 9], "we": [2, 6, 10], "welcom": 2, "were": [8, 9], "when": [3, 6, 7, 8, 9, 10], "where": 3, "whether": [6, 7, 8, 9], "which": [0, 2, 3, 6, 12], "while": 10, "window": [0, 6, 7, 8, 9], "winrm": 0, "within": 4, "work": [0, 6, 12], "world": 2, "would": [3, 10], "x27": [6, 7, 8, 9], "xml": 12, "xxxxxxxxxxxxxxxx": 6, "yaml": [0, 3, 6], "ye": [6, 7, 8, 9], "yml": [0, 2, 3, 6, 12], "you": [2, 3, 6, 7, 8, 9, 12], "your": [2, 3, 6, 12]}, "titles": ["KubeVirt Collection for Ansible Release Notes", "Contributing", "Lean Ansible bindings for KubeVirt", "Contributor\u2019s Guidelines", "Welcome to kubevirt.core Collection documentation", "Plugin Index", "kubevirt \u2013 Inventory source for KubeVirt VirtualMachines and VirtualMachineInstances", "kubevirt_vm \u2013 Create or delete KubeVirt VirtualMachines", "kubevirt_vm_info \u2013 Describe KubeVirt VirtualMachines", "kubevirt_vmi_info \u2013 Describe KubeVirt VirtualMachineInstances", "Collection Versioning Strategy", "Role Index", "Testing"], "titleterms": {"": 3, "0": 0, "1": 0, "2": 0, "3": 0, "4": 0, "5": 0, "A": 10, "ad": 10, "an": 10, "analysi": 12, "ani": 10, "ansibl": [0, 2, 12], "author": [6, 7, 8, 9], "autom": 10, "backward": 10, "bind": 2, "break": [0, 10], "bug": 10, "bugfix": 0, "build": 2, "chang": [0, 10], "code": 2, "collect": [0, 2, 4, 10], "compat": [2, 10], "conduct": 2, "config": 12, "content": [2, 10], "continu": 12, "contribut": [1, 2], "contributor": 3, "core": 4, "coverag": 12, "creat": 7, "delet": 7, "depend": 2, "describ": [8, 9], "develop": [3, 4], "document": [4, 10], "environ": 3, "error": 10, "exampl": [6, 7, 8, 9, 12], "exist": 10, "featur": 10, "fix": 10, "from": [2, 10], "galaxi": 2, "gener": 4, "govern": 2, "guid": 0, "guidelin": 3, "i": 10, "includ": 2, "index": [5, 11], "instal": 2, "integr": 12, "inventori": [5, 6], "kubevirt": [0, 2, 4, 6, 7, 8, 9], "kubevirt_vm": 7, "kubevirt_vm_info": 8, "kubevirt_vmi_info": 9, "lean": 2, "librari": 2, "licens": 2, "local": 2, "mainten": 2, "major": 0, "minor": 0, "modifi": 10, "modul": 5, "new": 10, "note": [0, 6, 7, 8, 9], "paramet": [6, 7, 8, 9], "playbook": 12, "plugin": [2, 5, 10], "polici": 2, "port": 0, "python": 2, "releas": [0, 2, 10], "remov": 10, "requir": [6, 7, 8, 9], "return": [7, 8, 9], "role": [10, 11], "run": 12, "saniti": 12, "secur": 10, "sourc": 6, "strategi": 10, "summari": 0, "synopsi": [6, 7, 8, 9], "test": 12, "thi": 2, "topic": 0, "tox": 12, "typograph": 10, "unit": 12, "us": 2, "user": 4, "v1": 0, "v2": 0, "valu": [7, 8, 9], "version": [2, 10], "virtualenv": 3, "virtualmachin": [6, 7, 8], "virtualmachineinst": [6, 9], "wa": 10, "welcom": 4, "within": 10}}) \ No newline at end of file