Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

파이썬 - Azure App Service에 응용 프로그램 배포하기 전의 환경

지난 글에서 파이썬 웹 앱을,

파이썬 웹 앱을 Azure App Service에 배포하기
; https://www.sysnet.pe.kr/2/0/13830

배포했었는데요, 이게 참 중간에 너무 생략된 단계가 많아서 혼란이 오는 부분이 있습니다. 관련 내용이 문서화로 공개돼 있긴 한데요,

Built-in images
; https://learn.microsoft.com/en-us/troubleshoot/azure/app-service/faqs-app-service-linux#built-in-images

빠른 참조를 위해 필요한 만큼만 정리해 보겠습니다. ^^




우선, 처음 App Service를 만들고 나면 기본적으로 다음의 메시지를 담은 HTML을 호스팅하는 예제가 자리 잡게 됩니다.

Your web app is running and waiting for your content

Your web app is live, but we don’t have your content yet. If you’ve already deployed, it could take up to 5 minutes for your content to show up, so come back soon.

Built with Python

...[생략]...

이 상태에서 SSH 접속을 하게 되면, 초기 시작 디렉터리가 /home/site/wwwroot로 나오고 그 하위에 기본 파이썬 예제 파일들이 있습니다.

/home/site/wwwroot# ls -l
total 4
-rwxrwxrwx 1 nobody nogroup 3269 May 13 05:47 hostingstart.html

얼핏 이 파일이 기본 화면이라고 생각할 수 있지만,

$ cat hostingstart.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>Microsoft Azure App Service - Welcome</title>
    <link rel="shortcut icon" href="https://appservice.azureedge.net/images/app-service/v4/favicon.ico" type="image/x-icon" />
    <link href="https://appservice.azureedge.net/css/app-service/v4/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous" />
    <style>
        html, body {
            height: 100%;
            background-color: #ffffff;
            color: #000000;
            font-size: 13px;
        }

        * {
            border-radius: 0 !important;
        }
    </style>
    <script src="https://appservice.azureedge.net/js/app-service/v4/loc.min.js" crossorigin="anonymous"></script>
    <script type="text/javascript">window.onload=function (){try{var a=window.location.hostname; if (a.includes(".azurewebsites.net")){a=a.replace(".azurewebsites.net", "")};var b=document.getElementById("depCenterLink"); b.setAttribute("href", b.getAttribute("href") + "&sitename=" + a); loc()}catch (d){}}</script>
</head>
<body>
    <nav class="navbar"><div class="navbar-brand "><div class="container pl-4 ml-5"><img src="https://appservice.azureedge.net/images/app-service/v4/azurelogo.svg" width="270" height="108" alt="" /></div></div></nav><div class="container-fluid mr-2 mt-5 pt-5"><div class="row"><div class="col-xs-12 col-sm-12 d-block d-lg-none d-xl-none d-md-block d-sm-block d-xs-block"><div class="text-center"><img src="https://appservice.azureedge.net/images/app-service/v4/web.svg" /></div></div><div class="pl-5 ml-5 col-xl-5 col-lg-5 col-md-10 col-sm-11 col-xs-11"><div class="container-fluid"><div class="row"><h2 id="upRunning">Your web app is running and waiting for your content</h2></div><div class="row mt-4 pt-4"><div id="appIsLive" style="font-size:16px;width: 516px;">Your web app is live, but we don’t have your content yet. If you’ve already deployed, it could take up to 5 minutes for your content to show up, so come back soon.</div></div><div class="row mt-4"><h5 class="mt-5"><img src="https://appservice.azureedge.net/images/app-service/v4/code.svg" /><span id="supporting">Supporting Node.js, Java, .NET and more</span></h5></div></div></div><div class="col-xl-5 col-lg-5 col-md-12 d-none d-lg-block"><div class="text-left"><img src="https://appservice.azureedge.net/images/app-service/v4/web.svg" /></div></div><div class="col-xl-1 col-lg-1 col-md-1"></div></div><div class="row mt-4"><div class="container-fluid"><div class="row mt-3"><div class="pl-5 ml-5 col-md-2 mt-4"><p><span id="haventDeployed">Haven’t deployed yet?</span><br /><span id="useDCenter">Use the deployment center to publish code or set up continuous deployment.</span><br /><a id="depCenterLink" href="https://go.microsoft.com/fwlink/?linkid=2057852"><button class="btn btn-primary mt-4" type="submit" id="deplCenter">Deployment center</button></a></p></div><div class="pl-5 ml-5 col-md-2 mt-4"><p><span id="newWebSite">Starting a new web site?</span><br /><span id="followQS">Follow our Quickstart guide to get a web app ready quickly.</span><br /><a href="https://go.microsoft.com/fwlink/?linkid=2084231"><button class="btn btn-primary mt-4" type="submit" id="quickStart">Quickstart</button></a></p></div></div></div></div></div>
</body>
</html>

내용은 같아도 파일 경로는 다릅니다. 첫 페이지가 어딘지 찾기 전에 SSH로 접속한 경우 기본 실행 환경을 구성하는 ~/.bashrc 파일을 살펴볼 필요가 있습니다.

/home/site/wwwroot# cat ~/.bashrc
# ...[주석 생략]...

export PATH="$PATH:/opt/mssql-tools18/bin"
cd /home
alias vizviewer=/opt/startup/code_profiler/vizviewer.sh
export APP_PATH="/home/site/wwwroot"
cd $APP_PATH
export VIRTUALENVIRONMENT_PATH="/home/site/wwwroot/antenv"
. antenv/bin/activate

즉, "cd ..."를 통해 /home/site/wwwroot로 이동하고, 그다음 파이썬 가상 환경인 antenv를 활성화시키는데요, 사실 처음 App Service가 생성된 시점에는 저 디렉터리가 없으므로 SSH 접속 시 저 코드에서 이런 오류 메시지가 나옵니다.

   _____                               
  /  _  \ __________ _________   ____  
 /  /_\  \\___   /  |  \_  __ \_/ __ \ 
/    |    \/    /|  |  /|  | \/\  ___/ 
\____|__  /_____ \____/ |__|    \___  >
        \/      \/                  \/ 
A P P   S E R V I C E   O N   L I N U X

Documentation: http://aka.ms/webapp-linux
Python 3.12.9
Note: Any data outside '/home' is not persisted
-bash: antenv/bin/activate: No such file or directory
root@pywebapp-f00b3990:/home/site/wwwroot# 

그리고 .bashrc의 구성을 이해하려면 Azure App Service 인스턴스가 뜰 때 가장 먼저 실행되는 프로세스를 살펴봐야 하는데요,

# ps aux
USER         PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root           1  0.0  0.0   2480    68 ?        SNs  06:11   0:00 /bin/sh /opt/startup/startup.sh
root          29  0.0  0.0  13352   420 ?        SNs  06:11   0:00 sshd: /usr/sbin/sshd [listener] 0 of 10-100 startups
root         986  0.0  0.0   6896   172 ?        SN   06:11   0:00 bash /run-diag.sh
root         988  1.1  1.3 3224032 25740 ?       SNl  06:11   0:05 ./DiagServer
root        1011  0.0  0.0   6744  1012 ?        SNs  06:11   0:00 /usr/sbin/cron
root        1023  0.1  1.1 187388 21608 ?        SNl  06:11   0:00 /opt/python/3.12.9/bin/python3 /opt/python/3/bin/gunicorn application:app
root        1026  0.1  1.6 286584 30468 ?        SNl  06:12   0:00 /opt/python/3.12.9/bin/python3 /opt/python/3/bin/gunicorn application:app
root        1029  0.5  1.6 285456 31204 ?        SN   06:12   0:02 /opt/python/3.12.9/bin/python3 /opt/python/3/bin/gunicorn application:app
root        1030  0.5  1.5 285480 30188 ?        SN   06:12   0:03 /opt/python/3.12.9/bin/python3 /opt/python/3/bin/gunicorn application:app
root        1051  0.0  0.1  13464  2992 ?        SNs  06:13   0:00 sshd: root@pts/0
root        1053  0.0  0.1   7160  3384 pts/0    SNs  06:13   0:00 -bash
root        1073  0.0  0.1   9756  3240 pts/0    RN+  06:20   0:00 ps aux

/opt/startup/startup.sh 스크립트의 구성으로 인해,

# cat /opt/startup/startup.sh 
#!/bin/sh

echo 'export APP_PATH="/home/site/wwwroot"' >> ~/.bashrc
echo 'cd $APP_PATH' >> ~/.bashrc

# Enter the source directory to make sure the script runs where the user expects
cd /home/site/wwwroot

export APP_PATH="/home/site/wwwroot"
if [ -z "$HOST" ]; then
                export HOST=0.0.0.0
fi

if [ -z "$PORT" ]; then
                export PORT=80
fi

export PATH="/opt/python//bin:${PATH}"
echo 'export VIRTUALENVIRONMENT_PATH="/home/site/wwwroot/antenv"' >> ~/.bashrc
echo '. antenv/bin/activate' >> ~/.bashrc
  echo WARNING: Could not find virtual environment directory '/home/site/wwwroot/antenv'.
  echo WARNING: Could not find package directory '/home/site/wwwroot/__oryx_packages__'.
GUNICORN_CMD_ARGS="--timeout 600 --access-logfile '-' --error-logfile '-' -c /opt/startup/gunicorn.conf.py --chdir=/opt/defaultsite" gunicorn application:app

~/.bashrc에 있던 내용 중 아래의 분량만큼은,

export APP_PATH="/home/site/wwwroot"
cd $APP_PATH
export VIRTUALENVIRONMENT_PATH="/home/site/wwwroot/antenv"
. antenv/bin/activate

App Service 인스턴스가 생성될 때마다 startup.sh에 의해 언제나 재구성되고 있는 것입니다. (그래서 App Service의 SSH 접속 시마다 .bashrc가 실행돼 /home/site/wwwroot에서 시작하게 되는 것입니다.)




다시 처음 질문으로 돌아가서, 그래서 최초 호스팅되는 페이지의 경로는 /opt/startup/startup.sh 파일의 마지막에 있는 gunicorn 시작 명령어로 알 수 있습니다.

GUNICORN_CMD_ARGS="--timeout 600 --access-logfile '-' --error-logfile '-' -c /opt/startup/gunicorn.conf.py --chdir=/opt/defaultsite" gunicorn application:app


--chdir=/opt/defaultsite 옵션으로 인해 작업 디렉터리가 바뀌는데요, 바로 그 디렉터리에 Azure App Service의 기본 화면을 보여주는 html 파일이 위치하게 됩니다.

# ls /opt/defaultsite/ -l
total 20
-rw-rw-r-- 1 root root  351 Mar  3 07:26 application.py
-rw-rw-r-- 1 root root 3447 Mar  3 07:26 hostingstart_dep.html
-rw-rw-r-- 1 root root 4560 Mar  3 07:26 hostingstart.html
drwxr-xr-x 2 root root 4096 May 13 06:12 __pycache__

그리고 gunicorn이 실행하는 application:app 함수는,

# cat /opt/defaultsite/application.py 
from flask import Flask
import os
app = Flask(__name__, static_folder='/opt/defaultsite')

@app.route('/')
def root():
    if os.path.isdir('/home/site/deployments') and len(next(os.walk('/home/site/deployments'))[1]) > 1:
        return app.send_static_file('hostingstart_dep.html')
    else:
        return app.send_static_file('hostingstart.html')

저렇게 Flask 프레임워크를 초기화하고 hostingstart.html 파일을 '/' 루트 요청의 응답으로 반환하는 역할을 합니다. 이 정도면, 대충 구조가 눈에 들어오시죠? ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 6/9/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 31  32  33  34  [35]  36  37  38  39  40  41  42  43  44  45  ...
NoWriterDateCnt.TitleFile(s)
13092정성태7/3/202217510.NET Framework: 2028. C# - HttpWebRequest의 POST 동작 방식파일 다운로드1
13091정성태7/3/202216112.NET Framework: 2027. C# - IPv4, IPv6를 모두 지원하는 서버 소켓 생성 방법
13090정성태6/29/202215661오류 유형: 815. PyPI에 업로드한 패키지가 반영이 안 되는 경우
13089정성태6/28/202216315개발 환경 구성: 646. HOSTS 파일 변경 시 Edge 브라우저에 반영하는 방법
13088정성태6/27/202214673개발 환경 구성: 645. "Developer Command Prompt for VS 2022" 명령행 환경의 폰트를 바꾸는 방법
13087정성태6/23/202218185스크립트: 41. 파이썬 - FastAPI / uvicorn 호스팅 환경에서 asyncio 사용하는 방법 [1]
13086정성태6/22/202217908.NET Framework: 2026. C# 11 - 문자열 보간 개선 2가지파일 다운로드1
13085정성태6/22/202217317.NET Framework: 2025. C# 11 - 원시 문자열 리터럴(raw string literals)파일 다운로드1
13084정성태6/21/202216794개발 환경 구성: 644. Windows - 파이썬 2.7을 msi 설치 없이 구성하는 방법
13083정성태6/20/202217184.NET Framework: 2024. .NET 7에 도입된 GC의 메모리 해제에 대한 segment와 region의 차이점 [2]
13082정성태6/19/202216226.NET Framework: 2023. C# - Process의 I/O 사용량을 보여주는 GetProcessIoCounters Win32 API파일 다운로드1
13081정성태6/17/202214969.NET Framework: 2022. C# - .NET 7 Preview 5 신규 기능 - System.IO.Stream ReadExactly / ReadAtLeast파일 다운로드1
13080정성태6/17/202216475개발 환경 구성: 643. Visual Studio 2022 17.2 버전에서 C# 11 또는 .NET 7.0 preview 적용
13079정성태6/17/202213670오류 유형: 814. 파이썬 - Error: The file/path provided (...) does not appear to exist
13078정성태6/16/202217281.NET Framework: 2021. WPF - UI Thread와 Render Thread파일 다운로드1
13077정성태6/15/202218215스크립트: 40. 파이썬 - PostgreSQL 환경 구성
13075정성태6/15/202215009Linux: 50. Linux - apt와 apt-get의 차이 [2]
13074정성태6/13/202215809.NET Framework: 2020. C# - NTFS 파일에 사용자 정의 속성값 추가하는 방법파일 다운로드1
13073정성태6/12/202216232Windows: 207. Windows Server 2022에 도입된 WSL 2
13072정성태6/10/202216346Linux: 49. Linux - ls 명령어로 출력되는 디렉터리 색상 변경 방법
13071정성태6/9/202217041스크립트: 39. Python에서 cx_Oracle 환경 구성
13070정성태6/8/202217658오류 유형: 813. Windows 11에서 입력 포커스가 바뀌는 문제 [1]
13069정성태5/26/202219616.NET Framework: 2019. C# - .NET에서 제공하는 3가지 Timer 비교 [2]
13068정성태5/24/202218377.NET Framework: 2018. C# - 일정 크기를 할당하는 동안 GC를 (가능한) 멈추는 방법 [1]파일 다운로드1
13067정성태5/23/202215926Windows: 206. Outlook - 1년 이상 지난 메일이 기본적으로 안 보이는 문제
13066정성태5/23/202215884Windows: 205. Windows 11 - Windows + S(또는 Q)로 뜨는 작업 표시줄의 검색 바가 동작하지 않는 경우
... 31  32  33  34  [35]  36  37  38  39  40  41  42  43  44  45  ...