Home Applications Irisheimer

Irisheimer

This application is not supported by InterSystems Corporation. Please be notified that you use it at your own risk.
4.5
0 reviews
0
Awards
63
Views
0
IPM installs
0
0
Details
Releases
Reviews
Issues
Videos  (1)
Articles  (1)
Automates AWS deployment of InterSystems WSGI apps using Pulumi

What's new in this version

Initial Release

🪻 Irisheimer

Irisheimer is a specialized CLI tool designed to streamline the deployment of InterSystems IRIS applications using Flask WSGI servers on AWS infrastructure. This project aims to provide a simple, one-command solution that sets up your application to be deployment-ready from the start.

Purpose

The primary goal of Irisheimer is to eliminate the complex, time-consuming setup process typically associated with deploying InterSystems IRIS applications on AWS. By automating the generation of Pulumi configurations, Irisheimer allows developers to focus on their application logic rather than infrastructure setup.

Features

  • Generates a __main__.py file with Pulumi AWS configuration tailored for InterSystems IRIS and Flask
  • Customizes the configuration with your provided Git repository URL
  • Sets up EC2 instance, VPC, security groups, and other necessary AWS resources
  • Configures the EC2 instance to run a Flask WSGI server optimized for InterSystems IRIS
  • Ensures all necessary ports for IRIS are opened in the security group

Prerequisites

  • Python 3.6+
  • pip
  • Pulumi (for deploying the generated configuration)
  • Basic familiarity with InterSystems IRIS and Flask

Installation

You can install Irisheimer directly from the GitHub repository:

pip install git+https://github.com/flerovious/irisheimer.git#egg=irisheimer

This command installs the package from the main branch of the repository.

For development, you can clone the repository and install it in editable mode:

git clone https://github.com/flerovious/irisheimer.git
cd irisheimer
pip install -e .

If you prefer using Poetry for development:

git clone https://github.com/flerovious/irisheimer.git
cd irisheimer
poetry install

Usage

To set up your InterSystems IRIS Flask application for AWS deployment:

irisheimer 

Replace <repository-url> with the URL of your Git repository containing the IRIS Flask application.

Example:

irisheimer https://github.com/your-username/your-iris-flask-app.git

This command generates a __main.py__ file in your current working directory, containing the Pulumi configuration for deploying your IRIS Flask application on AWS.

Generated Configuration

The __main.py__ file includes Pulumi code to create AWS resources optimized for InterSystems IRIS:

  • EC2 instance (sized appropriately for IRIS)
  • VPC
  • Internet Gateway
  • Public Subnet
  • Route Table
  • Security Group (with IRIS-specific ports opened)

The EC2 instance’s user data script:

  1. Updates the system
  2. Installs necessary dependencies (Git, Docker, Docker Compose)
  3. Clones your specified repository
  4. Sets up and starts your IRIS Flask application using Docker Compose

Next Steps

After generating __main.py__:

  1. Review and adjust the configuration if needed.
  2. Ensure Pulumi is installed and configured.
  3. Run pulumi up in the directory containing __main.py__ to deploy your infrastructure.
  4. Once deployed, your IRIS Flask application will be running on AWS and accessible via the EC2 instance’s public IP or DNS.

Contributing

Contributions to improve Irisheimer are welcome! Please feel free to submit a Pull Request to the GitHub repository.

License

MIT License

Support

If you encounter any issues or have questions about deploying InterSystems IRIS applications with Irisheimer, please open an issue on the GitHub repository.

Made with
Version
1.0.022 Sep, 2024
Category
Developer Environment
Works with
InterSystems IRIS
First published
22 Sep, 2024