|
1 |
| -# Introducing a Revolutionary Deployment Tool on the Akash Network to Deploy Applications Directly from GitHub/GitLab/BitBucket |
2 |
| - |
3 |
| -If you’ve ever found yourself bogged down by the complexities of deployment and CI/CD, especially on Akash Network, our new tool is here to change the game. Designed to provide a Vercel-like experience, this tool automates the deployment process, allowing you to focus on what you do best—coding! |
4 |
| - |
5 |
| -Note: This tool is currently in the MVP phase. |
6 |
| - |
7 |
| -## Watch the Video |
8 |
| - |
9 |
| -[](https://youtu.be/bzPXWKgyEtw) |
10 |
| - |
11 |
| -## Empowering Developers with Automation |
12 |
| - |
13 |
| -Deploying applications can often involve a steep learning curve, particularly when dealing with containerization and CI/CD pipelines. Our tool simplifies this by automating deployments directly from your GitHub repository to the Akash Network. It supports several popular JavaScript frameworks, making it a versatile option for many developers. |
14 |
| - |
15 |
| -### Supported Frameworks Include: |
16 |
| - |
17 |
| -#### JavaScript Frameworks: |
18 |
| - |
19 |
| -- **React** |
20 |
| -- **Vite-react** |
21 |
| -- **Vue.js** |
22 |
| -- **Astro** |
23 |
| -- **Angular** |
24 |
| -- **Express.js** |
25 |
| -- **Next.js** |
26 |
| -- **Ember.js** |
27 |
| -- **Gatsby.js** |
28 |
| -- **Vite** |
29 |
| -- **VitePress** |
30 |
| -- **Nuxt.js** |
31 |
| -- **Preact** |
32 |
| -- **Ionic React** |
33 |
| -- **Ionic Angular** |
34 |
| -- **Stencil** |
35 |
| -- **Gridsome** |
36 |
| -- **Umi.js** |
37 |
| -- **11ty.js** |
38 |
| -- **Remix** |
39 |
| -- **VuePress** |
40 |
| - |
41 |
| -#### Python Frameworks: |
42 |
| - |
43 |
| -- **Django** |
44 |
| -- **Flask** |
45 |
| - |
46 |
| -## Key Features That Set Our Tool Apart |
47 |
| - |
48 |
| -This deployment tool isn't just about automating processes; it's about enhancing your workflow and productivity. Here’s what it offers: |
49 |
| - |
50 |
| -- **Automated Builds and Deployments**: Simply link your public GitHub repository, and the tool takes care of the rest. Each commit you push triggers a build and deployment cycle, ensuring your application is always up-to-date. |
51 |
| - |
52 |
| -- **Continuous Integration**: Never worry about out-of-sync versions or manual updates again. This tool ensures that your deployed application mirrors the latest changes in your repository. |
53 |
| - |
54 |
| -- **Customizable Build Processes**: Tailor the deployment process to fit your project's specific needs. Whether it’s specifying a custom build directory or custom commands, you have the flexibility to configure as needed. |
55 |
| - |
56 |
| -- **Roll back to previous good version in case of bad commits**: Incase of commits that break your application and cause error, the tool will automatically roll back to previous good version. |
57 |
| - |
58 |
| -## Getting Started: Simple Steps for Deployment |
59 |
| - |
60 |
| -To leverage this tool effectively, follow these straightforward steps: |
61 |
| - |
62 |
| -1. **Configure Environment Variables**: Adjust the SDL (Service Deployment Language) file to include your project specifics. Key environment variables like `REPO_URL` and `BRANCH_NAME` need to be set to align with your repository details. |
63 |
| - |
64 |
| -2. **Customize the Build Settings**: For projects that don’t fit the conventional build paths or commands, you can easily add custom configurations like `BUILD_DIRECTORY` and `BUILD_COMMAND`. |
65 |
| - |
66 |
| -3. **Deploy Your Application**: With your SDL file configured, deploying your application is as simple as executing the deployment command. The system handles everything from compiling to hosting. |
67 |
| - |
68 |
| -## Sample SDL Configuration for Quick Setup |
69 |
| - |
70 |
| -For a practical application, here’s how you might set up your SDL file: |
| 1 | +# Console-CI/CD for JS/TS |
| 2 | + |
| 3 | +**Quick Start**: Access this feature directly at: |
| 4 | +https://console.akash.network/new-deployment?step=edit-deployment&templateId=akash-network-awesome-akash-automatic-deployment-CICD-template&gitProvider=github |
| 5 | + |
| 6 | +## Overview |
| 7 | + |
| 8 | +A deployment automation tool for Akash Network that provides a Vercel-like experience. This tool streamlines the deployment process by automating builds and deployments directly from your GitHub repository. |
| 9 | + |
| 10 | +## Supported Frameworks |
| 11 | + |
| 12 | +### JavaScript Frameworks: |
| 13 | +- React |
| 14 | +- Vite-react |
| 15 | +- Vue.js |
| 16 | +- Astro |
| 17 | +- Angular |
| 18 | +- Express.js |
| 19 | +- Next.js |
| 20 | +- Ember.js |
| 21 | +- Gatsby.js |
| 22 | +- Vite |
| 23 | +- VitePress |
| 24 | +- Nuxt.js |
| 25 | +- Preact |
| 26 | +- Ionic React |
| 27 | +- Ionic Angular |
| 28 | +- Stencil |
| 29 | +- Gridsome |
| 30 | +- Umi.js |
| 31 | +- 11ty.js |
| 32 | +- Remix |
| 33 | +- VuePress |
| 34 | + |
| 35 | +## Key Features |
| 36 | + |
| 37 | +- **Automated Builds and Deployments**: Automatic build and deployment cycles triggered by GitHub commits |
| 38 | +- **Continuous Integration**: Ensures deployed applications stay synchronized with repository changes |
| 39 | +- **Customizable Build Processes**: Configurable build directories and commands |
| 40 | +- **Automatic Rollback**: Reverts to previous working version in case of deployment failures |
| 41 | + |
| 42 | +## Getting Started |
| 43 | + |
| 44 | +### 1. Configure Environment Variables |
| 45 | +Adjust the SDL file with your project-specific variables: |
| 46 | +- `REPO_URL` |
| 47 | +- `BRANCH_NAME` |
| 48 | + |
| 49 | +### 2. Customize Build Settings |
| 50 | +Configure custom build parameters if needed: |
| 51 | +- `BUILD_DIRECTORY` |
| 52 | +- `BUILD_COMMAND` |
| 53 | + |
| 54 | +### 3. Deploy |
| 55 | +Execute deployment after SDL configuration is complete. |
| 56 | + |
| 57 | +## Sample SDL Configuration |
71 | 58 |
|
72 | 59 | ```yaml
|
73 | 60 | ---
|
@@ -106,27 +93,11 @@ deployment:
|
106 | 93 | count: 1
|
107 | 94 | ```
|
108 | 95 |
|
109 |
| -This setup details how to expose your service, manage environment variables, and define resource allocations, providing a seamless deployment experience. |
110 |
| -Awesome akash repo: [Click Here](https://github.com/akash-network/awesome-akash/blob/master/automatic-deployment-CICD-template/deploy.yml) |
111 |
| -
|
112 |
| -
|
113 |
| -## Why This Tool Is a Game Changer |
114 |
| -
|
115 |
| -Our deployment tool is more than just a utility—it's a shift towards more efficient, less cumbersome development practices. By streamlining the traditional barriers associated with deployment on Akash Network, it allows you to deploy applications with the ease and agility that modern web development demands. |
116 |
| -
|
117 |
| -## What’s Next? |
118 |
| -
|
119 |
| -As we look to the future, we are excited to expand the capabilities of this tool. Our roadmap includes: |
120 |
| -
|
121 |
| -- **Support for More Languages and Frameworks**: Plans are underway to include support for additional programming languages like Python and Go, broadening the scope of our tool to cater to a more diverse range of projects. |
122 |
| -
|
123 |
| -- **Development of a User Interface**: To deliver a truly Vercel-like experience, we are in the process of creating a user-friendly interface. This will make the tool even more accessible and easier to use for all developers. |
124 |
| -
|
125 |
| -- **Email Notifications**: We will be introducing email notifications to keep you updated on the status of your deployments and other important events, enhancing the overall user experience. |
| 96 | +For the complete SDL template, visit: [Awesome Akash Repository](https://github.com/akash-network/awesome-akash/blob/master/automatic-deployment-CICD-template/deploy.yml) |
126 | 97 |
|
127 |
| -- **Direct Implementation on Console**: To deliver a truly Vercel-like experience, we will be building user-friendly GUI directly onto console. This will make the tool even more accessible and easier to use for all developers. |
128 | 98 |
|
129 |
| -As we continue to enhance this tool, we invite you to join us on this journey. Try it out, give us your feedback, and help us redefine the deployment landscape on the Akash Network. Happy coding and deploying! |
| 99 | +## Contributing |
| 100 | +We welcome feedback and contributions to help improve this deployment tool for the Akash Network community. |
130 | 101 |
|
131 |
| -Thank you |
132 |
| -HoomanHq |
| 102 | +## Acknowledgments |
| 103 | +Developed by HoomanHq for the Akash Network ecosystem. |
0 commit comments