Skip to content

Latest commit

 

History

History
162 lines (107 loc) · 4.43 KB

framework-astro.mdx

File metadata and controls

162 lines (107 loc) · 4.43 KB
Raw
title description meta_tags namespace permalink menu_namespace
How to build with Astro
Build with Astro.
astro, js, jamstack
docs_framework_astro
/documentation/products/cli/frameworks/astro/
cliMenuAlpha

import Badge from '~/components/Badge.astro';

Static application

Astro is listed on the Jamstack documentation as a static site generator, aligned to the Jamstack approach.

Learn more about Astro.

Requirements

Before getting started, you must have:

Initializing an Astro project on the edge

  1. Initialize the project:
  azion init
  1. Accept the suggested name for your project, or enter a name:
(Hit enter to accept the suggested name in parentheses) Your project's name:  (dynamic_caligari)

Output:

Getting templates available
  1. Choose the Astro template:
Getting templates available? Choose a template for your project: (Use arrow keys)
  Angular 
 ❯Astro 
  Hexo 
  Next 
  React 
  Vue 
  Vite

Now, Astro's CLI will follow the process and initialize your Astro project.

  1. With the template fetched and configured, you can choose to start a local development server.
Do you want to start a local development server? (y/N)

The following steps are based on the answer you gave.

Answering yes to local dev

  1. Install the project dependencies. Input y when the interaction prompts:
  Do you want to install project dependencies? This may be required to start local development server (y/N)

Wait until the installation is complete.

Output:

Your Edge Application was built successfully
[Vulcan] [Server] › ✔  success   Function running on port http://localhost:3000/
  1. On the browser, go to http://localhost:3000/ and you can see your Astro project running.

Deploying the project

When your project is running locally, you're still able to deploy it to the edge. To do so:

  1. Stop the terminal execution with control + c.

  2. Access the project folder:

cd [your-project-name]
  1. Deploy the project:
azion deploy
  1. Wait while the project is built and deployed to the Azion Edge Platform.

After the deployment is complete, you'll receive a domain to access your Astro project on the Azion's platform.

Wait a few minutes so the propagation takes place, and then access your application using the provided domain, which should be similar to https://xxxxxxx.map.azionedge.net.

Answering no to local dev

After indicating you don't want to have a local server running, deploy the Astro project to the edge.

  1. Enter y to the following interaction, indicating you want to deploy the project:
   Do you want to deploy your project? (y/N)
  1. Install the project dependencies. Input y when the interaction prompts:
  Do you want to install project dependencies? This may be required to deploy your project (y/N)
  1. Wait while the project is built and deployed to the Azion edge platform.

After the deployment is complete, you'll receive a domain to access your Astro project on the Azion Platform.

Wait a few minutes so the propagation takes place, and then access your application using the provided domain, which should be similar to https://xxxxxxx.map.azionedge.net.

Watch an Astro building guide on Azion's YouTube channel:

<iframe src="https://www.youtube.com/embed/FIMBJBpZsdU" title="How to build with Astro" loading="lazy" width="600" height="400" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

import ContributorList from '~/components/ContributorList.astro'

Contributors Contributor