{"id":20155253,"url":"https://github.com/redhat-cop/cloud.aws_troubleshooting","last_synced_at":"2026-02-25T13:01:20.706Z","repository":{"id":62168543,"uuid":"546904638","full_name":"redhat-cop/cloud.aws_troubleshooting","owner":"redhat-cop","description":"Ansible Roles for troubleshooting AWS Resources","archived":false,"fork":false,"pushed_at":"2025-02-25T17:49:11.000Z","size":255,"stargazers_count":4,"open_issues_count":0,"forks_count":9,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-03-23T23:51:13.715Z","etag":null,"topics":["validated-content"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redhat-cop.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-06T20:57:38.000Z","updated_at":"2025-02-25T17:49:15.000Z","dependencies_parsed_at":"2023-11-10T17:27:45.696Z","dependency_job_id":"cb8cc39a-e710-4ca4-b2d5-dbac7f977328","html_url":"https://github.com/redhat-cop/cloud.aws_troubleshooting","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Fcloud.aws_troubleshooting","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Fcloud.aws_troubleshooting/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Fcloud.aws_troubleshooting/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Fcloud.aws_troubleshooting/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redhat-cop","download_url":"https://codeload.github.com/redhat-cop/cloud.aws_troubleshooting/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119314,"owners_count":21050755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["validated-content"],"created_at":"2024-11-13T23:30:57.671Z","updated_at":"2026-02-25T13:01:20.700Z","avatar_url":"https://github.com/redhat-cop.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cloud.aws_troubleshooting Validated Content Collection\n\nThis repository hosts the cloud.aws_troubleshooting Ansible Collection.\n\n## Description\n\nThe cloud.aws_troubleshooting validated content collection in Ansible is designed to help users efficiently diagnose and resolve issues within their AWS environments. This collection includes a variety of Ansible roles and playbooks specifically tailored for troubleshooting common problems encountered in AWS infrastructure.\n\n## Requirements\n\nThe [amazon.aws](https://github.com/ansible-collections/amazon.aws) and [community.aws](https://github.com/ansible-collections/amazon.aws) collections MUST be installed in order for this collection to work.\n\n\u003c!--start requires_ansible--\u003e\n### Ansible version compatibility\n\nThis collection has been tested against following Ansible versions: **\u003e=2.17.0**.\n\n### Included content\n\nClick on the name of a role to view that content's documentation:\n\n\u003c!--start collection content--\u003e\n### Roles\n\nName | Description\n--- | ---\n[cloud.aws_troubleshooting.aws_setup_credentials](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/aws_setup_credentials/README.md)|A role to define credentials for aws modules.\n[cloud.aws_troubleshooting.connectivity_troubleshooter](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter/README.md)|A role to troubleshoot connectivity issues between the following: a) AWS resources within an Amazon Virtual Private Cloud (Amazon VPC); b) AWS resources in different Amazon VPCs within the same AWS Region that are connected using VPC peering; c) AWS resources in an Amazon VPC and an internet resource using an internet gateway; d) AWS resources in an Amazon VPC and an internet resource using a network address translation (NAT) gateway.\n[cloud.aws_troubleshooting.connectivity_troubleshooter_igw](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter_igw/README.md)|A role to troubleshoot connectivity issues between AWS resources in an Amazon VPC and an internet resource using an internet gateway.\n[cloud.aws_troubleshooting.connectivity_troubleshooter_local](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter_local/README.md)|A role to troubleshoot connectivity issues between AWS resources within an Amazon Virtual Private Cloud (Amazon VPC).\n[cloud.aws_troubleshooting.connectivity_troubleshooter_nat](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter_nat/README.md)|A role to troubleshoot connectivity issues between AWS resources in an Amazon VPC and an internet resource using a network address translation (NAT) gateway.\n[cloud.aws_troubleshooting.connectivity_troubleshooter_peering](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter_peering/README.md)|A role to troubleshoot connectivity issues between AWS resources in different Amazon VPCs within the same AWS Region that are connected using VPC peering.\n[cloud.aws_troubleshooting.connectivity_troubleshooter_validate](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/connectivity_troubleshooter_validate/README.md)|A role to validate input parameters for troubleshoot_connectivity_* roles and return connection next hop.\n[cloud.aws_troubleshooting.troubleshoot_rds_connectivity](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/roles/troubleshoot_rds_connectivity/README.md)|A role to troubleshoot RDS connectivity from an EC2 instance.\n\n\u003c!--end collection content--\u003e\n\n## Installation\n\nTo consume this Validated Content from Automation Hub, please ensure that you add the following lines to your ansible.cfg file.\n\n```ini\n[galaxy]\nserver_list = automation_hub\n\n[galaxy_server.automation_hub]\nurl=https://cloud.redhat.com/api/automation-hub/\nauth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token\ntoken=\u003cSuperSecretToken\u003e\n```\n\nThe token can be obtained from the [Automation Hub Web UI](https://console.redhat.com/ansible/automation-hub/token).\n\nOnce the above steps are done, you can run the following command to install the collection.\n\n```shell\nansible-galaxy collection install cloud.aws_troubleshooting\n```\n\n## Use cases\n\nOnce installed, you can reference the cloud.aws_troubleshooting collection content by its fully qualified collection name (FQCN), for example:\n\n```yaml\n  # Troubleshoot when ec2 instance cannot connect to rds instance\n  - hosts: all\n    tasks:\n       - name: Validate that role is also failing\n         block:\n           - name: Include role cloud.aws_troubleshooting.troubleshoot_rds_connectivity\n             ansible.builtin.include_role:\n               name: cloud.aws_troubleshooting.troubleshoot_rds_connectivity\n             vars:\n               troubleshoot_rds_connectivity_db_instance_id: \"{{ rds_identifier }}\"\n               troubleshoot_rds_connectivity_ec2_instance_id: \"{{ ec2_instance_id }}\"\n         rescue:\n           - name: Set role failure info\n             ansible.builtin.set_fact:\n               role_failure_action: \"{{ ansible_failed_task.action }}\"\n               role_failure_msg: \"{{ ansible_failed_result.msg }}\"\n\n  # Troubleshoot AWS resource connectivity\n  - hosts: all\n    tasks:\n       - name: Include 'cloud.aws_troubleshooting.connectivity_troubleshooter' role\n        ansible.builtin.include_role:\n          name: cloud.aws_troubleshooting.connectivity_troubleshooter\n        vars:\n          connectivity_troubleshooter_destination_ip: \"{{ ip_instance_2 }}\"\n          connectivity_troubleshooter_destination_port: 80\n          connectivity_troubleshooter_source_ip: \"{{ ip_instance_1 }}\"\n```\n\n## Contributing to this collection\n\nWe welcome community contributions to this collection. If you find problems, please open an issue or create a PR against this collection repository.\nSee [CONTRIBUTING.md](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/CONTRIBUTING.md) for more details.\n\n### Testing\n\nThe project uses `ansible-lint` and `black`.\nAssuming this repository is checked out in the proper structure,\ne.g. `collections_root/ansible_collections/cloud/aws_troubleshooting/`, run:\n\n```shell\n  tox -e linters\n```\n\nSanity and unit tests are run as normal:\n\n```shell\n  ansible-test sanity\n```\n\nIf you want to run cloud integration tests, ensure you log in to the cloud:\n\n```shell\n# using the \"default\" profile on AWS\n  aws configure set aws_access_key_id     my-access-key\n  aws configure set aws_secret_access_key my-secret-key\n  aws configure set region                eu-north-1\n\n  ansible-test integration [target]\n```\n\nThis collection is tested using GitHub Actions. To know more about CI, refer to [CI.md](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/CI.md).\n\n## Support\n\nFor the latest supported versions, refer to the release notes below.\n\nIf you encounter issues or have questions, you can submit a support request through the following channels:\n - GitHub Issues: Report bugs, request features, or ask questions by opening an issue in the [GitHub repository](https://github.com/redhat-cop/cloud.aws_troubleshooting/).\n - Ansible Community: Engage with the Ansible community on the Ansible Project Mailing List or [Ansible Forum](https://forum.ansible.com/g/AWS).\n\n## Release Notes\n\nSee the [raw generated changelog](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/CHANGELOG.rst).\n\n## Related Information\n\n - [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html).\n - [Ansible Rulebook documentation](https://ansible.readthedocs.io/projects/rulebook/en/stable/index.html).\n - [Ansible Community code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)\n\n## License\n\nGNU General Public License v3.0 or later\nSee [LICENSE](https://github.com/redhat-cop/cloud.aws_troubleshooting/blob/main/LICENSE) to see the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Fcloud.aws_troubleshooting","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredhat-cop%2Fcloud.aws_troubleshooting","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Fcloud.aws_troubleshooting/lists"}