Przewodniki

Python

Nasz przykład w Pythonie korzysta z platformy Flask. Możesz pobrać by uzyskać pełny kod źródłowy w linkach.

W razie potrzeby zainstaluj Pythona w wersji 3.7 lub nowszej i upewnij się, że jest dostępny pip.

python3 -m ensurepip --upgrade

Zalecamy też skonfigurowanie i aktywowanie nowego wirtualnego serwera w Pythonie. dla środowiska.

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

W każdym podkatalogu przewodnika znajduje się element requirements.txt pobrane przykłady. Wymagane biblioteki możesz szybko zainstalować za pomocą pip Za pomocą tych poleceń zainstaluj wymagane biblioteki oto pierwszy przewodnik.

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

Node.js

W naszym przykładzie ze środowiskiem Node.js korzystamy z platformy Express. Możesz pobrać pełny kod źródłowy, jaki znajdziesz w linkach.

Ten przykład wymaga środowiska Node.js w wersji 16.13 lub nowszej.

Zainstaluj wymagane moduły węzłów za pomocą interfejsu npm.

npm install

Java

Nasz przykład w Javie korzysta ze platformy Spring Boot. Możesz pobrać pełny kod źródłowy, jaki znajdziesz w linkach.

Zainstaluj Java 11 lub nowszą, jeśli nie masz jej jeszcze zainstalowanej na komputerze.

Aplikacje Spring Boot mogą używać Gradle lub Maven do obsługi kompilacji i zarządzania nimi zależności. Ten przykład obejmuje otokę Maven, która zapewnia powodzenie kompilacji bez konieczności instalowania samego narzędzia Maven.

W katalogu, w którym został pobrany lub sklonowany projekt, uruchom te polecenia, aby upewnić się, że spełniasz wymagania wstępne do uruchomienia projektu.

java --version
./mvnw --version

Lub w systemie Windows:

java -version
mvnw.cmd --version

Python

• Katalog główny zawiera następujące pliki:

  • main.py – punkt wejścia aplikacji w języku Python. Podaj serwer konfiguracji, której chcesz użyć w tym pliku, a następnie uruchom go uruchom serwer.
  • requirements.txt – moduły Pythona wymagane do uruchomienia aplikacji internetowej. Mogą być one instalowane automatycznie za pomocą aplikacji pip install -r requirements.txt.

  • client_secret.json – plik z tajnym kluczem klienta pobrany z Google. Google Cloud. Pamiętaj, że nie ma tego w przykładowym archiwum. Ty zmień nazwę pobranego pliku danych logowania i skopiuj go katalog główny.

• config.py – opcje konfiguracji serwera Flask.

• Katalog webapp zawiera treść aplikacji internetowej. Oto niektóre z nich:

• Katalog /templates/ z szablonami Jinja dla różnych stron.

• Katalog /static/ z obrazami, CSS i pomocniczym kodem JavaScript .

• routes.py – metody obsługi tras aplikacji internetowych.

• __init__.py – inicjator modułu webapp. Ten Inicjator uruchamia serwer Flask i wczytuje opcje konfiguracji. ustawiono w komórce config.py.

• Dodatkowe pliki wymagane w przypadku konkretnego kroku przewodnika.

Node.js

Każdy krok przejścia można znaleźć w oddzielnym <step> folderu głównego. Każdy krok obejmuje:

• Pliki statyczne, takie jak JavaScript, CSS i obrazy, znajdują się Folder ./<step>/public.
• Routery ekspresowe znajdują się w folderach ./<step>/routes.
• Szablony HTML znajdują się w folderach ./<step>/views.
• Aplikacja serwera to ./<step>/app.js.

Java

Katalog projektu zawiera:

• Katalog src.main zawiera kod źródłowy i konfigurację do uruchomienia aplikacji. Ten katalog zawiera następujące elementy: + java.com.addons.spring Katalog zawiera Application.java i Controller.java pliki. Plik Application.java odpowiada za uruchomienie serwera aplikacji, podczas gdy plik Controller.java obsługuje i punktu końcowego. + resources zawiera katalog templates z Pliki HTML i JavaScript. Zawiera również Plik application.properties określający port, na którym zostanie uruchomione serwera, ścieżkę do pliku magazynu kluczy i ścieżkę do klucza templates. Ten przykład zawiera plik magazynu kluczy w katalogu resources. Możesz ją zapisać w dowolnym miejscu ale pamiętaj o zaktualizowaniu usługi application.properties ze ścieżką.
  • pom.xml zawiera informacje potrzebne do skompilowania projektu oraz zdefiniować wymagane zależności.
  • .gitignore zawiera nazwy plików, których nie należy przesyłać do git. Pamiętaj, aby dodać ścieżkę do magazynu kluczy w tym .gitignore. W podanym przykładzie jest to secrets/*.p12 (cel parametru omówiono w sekcji poniżej). Przewodnik 2 i należy też podać ścieżkę do pliku client_secret.json, aby mieć pewność, że nie uwzględnisz swoich w repozytorium zdalnym. W przewodniku 3 i kolejnych należy dodać ścieżkę do pliku bazy danych H2 i pliku datastore fabryki. Więcej informacji o konfiguracji tych magazynów danych: można znaleźć w trzecim przewodniku po obsłudze powtarzających się wizyt.
  • mvnw i mvnw.cmd to pliki wykonywalne kodu Maven dla Unix i Windows. Na przykład uruchomienie ./mvnw --version na System Unix na wyjściu generuje m.in. wersję Apache Maven.
  • Katalog .mvn zawiera konfigurację kodu Maven.

Python

Dane logowania OAuth

Utwórz i pobierz dane logowania OAuth w sposób opisany powyżej. Miejsce plik JSON w katalogu głównym obok serwera aplikacji uruchom plik.

Konfigurowanie serwera

Serwer WWW możesz uruchomić na kilka sposobów. Na koniec Pythona, dodaj jeden z tych elementów:

1. Niezabezpieczony plik localhost. Nadaje się to do bezpośredniego testowania tylko w oknie przeglądarki; niezabezpieczonych domen nie można wczytać Element iframe dodatku Classroom.

   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. Zabezpiecz urządzenie localhost. Musisz określić krotkę plików kluczy SSL dla ssl_context argument.

   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. Serwer Gunicorn Jest to odpowiednie dla serwera produkcyjnego lub wdrożenie w chmurze. Zalecamy ustawienie zmiennej środowiskowej PORT dla użyj z tą opcją uruchamiania.

   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")
   

Uruchamianie serwera

Uruchom aplikację w Pythonie, aby uruchomić serwer zgodnie z konfiguracją poprzedniego kroku.

python main.py

Kliknij wyświetlony adres URL, aby otworzyć aplikację internetową w przeglądarce i potwierdzić, ale działa prawidłowo.

Node.js

Konfigurowanie serwera

Aby serwer działał przy użyciu protokołu HTTPS, musisz utworzyć własny certyfikat która służy do uruchamiania aplikacji przez HTTPS. Dane logowania powinny być zapisano jako sslcert/cert.pem i sslcert/key.pem w katalogu głównym repozytorium folderu Dysku. Konieczne może być dodanie tych kluczy do łańcucha kluczy systemu operacyjnego, aby przeglądarki, aby je zaakceptować.

Sprawdź, czy *.pem znajduje się w pliku .gitignore, bo nie chcesz aby przekazać plik do Git.

Uruchamianie serwera

Możesz uruchomić tę aplikację, używając tego polecenia, podstawiając za step01 dla odpowiedniego kroku, który chcesz uruchomić jako serwer (na przykład step01 w przypadku aplikacji 01-basic-app i step02 w przypadku logowania się 02).

npm run step01

lub

npm run step02

Spowoduje to uruchomienie serwera WWW pod adresem https://localhost:5000.

Możesz zakończyć działanie serwera, wpisując Control + C w terminalu.

Java

Konfigurowanie serwera

Aby serwer działał przy użyciu protokołu HTTPS, musisz utworzyć własny certyfikat która służy do uruchamiania aplikacji przez HTTPS.

Do programowania lokalnego warto używać narzędzia mkcert. Po zainstalowaniu aplikacji mkcert następujące polecenia wygenerują lokalnie przechowywany certyfikat do uruchomienia HTTPS.

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

W tym przykładzie umieszczamy plik magazynu kluczy w katalogu zasobów. Możesz możesz przechowywać dane w dowolnym miejscu, ale pamiętaj, aby zawsze application.properties z odpowiednią ścieżką. Nazwa domeny to domena, w której uruchamiasz projekt (np. localhost).

Sprawdź, czy *.p12 znajduje się w pliku .gitignore, bo nie chcesz aby przekazać plik do Git.

Uruchamianie serwera

Uruchom serwer, uruchamiając metodę main w narzędziu Application.java . Na przykład w IntelliJ możesz kliknąć prawym przyciskiem myszy Application.java Run 'Application' w src/main/java/com/addons/spring lub otwórz aplikację Application.java aby kliknąć zieloną strzałkę po lewej stronie ikony main(String[] args) podpis metody. Możesz też uruchomić projekt w terminalu okno:

./mvnw spring-boot:run

lub w systemie Windows:

mvnw.cmd spring-boot:run

Spowoduje to uruchomienie serwera na stronie https://localhost:5000 lub na porcie, określono w kolumnie application.properties.