GitmoxiLogo Gitmoxi

Navigation Pane

Overview
Getting Started
Install on ECS Fargate
Install on EKS
Repo Setup
Testing ECS
Testing EKS
Testing Lambda
Uninstall Gitmoxi
Core Concepts
Gitmoxi for ECS
ECS Deployment Definition
Gitmoxi for Lambda
Lambda Deployment Definition
Lambda Event Source Mapping
Input Parameterization
CLI Reference

Install Gitmoxi on ECS Fargate

Prerequisites

Make sure you have done all the steps in the Getting Started section and set the following environment variables which are required for installing Gitmoxi on ECS Fargate.

AWS_REGION
AWS_ACCOUNT
AWS_PROFILE
GITHUB_TOKEN

Required AWS IAM Role

The Gitmoxi Terraform will use your AWS credentials to create the following resources. Ensure that your signed-in user has permissions to create:

Resource TypeDetails
Network Infrastructure• VPC with subnets (1 private, 1 public per AZ)
• NAT Gateways
• Internet Gateways
Load Balancing• Application Load Balancer (ALB)
• One listener
• Two target groups for blue/green deployment
• Security group for load balancer
Container Services• ECS cluster
• Gitmoxi ECS service and task definition
• Security group for Gitmoxi ECS task
IAM• IAM roles for Gitmoxi ECS task
Logging• CloudWatch log group for Gitmoxi containers

Start by setting few input variables needed by the Terraform module.

export TF_VAR_github_token=$GITHUB_TOKEN
export TF_VAR_aws_region=$AWS_REGION
export TF_VAR_aws_account_id=$AWS_ACCOUNT

Install Gitmoxi

Go to the gitmoxi-trial directory, which is obtained by unzipping the trial download file you recieved in email. Under the ecs-fargate directory you will find the gitmoxi.tf which has all the infrastructure needed for installing Gitmoxi on ECS/Fargate.

cd gitmoxi-trial
export GITMOXI_DEPLOY_DIR=$PWD
cd ecs-fargate
terraform init
terraform apply --auto-approve
export GITMOXI_ENDPOINT_URL="http://$(terraform output -raw alb_endpoint)"
export GITMOXI_TASK_IAM_ROLE="$(terraform output -raw task_iam_role)"
echo $GITMOXI_ENDPOINT_URL

The Terraform output will give the ALB DNS where you can access the Gitmoxi frontend. Once gitmoxi-svc is running in the gitmoxi cluster in the region you specified, then you can should see below page at the ALB URL. The ECS task IAM role will be needed in the EKS test section; hence we have setup the environment variable GITMOXI_TASK_IAM_ROLE.

Gitmoxi Up and Running

Wait for the gitmoxi service to be ready. You should see the below UI at $GITMOXI_ENDPOINT_URL before proceeding with the next steps. Gitmoxi UI

Next, we will add a GitHub repository to Gitmoxi to test the GitOps workflow.

Elevate Your Deployment Experience Today

Experience the power of Gitmoxi — your go-to solution for simple, flexible, and transparent deployment management

Try Now for Free

Email Address *

End User License Agreement

END USER LICENSE AGREEMENT (EULA)

IMPORTANT: PLEASE READ THIS AGREEMENT CAREFULLY BEFORE DOWNLOADING, INSTALLING, OR USING THE SOFTWARE.

By downloading, installing, or using this software, you acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms. If you do not agree to these terms, do not install or use the software.

-------------------------------------------------------------------------------

1. GRANT OF LICENSE  
Subject to the terms of this Agreement, SKAI Software Corporation grants you a limited, non-exclusive, non-transferable, non-sublicensable license to install and use the software solely for your personal or internal business purposes.  

-------------------------------------------------------------------------------

2. RESTRICTIONS  
You may NOT:  
a) Modify, adapt, translate, or create derivative works from the software.  
b) Reverse engineer, decompile, or disassemble the software, except as expressly permitted by applicable law.  
c) Rent, lease, loan, sell, sublicense, distribute, or otherwise transfer the software to any third party.  
d) Remove, alter, or obscure any proprietary notices, trademarks, or labels from the software.  

-------------------------------------------------------------------------------

3. OWNERSHIP  
The software is and remains the exclusive property of SKAI Software Corporation. This Agreement does NOT transfer ownership of the software; it only grants you a limited license to use it. SKAI Software Corporation reserves all rights not expressly granted.  

-------------------------------------------------------------------------------

4. TERMINATION  
This Agreement is effective until terminated. Your rights under this Agreement will automatically terminate without notice if you violate any provision.  

Upon termination, you MUST IMMEDIATELY:  
- Cease all use of the software.  
- Delete or destroy all copies in your possession.  

Termination does not limit SKAI Software Corporation’s right to pursue any other remedies available under law or equity.  

-------------------------------------------------------------------------------

5. DISCLAIMER OF WARRANTY  
THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  

SKAI SOFTWARE CORPORATION DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.  

SKAI SOFTWARE CORPORATION DOES NOT WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE, UNINTERRUPTED, OR COMPATIBLE WITH ALL SYSTEMS.  

YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT USE OF THE SOFTWARE IS AT YOUR SOLE RISK.  

-------------------------------------------------------------------------------

6. LIMITATION OF LIABILITY  
TO THE FULLEST EXTENT PERMITTED BY LAW:  

IN NO EVENT SHALL SKAI SOFTWARE CORPORATION BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, INCLUDING BUT NOT LIMITED TO LOST PROFITS, BUSINESS INTERRUPTION, OR LOSS OF DATA, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  

IN NO EVENT SHALL SKAI SOFTWARE CORPORATION'S TOTAL LIABILITY UNDER THIS AGREEMENT EXCEED THE AMOUNT YOU PAID FOR THE SOFTWARE, IF ANY.  

SOME JURISDICTIONS DO NOT ALLOW CERTAIN LIMITATIONS OF LIABILITY, SO SOME OF THESE LIMITATIONS MAY NOT APPLY TO YOU.  

-------------------------------------------------------------------------------

7. INDEMNIFICATION  
You agree to INDEMNIFY, DEFEND, AND HOLD HARMLESS SKAI Software Corporation, its affiliates, officers, directors, employees, and agents from any claims, liabilities, damages, costs, or expenses (including attorneys’ fees) arising out of:  
a) Your use or misuse of the software.  
b) Your violation of this Agreement.  
c) Your violation of any applicable laws or third-party rights.  

-------------------------------------------------------------------------------

8. GOVERNING LAW & JURISDICTION  
This Agreement shall be governed by and construed in accordance with the LAWS OF THE STATE OF DELAWARE, U.S.A., WITHOUT REGARD TO ITS CONFLICT OF LAW PRINCIPLES.  

ANY DISPUTE ARISING FROM OR RELATED TO THIS AGREEMENT SHALL BE EXCLUSIVELY RESOLVED IN THE STATE OR FEDERAL COURTS LOCATED IN DELAWARE, AND YOU IRREVOCABLY CONSENT TO SUCH JURISDICTION.  

-------------------------------------------------------------------------------

9. SEVERABILITY  
If any provision of this Agreement is found to be invalid or unenforceable, the remaining provisions shall remain in full force and effect.  

-------------------------------------------------------------------------------

10. FORCE MAJEURE  
SKAI Software Corporation shall NOT BE LIABLE for any failure or delay in performance due to causes beyond its reasonable control, including but not limited to natural disasters, war, government actions, network failures, or cyber-attacks.  

-------------------------------------------------------------------------------

11. ENTIRE AGREEMENT  
This Agreement constitutes the ENTIRE AGREEMENT between you and SKAI Software Corporation regarding the software and supersedes all prior agreements, representations, or understandings.  

-------------------------------------------------------------------------------

BY DOWNLOADING, INSTALLING, OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ AND UNDERSTOOD THIS AGREEMENT AND AGREE TO BE BOUND BY ITS TERMS.

I have read and accept the End User License Agreement

×