From e40caa55e88182391d1923a2312d97aad8703875 Mon Sep 17 00:00:00 2001 From: git_admin Date: Sun, 3 May 2026 18:54:19 +0000 Subject: [PATCH] Tower: upload cetmix_tower_aws 18.0.1.0.1 (was 18.0.1.0.1, via marketplace) --- addons/cetmix_tower_aws/README.rst | 308 ++++++++ addons/cetmix_tower_aws/__init__.py | 1 + addons/cetmix_tower_aws/__manifest__.py | 24 + addons/cetmix_tower_aws/demo/demo_data.xml | 74 ++ .../i18n/cetmix_tower_aws.pot | 31 + addons/cetmix_tower_aws/i18n/it.po | 39 + addons/cetmix_tower_aws/models/__init__.py | 1 + .../models/cx_tower_command.py | 40 + addons/cetmix_tower_aws/pyproject.toml | 3 + addons/cetmix_tower_aws/readme/CONFIGURE.md | 42 ++ addons/cetmix_tower_aws/readme/CONTEXT.md | 5 + addons/cetmix_tower_aws/readme/DESCRIPTION.md | 6 + addons/cetmix_tower_aws/readme/HISTORY.md | 0 addons/cetmix_tower_aws/readme/USAGE.md | 121 ++++ .../readme/newsfragments/.gitkeep | 0 .../static/description/banner.png | Bin 0 -> 93498 bytes .../static/description/icon.png | Bin 0 -> 22128 bytes .../static/description/index.html | 684 ++++++++++++++++++ addons/cetmix_tower_aws/tests/__init__.py | 1 + .../tests/test_boto3_integration.py | 64 ++ 20 files changed, 1444 insertions(+) create mode 100644 addons/cetmix_tower_aws/README.rst create mode 100644 addons/cetmix_tower_aws/__init__.py create mode 100644 addons/cetmix_tower_aws/__manifest__.py create mode 100644 addons/cetmix_tower_aws/demo/demo_data.xml create mode 100644 addons/cetmix_tower_aws/i18n/cetmix_tower_aws.pot create mode 100644 addons/cetmix_tower_aws/i18n/it.po create mode 100644 addons/cetmix_tower_aws/models/__init__.py create mode 100644 addons/cetmix_tower_aws/models/cx_tower_command.py create mode 100644 addons/cetmix_tower_aws/pyproject.toml create mode 100644 addons/cetmix_tower_aws/readme/CONFIGURE.md create mode 100644 addons/cetmix_tower_aws/readme/CONTEXT.md create mode 100644 addons/cetmix_tower_aws/readme/DESCRIPTION.md create mode 100644 addons/cetmix_tower_aws/readme/HISTORY.md create mode 100644 addons/cetmix_tower_aws/readme/USAGE.md create mode 100644 addons/cetmix_tower_aws/readme/newsfragments/.gitkeep create mode 100644 addons/cetmix_tower_aws/static/description/banner.png create mode 100644 addons/cetmix_tower_aws/static/description/icon.png create mode 100644 addons/cetmix_tower_aws/static/description/index.html create mode 100644 addons/cetmix_tower_aws/tests/__init__.py create mode 100644 addons/cetmix_tower_aws/tests/test_boto3_integration.py diff --git a/addons/cetmix_tower_aws/README.rst b/addons/cetmix_tower_aws/README.rst new file mode 100644 index 0000000..30a7885 --- /dev/null +++ b/addons/cetmix_tower_aws/README.rst @@ -0,0 +1,308 @@ +================ +Cetmix Tower AWS +================ + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:e427fa4368b78aacbc6faa6232b54496e83fbe4905ddef4cc17f3913e5ee3ee0 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-cetmix%2Fcetmix--tower-lightgray.png?logo=github + :target: https://github.com/cetmix/cetmix-tower/tree/18.0/cetmix_tower_aws + :alt: cetmix/cetmix-tower + +|badge1| |badge2| |badge3| + +**⚠️ DISCLAIMER: TECHNICAL MODULE** + +This module integrates Boto3 library, the Amazon Web Services (AWS) +Software Development Kit (SDK) for Python, into the Cetmix Tower. + + **This is a technical module intended for system administrators or + DevOps professionals.** It may involve server configuration, + infrastructure management, or advanced setup outside the standard + Odoo interface. Not intended for direct use by end users. + +**Table of contents** + +.. contents:: + :local: + +Use Cases / Context +=================== + +Although Amazon Web Services (AWS) allows API calls without using an +SDK, we found that integrating the Amazon SDK into Cetmix Tower makes +provisioning, configuring, and maintaining AWS instances more convenient +for the end user. However, not all Cetmix Tower users require this +functionality, so to avoid overloading the system, we have included it +in a separate module. + +Configuration +============= + +**Prerequisites** + +The module has ``boto3`` defined in its external dependencies, which +means, you should install the Python ``boto3`` package manually if you +don't have automatic package installation configured in your Odoo +environment. Run ``pip install boto3`` to install it. + +**Setting up AWS Access** + +1. **Create AWS Access Keys** + + To use the AWS integration with Cetmix Tower, you need to create AWS + access keys: + + - Follow the `official AWS + documentation `__ + (https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) + for creating IAM access keys + - It's recommended to create a dedicated IAM user with appropriate + permissions for Cetmix Tower + - Store your access key ID and secret access key securely - you'll + need them in the next step + +2. **Configure AWS Secrets in Cetmix Tower** + + Create two secrets in Cetmix Tower to store your AWS credentials: + + - Navigate to ``Cetmix Tower > Settings > Keys and Secrets`` + - Create a new Secret with: + + - Name: ``AWS Access Key`` + - Reference: ``aws_access_key`` + - Key Type: ``Secret`` + + - Enter your AWS access key ID in the Secret Value tab + - Similarly, create another Secret with: + + - Name: ``AWS Secret Access Key`` + - Reference: ``aws_secret_access_key`` + - Key Type: ``Secret`` + + - Enter your AWS secret access key in the Secret Value tab + + .. + + Note: These secrets will be accessible as + ``#!cxtower.secret.aws_access_key!#`` and + ``#!cxtower.secret.aws_secret_access_key!#`` in your commands. + +3. **Configure AWS Region** + + Create a variable to define your AWS region: + + - Navigate to ``Cetmix Tower > Settings > Variables`` + - Create a new Variable with: + + - Name: ``AWS Region Name`` + - Reference: ``aws_region_name`` + - Type: ``String`` + + - Set your AWS region (e.g., ``us-east-1``, ``eu-west-1``) as the + value + +Usage +===== + +Please check the `official Boto3 +Documentation `__ +(https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) for +the detailed information about the services and methods provided by the +Boto3 library. + + **Disclaimer**: The following example demonstrates one of many + possible commands you can create and run with this module. The boto3 + library provides access to the full range of AWS services and methods + - this is just a starting point to help you get familiar with the + integration. + +Example of Cetmix Tower Python Command to List EC2 Instances +------------------------------------------------------------ + +Navigate to Command Creation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Go to ``Cetmix Tower > Commands > Commands`` +- Click the ``Create`` button + +Configure Command Settings +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Set a descriptive ``Name`` (e.g., "List AWS EC2 Instances") +- Leave ``Reference`` blank to generate automatically (or set a custom + reference) +- Select ``Action``: "Execute Python code" +- Set ``Access Level``: Choose appropriate level (e.g., "Manager") +- Optional: Set ``Default Path`` if needed +- Optional: Add ``Tags`` (e.g., "aws", "ec2") for better organization + +Add Required Variables +~~~~~~~~~~~~~~~~~~~~~~ + +- In the ``Variables`` tab, add the previously configured variable: + + - ``aws_region_name`` + +Add Required Secrets +~~~~~~~~~~~~~~~~~~~~ + +- In the ``Secrets`` field, add the previously configured secrets: + + - ``aws_access_key`` + - ``aws_secret_access_key`` + +Write Python Code +~~~~~~~~~~~~~~~~~ + +- Go to the ``Code`` tab + +- Enter the following Python code: + + .. code:: python + + # List EC2 instances using boto3 + result = {"exit_code": 0, "message": None} + + session = boto3.Session( + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#, + region_name={{ aws_region_name }} + ) + ec2 = session.client('ec2') + instances = ec2.describe_instances() + + instance_details = [] + for reservation in instances['Reservations']: + for instance in reservation['Instances']: + instance_detail = "Instance ID: " + instance['InstanceId'] + instance_detail += ", Type: " + instance.get('InstanceType', 'Unknown') + instance_detail += ", State: " + instance.get('State', {}).get('Name', 'Unknown') + instance_details.append(instance_detail) + + if instance_details: + result["message"] = "Found " + str(len(instance_details)) + " EC2 instances:\n" + "\n".join(instance_details) + else: + result["message"] = "No EC2 instances found" + +Save the Command +~~~~~~~~~~~~~~~~ + +- Click the ``Save`` button to create the command + +Running the AWS EC2 Command +--------------------------- + +Navigate to Server +~~~~~~~~~~~~~~~~~~ + +- Go to ``Cetmix Tower > Servers > Servers`` +- Open the server where you want to run the command + +Execute Command from Server +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Click the ``Command`` button at the top of the server form +- In the popup dialog: + + - Select your AWS EC2 command from the dropdown + - Verify the variable values (if any need adjustment) + - Click ``Run`` to execute + +View Command Results +~~~~~~~~~~~~~~~~~~~~ + +- After execution, the command log will display showing: + + - The command executed + - Execution status + - Output message containing EC2 instance details if successful + +Example Output +-------------- + +For a successful execution with EC2 instances: + +.. code:: bash + + Found 3 EC2 instances: + Instance ID: i-0abc123def456789, Type: t2.micro, State: running + Instance ID: i-0def456abc789123, Type: t3.medium, State: stopped + Instance ID: i-0789abc123def456, Type: m5.large, State: running + +For a successful execution with no EC2 instances: + +.. code:: bash + + No EC2 instances found + +Creating Additional AWS Commands +-------------------------------- + +The cetmix_tower_aws module provides access to the boto3 Python library +for AWS service integration. Here are some common services you can use: + +.. code:: python + + # Standard client initialization pattern + client = boto3.client( + 'service_name', # Replace with: ec2, s3, rds, cloudwatch, etc. + region_name={{ aws_region_name }}, + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!# + ) + + # Or use resource interface for object-oriented access + resource = boto3.resource( + 'service_name', # Replace with: ec2, s3, etc. + region_name={{ aws_region_name }}, + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!# + ) + +Popular AWS services include: EC2 (compute), S3 (storage), RDS +(databases), and CloudWatch (monitoring). + +For more details, see the `AWS Boto3 +Documentation `__. + +Changelog +========= + + + +Bug Tracker +=========== + +Bugs are tracked on `GitHub Issues `_. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +------- + +* Cetmix + +Maintainers +----------- + +This module is part of the `cetmix/cetmix-tower `_ project on GitHub. + +You are welcome to contribute. diff --git a/addons/cetmix_tower_aws/__init__.py b/addons/cetmix_tower_aws/__init__.py new file mode 100644 index 0000000..0650744 --- /dev/null +++ b/addons/cetmix_tower_aws/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/addons/cetmix_tower_aws/__manifest__.py b/addons/cetmix_tower_aws/__manifest__.py new file mode 100644 index 0000000..04e3a1f --- /dev/null +++ b/addons/cetmix_tower_aws/__manifest__.py @@ -0,0 +1,24 @@ +# Copyright 2024 Cetmix OÜ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Cetmix Tower AWS", + "summary": """Cetmix Tower AWS EC2 API integration""", + "version": "18.0.1.0.1", + "category": "Productivity", + "license": "AGPL-3", + "author": "Cetmix", + "website": "https://tower.cetmix.com", + "live_test_url": "https://tower.cetmix.com/download", + "images": ["static/description/banner.png"], + "installable": True, + "external_dependencies": { + "python": ["boto3"], + }, + "depends": [ + "cetmix_tower_server", + ], + "demo": [ + "demo/demo_data.xml", + ], +} diff --git a/addons/cetmix_tower_aws/demo/demo_data.xml b/addons/cetmix_tower_aws/demo/demo_data.xml new file mode 100644 index 0000000..6408168 --- /dev/null +++ b/addons/cetmix_tower_aws/demo/demo_data.xml @@ -0,0 +1,74 @@ + + + + + AWS Access Key + aws_access_key + s + AKIAIOSFODNN7EXAMPLE + + + + AWS Secret Access Key + aws_secret_access_key + s + wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY + + + + + AWS Region Name + aws_region_name + + + + + + us-east-1 + + + + + List AWS EC2 Instances + python_code + +# List EC2 instances using boto3 +result = {"exit_code": 0, "message": None} + +session = boto3.Session( + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#, + region_name={{ aws_region_name }} +) +ec2 = session.client('ec2') +instances = ec2.describe_instances() + +instance_details = [] +for reservation in instances['Reservations']: + for instance in reservation['Instances']: + instance_detail = "Instance ID: " + instance['InstanceId'] + instance_detail += ", Type: " + instance.get('InstanceType', 'Unknown') + instance_detail += ", State: " + instance.get('State', {}).get('Name', 'Unknown') + instance_details.append(instance_detail) + +if instance_details: + result["message"] = "Found " + str(len(instance_details)) + " EC2 instances:\n" + "\n".join(instance_details) +else: + result["message"] = "No EC2 instances found" + + 1 + + List EC2 instances using boto3 AWS SDK + + diff --git a/addons/cetmix_tower_aws/i18n/cetmix_tower_aws.pot b/addons/cetmix_tower_aws/i18n/cetmix_tower_aws.pot new file mode 100644 index 0000000..e751860 --- /dev/null +++ b/addons/cetmix_tower_aws/i18n/cetmix_tower_aws.pot @@ -0,0 +1,31 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * cetmix_tower_aws +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 18.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: cetmix_tower_aws +#: model:ir.model,name:cetmix_tower_aws.model_cx_tower_command +msgid "Cetmix Tower Command" +msgstr "" + +#. module: cetmix_tower_aws +#. odoo-python +#: code:addons/cetmix_tower_aws/models/cx_tower_command.py:0 +msgid "" +"Python 'boto3' library for AWS services. Available methods: 'client', " +"'resource', 'Session'
Supports AWS services like EC2, S3, RDS, Lambda, " +"CloudWatch, etc.
Please check the Boto3 Documentation for the detailed information about " +"the services and methods." +msgstr "" diff --git a/addons/cetmix_tower_aws/i18n/it.po b/addons/cetmix_tower_aws/i18n/it.po new file mode 100644 index 0000000..cc3f90d --- /dev/null +++ b/addons/cetmix_tower_aws/i18n/it.po @@ -0,0 +1,39 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * cetmix_tower_aws +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 18.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: \n" +"PO-Revision-Date: \n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"X-Generator: Poedit 2.3\n" +"Language: it\n" + +#. module: cetmix_tower_aws +#: model:ir.model,name:cetmix_tower_aws.model_cx_tower_command +msgid "Cetmix Tower Command" +msgstr "Comando Cetmix Tower" + +#. module: cetmix_tower_aws +#. odoo-python +#: code:addons/cetmix_tower_aws/models/cx_tower_command.py:0 +#, python-format +msgid "Python 'boto3' library for AWS services. Available methods: 'client', 'resource', 'Session'
Supports AWS services like EC2, S3, RDS, Lambda, CloudWatch, etc.
Please check the Boto3 Documentation for the detailed information about the services and methods." +msgstr "Libreria Python 'boto3' per servizi AWS. Metodi disponibili: 'client', 'resource', 'Session'
Supporta servizi AWS come EC2, S3, RDS, Lambda, CloudWatch, ecc.
Consultare la documentazione Boto3 per informazioni dettagliate su servizi e metodi." + +#~ msgid "" +#~ "# - boto3: Python 'boto3' library for AWS services. Available methods: " +#~ "'client', 'resource', 'Session'\n" +#~ "# Supports AWS services like EC2, S3, RDS, Lambda, CloudWatch, etc." +#~ msgstr "" +#~ "# - boto3: libreria Python 'boto3' per servizi AWS. Metodi disponibili: " +#~ "'client', 'resource', 'Session'\n" +#~ "# Supporta servizi AWS come EC2, S3, RDS, Lambda, CloudWatch, ecc." diff --git a/addons/cetmix_tower_aws/models/__init__.py b/addons/cetmix_tower_aws/models/__init__.py new file mode 100644 index 0000000..3b8ff9d --- /dev/null +++ b/addons/cetmix_tower_aws/models/__init__.py @@ -0,0 +1 @@ +from . import cx_tower_command diff --git a/addons/cetmix_tower_aws/models/cx_tower_command.py b/addons/cetmix_tower_aws/models/cx_tower_command.py new file mode 100644 index 0000000..b6126d9 --- /dev/null +++ b/addons/cetmix_tower_aws/models/cx_tower_command.py @@ -0,0 +1,40 @@ +# Copyright 2024 Cetmix OÜ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import _, models +from odoo.tools.safe_eval import wrap_module + +# Wrap boto3 safely +boto3 = wrap_module(__import__("boto3"), ["client", "resource", "Session"]) + + +class CxTowerCommand(models.Model): + """Extends cx.tower.command to add AWS boto3 functionality.""" + + _inherit = "cx.tower.command" + + def _custom_python_libraries(self): + """ + Add the boto3 library to the available libraries. + """ + custom_python_libraries = super()._custom_python_libraries() + custom_python_libraries.update( + { + "cetmix_tower_aws": { + "boto3": { + "import": boto3, + "help": _( + "Python 'boto3' library for AWS services. " + "Available methods: 'client', 'resource', 'Session'
" + "Supports AWS services like EC2, S3, RDS, Lambda, " + "CloudWatch, etc.
" + "Please check the Boto3 Documentation for the detailed " + "information about the services and methods." + ), + }, + } + } + ) + return custom_python_libraries diff --git a/addons/cetmix_tower_aws/pyproject.toml b/addons/cetmix_tower_aws/pyproject.toml new file mode 100644 index 0000000..4231d0c --- /dev/null +++ b/addons/cetmix_tower_aws/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/addons/cetmix_tower_aws/readme/CONFIGURE.md b/addons/cetmix_tower_aws/readme/CONFIGURE.md new file mode 100644 index 0000000..507f735 --- /dev/null +++ b/addons/cetmix_tower_aws/readme/CONFIGURE.md @@ -0,0 +1,42 @@ +**Prerequisites** + +The module has `boto3` defined in its external dependencies, which means, you should install the Python `boto3` package manually if you don't have automatic package installation configured in your Odoo environment. Run `pip install boto3` to install it. + +**Setting up AWS Access** + +1. **Create AWS Access Keys** + + To use the AWS integration with Cetmix Tower, you need to create AWS access keys: + + - Follow the [official AWS documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) (https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) for creating IAM access keys + - It's recommended to create a dedicated IAM user with appropriate permissions for Cetmix Tower + - Store your access key ID and secret access key securely - you'll need them in the next step + +2. **Configure AWS Secrets in Cetmix Tower** + + Create two secrets in Cetmix Tower to store your AWS credentials: + + - Navigate to `Cetmix Tower > Settings > Keys and Secrets` + - Create a new Secret with: + - Name: `AWS Access Key` + - Reference: `aws_access_key` + - Key Type: `Secret` + - Enter your AWS access key ID in the Secret Value tab + - Similarly, create another Secret with: + - Name: `AWS Secret Access Key` + - Reference: `aws_secret_access_key` + - Key Type: `Secret` + - Enter your AWS secret access key in the Secret Value tab + + > Note: These secrets will be accessible as `#!cxtower.secret.aws_access_key!#` and `#!cxtower.secret.aws_secret_access_key!#` in your commands. + +3. **Configure AWS Region** + + Create a variable to define your AWS region: + + - Navigate to `Cetmix Tower > Settings > Variables` + - Create a new Variable with: + - Name: `AWS Region Name` + - Reference: `aws_region_name` + - Type: `String` + - Set your AWS region (e.g., `us-east-1`, `eu-west-1`) as the value diff --git a/addons/cetmix_tower_aws/readme/CONTEXT.md b/addons/cetmix_tower_aws/readme/CONTEXT.md new file mode 100644 index 0000000..b7f251f --- /dev/null +++ b/addons/cetmix_tower_aws/readme/CONTEXT.md @@ -0,0 +1,5 @@ +Although Amazon Web Services (AWS) allows API calls without using an SDK, we found that +integrating the Amazon SDK into Cetmix Tower makes provisioning, configuring, and +maintaining AWS instances more convenient for the end user. However, not all Cetmix +Tower users require this functionality, so to avoid overloading the system, we have +included it in a separate module. diff --git a/addons/cetmix_tower_aws/readme/DESCRIPTION.md b/addons/cetmix_tower_aws/readme/DESCRIPTION.md new file mode 100644 index 0000000..3edf51d --- /dev/null +++ b/addons/cetmix_tower_aws/readme/DESCRIPTION.md @@ -0,0 +1,6 @@ +**⚠️ DISCLAIMER: TECHNICAL MODULE** + +This module integrates Boto3 library, the Amazon Web Services (AWS) Software Development Kit (SDK) for Python, into the Cetmix Tower. + +> **This is a technical module intended for system administrators or DevOps professionals.** It may involve server configuration, infrastructure management, or advanced setup outside the standard Odoo interface. Not intended for direct use by end users. + diff --git a/addons/cetmix_tower_aws/readme/HISTORY.md b/addons/cetmix_tower_aws/readme/HISTORY.md new file mode 100644 index 0000000..e69de29 diff --git a/addons/cetmix_tower_aws/readme/USAGE.md b/addons/cetmix_tower_aws/readme/USAGE.md new file mode 100644 index 0000000..92cc9b9 --- /dev/null +++ b/addons/cetmix_tower_aws/readme/USAGE.md @@ -0,0 +1,121 @@ +Please check the [official Boto3 Documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) (https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) for the detailed information about the services and methods provided by the Boto3 library. + +> **Disclaimer**: The following example demonstrates one of many possible commands you can create and run with this module. The boto3 library provides access to the full range of AWS services and methods - this is just a starting point to help you get familiar with the integration. + +## Example of Cetmix Tower Python Command to List EC2 Instances + +### Navigate to Command Creation +- Go to `Cetmix Tower > Commands > Commands` +- Click the `Create` button + +### Configure Command Settings +- Set a descriptive `Name` (e.g., "List AWS EC2 Instances") +- Leave `Reference` blank to generate automatically (or set a custom reference) +- Select `Action`: "Execute Python code" +- Set `Access Level`: Choose appropriate level (e.g., "Manager") +- Optional: Set `Default Path` if needed +- Optional: Add `Tags` (e.g., "aws", "ec2") for better organization + +### Add Required Variables +- In the `Variables` tab, add the previously configured variable: + - `aws_region_name` + +### Add Required Secrets +- In the `Secrets` field, add the previously configured secrets: + - `aws_access_key` + - `aws_secret_access_key` + +### Write Python Code +- Go to the `Code` tab +- Enter the following Python code: + + ```python + # List EC2 instances using boto3 + result = {"exit_code": 0, "message": None} + + session = boto3.Session( + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#, + region_name={{ aws_region_name }} + ) + ec2 = session.client('ec2') + instances = ec2.describe_instances() + + instance_details = [] + for reservation in instances['Reservations']: + for instance in reservation['Instances']: + instance_detail = "Instance ID: " + instance['InstanceId'] + instance_detail += ", Type: " + instance.get('InstanceType', 'Unknown') + instance_detail += ", State: " + instance.get('State', {}).get('Name', 'Unknown') + instance_details.append(instance_detail) + + if instance_details: + result["message"] = "Found " + str(len(instance_details)) + " EC2 instances:\n" + "\n".join(instance_details) + else: + result["message"] = "No EC2 instances found" + ``` + +### Save the Command +- Click the `Save` button to create the command + +## Running the AWS EC2 Command + +### Navigate to Server +- Go to `Cetmix Tower > Servers > Servers` +- Open the server where you want to run the command + +### Execute Command from Server +- Click the `Command` button at the top of the server form +- In the popup dialog: + - Select your AWS EC2 command from the dropdown + - Verify the variable values (if any need adjustment) + - Click `Run` to execute + +### View Command Results +- After execution, the command log will display showing: + - The command executed + - Execution status + - Output message containing EC2 instance details if successful + +## Example Output + +For a successful execution with EC2 instances: + +```bash +Found 3 EC2 instances: +Instance ID: i-0abc123def456789, Type: t2.micro, State: running +Instance ID: i-0def456abc789123, Type: t3.medium, State: stopped +Instance ID: i-0789abc123def456, Type: m5.large, State: running +``` + +For a successful execution with no EC2 instances: + +```bash +No EC2 instances found +``` + +## Creating Additional AWS Commands + +The cetmix_tower_aws module provides access to the boto3 Python library for AWS service integration. Here are some common services you can use: + +```python +# Standard client initialization pattern +client = boto3.client( + 'service_name', # Replace with: ec2, s3, rds, cloudwatch, etc. + region_name={{ aws_region_name }}, + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!# +) + +# Or use resource interface for object-oriented access +resource = boto3.resource( + 'service_name', # Replace with: ec2, s3, etc. + region_name={{ aws_region_name }}, + aws_access_key_id=#!cxtower.secret.aws_access_key!#, + aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!# +) +``` + +Popular AWS services include: EC2 (compute), S3 (storage), RDS (databases), and CloudWatch (monitoring). + +For more details, see the [AWS Boto3 Documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html). diff --git a/addons/cetmix_tower_aws/readme/newsfragments/.gitkeep b/addons/cetmix_tower_aws/readme/newsfragments/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/addons/cetmix_tower_aws/static/description/banner.png b/addons/cetmix_tower_aws/static/description/banner.png new file mode 100644 index 0000000000000000000000000000000000000000..6208375d55a732bfe97fed2858b1bfd345b98fcd GIT binary patch literal 93498 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 F{{#JqH_ZS5 literal 0 HcmV?d00001 diff --git a/addons/cetmix_tower_aws/static/description/index.html b/addons/cetmix_tower_aws/static/description/index.html new file mode 100644 index 0000000..c7b841e --- /dev/null +++ b/addons/cetmix_tower_aws/static/description/index.html @@ -0,0 +1,684 @@ + + + + + +Cetmix Tower AWS + + + +
+

Cetmix Tower AWS

+ + +

Beta License: AGPL-3 cetmix/cetmix-tower

+

⚠️ DISCLAIMER: TECHNICAL MODULE

+

This module integrates Boto3 library, the Amazon Web Services (AWS) +Software Development Kit (SDK) for Python, into the Cetmix Tower.

+
+This is a technical module intended for system administrators or +DevOps professionals. It may involve server configuration, +infrastructure management, or advanced setup outside the standard +Odoo interface. Not intended for direct use by end users.
+

Table of contents

+ +
+

Use Cases / Context

+

Although Amazon Web Services (AWS) allows API calls without using an +SDK, we found that integrating the Amazon SDK into Cetmix Tower makes +provisioning, configuring, and maintaining AWS instances more convenient +for the end user. However, not all Cetmix Tower users require this +functionality, so to avoid overloading the system, we have included it +in a separate module.

+
+
+

Configuration

+

Prerequisites

+

The module has boto3 defined in its external dependencies, which +means, you should install the Python boto3 package manually if you +don’t have automatic package installation configured in your Odoo +environment. Run pip install boto3 to install it.

+

Setting up AWS Access

+
    +

  1. Create AWS Access Keys

    +

    To use the AWS integration with Cetmix Tower, you need to create AWS +access keys:

    + +
    2. +

  2. Configure AWS Secrets in Cetmix Tower

    +

    Create two secrets in Cetmix Tower to store your AWS credentials:

    +
      +
    • Navigate to Cetmix Tower > Settings > Keys and Secrets
      • +
    • Create a new Secret with:
        +
      • Name: AWS Access Key
        • +
      • Reference: aws_access_key
        • +
      • Key Type: Secret
        • +
      +
      • +
    • Enter your AWS access key ID in the Secret Value tab
      • +
    • Similarly, create another Secret with:
        +
      • Name: AWS Secret Access Key
        • +
      • Reference: aws_secret_access_key
        • +
      • Key Type: Secret
        • +
      +
      • +
    • Enter your AWS secret access key in the Secret Value tab
      • +
    + +
    +

    Note: These secrets will be accessible as +#!cxtower.secret.aws_access_key!# and +#!cxtower.secret.aws_secret_access_key!# in your commands.

    +
    +
    3. +

  3. Configure AWS Region

    +

    Create a variable to define your AWS region:

    +
      +
    • Navigate to Cetmix Tower > Settings > Variables
      • +
    • Create a new Variable with:
        +
      • Name: AWS Region Name
        • +
      • Reference: aws_region_name
        • +
      • Type: String
        • +
      +
      • +
    • Set your AWS region (e.g., us-east-1, eu-west-1) as the +value
      • +
    +
    4. +
+
+
+

Usage

+

Please check the official Boto3 +Documentation +(https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) for +the detailed information about the services and methods provided by the +Boto3 library.

+
+Disclaimer: The following example demonstrates one of many +possible commands you can create and run with this module. The boto3 +library provides access to the full range of AWS services and methods +- this is just a starting point to help you get familiar with the +integration.
+
+

Example of Cetmix Tower Python Command to List EC2 Instances

+ +
+

Configure Command Settings

+
    +
  • Set a descriptive Name (e.g., “List AWS EC2 Instances”)
    • +
  • Leave Reference blank to generate automatically (or set a custom +reference)
    • +
  • Select Action: “Execute Python code”
    • +
  • Set Access Level: Choose appropriate level (e.g., “Manager”)
    • +
  • Optional: Set Default Path if needed
    • +
  • Optional: Add Tags (e.g., “aws”, “ec2”) for better organization
    • +
+
+
+

Add Required Variables

+
    +
  • In the Variables tab, add the previously configured variable:
      +
    • aws_region_name
      • +
    +
    • +
+
+
+

Add Required Secrets

+
    +
  • In the Secrets field, add the previously configured secrets:
      +
    • aws_access_key
      • +
    • aws_secret_access_key
      • +
    +
    • +
+
+
+

Write Python Code

+
    +

  • Go to the Code tab

    +
    • +

  • Enter the following Python code:

    +
    +# List EC2 instances using boto3
+result = {"exit_code": 0, "message": None}
+
+session = boto3.Session(
+    aws_access_key_id=#!cxtower.secret.aws_access_key!#,
+    aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#,
+    region_name={{ aws_region_name }}
+)
+ec2 = session.client('ec2')
+instances = ec2.describe_instances()
+
+instance_details = []
+for reservation in instances['Reservations']:
+    for instance in reservation['Instances']:
+        instance_detail = "Instance ID: " + instance['InstanceId']
+        instance_detail += ", Type: " + instance.get('InstanceType', 'Unknown')
+        instance_detail += ", State: " + instance.get('State', {}).get('Name', 'Unknown')
+        instance_details.append(instance_detail)
+
+if instance_details:
+    result["message"] = "Found " + str(len(instance_details)) + " EC2 instances:\n" + "\n".join(instance_details)
+else:
+    result["message"] = "No EC2 instances found"
+
    +
    • +
+
+
+

Save the Command

+
    +
  • Click the Save button to create the command
    • +
+
+
+
+

Running the AWS EC2 Command

+ +
+

Execute Command from Server

+
    +
  • Click the Command button at the top of the server form
    • +
  • In the popup dialog:
      +
    • Select your AWS EC2 command from the dropdown
      • +
    • Verify the variable values (if any need adjustment)
      • +
    • Click Run to execute
      • +
    +
    • +
+
+
+

View Command Results

+
    +
  • After execution, the command log will display showing:
      +
    • The command executed
      • +
    • Execution status
      • +
    • Output message containing EC2 instance details if successful
      • +
    +
    • +
+
+
+
+

Example Output

+

For a successful execution with EC2 instances:

+
+Found 3 EC2 instances:
+Instance ID: i-0abc123def456789, Type: t2.micro, State: running
+Instance ID: i-0def456abc789123, Type: t3.medium, State: stopped
+Instance ID: i-0789abc123def456, Type: m5.large, State: running
+
+

For a successful execution with no EC2 instances:

+
+No EC2 instances found
+
+
+
+

Creating Additional AWS Commands

+

The cetmix_tower_aws module provides access to the boto3 Python library +for AWS service integration. Here are some common services you can use:

+
+# Standard client initialization pattern
+client = boto3.client(
+    'service_name',  # Replace with: ec2, s3, rds, cloudwatch, etc.
+    region_name={{ aws_region_name }},
+    aws_access_key_id=#!cxtower.secret.aws_access_key!#,
+    aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#
+)
+
+# Or use resource interface for object-oriented access
+resource = boto3.resource(
+    'service_name',  # Replace with: ec2, s3, etc.
+    region_name={{ aws_region_name }},
+    aws_access_key_id=#!cxtower.secret.aws_access_key!#,
+    aws_secret_access_key=#!cxtower.secret.aws_secret_access_key!#
+)
+
+

Popular AWS services include: EC2 (compute), S3 (storage), RDS +(databases), and CloudWatch (monitoring).

+

For more details, see the AWS Boto3 +Documentation.

+
+
+ +
+

Bug Tracker

+

Bugs are tracked on GitHub Issues. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +feedback.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Cetmix
    • +
+
+
+

Maintainers

+

This module is part of the cetmix/cetmix-tower project on GitHub.

+

You are welcome to contribute.

+
+
+
+ + diff --git a/addons/cetmix_tower_aws/tests/__init__.py b/addons/cetmix_tower_aws/tests/__init__.py new file mode 100644 index 0000000..bcd6c6b --- /dev/null +++ b/addons/cetmix_tower_aws/tests/__init__.py @@ -0,0 +1 @@ +from . import test_boto3_integration diff --git a/addons/cetmix_tower_aws/tests/test_boto3_integration.py b/addons/cetmix_tower_aws/tests/test_boto3_integration.py new file mode 100644 index 0000000..136f0f0 --- /dev/null +++ b/addons/cetmix_tower_aws/tests/test_boto3_integration.py @@ -0,0 +1,64 @@ +# Copyright 2024 Cetmix OÜ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). +from odoo.tests import common + + +class TestBoto3Integration(common.TransactionCase): + """Test boto3 integration with Cetmix Tower commands.""" + + def setUp(self): + super().setUp() + # Create a test command + self.command = self.env["cx.tower.command"].create( + { + "name": "Test AWS Command", + "action": "python_code", + } + ) + self.eval_context = self.env[ + "cx.tower.command" + ]._get_python_command_eval_context() + + def test_boto3_in_evaluation_context(self): + """Test that boto3 is added to the evaluation context.""" + # Get evaluation context + # Check if boto3 is in the evaluation context + self.assertIn("boto3", self.eval_context) + # Check available methods + boto3_obj = self.eval_context["boto3"] + self.assertTrue(hasattr(boto3_obj, "client")) + self.assertTrue(hasattr(boto3_obj, "resource")) + self.assertTrue(hasattr(boto3_obj, "Session")) + + def test_boto3_in_evaluation_context_with_server(self): + """Test that boto3 is added to the evaluation context + when server is provided.""" + # Create a test server + test_server = self.env["cx.tower.server"].create( + { + "name": "Test AWS Server", + "reference": "test_aws_server", + "ip_v4_address": "localhost", + "ssh_username": "admin", + "ssh_password": "password", + "ssh_auth_mode": "p", + "host_key": "test_key", + } + ) + + # Get evaluation context with server + eval_context = self.env["cx.tower.command"]._get_python_command_eval_context( + server=test_server + ) + + # Check if boto3 is in the evaluation context + self.assertIn("boto3", eval_context) + + # Check available methods + boto3_obj = eval_context["boto3"] + self.assertTrue(hasattr(boto3_obj, "client")) + self.assertTrue(hasattr(boto3_obj, "resource")) + self.assertTrue(hasattr(boto3_obj, "Session")) + + # Verify server is correctly passed to the context + self.assertEqual(eval_context["server"], test_server)