Esta página foi traduzida pela API Cloud Translation.

Alojamento de um Website estático no App Engine

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

Pode usar o App Engine para alojar um Website estático. As páginas Web estáticas podem conter tecnologias do lado do cliente, como HTML, CSS e JavaScript. A alojamento do seu site estático no App Engine pode custar menos do que usar um fornecedor de alojamento tradicional, uma vez que o ambiente padrão do App Engine oferece um nível gratuito.

Os sites alojados no App Engine estão alojados no subdomínio REGION_ID.r.appspot.com, como [my-project-id].uc.r.appspot.com. Depois de implementar o seu site, pode mapear o seu próprio nome de domínio para o Website alojado no App Engine.

Antes de começar

Antes de poder alojar o seu Website no App Engine:

Crie um novo Google Cloud projeto da consola ou obtenha o ID do projeto de um projeto existente para usar:

Aceda à página Projetos

Sugestão: pode obter uma lista dos IDs dos seus projetos existentes com a ferramenta de linhas de comando gcloud.
Instale e, em seguida, inicialize a CLI Google Cloud:

Transfira o SDK

Criar um Website para alojamento no Google App Engine

Estrutura básica do projeto

Este guia usa a seguinte estrutura para o projeto:

app.yaml: configure as definições da sua aplicação do App Engine.
www/: diretório para armazenar todos os ficheiros estáticos, como HTML, CSS, imagens e JavaScript.
- css/: diretório para armazenar folhas de estilos.
  - style.css: folha de estilos básica que formata o aspeto e a funcionalidade do seu site.
- images/: diretório opcional para armazenar imagens.
- index.html: um ficheiro HTML que apresenta conteúdo para o seu Website.
- js/: diretório opcional para armazenar ficheiros JavaScript.
- Outros diretórios de recursos.

A criar o ficheiro `app.yaml`

O ficheiro app.yaml é um ficheiro de configuração que indica ao App Engine como mapear URLs para os seus ficheiros estáticos. Nos passos seguintes, vai adicionar controladores que vão carregar o www/index.html quando alguém visitar o seu Website, e todos os ficheiros estáticos vão ser armazenados e chamados a partir do diretório www.

Crie o ficheiro app.yaml no diretório raiz da sua aplicação:

Crie um diretório com o mesmo nome do ID do projeto. Pode encontrar o ID do projeto na consola.
No diretório que acabou de criar, crie um ficheiro denominado app.yaml.
Edite o ficheiro app.yaml e adicione o elemento handlers com base nos requisitos do seu Website. Por exemplo, o ficheiro app.yaml para o tempo de execução do Python pode ser criado da seguinte forma:
```
runtime: python39

handlers:
- url: /
  static_files: www/index.html
  upload: www/index.html

- url: /(.*)
  static_files: www/\1
  upload: www/(.*)
```

Pode encontrar mais informações de referência sobre o ficheiro app.yaml na app.yaml documentação de referência.

A criar o ficheiro `index.html`

Crie um ficheiro HTML que seja publicado quando alguém navegar para a página raiz do seu Website. Armazene este ficheiro no seu diretório www.

<html>
  <head>
    <title>Hello, world!</title>
    <link rel="stylesheet" type="text/css" href="/css/style.css">
  </head>
  <body>
    <h1>Hello, world!</h1>
    <p>
      This is a simple static HTML file that will be served from Google App
      Engine.
    </p>
  </body>
</html>

Implementar a sua aplicação no App Engine

Quando implementa os ficheiros da aplicação, o seu Website é carregado para o App Engine. Para implementar a sua app, execute o seguinte comando a partir do diretório raiz da sua aplicação onde se encontra o ficheiro app.yaml:

gcloud app deploy

Sinalizadores opcionais:

Inclua a flag --project para especificar um ID do projeto da consola Google Cloud alternativo ao que inicializou como predefinição na CLI gcloud. Exemplo: --project [YOUR_PROJECT_ID]
Inclua a flag -v para especificar um ID da versão. Caso contrário, é gerado um ID para si. Exemplo: -v [YOUR_VERSION_ID]

Para saber como implementar a sua app a partir da linha de comandos, consulte o artigo Implementar a sua aplicação.

Visualizar a sua candidatura

Para iniciar o navegador e ver a app em https://PROJECT_ID.REGION_ID.r.appspot.com, execute o seguinte comando:

gcloud app browse

O que se segue?

Publique o seu Website alojado no App Engine a partir de um domínio personalizado.