diff --git a/src/components/DocsCard.astro b/src/components/DocsCard.astro new file mode 100644 index 0000000000..c30e59a9ac --- /dev/null +++ b/src/components/DocsCard.astro @@ -0,0 +1,32 @@ +--- +/** + * Docs CTA card. Place inside a grid wrapper: + *
+ */ +interface Props { + link: string; + title: string; + icon?: string; + description?: string; + titleTag?: 'h2' | 'h3' | 'h4' | 'h5' | 'h6'; +} +import CardBaseClickableSFC from 'azion-webkit/cardbaseclickable'; +import CardTitleSFC from 'azion-webkit/cardtitle'; +import CardDescriptionSFC from 'azion-webkit/carddescription'; + +// azion-webkit's .d.ts files omit pass-through props (grid, hover, class, titleTag), +// so the components are cast to keep `astro check` clean. +const CardBaseClickable = CardBaseClickableSFC as any; +const CardTitle = CardTitleSFC as any; +const CardDescription = CardDescriptionSFC as any; + +const { link, title, icon, description, titleTag = 'h3' } = Astro.props; +--- + + + + {icon && } + {title} + {description && {description}} + + diff --git a/src/content/docs/en/pages/get-started/first-deploy/index.mdx b/src/content/docs/en/pages/get-started/first-deploy/index.mdx new file mode 100644 index 0000000000..cb062d7a3e --- /dev/null +++ b/src/content/docs/en/pages/get-started/first-deploy/index.mdx @@ -0,0 +1,145 @@ +--- +title: 'First deploy in a few minutes' +description: >- + Put an application live on the Azion Web Platform in a few minutes, + using a template, a GitHub repository, or the Azion CLI, and verify it + answers HTTP 200 on its own Azion domain. +meta_tags: >- + Azion, first deploy, tutorial, quickstart, template, GitHub import, Azion + CLI, azion link, edge application, verification +namespace: documentation_get_started_first_deploy +permalink: /documentation/get-started/first-deploy/ +--- + +import DocsCard from '~/components/DocsCard.astro'; + + +By the end of this tutorial, an application will be live on the Azion Web Platform, answering HTTP 200 on its own Azion domain. It takes a few minutes. + +Three complete paths get you there. Pick one. They all end in the same place: + +
+ + + +
+ +Not sure which one? Take the template path: it needs no local tooling. + +## Before you start + +All you need is an Azion account. You can [create one for free](https://console.azion.com/signup/), and it doesn't ask for a credit card. Anything path-specific is listed in the path itself. + +--- + +## Deploy a template via Console + +Templates are ready-made projects (e-commerce, blogs, APIs, full-stack SSR) that go live in a few clicks. You don't need any local tooling. + +:::note +Some templates are integrated with third-party services, so you may need to create accounts, generate tokens, or activate Azion products before deploying. Templates integrated with GitHub ask you to connect your account: click **Connect with GitHub** when prompted and confirm the connection in the pop-up. Each [template's guide](/en/documentation/products/guides/#azion-templates) lists its specific prerequisites. +::: + +1. [Access Azion Console](https://console.azion.com). +2. Click **+ Create** on the homepage. +3. In the modal, select **Templates**. +4. Browse and pick the one you want to start with. +5. Fill in the configuration page. +6. Click **Deploy**, in the bottom-right corner. + +Follow the deploy through the logs window. When it finishes, the page shows your application's name, its deploy logs, and its **Azion domain**. Some templates also create a function and apply pre-defined configurations to optimize your application's performance. The template's guide lists what's included. + +### Test it + +Copy the Azion domain from the confirmation page: + +```bash +curl -I https:// +# HTTP/2 200 +``` + +Open the same URL in the browser to see your application running. + +:::note +New URLs can take a few minutes to propagate to Azion's edge locations. If you get an error right after deploying, wait a moment and try again. +::: + +--- + +## Import a project from GitHub + +**Before you start:** you need a GitHub account and a repository using one of the [supported frameworks](/en/documentation/products/devtools/azion-edge-runtime/frameworks-compatibility/). + +1. In [Azion Console](https://console.azion.com), click **+ Create**. +2. Select **Import from GitHub**. +3. Connect your GitHub account. +4. Select your repository. +5. Choose a name for the application and a **Framework Preset**. +6. Enter the install command (usually `npm install`). +7. Confirm and follow the logs until the **Azion domain** shows up. + +### Test it + +```bash +curl -I https:// +# HTTP/2 200 +``` + +Open the Azion domain in the browser to see your application running. If you get an error right away, wait a few minutes: new URLs take a moment to propagate to Azion's edge locations. + +--- + +## Deploy with Azion CLI + +**Before you start:** you need the Azion CLI (installed below) and a local project using one of the [supported frameworks](/en/documentation/products/devtools/azion-edge-runtime/frameworks-compatibility/), with its dependencies installed. + +:::tip +Starting from scratch instead? Run `azion init` to create a new project from a framework template, then deploy it the same way. See the [CLI overview](/en/documentation/products/azion-cli/overview/) and the [link command reference](/en/documentation/products/cli/link-command/) for details. +::: + +### Install the Azion CLI + +```bash +curl -fsSL https://cli.azion.app/install.sh | bash +``` + +### Link and deploy + +Authenticate: + +```bash +azion login +``` + +In the project's root folder, link it to Azion: + +```bash +azion link +``` + +The CLI guides you from there: confirm the linking, accept or change the suggested application name, and pick a **preset** matching your framework. When it asks `Do you want to deploy your project?`, answer **yes**. (If you answer no, run `azion deploy` when you're ready.) + +At the end of the deploy, the CLI prints your application's **Azion domain**. + +### Test it + +```bash +curl -I https:// +# HTTP/2 200 +``` + +If you get an error right away, wait a few minutes: new URLs take a moment to propagate to Azion's edge locations. + +--- + +## What you built + +You deployed an application to Azion's global network and confirmed it answers on its own domain. The workflow is the same one you'll use for production projects. + +## Next steps + +
+ + + +
diff --git a/src/content/docs/en/pages/get-started/index.mdx b/src/content/docs/en/pages/get-started/index.mdx new file mode 100644 index 0000000000..b7896e6b79 --- /dev/null +++ b/src/content/docs/en/pages/get-started/index.mdx @@ -0,0 +1,71 @@ +--- +title: Get started with Azion +description: >- + Start here: deploy your first application on Azion in minutes using a + template, a GitHub repository, or the Azion CLI, and find the right path + for your goal. +meta_tags: >- + Azion, get started, first deploy, quickstart, template, GitHub, CLI, + onboarding, edge computing +namespace: documentation_get_started +permalink: /documentation/get-started/ +--- + +import LinkButton from 'azion-webkit/linkbutton'; +import DocsCard from '~/components/DocsCard.astro'; + +**Azion Web Platform** lets you build, secure, and observe applications running on a global network. The fastest way to understand what that means is to put something live: the first deploy takes a few minutes and doesn't require a credit card. + +## Deploy your first application + +Three doors, same destination: an application answering on its own Azion domain. Pick the one that matches how you work. + +
+ + + +
+ + + +## Find your path + +
+ + + +
+ +Also useful: [Accounts and billing](/en/documentation/products/accounts/) · [Architectures](/en/documentation/architectures/) + +## Build with your framework + +Ready-made build paths for the stack you already use. + +
+ + + + + + + + + + + + + + + + + +
+ +## After the first deploy + +
+ + + +
diff --git a/src/content/docs/pt-br/pages/get-started/first-deploy/index.mdx b/src/content/docs/pt-br/pages/get-started/first-deploy/index.mdx new file mode 100644 index 0000000000..93fce5b04e --- /dev/null +++ b/src/content/docs/pt-br/pages/get-started/first-deploy/index.mdx @@ -0,0 +1,145 @@ +--- +title: 'Primeiro deploy em poucos minutos' +description: >- + Coloque uma aplicação no ar na Azion Web Platform em poucos minutos, + usando um template, um repositório do GitHub ou a Azion CLI, e verifique + que ela responde HTTP 200 no seu próprio domínio Azion. +meta_tags: >- + Azion, primeiro deploy, tutorial, quickstart, template, importar do + GitHub, Azion CLI, azion link, aplicação, verificação +namespace: documentation_get_started_first_deploy +permalink: /documentacao/get-started/first-deploy/ +--- + +import DocsCard from '~/components/DocsCard.astro'; + + +Ao final deste tutorial, uma aplicação estará no ar na Azion Web Platform, respondendo HTTP 200 no seu próprio domínio Azion. Leva poucos minutos. + +Três caminhos completos levam você até lá. Escolha um. Todos terminam no mesmo lugar: + +
+ + + +
+ +Na dúvida, vá pelo caminho do template: ele não precisa de nenhuma ferramenta local. + +## Antes de começar + +Você só precisa de uma conta Azion. Você pode [criar uma gratuitamente](https://console.azion.com/signup/), e ela não pede cartão de crédito. O que for específico de cada caminho está listado no próprio caminho. + +--- + +## Faça deploy de um template via Console + +Templates são projetos prontos (e-commerce, blogs, APIs, SSR full-stack) que entram no ar em poucos cliques. Você não precisa de nenhuma ferramenta local. + +:::note +Alguns templates são integrados a serviços de terceiros, então pode ser necessário criar contas, gerar tokens ou ativar produtos da Azion antes do deploy. Templates integrados ao GitHub pedem para conectar a sua conta: clique em **Connect with GitHub** quando solicitado e confirme a conexão no pop-up. O [guia de cada template](/pt-br/documentacao/produtos/guias/#azion-templates) lista os pré-requisitos específicos. +::: + +1. [Acesse o Azion Console](https://console.azion.com). +2. Clique em **+ Create** na página inicial. +3. No modal, selecione **Templates**. +4. Navegue e escolha o template com que deseja começar. +5. Preencha a página de configuração. +6. Clique em **Deploy**, no canto inferior direito. + +Acompanhe o deploy pela janela de logs. Ao concluir, a página mostra o nome da aplicação, os logs de deploy e o **domínio Azion**. Alguns templates também criam uma function e aplicam configurações predefinidas para otimizar a performance da sua aplicação. O guia do template lista o que está incluído. + +### Teste + +Copie o domínio Azion da página de confirmação: + +```bash +curl -I https:// +# HTTP/2 200 +``` + +Abra a mesma URL no navegador para ver a aplicação rodando. + +:::note +URLs novas podem levar alguns minutos para propagar para as edge locations da Azion. Se aparecer um erro logo após o deploy, aguarde um momento e tente de novo. +::: + +--- + +## Importe um projeto do GitHub + +**Antes de começar:** você precisa de uma conta no GitHub e de um repositório usando um dos [frameworks compatíveis](/pt-br/documentacao/produtos/devtools/azion-edge-runtime/compatibilidade-frameworks/). + +1. No [Azion Console](https://console.azion.com), clique em **+ Create**. +2. Selecione **Import from GitHub**. +3. Conecte sua conta do GitHub. +4. Selecione seu repositório. +5. Escolha um nome para a aplicação e um **Framework Preset**. +6. Insira o comando de instalação (normalmente `npm install`). +7. Confirme e acompanhe os logs até o **domínio Azion** aparecer. + +### Teste + +```bash +curl -I https:// +# HTTP/2 200 +``` + +Abra o domínio Azion no navegador para ver a aplicação rodando. Se aparecer um erro logo de cara, aguarde alguns minutos: URLs novas levam um tempo para propagar para as edge locations da Azion. + +--- + +## Faça deploy com a Azion CLI + +**Antes de começar:** você precisa da Azion CLI (instalada abaixo) e de um projeto local usando um dos [frameworks compatíveis](/pt-br/documentacao/produtos/devtools/azion-edge-runtime/compatibilidade-frameworks/), com as dependências instaladas. + +:::tip +Começando do zero? Rode `azion init` para criar um projeto novo a partir de um template de framework e faça o deploy da mesma forma. Veja a [visão geral da CLI](/pt-br/documentacao/produtos/azion-cli/visao-geral/) e a [referência do comando link](/pt-br/documentacao/produtos/azion-cli/link-comando/) para mais detalhes. +::: + +### Instale a Azion CLI + +```bash +curl -fsSL https://cli.azion.app/install.sh | bash +``` + +### Vincule e faça o deploy + +Autentique-se: + +```bash +azion login +``` + +Na pasta raiz do projeto, vincule-o à Azion: + +```bash +azion link +``` + +A CLI guia você a partir daí: confirme o vínculo, aceite ou altere o nome sugerido para a aplicação e escolha um **preset** compatível com o seu framework. Quando perguntar `Do you want to deploy your project?`, responda **yes**. (Se responder no, rode `azion deploy` quando estiver pronto.) + +Ao final do deploy, a CLI imprime o **domínio Azion** da sua aplicação. + +### Teste + +```bash +curl -I https:// +# HTTP/2 200 +``` + +Se aparecer um erro logo de cara, aguarde alguns minutos: URLs novas levam um tempo para propagar para as edge locations da Azion. + +--- + +## O que você construiu + +Você fez o deploy de uma aplicação na rede global da Azion e confirmou que ela responde no seu próprio domínio. O fluxo é o mesmo que você vai usar em projetos de produção. + +## Próximos passos + +
+ + + +
diff --git a/src/content/docs/pt-br/pages/get-started/index.mdx b/src/content/docs/pt-br/pages/get-started/index.mdx new file mode 100644 index 0000000000..7f1ac0b296 --- /dev/null +++ b/src/content/docs/pt-br/pages/get-started/index.mdx @@ -0,0 +1,71 @@ +--- +title: Comece com a Azion +description: >- + Comece aqui: faça o deploy da sua primeira aplicação na Azion em minutos + usando um template, um repositório do GitHub ou a Azion CLI, e encontre o + caminho certo para o seu objetivo. +meta_tags: >- + Azion, comece agora, primeiro deploy, quickstart, template, GitHub, CLI, + onboarding, edge computing +namespace: documentation_get_started +permalink: /documentacao/get-started/ +--- + +import LinkButton from 'azion-webkit/linkbutton'; +import DocsCard from '~/components/DocsCard.astro'; + +A **Azion Web Platform** permite construir, proteger e observar aplicações rodando em uma rede global. A forma mais rápida de entender o que isso significa é colocar algo no ar: o primeiro deploy leva poucos minutos e não exige cartão de crédito. + +## Faça o deploy da sua primeira aplicação + +Três portas, o mesmo destino: uma aplicação respondendo no seu próprio domínio Azion. Escolha a que combina com o seu jeito de trabalhar. + +
+ + + +
+ + + +## Encontre o seu caminho + +
+ + + +
+ +Também úteis: [Contas e faturamento](/pt-br/documentacao/produtos/gestao-de-contas/) · [Arquiteturas](/pt-br/documentacao/arquiteturas/) + +## Construa com seu framework + +Caminhos de build prontos para a stack que você já usa. + +
+ + + + + + + + + + + + + + + + + +
+ +## Depois do primeiro deploy + +
+ + + +