diff --git a/apps/docs/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-hugo.mdx b/apps/docs/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-hugo.mdx index 7611599a03..184ef5fcaf 100644 --- a/apps/docs/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-hugo.mdx +++ b/apps/docs/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-hugo.mdx @@ -60,7 +60,7 @@ Azion deploys a Hugo template as a ready project. The Console route starts from | Influencer Hugo | Product showcase | | Vex Hugo | Product landing page | -The Hugo Boilerplate has a guide of its own, linked in the table. Influencer Hugo and Vex Hugo share one guide: [Deploy an E-commerce with Hugo Templates](/en/documentation/guides/application-development/frameworks/hugo-ecommerce-collection/). For more information on templates, refer to [Azion Marketplace](/en/documentation/platform/marketplace/). +The Hugo Boilerplate has a guide of its own, linked in the table. Influencer Hugo and Vex Hugo share one guide: [Deploy a Hugo e-commerce template](/en/documentation/guides/application-development/frameworks/hugo-ecommerce-collection/). For more information on templates, refer to [Azion Marketplace](/en/documentation/platform/marketplace/). --- diff --git a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/astro-ecommerce-collection.mdx b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/astro-ecommerce-collection.mdx index d366237363..4fc01a16d7 100644 --- a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/astro-ecommerce-collection.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/astro-ecommerce-collection.mdx @@ -1,137 +1,120 @@ --- -title: "Deploy an E-commerce with Astro Templates" +title: Deploy an Astro e-commerce template description: >- - This guide contains instructions to create an e-commerce application using templates based on Astro. -meta_tags: >- - Astro, e-commerce, templates, guides, Azion Marketplace, deployment, online store + Deploy an e-commerce application to Azion from one of the Astro E-commerce + Templates. Each template creates a GitHub repository, an application, and a + domain. +meta_tags: 'Astro, e-commerce, templates, guides, Azion Marketplace, deployment, online store, Astro E-commerce Templates, Astro Audiophile, Astro Ecommerce, Astro Quickstore' namespace: docs_guides_astro_ecommerce_templates_collection permalink: /documentation/guides/application-development/frameworks/astro-ecommerce-collection/ --- - import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' -import DocButton from '~/components/webkit/DocButton.vue'; +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' -The **Astro E-commerce Templates** collection offers configurations for building e-commerce applications using templates. These templates are all based on the **Astro** framework. +You can deploy an e-commerce application to Azion from one of the Astro E-commerce Templates in Azion Console. To create an application without a template, refer to [Applications quickstart](/en/documentation/platform/applications/quickstart/). -The available templates are: +The Astro E-commerce Templates collection holds three templates, all based on the Astro framework: -- **Astro Audiophile**: create a stylish e-commerce based on Astro. It uses version `3.1.2` of Astro. -- **Astro Ecommerce**: deploy a complete e-commerce. It uses version `2.0.1` of Astro. -- **Astro Quickstore**: create your online store with Astro and Tailwind CSS. It uses versions `2.0.1` of Astro and `4.0.0-alpha.23` of Tailwind CSS. +- **Astro Audiophile**: a stylish e-commerce based on Astro. It uses version `3.1.2` of Astro. +- **Astro Ecommerce**: a complete e-commerce. It uses version `2.0.1` of Astro. +- **Astro Quickstore**: an online store built with Astro and Tailwind CSS. It uses versions `2.0.1` of Astro and `4.0.0-alpha.23` of Tailwind CSS. -The deployment process for each of these templates creates a GitHub repository for your project, along with an application and a domain. This setup enables easy access and management of your e-commerce application through the Azion Web Platform. +Each template's deployment creates a GitHub repository for your project, an [application](/en/documentation/platform/applications/) that serves it, and a domain to reach it. The templates use [Application Accelerator](/en/documentation/platform/applications/application-accelerator/), [Functions](/en/documentation/platform/functions/), and [Cache](/en/documentation/platform/applications/cache/), and their usage can generate costs. For more information, refer to [Pricing](/en/documentation/fundamentals/pricing/). --- -## Requirements +## Prerequisites -- A [GitHub account](https://github.com/signup) to connect with Azion and create your new repository. - - Every push will be deployed automatically to this repository to keep your project updated. -- These templates use [Application Accelerator](/en/documentation/platform/applications/application-accelerator/), [Functions](/en/documentation/platform/functions/), and [Cache](/en/documentation/platform/applications/cache/), and it may generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information. +- An Azion account. To create one, refer to [Create an account](/en/documentation/fundamentals/creating-account/). +- Access to Azion Console. To sign in, refer to [Access Azion Console](/en/documentation/guides/platform/account-and-billing/how-to-access-azion-console/). +- A [GitHub account](https://github.com/signup). Azion connects to it and creates the project's repository there. --- -## Deploying the template - -You can obtain and configure your templates through the Azion Console. To easily deploy any of them on Azion, select the respective button below. - - - - +## Deploy a template ---- +Each template in the collection opens as a configuration form in Azion Console, and an asterisk marks each mandatory field. -## Setting up the template +To deploy a template: -In the configuration form, you must provide the information to configure your application. Fill in the presented fields. + + -Fields identified with an asterisk are mandatory. + Go to the template you want to deploy in Azion Console: - - + - [Astro Audiophile](https://console.azion.com/create/azion-community/astro--audiophile) + - [Astro Ecommerce](https://console.azion.com/create/azion-community/astro--ecommerce) + - [Astro Quickstore](https://console.azion.com/create/azion-community/astro--quickstore) - - A pop-up window will open to confirm the installation of the [Azion GitHub App](/en/documentation/guides/application-development/automation/azion-github-app/), a tool that connects your GitHub account with Azion's platform. - - Define your permissions and repository access as desired. + The configuration form opens. - + - Select the **Git Scope** to work with. + A window opens to confirm the installation of the [Azion GitHub App](/en/documentation/guides/application-development/automation/azion-github-app/), which connects your GitHub account with Azion. In that window, define the app's permissions and repository access. - + + - - The bucket for storage and the function will use the same name. - - Use a unique and easy-to-remember name. If the name has already been used, the platform returns an error message. + Enter a unique name that you can remember. The storage bucket and the function that the template creates take the same name. If the name is already in use, the platform returns an error message. - + - Select the **Deploy** button to start the deployment process. + Select **Deploy**. -During the deployment, you'll be able to follow the process through a window showing the logs. When it's complete, the page shows information about the application and some options to continue your journey. +A window shows the deployment logs while it runs. When the deployment completes, the page shows the application's details, a browser link to it, and options to continue. -:::note -The link to the application allows you to see it on the browser. However, it takes a certain time to propagate and configure the application on Azion's distributed infrastructure. It may be necessary to wait a few minutes for the URL to be activated and for the application page to be effectively displayed in the browser. -::: +The link can take a few minutes to start serving the application, while its configuration propagates across Azion's distributed infrastructure. If the page does not load, wait a few minutes and open the link again. --- -## Managing the template +## Update the project -Considering that this initial setup may not be optimal for your specific application, all settings can be customized any time you need by using Azion's platform. +Every push to the GitHub repository that the template creates deploys automatically. -To manage and edit your application's settings, follow these steps: +To update the deployed project, push your changes to that repository. Azion deploys them, and the application serves the new version. - - +--- - [Access Azion Console](https://console.azion.com). +## Manage the application - - +The settings that the template applies may not fit your application. You can change any of them at any time from Azion Console. + +To open the application's settings: - On the upper-left corner, select **Products menu**, the icon with three horizontal lines, > **Applications**. + + - - You'll be redirected to the **Applications** page. It lists all the applications you've created. + Access [Azion Console](https://console.azion.com/) > **Applications**. The list shows every application you created, in alphabetical order. - - - Find the application related to your template and select it. + - - The list is organized alphabetically. You can also use the **search bar** located in the upper-left corner of the list; currently, it filters only by **Application Name**. + To find it in a long list, search by its name. The search filters the list by application name only. -After selecting the application you'll work on, you'll be directed to a page containing all the settings you can configure. +The application opens on a page that holds every setting you can configure. For more information, refer to [Main Settings](/en/documentation/platform/applications/main-settings/), [Rules Engine for Applications](/en/documentation/platform/applications/rules-engine/), and [Device Groups](/en/documentation/platform/applications/device-groups/). -:::tip -Read the documentation about [managing applications](/en/documentation/platform/applications/quickstart/) for more details. -::: +--- + +## Add a custom domain -### Adding a custom domain +The deployment assigns the application a [workload](/en/documentation/platform/workloads/) domain in the format `xxxxxxxxxx.map.azionedge.net`, which a browser can open. To serve the application from a domain you own, add a custom domain. To add one, refer to [Add a custom domain to a workload](/en/documentation/guides/platform/migration/configure-a-domain/). For more information, refer to [Domains](/en/documentation/platform/workloads/domains/). + +--- -The application created during the deployment has an assigned Azion Workload domain to make it accessible through the browser. The domain has the following format: `xxxxxxxxxx.map.azionedge.net/`. However, you can add a custom domain for users to access your application through it. +## Next steps -For more information, refer to [Add a custom domain to a workload](/en/documentation/guides/platform/migration/configure-a-domain/). + + + + diff --git a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx index 552bca742a..f76463e45f 100644 --- a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx @@ -1,86 +1,103 @@ --- -title: How to deploy the Azion Starter Kit +title: Deploy the Azion Starter Kit description: >- - This template accelerates the creation of a basic edge stack to explore - Azion's platform and its features. -meta_tags: 'templates, guides, Azion Marketplace, security, bot protection, edge computing' + Deploy an application and a firewall with caching rules, image processing, + and Bot Manager Lite, to explore Azion's platform and its features. +meta_tags: 'templates, guides, Azion Marketplace, security, bot protection, Azion Starter Kit, starter kit' namespace: docs_guides_templates_azion_starter_kit permalink: /documentation/guides/application-development/frameworks/azion-starter-kit/ --- - import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' -import DocButton from '~/components/webkit/DocButton.vue'; +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' + +You can deploy a basic stack of application and security settings to Azion from the Azion Starter Kit template in Azion Console. To create an application without a template, refer to [Applications quickstart](/en/documentation/platform/applications/quickstart/). -**Azion Starter Kit** is ideal for taking your first steps within Azion Web Platform. With this template, you can accelerate the creation of a basic edge stack to explore the platform and its features. +Use the Azion Starter Kit to take your first steps on Azion Web Platform and to explore the platform and its features. The template includes: -This template includes: +- A new [application](/en/documentation/platform/applications/), with common caching rules for images and for dynamic and static files. +- [Image Processor](/en/documentation/platform/applications/image-processor/) features to manipulate and process images directly on Azion. +- A new [firewall](/en/documentation/platform/firewall/) with rules that execute a function instance for Bot Manager Lite and deny requests from the pre-built Azion IP Tor Exit Nodes network list. -- The deployment of a new application, with common caching rules for images and dynamic and static files. -- Azion Image Processor features to manipulate and process images directly on Azion. -- The creation of a new Firewall with rules to execute a function instance for Bot Manager Lite and deny requests from the pre-built Azion IP Tor Exit Nodes network list. +The template uses [Application Accelerator](/en/documentation/platform/applications/application-accelerator/), [Functions](/en/documentation/platform/functions/), [Image Processor](/en/documentation/platform/applications/image-processor/), and [Network Shield](/en/documentation/platform/firewall/network-shield/), and their usage can generate costs. For more information, refer to [Pricing](/en/documentation/fundamentals/pricing/). --- -## Requirements +## Prerequisites -To use this template, you must: +- An Azion account. To create one, refer to [Create an account](/en/documentation/fundamentals/creating-account/). +- Access to Azion Console. To sign in, refer to [Access Azion Console](/en/documentation/guides/platform/account-and-billing/how-to-access-azion-console/). +- Application Accelerator, Functions, Image Processor, and Network Shield enabled on your account. +- The latest version of the Bot Manager Lite integration, installed. To install it, go to [Azion Marketplace](https://console.azion.com/marketplace) and select **Install**. For more information, refer to [Install Bot Manager Lite](/en/documentation/guides/application-development/integrations/bot-manager-lite/). +- A hosted origin that holds your content. The configuration form asks for its address. -- Launch the latest version of the **Bot Manager Lite** integration. - - Go to [Azion Marketplace](https://console.azion.com/marketplace) to install this integration by selecting the **Install** button. Check the [How to install Azion Bot Manager Lite](/en/documentation/guides/application-development/integrations/bot-manager-lite/) guide for more details. - - If you didn't launch the Bot Manager Lite function before trying to use this template, the execution will fail and a log explaining the reason will be printed. +If you do not install the Bot Manager Lite function before you use this template, the deployment fails and prints a log that explains the reason. -- This template uses [Application Accelerator](/en/documentation/platform/applications/application-accelerator/), [Functions](/en/documentation/platform/functions/), [Image processor](/en/documentation/platform/applications/image-processor/), and [Network Shield](/en/documentation/platform/firewall/network-shield/), and it may generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information. +--- -## Deploying the template +## Deploy the template -You can obtain and configure your template through the Azion Console. To easily deploy it on Azion, select the button below. +The Azion Starter Kit opens as a configuration form in Azion Console, and an asterisk marks each mandatory field. - +To deploy the template: ---- + + + + Go to [Azion Starter Kit](https://console.azion.com/create/azion/azion-starter) in Azion Console. The configuration form opens. + + + + + In **Application Name**, enter a unique name that you can remember. The name identifies the new application, its domain, and the firewall on Azion. If the name is already in use, the platform returns an error message. + + + + + In **Origin Address**, enter the address of the hosted origin. The application fetches the original content from it. For example: `www.yourwebsite.com`. + + + + + Some origins need a different value in the `Host` header of the request that retrieves their content. In **Custom Host Header**, enter that value. To take the host value from the request URI, enter the `${host}` variable. For more information, refer to [Origins](/en/documentation/platform/connectors/origins/#host-header). -## Setting up the template + + + + Select **Deploy**. + + + + +A window shows the deployment logs while it runs. When the deployment completes, the page shows the application's details, a browser link to it, and options to continue. -In the configuration form, you must provide the information to configure your application. Fill in the presented fields. +The link can take a few minutes to start serving the application, while its configuration propagates across Azion's distributed infrastructure. If the page does not load, wait a few minutes and open the link again. To change the settings that the deployment applies, refer to [Manage the application](#manage-the-application). -Fields identified with an asterisk are mandatory. +Watch the deployment of the Azion Starter Kit: -- **Application Name** *: the name of your new application, domain, and Firewall on Azion. -- **Origin Address** *: the address of the hosted origin the application should fetch the content from. - - Example: `www.yourwebsite.com` -- **Custom Host Header**: in some cases, it may be necessary to add host information in the header request to retrieve information from the origin. This variable is used for that purpose. - - Example: `${host}`. Read more about the host header and how to customize it on the [Origins](/en/documentation/platform/connectors/origins/#host-header) documentation. +