Getting Started with Gitmoxi

Gitmoxi is inspired by GitOps paradigm where you store, version control, and collaborate on deployment artifacts in Git. Gitmoxi uses deployment artifact files such as ECS service, task, and Lambda function definition to create and update associated objects in AWS services. So you will need GitHub and AWS accounts to try Gitmoxi continuous deployment features. In this getting started guide you will:

Install Gitmoxi on ECS with Fargate,
Perform GitOps-based creation and updates including blue/green with sample applications
Clean-up all the test resources

Start by downloading the artifacts to deploy Gitmoxi on ECS Fargate or EKS. Please note that this download is strictly for trial purposes to learn, test, and evaluate Gitmoxi. Please do not use this for any production or sensitive environments.

Prerequisites

pip install gmctl
gmctl --help

GitHub token for GitOps

Before deploying Gitmoxi for trial, in your GitHub account create a developer token (classic). You will need to grant repo and read:packages access.

GitHub token access

Copy the token value and set the following environment variable, followed by the key AWS region and account variables.

export GITHUB_TOKEN=<GITHUB_TOKEN>
export AWS_REGION=<region_to_install_Gitmoxi>
export AWS_ACCOUNT=<account_id_to_install_Gitmoxi>

If you are using AWS Profile then set the AWS_PROFILE environment variable otherwise Terraform will likely give error. You can usually find the AWS Profile in ~/.aws/config in the first line within the [] brackets.

cat ~/.aws/config

[profile <YOUR_AWS_PROFILE_IS_LIKELY_HERE>]
...

export AWS_PROFILE=<YOUR AWS PROFILE>

Next, install Gitmoxi either on ECS Fargate or EKS whichever service best fits your needs and skills.

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.

Navigation Pane

Getting Started with Gitmoxi

Prerequisites

Table of Contents

Elevate Your Deployment Experience Today

Navigation Pane

Getting Started with Gitmoxi

Prerequisites

Table of Contents

Elevate Your Deployment Experience Today

Email Address *

End User License Agreement

I have read and accept the End User License Agreement