Tutoriais

Python

Nosso exemplo de Python usa o framework Flask. Você pode fazer 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. Você pode 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 de Node.js usa o framework Express. Você pode fazer 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ó necessários usando npm.

npm install

Java

Nosso exemplo de Java usa o framework Spring Boot. Você pode fazer 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 um build bem-sucedido sem exigir que você instale o Maven.

No diretório em que você baixou ou clonou o projeto, execute os comandos a seguir 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 app da Web. 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. Ele 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. 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 handler 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 adicionais conforme exigido por uma etapa específica do tutorial.

Node.js

Cada etapa do tutorial pode ser encontrada no próprio <step> subdiretório. Cada etapa contém:

• Arquivos estáticos, como JavaScript, CSS e imagens, são encontrados na ./<step>/public pasta.
• Os roteadores Express são encontrados nas pastas ./<step>/routes.
• Os modelos HTML são encontrados 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. 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 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 do keystore e o caminho para o diretório templates. Este exemplo inclui o arquivo do keystore no diretório resources. Você pode armazená-lo onde preferir, mas atualize o application.properties arquivo com o caminho de acordo.
  • 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 o keystore nesse .gitignore. No exemplo fornecido, esse é secrets/*.p12. A finalidade do keystore é discutida na seção abaixo. Para o tutorial 2 e versões mais recentes, 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 o tutorial 3 e versões mais recentes, adicione o caminho para o arquivo de banco de dados H2 e a fábrica de armazenamento de dados de arquivos. Mais informações sobre a configuração desses armazenamentos de dados podem ser encontradas no terceiro tutorial sobre como processar visitas repetidas.
  • 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 gera 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 de OAuth

Crie e faça o download das 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

Você tem várias opções para executar o servidor da Web. No final do arquivo Python, adicione um dos seguintes:

1. localhost não seguro. Isso é adequado apenas para testes diretos em uma janela do navegador. Domínios não seguros não podem ser carregados 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. localhost seguro. Você precisa 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 conferir o app da Web em um navegador e confirmar se ele está funcionando corretamente.

Node.js

Configurar o servidor

Para executar o servidor por HTTPS, você precisa criar um autocertificado 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 confirmar o arquivo no Git.

Iniciar o servidor

Você pode executar o aplicativo com o comando a seguir, 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, você precisa criar um autocertificado 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 por 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 armazená-lo onde preferir, mas atualize o arquivo application.properties com o caminho de acordo. 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 confirmar o arquivo no Git.

Iniciar o servidor

Inicie o servidor executando o método main no arquivo Application.java. No IntelliJ, por exemplo, você pode clicar com o botão direito em Application.java > Run 'Application' no diretório src/main/java/com/addons/spring ou abrir o Application.java arquivo para clicar na seta verde à esquerda da assinatura do método main(String[] args). Como alternativa, você pode executar o projeto em uma janela do 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.