Azure App Service on Linux FAQ (Usługa Azure App Service w systemie Linux — często zadawane pytania)

Te polecenia lub skrypty są wykonywane po uruchomieniu wbudowanego kontenera platformy Docker, ale przed uruchomieniem kodu aplikacji.

Ta akcja jest taka sama jak ponowne uruchomienie platformy Docker.

Tak, można to zrobić za pośrednictwem lokacji zarządzania kontrolą źródła (SCM).

Ustaw pole zarezerwowane usługi app service na wartość true.

Tak, aby skonfigurować ciągłą integrację/ciągłe wdrażanie dla usługi Azure Container Registry lub DockerHub, postępując zgodnie z instrukcjami Ciągłe wdrażanie za pomocą usługi Web App for Containers. W przypadku rejestrów prywatnych można odświeżyć kontener, zatrzymując się, a następnie uruchamiając aplikację internetową. Możesz też zmienić lub dodać fikcyjne ustawienie aplikacji, aby wymusić odświeżenie kontenera.

Tak.

Tak, należy ustawić ustawienie aplikacji o nazwie WEBSITE_WEBDEPLOY_USE_SCM false.

Jeśli wdrożenie usługi Git nie powiedzie się w aplikacji internetowej systemu Linux, wybierz jedną z następujących opcji, aby wdrożyć kod aplikacji:

• Użyj funkcji ciągłego dostarczania (wersja zapoznawcza): możesz przechowywać kod źródłowy aplikacji w repozytorium Git usługi Azure DevOps lub repozytorium GitHub, aby używać usługi Azure Continuous Delivery. Aby uzyskać więcej informacji, zobacz How to configure Continuous Delivery for Linux web app (Jak skonfigurować ciągłe dostarczanie dla aplikacji internetowej systemu Linux).

• Użyj interfejsu API wdrażania pliku ZIP: aby użyć tego interfejsu API, za pomocą protokołu SSH w aplikacji internetowej przejdź do folderu, w którym chcesz wdrożyć kod. Uruchom następujący kod:

  curl -X POST -u <user> --data-binary @<zipfile> https://{your-sitename}.scm.azurewebsites.net/api/zipdeploy
  

  Jeśli wystąpi błąd, że polecenie nie zostanie znalezione, przed uruchomieniem poprzedniego curl polecenia upewnij się, że curl program curl został zainstalowany przy apt-get install curl użyciu polecenia .

Tak, wyłącz perMessageDeflate w kodzie Node.js po stronie serwera. Jeśli na przykład używasz socket.io, użyj następującego kodu:

const io = require('socket.io')(server,{
  perMessageDeflate :false
});

Tak.

Tak, podczas wdrażania usługi Git kudu powinien wykryć, że wdrażasz aplikację PHP (dzięki obecności pliku composer.lock), a kudu wyzwoli instalację kompozytora.

Tak, ta funkcja jest dostępna w interfejsie wiersza polecenia platformy Azure. Można użyć tożsamości przypisanych przez system lub przypisanych przez użytkownika. Ta funkcja nie jest obecnie obsługiwana w witrynie Azure Portal.

Jeśli WEBSITES_ENABLE_APP_SERVICE_STORAGE ustawienie jest nieokreślone lub ustawione na wartość false, /home/ katalog nie będzie współużytkowany w wystąpieniach skalowania, a zapisane pliki nie będą utrwalane po ponownym uruchomieniu. Jawne ustawienie WEBSITES_ENABLE_APP_SERVICE_STORAGE wartości true spowoduje włączenie instalacji. Po ustawieniu wartości true, jeśli chcesz wyłączyć instalację, musisz jawnie ustawić WEBSITES_ENABLE_APP_SERVICE_STORAGE wartość false.

App Service dla systemu Linux używa dwóch różnych typów magazynu:

• Magazyn systemu plików: magazyn systemu plików jest uwzględniony w ramach limitu przydziału planu usługi App Service. Jest używany, gdy pliki są zapisywane w magazynie trwałym, który jest zakorzeniony w /home katalogu.
• Miejsce na dysku hosta: miejsce na dysku hosta jest używane do przechowywania obrazów kontenerów. Jest ona zarządzana przez platformę za pośrednictwem sterownika magazynu platformy Docker.

Miejsce na dysku hosta jest oddzielone od limitu przydziału magazynu systemu plików. Nie można go rozwinąć i istnieje limit 15 GB dla każdego wystąpienia. Służy do przechowywania dowolnych obrazów niestandardowych w ramach procesu roboczego. W zależności od dokładnej dostępności miejsca na dysku hosta może być możliwe użycie większych niż 15 GB, ale nie jest to gwarantowane.

Jeśli zapisywalna warstwa kontenera zapisuje dane poza /home katalogiem lub zainstalowanej ścieżki magazynu platformy Azure, zostanie również użyte miejsce na dysku hosta.

Platforma rutynowo czyści miejsce na dysku hosta, aby usunąć nieużywane kontenery. Jeśli kontener zapisuje dużą ilość danych poza /home katalogiem lub byOS ( Bring Your Own Storage), spowoduje to błędy uruchamiania lub wyjątki środowiska uruchomieniowego po przekroczeniu limitu miejsca na dysku hosta.

Zalecamy przechowywanie obrazów kontenerów tak małych, jak to możliwe i zapisywanie danych w magazynie trwałym lub byOS podczas uruchamiania w usłudze App Service systemu Linux. Jeśli nie jest to możliwe, musisz podzielić plan usługi App Service, ponieważ miejsce na dysku hosta jest stałe i współdzielone między wszystkie kontenery w planie usługi App Service.

Możesz skonfigurować czas oczekiwania platformy przed ponownym uruchomieniem kontenera. W tym celu ustaw WEBSITES_CONTAINER_START_TIME_LIMIT ustawienie aplikacji na odpowiednią wartość. Wartość domyślna to 230 sekund, a maksymalna wartość to 1800 sekund.

Podaj pełny adres URL rejestru, w tym http:// lub https://.

Dodaj pełną nazwę obrazu, w tym adres URL rejestru prywatnego (na przykład myacr.azurecr.io/dotnet:latest). Nazwy obrazów używające portu niestandardowego nie mogą być wprowadzane za pośrednictwem portalu. Aby ustawić docker-custom-image-namepolecenie , użyj az narzędzia wiersza polecenia.

Nie obsługujemy uwidaczniania więcej niż jednego portu.

Tak, funkcja bring your own storage jest dostępna w wersji zapoznawczej.

Witryna SCM działa w osobnym kontenerze. Nie można sprawdzić systemu plików ani uruchomionych procesów kontenera aplikacji.

Nie, platforma obsługuje kończenie żądań HTTPS na udostępnionych frontonach.

Tak, jest to wymagane w przypadku kontenerów niestandardowych. Aby ręcznie skonfigurować port niestandardowy, użyj instrukcji EXPOSE w pliku Dockerfile i ustawieniu aplikacji, WEBSITES_PORT z wartością portu, która ma być powiązana z kontenerem.

Tak, zastąp zmienną środowiskową przed uruchomieniem aplikacji .NET Core. Na przykład w skrycie init.sh: eksportowanie ASPNETCORE_URLS={Wartość}

Aby można było używać usługi ACR z wieloma kontenerami, wszystkie obrazy kontenerów muszą być hostowane na tym samym serwerze rejestru usługi ACR. Gdy znajdują się one na tym samym serwerze rejestru, należy utworzyć ustawienia aplikacji, a następnie zaktualizować plik konfiguracji narzędzia Docker Compose, aby uwzględnić nazwę obrazu usługi ACR.

Utwórz następujące ustawienia aplikacji:

• DOCKER_REGISTRY_SERVER_USERNAME
• DOCKER_REGISTRY_SERVER_URL (pełny adres URL, np. https://<server-name>.azurecr.io)
• DOCKER_REGISTRY_SERVER_PASSWORD (włącz dostęp administratora w ustawieniach usługi ACR)

W pliku konfiguracji odwołaj się do obrazu usługi ACR, jak w poniższym przykładzie:

image: <server-name>.azurecr.io/<image-name>:<tag>

• Tylko jeden kontener może być otwarty w celu uzyskania dostępu
• Dostępny jest tylko port 80 i 8080 (uwidocznione porty)

Poniżej przedstawiono reguły określania, który kontener jest dostępny — w kolejności pierwszeństwa:

• Ustawienie WEBSITES_WEB_CONTAINER_NAME aplikacji ustawione na nazwę kontenera
• Pierwszy kontener do zdefiniowania portu 80 lub 8080
• Jeśli żadna z powyższych wartości nie jest prawdziwa, pierwszy kontener zdefiniowany w pliku będzie dostępny (uwidoczniony)

Opcja depends_on jest nieobsługiwana w usłudze App Service i zostanie zignorowana. Podobnie jak zalecenie dotyczące uruchamiania i zamykania kontrolki z platformy Docker, aplikacje wielokontenerowe usługi App Service powinny sprawdzać zależności za pośrednictwem kodu aplikacji — zarówno podczas uruchamiania, jak i rozłączania. Poniższy przykładowy kod przedstawia sprawdzanie aplikacji w języku Python, aby sprawdzić, czy kontener Redis jest uruchomiony.

import time
import redis
from flask import Flask
app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)
def get_hit_count():
    retries = 5
    while True:
        try:
            return cache.incr('hits')
        except redis.exceptions.ConnectionError as exc:
            if retries == 0:
                raise exc
            retries -= 1
            time.sleep(0.5)
@app.route('/')
def hello():
    count = get_hit_count()
    return 'Hello from Azure App Service team! I have been seen {} times.\n'.format(count)
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=80, debug=True)

Gniazda sieci Web

Gniazda internetowe są obsługiwane w aplikacjach systemu Linux. Ustawienie webSocketsEnabled usługi ARM nie ma zastosowania do aplikacji systemu Linux, ponieważ gniazda internetowe są zawsze włączone dla systemu Linux.

Ceny różnią się w zależności od jednostki SKU i regionu, ale możesz zobaczyć więcej szczegółów na naszej stronie cennika: Cennik usługi App Service.

Po uruchomieniu kontenera przez usługi aplikacja systemu Azure żądanie rozgrzewki wysyła żądanie HTTP do punktu końcowego /robots933456.txt aplikacji. Jest to po prostu fikcyjny punkt końcowy, ale aplikacja musi odpowiadać za pomocą dowolnego kodu stanu innego niż 5XX. Jeśli logika aplikacji nie odpowiada z żadnym kodem stanu HTTP do nieistniejących punktów końcowych, żądanie rozgrzewania nie może odebrać odpowiedzi i bezterminowe ponowne uruchomienie kontenera. Żądanie rozgrzewki może również zakończyć się niepowodzeniem z powodu błędu konfiguracji portu.

Aby upewnić się, że port jest poprawnie skonfigurowany w usługach aplikacja systemu Azure, zobacz pytanie Jak mogę określić port w kontenerze systemu Linux?

Żądanie rozgrzewania domyślnie kończy się niepowodzeniem po odczekaniu 240 sekund odpowiedzi z kontenera. Możesz zwiększyć limit czasu żądania rozgrzewania kontenera, dodając ustawienie WEBSITES_CONTAINER_START_TIME_LIMIT aplikacji z wartością z zakresu od 240 do 1800 sekund.

System plików aplikacji jest zainstalowanym udziałem sieciowym. Umożliwia to skalowanie w poziomie scenariuszy, w których kod musi być wykonywany na wielu hostach. Niestety blokuje to użycie dostawców baz danych opartych na plikach, takich jak SQLite, ponieważ nie jest możliwe uzyskanie wyłącznych blokad w pliku bazy danych. Zalecamy usługę zarządzanej bazy danych: Azure SQL, Azure Database for MySQL lub Azure Database for PostgreSQL

W ustawieniach aplikacji można używać tylko liter (A-Z, a-z), cyfr (0–9) i znaku podkreślenia (_).

Swój pomysł możesz przesłać na forum opinii usługi Web Apps. Dodaj ciąg "[Linux]" do tytułu swojego pomysłu.

Następne kroki

• Co to jest usługa aplikacja systemu Azure w systemie Linux?
• Konfigurowanie środowisk przejściowych w usłudze Azure App Service
• Ciągłe wdrażanie za pomocą usługi Web App for Containers
• Co należy wiedzieć: Web Apps i Linux
• Dokumentacja zmiennych środowiskowych i ustawień aplikacji

Skontaktuj się z nami, aby uzyskać pomoc

Jeśli masz pytania lub potrzebujesz pomocy, utwórz wniosek o pomoc techniczną lub zadaj pytanie w społeczności wsparcia dla platformy Azure. Możesz również przesłać opinię o produkcie do społeczności opinii na temat platformy Azure.