Tutoriais

Python

Nosso exemplo em Python usa o framework Flask. Faça o download do código-fonte completo nos links fornecidos.

Se necessário, instale o Python 3.7 ou mais recente e verifique se o pip está disponível.

python3 -m ensurepip --upgrade

Também recomendamos que você configure e ative um novo ambiente virtual do Python.

python3 -m venv .classroom-addon-env
source .classroom-addon-env/bin/activate

Há um requirements.txt em cada subdiretório de tutorial nos exemplos baixados. É possível instalar rapidamente as bibliotecas necessárias usando pip. Use os comandos a seguir para instalar as bibliotecas necessárias para o primeiro tutorial.

cd flask/01-basic-app
pip install -r requirements.txt

Node.js

Nosso exemplo do Node.js usa o framework Express. Faça o download do código-fonte completo nos links fornecidos.

Este exemplo requer o Node.js v16.13 ou mais recente.

Instale os módulos de nós necessários usando npm.

npm install

Java

Nosso exemplo em Java usa o framework Spring Boot. Faça o download do código-fonte completo nos links fornecidos.

Instale o Java 11 ou mais recente se ele ainda não estiver instalado na sua máquina.

Os aplicativos Spring Boot podem usar o Gradle ou o Maven para processar builds e gerenciar dependências. Este exemplo inclui o wrapper do Maven, que garante uma compilação bem-sucedida sem exigir a instalação do Maven.

No diretório em que você baixou ou clonou o projeto, execute os seguintes comandos para garantir que você tenha os pré-requisitos para executar o projeto.

java --version
./mvnw --version

Ou no Windows:

java -version
mvnw.cmd --version

Python

• A raiz do diretório contém os seguintes arquivos:

  • main.py: o ponto de entrada do aplicativo Python. Especifique a configuração do servidor que você quer usar nesse arquivo e execute-o para iniciar o servidor.
  • requirements.txt: os módulos Python necessários para executar o web app. Eles podem ser instalados automaticamente usando pip install -r requirements.txt.

  • client_secret.json: o arquivo de chave secreta do cliente baixado do Google Cloud. Isso não está incluído no arquivo de exemplo. Renomeie e copie o arquivo de credenciais baixado para cada raiz de diretório.

• config.py: opções de configuração para o servidor Flask.

• O diretório webapp contém o conteúdo do aplicativo da Web. Ele inclui o seguinte:

• O diretório /templates/ com modelos Jinja para várias páginas.

• O diretório /static/ com imagens, CSS e arquivos JavaScript auxiliares.

• routes.py: os métodos de manipulador para as rotas do aplicativo da Web.

• __init__.py: o inicializador do módulo webapp. Esse inicializador inicia o servidor Flask e carrega as opções de configuração definidas em config.py.

• Arquivos extras, conforme exigido por uma etapa específica do tutorial.

Node.js

Cada etapa do tutorial pode ser encontrada em uma subpasta <step> própria. Cada etapa contém:

• Arquivos estáticos, como JavaScript, CSS e imagens, são encontrados na pasta ./<step>/public.
• Os roteadores expressos estão nas pastas ./<step>/routes.
• Os modelos HTML estão nas pastas ./<step>/views.
• O aplicativo do servidor é ./<step>/app.js.

Java

O diretório do projeto inclui o seguinte:

• O diretório src.main contém o código-fonte e a configuração para executar o aplicativo com sucesso. Esse diretório inclui o seguinte: + O diretório java.com.addons.spring contém os arquivos Application.java e Controller.java. O arquivo Application.java é responsável por executar o servidor de aplicativos, enquanto o arquivo Controller.java processa a lógica do endpoint. + O diretório resources contém o diretório templates com arquivos HTML e JavaScript. Ele também contém o arquivo application.properties, que especifica a porta para executar o servidor, o caminho para o arquivo de keystore e o caminho para o diretório templates. Este exemplo inclui o arquivo de keystore no diretório resources. Você pode armazenar o arquivo onde preferir, mas atualize o arquivo application.properties com o caminho adequado.
  • O pom.xml contém as informações necessárias para criar o projeto e definir as dependências necessárias.
  • .gitignore contém nomes de arquivos que não devem ser enviados ao git. Adicione o caminho para seu keystore neste .gitignore. No exemplo fornecido, é secrets/*.p12. A finalidade do keystore é discutida na seção abaixo. Para o tutorial 2 e além, inclua também o caminho para o arquivo client_secret.json para garantir que você não inclua seus secrets em um repositório remoto. Para os tutoriais 3 e posteriores, adicione o caminho para o arquivo de banco de dados H2 e a fábrica de repositório de dados de arquivo. Mais informações sobre a configuração desses repositórios de dados podem ser encontradas no terceiro tutorial sobre como lidar com visitas recorrentes.
  • mvnw e mvnw.cmd são os executáveis do wrapper do Maven para Unix e Windows, respectivamente. Por exemplo, executar ./mvnw --version no Unix mostra a versão do Apache Maven, entre outras informações.
  • O diretório .mvn contém a configuração do wrapper do Maven.

Python

Credenciais do OAuth

Crie e faça o download das suas credenciais do OAuth conforme descrito anteriormente. Coloque o arquivo JSON no diretório raiz ao lado do arquivo de inicialização do servidor do aplicativo.

Configurar o servidor

Há várias opções para executar o servidor da Web. No final do seu arquivo Python, adicione uma das seguintes opções:

1. localhost não protegida. Isso é adequado apenas para testes diretos em uma janela do navegador. Não é possível carregar domínios não seguros no iframe do complemento do Google Sala de Aula.

   if __name__ == "__main__":
     # Disable OAuthlib's HTTPs verification.
     os.environ["OAUTHLIB_INSECURE_TRANSPORT"] = "1"
   
     # Run the web app at http://localhost:5000.
     app.run(debug=True)
   

2. Proteger o localhost. É necessário especificar uma tupla de arquivos de chave SSL para o argumento ssl_context.

   if __name__ == "__main__":
     # Run the web app at https://localhost:5000.
     app.run(host="localhost",
             ssl_context=("localhost.pem", "localhost-key.pem"),
             debug=True)
   

3. Servidor Gunicorn. Isso é adequado para um servidor pronto para produção ou implantação na nuvem. Recomendamos definir uma variável de ambiente PORT para uso com essa opção de inicialização.

   if __name__ == "__main__":
     # Run the web app at https://<your domain>:<server_port>.
     # Defaults to https://<your domain>:8080.
     server_port = os.environ.get("PORT", "8080")
     app.run(debug=True, port=server_port, host="0.0.0.0")
   

Iniciar o servidor

Execute o aplicativo Python para iniciar o servidor conforme configurado na etapa anterior.

python main.py

Clique no URL que aparece para ver o web app em um navegador e confirmar que ele está funcionando corretamente.

Node.js

Configurar o servidor

Para executar o servidor por HTTPS, crie um certificado autoassinado usado para executar o aplicativo por HTTPS. Essas credenciais precisam ser salvas como sslcert/cert.pem e sslcert/key.pem na pasta raiz do repositório. Talvez seja necessário adicionar essas chaves ao chaveiro do SO para que o navegador as aceite.

Verifique se *.pem está no arquivo .gitignore, porque você não quer fazer commit do arquivo no git.

Iniciar o servidor

Execute o aplicativo com o seguinte comando, substituindo step01 pela etapa correta que você quer executar como um servidor (por exemplo, step01 para 01-basic-app e step02 para 02-sign-in).

npm run step01

ou

npm run step02

Isso inicia o servidor da Web em https://localhost:5000.

Você pode encerrar o servidor com Control + C no terminal.

Java

Configurar o servidor

Para executar o servidor por HTTPS, crie um certificado autoassinado usado para executar o aplicativo por HTTPS.

Considere usar o mkcert para desenvolvimento local. Depois de instalar o mkcert, os comandos a seguir geram um certificado armazenado localmente para execução em HTTPS.

mkcert -install
mkcert -pkcs12 -p12-file <path_to_keystore> <domain_name>

Este exemplo inclui o arquivo do keystore no diretório de recursos. Você pode armazenar o arquivo onde preferir, mas atualize o arquivo application.properties com o caminho adequado. O nome de domínio é o domínio em que você executa o projeto (por exemplo, localhost).

Verifique se *.p12 está no arquivo .gitignore, porque você não quer fazer commit do arquivo no git.

Iniciar o servidor

Execute o método main no arquivo Application.java para iniciar o servidor. No IntelliJ, por exemplo, clique com o botão direito do mouse em Application.java > Run 'Application' no diretório src/main/java/com/addons/spring ou abra o arquivo Application.java e clique na seta verde à esquerda da assinatura do método main(String[] args). Outra opção é executar o projeto em uma janela de terminal:

./mvnw spring-boot:run

ou no Windows:

mvnw.cmd spring-boot:run

Isso inicia o servidor em https://localhost:5000 ou na porta especificada em application.properties.