- \n
- Go Environment Hosting<\/a><\/li>\n
- Golang Versioning<\/a><\/li>\n
- Go Application Deployment<\/a><\/li>\n
- Domains Management<\/a><\/li>\n
- Automatic Vertical Scaling<\/a><\/li>\n
- Manual Horizontal Scaling<\/a><\/li>\n
- Automatic Horizontal Scaling<\/a><\/li>\n<\/ul>\n
Go Environment Hosting<\/h2>\n
To host your Go application, you need to create<\/a> the appropriate environment using the Topology Wizard.<\/strong><\/p>\n
1. Switch to the Go engine<\/strong> tab.<\/p>\n
2. Add Golang<\/a> as your application server and include any other software stacks required for your project (e.g., load balancers, databases, or shared storage).<\/p>\n
3. Adjust your environment’s node count, set cloudlet limits for RAM and CPU, attach public IPs, etc., if needed.<\/p>\n
Note:<\/strong> This template uses the modern system<\/strong> initialization daemon.<\/div>\n<\/div>\n![\"Create](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_02-1.png\")
<\/a><\/p>\nNote:<\/strong> All instances on the platform are fully isolated containers<\/a>, automatically distributed across available hosts (physical servers or VMs) using anti-affinity rules. This setup minimizes the risk of application downtime and ensures high availability<\/a>.<\/div>\n<\/div>\nNeed help setting up your environment? Check out our Create Environment<\/strong> guide!<\/p>\n
<\/div>\n\t\t\n\t\t\t\n \n \n\n\n \n \t\t\n\t\t\t\t\n\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t <\/div>\n <\/div>\n <\/div>\n <\/section>\n \t\t<\/div>\n\t\t\n<\/div>\nGolang Versioning<\/h2>\n
As of now, the platform supports the following versions of the Golang stack template:<\/p>\n
- \n
- 1.22.3<\/strong><\/li>\n
- 1.22.2<\/strong><\/li>\n
- 1.22.1<\/strong><\/li>\n
- 1.21.10<\/strong><\/li>\n
- 1.21.9<\/strong><\/li>\n
- 1.21.8<\/strong><\/li>\n
- 1.20.14<\/strong><\/li>\n
- 1.20.13<\/strong><\/li>\n
- 1.20.12<\/strong><\/li>\n
- 1.19.12<\/strong><\/li>\n
- 1.19.11<\/strong><\/li>\n
- 1.19.10<\/strong><\/li>\n<\/ul>\n
You can select the preferred version during environment creation and change it later by redeploying the container<\/a>. All custom data within the node(s) will be preserved, enabling you to easily upgrade your software version when a new stack template is released.<\/p>\n
![\"Redeploy](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_03.png\" "\\"Redeploy")
<\/a><\/p>\nGo Application Deployment<\/h2>\n
After creating your environment, you can deploy<\/a> your Go project from a Git repository (deployment from an application archive will be available in the upcoming platform release).<\/p>\n
You can customize the deployment process by configuring the following container variables<\/a>:<\/p>\n
- \n
- GO_RUN<\/strong>: Specifies the name of the executable binary file (if not set, the deployment script will try to locate one based on the Git project name).<\/li>\n
- OPATH<\/strong>: Defines the deployment folder (default is `\/home\/jelastic\/webapp`).<\/li>\n
- GO_BUILD_OPTIONS<\/strong>: Provides additional options for the build operation<\/a> (default is `-a` to force rebuilding of packages that are already up-to-date).<\/li>\n
- GO_RUN_OPTIONS<\/strong>: Provides additional options for the run operation<\/a>.<\/li>\n<\/ul>\n
![\"Deploy](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_04.png\")
<\/a><\/p>\nDuring deployment, the platform automatically performs the following steps:<\/p>\n
- \n
- Parses the provided Git URL to get a link to the Go<\/strong> project.<\/li>\n
- Downloads the package with all the dependencies using the `go get`<\/a> command.<\/li>\n
- In case of error, it performs a download as for a common Git project and retries getting the Go dependencies.<\/li>\n
- Builds the project with the `go build`<\/strong> command (using the additional options specified in the `GO_BUILD_OPTIONS`<\/strong> variable).<\/li>\n
- Runs the binary defined by the `GO_RUN`<\/strong> variable with the `go run`<\/strong> command (using the additional options specified in `GO_RUN_OPTIONS`<\/strong>).<\/li>\n<\/ol>\n
After successful deployment, the Go project is located in the directory set with the `GOPATH`<\/strong> variable. The workspace hierarchy<\/a> inside follows the requirements outlined in the official documentation.<\/p>\n
For more information about Go application deployment, refer to the following documents:<\/p>\n
- \n
- Deployment Manager<\/a><\/li>\n
- Deployment Guide<\/a><\/li>\n
- Auto-Deploy Overview<\/a><\/li>\n
- Deployment Hooks<\/a><\/li>\n<\/ul>\n
<\/div>\n\t\t\n\t\t\t\n \n \n\n\n \n \t\t\n\t\t\t\t\n\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t <\/div>\n <\/div>\n <\/div>\n <\/section>\n \t\t<\/div>\n\t\t\n<\/div>\nDomains Management<\/h2>\n
With the platform, you can easily bind an external (custom) domain<\/a> name to your Go application, replacing the default environment domain. Depending on the entry point used, there are two options:<\/p>\n
- \n
- CNAME Redirect:<\/strong> Recommended for dev<\/strong> and test<\/strong> environments using the Shared Load Balancer.<\/li>\n
- DNS A Record:<\/strong> Suitable for production<\/strong> environments with a public IP, as it can handle high traffic loads.<\/li>\n<\/ul>\n
Additionally, you can effortlessly swap domains<\/a> to redirect traffic from one environment to another (e.g., to switch to a newer application version without downtime).<\/p>\n
![\"Swap](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_05-1.png\")
<\/a><\/p>\nTip<\/strong>: For access via public IP, traffic can be redirected to another environment using the SwapExtIps<\/a> API method (also available via CLI<\/a>).<\/div>\n<\/div>\nAutomatic Vertical Scaling<\/h2>\n
Automatic vertical scaling is facilitated by the platform\u2019s ability to dynamically allocate resources (RAM and CPU) to a server within predefined limits based on its current demands, without requiring manual intervention. This feature ensures you never overpay for unused resources<\/strong>\u00a0and saves time by eliminating the need to manage load-related adjustments or architectural changes.<\/p>\n
The scaling process is automatically managed by the platform. You simply need to specify the lower and upper cloudlet<\/a> limits (each cloudlet equals 128 MiB of RAM and 200 MHz of CPU) for your Go server through the topology wizard:<\/p>\n
![\"Vertical](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_06.png\")
<\/a><\/p>\nYour application will operate within these limits, reducing resource consumption when the load is low and increasing it when the load is high. This way, you only pay for the resources consumed. For more information, please refer to the automatic vertical scaling<\/a> documentation.<\/p>\n
Manual Horizontal Scaling<\/h2>\n
Additional Golang servers can be easily added via the topology wizard during environment creation or adjustment. Simply click the “+<\/strong>” button in the Horizontal Scaling section and add the desired number of instances.<\/p>\n
![\"Horizontal](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_07.png\")
<\/a><\/p>\nThe maximum number of same-type servers within a single environment layer depends on the specific hosting provider’s settings (usually this limit is 16 nodes, which can be increased by sending a request to support).<\/p>\n
Additionally, when scaling Golang servers, a load-balancing<\/a> node is automatically added to the environment topology to ensure proper request distribution. For more details about manual horizontal scaling<\/a>, refer to the documentation.<\/p>\n
Automatic Horizontal Scaling<\/h2>\n
Automatic horizontal scaling is achieved through configurable triggers that increase or decrease the number of nodes based on application load. To set up automatic scaling, click the Add button to Settings > Auto Horizontal Scaling in your environment.<\/p>\n
You can then configure triggers for specific stacks and resources (CPU, RAM, Network, Disk) by setting the scaling conditions.<\/p>\n
- DNS A Record:<\/strong> Suitable for production<\/strong> environments with a public IP, as it can handle high traffic loads.<\/li>\n<\/ul>\n
- Deployment Guide<\/a><\/li>\n
- Downloads the package with all the dependencies using the `go get`<\/a> command.<\/li>\n
- OPATH<\/strong>: Defines the deployment folder (default is `\/home\/jelastic\/webapp`).<\/li>\n
- 1.22.2<\/strong><\/li>\n
- Golang Versioning<\/a><\/li>\n
![\"Auto](\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/06\/Golang-hosting_08-1.png\")
<\/a><\/p>\n