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

Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제

지난 글에 설명한 Compress-Archive를 이용해 python 앱 디렉터리를 압축하고 그 결과물을 Azure Web App에 배포하게 되면,

c:\temp> powershell Compress-Archive c:\temp\deploy\* test.zip

c:\temp> az webapp deploy --resource-group pywebapp_group --name pywebapp --src-path test.zip

웬일인지 Python Web App이 정상적으로 동작하지 않는 것을 볼 수 있습니다. 원인을 찾기 위해 Azure Portal을 통해 해당 App Service로 SSH 연결을 통해 들어가 봤더니 디렉터리 구성이 이런 식으로 황당하게 되어 있었습니다.

# ls
 antenv                                                  'static\bootstrap\css\bootstrap.rtl.css'
 CHANGELOG.md                                            'static\bootstrap\css\bootstrap.rtl.css.map'
 CONTRIBUTING.md                                         'static\bootstrap\css\bootstrap.rtl.min.css'
 LICENSE.md                                              'static\bootstrap\css\bootstrap.rtl.min.css.map'
 main.py                                                 'static\bootstrap\css\bootstrap-utilities.css'
 README.md                                               'static\bootstrap\css\bootstrap-utilities.css.map'
 requirements.txt                                        'static\bootstrap\css\bootstrap-utilities.min.css'
 startup.sh                                              'static\bootstrap\css\bootstrap-utilities.min.css.map'
'static\bootstrap\'                                      'static\bootstrap\css\bootstrap-utilities.rtl.css'
'static\bootstrap\css\bootstrap.css'                     'static\bootstrap\css\bootstrap-utilities.rtl.css.map'
'static\bootstrap\css\bootstrap.css.map'                 'static\bootstrap\css\bootstrap-utilities.rtl.min.css'
'static\bootstrap\css\bootstrap-grid.css'                'static\bootstrap\css\bootstrap-utilities.rtl.min.css.map'
'static\bootstrap\css\bootstrap-grid.css.map'            'static\bootstrap\js\bootstrap.bundle.js'
'static\bootstrap\css\bootstrap-grid.min.css'            'static\bootstrap\js\bootstrap.bundle.js.map'
'static\bootstrap\css\bootstrap-grid.min.css.map'        'static\bootstrap\js\bootstrap.bundle.min.js'
'static\bootstrap\css\bootstrap-grid.rtl.css'            'static\bootstrap\js\bootstrap.bundle.min.js.map'
'static\bootstrap\css\bootstrap-grid.rtl.css.map'        'static\bootstrap\js\bootstrap.esm.js'
'static\bootstrap\css\bootstrap-grid.rtl.min.css'        'static\bootstrap\js\bootstrap.esm.js.map'
'static\bootstrap\css\bootstrap-grid.rtl.min.css.map'    'static\bootstrap\js\bootstrap.esm.min.js'
'static\bootstrap\css\bootstrap.min.css'                 'static\bootstrap\js\bootstrap.esm.min.js.map'
'static\bootstrap\css\bootstrap.min.css.map'             'static\bootstrap\js\bootstrap.js'
'static\bootstrap\css\bootstrap-reboot.css'              'static\bootstrap\js\bootstrap.js.map'
'static\bootstrap\css\bootstrap-reboot.css.map'          'static\bootstrap\js\bootstrap.min.js'
'static\bootstrap\css\bootstrap-reboot.min.css'          'static\bootstrap\js\bootstrap.min.js.map'
'static\bootstrap\css\bootstrap-reboot.min.css.map'      'static\favicon.ico'
'static\bootstrap\css\bootstrap-reboot.rtl.css'          'static\images\azure-icon.svg'
'static\bootstrap\css\bootstrap-reboot.rtl.css.map'      'templates\hello.html'
'static\bootstrap\css\bootstrap-reboot.rtl.min.css'      'templates\index.html'
'static\bootstrap\css\bootstrap-reboot.rtl.min.css.map'

위의 예에서 "'static\bootstrap\'" 파일은 원래 "static" 디렉터리 하위에 "bootstrap" 디렉터리가 있어야 하는데, Compress-Archive가 압축 파일의 경로를 '\'로 구분한 것을 그대로 (디렉터리가 아닌) 파일명으로 인식해 압축을 해제한 것입니다.

이 문제를 없애려면, 압축 파일을 만들 때 경로 구분자를 '/'로 바꾸어야 합니다. 단지 Compress-Archive는 이를 위한 옵션이 없으므로, tar를 대신 쓸 수 있습니다.

// 파이썬 웹 앱의 디렉터리가 c:\temp\deploy에 있다고 가정

c:\temp> cd c:\temp\deploy

c:\temp\deploy> tar.exe -a -c -f test.zip *

하지만 저 명령어는 1) 가끔씩 0KB 크기의 test.zip 자체를 포함하거나 2) 필요 없는 오류 메시지("Can't add archive to itself")를 출력하는 이상한 동작을 하는데요, 그래도 뭐 다른 파일들은 모두 정상적으로 압축이 됐으므로 문제가 되진 않습니다.




그래도 만약, 저런 동작이 눈에 거슬린다면 tar 대신 C#을 이용해 직접 만들어도 됩니다. 사실 ZipArchiveEntry의 이름에서 디렉터리 구분자를 ('\'가 아닌) '/'로 바꾸어야 하는 정도의 간단한 작업만 필요하므로 그리 어렵지 않게 코딩할 수 있습니다.

using System.IO.Compression;

namespace uCompressArchive
{
    internal class Program
    {
        static void Main(string[] args)
        {
            if (args.Length == 0)
            {
                Console.WriteLine($"Usage: {nameof(uCompressArchive)} directory");
                Console.WriteLine($"Usage: {nameof(uCompressArchive)} zipfilename directory");
                return;
            }

            string targetDir;
            string zipFileName;
            string zipFilePath;

            if (args.Length == 1)
            {
                targetDir = args[0];
                zipFilePath = Path.GetFileName(Environment.CurrentDirectory) + ".zip";
            }
            else
            {
                zipFilePath = args[0];
                targetDir = args[1];
            }

            if (targetDir == ".")
            {
                zipFileName = Path.GetFileName(zipFilePath) ?? "temp";
            }
            else
            {
                zipFileName = Path.GetFileName(zipFilePath);
            }

            using (FileStream fs = File.OpenWrite(zipFilePath))
            using (ZipArchive destArchive = new ZipArchive(fs, ZipArchiveMode.Create, true))
            {
                Directory.EnumerateFiles(targetDir, "*", SearchOption.AllDirectories)
                    .ToList()
                    .ForEach(file =>
                    {
                        string entryName = file.Substring(targetDir.Length + 1);
                        entryName = entryName.Replace('\\', '/');

                        if (targetDir == "." && entryName.Equals(zipFileName, StringComparison.OrdinalIgnoreCase))
                        {
                            // "ucompressarchive test.zip ." 실행 시 오류 방지
                            return;
                        }

                        ZipArchiveEntry entry = destArchive.CreateEntry(entryName);
                        using (Stream src = File.OpenRead(file))
                        using (Stream dest = entry.Open())
                        {
                            src.CopyTo(dest);
                        }
                    });
            }
        }
    }
}

따라서, 위의 프로그램으로 압축한 것을 올리면 아래와 같이 깔끔하게 디렉터리 구분이 반영된 배포 결과물이 나옵니다.

# ls -l
total 40
drwxr-xr-x 5 root root 4096 Nov 25 02:33 antenv
-rwxr-xr-x 1 root root  148 Nov 25 02:33 CHANGELOG.md
-rwxr-xr-x 1 root root 4017 Nov 25 02:33 CONTRIBUTING.md
-rwxr-xr-x 1 root root 1160 Nov 25 02:33 LICENSE.md
-rwxr-xr-x 1 root root 1368 Nov 25 02:33 main.py
-rwxr-xr-x 1 root root 1446 Nov 25 02:33 README.md
-rwxr-xr-x 1 root root   54 Nov 25 02:33 requirements.txt
-rwxr-xr-x 1 root root   43 Nov 25 02:33 startup.sh
drwxr-xr-x 4 root root 4096 Nov 25 02:33 static
drwxr-xr-x 2 root root 4096 Nov 25 02:33 templates

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 5/13/2025]

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

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13945정성태6/7/2025403오류 유형: 960. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/2025420오류 유형: 959. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/2025590개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용
13942정성태6/5/2025815오류 유형: 958. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/2025995닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251380C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20251675오류 유형: 957. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251432개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251352개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251180개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251216파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
13934정성태5/20/20251708스크립트: 77. 파이썬 - 'urllib.request' 모듈의 명시적/암시적 로딩 차이
13933정성태5/19/20251287오류 유형: 956. Visual Studio 2022가 17.12 버전부터 업데이트 되지 않는다면?
13932정성태5/18/20251492스크립트: 76. 파이썬 - Version 문자열 다루기(semver 패키지)
13931정성태5/17/20251787스크립트: 75. 파이썬 - Cython 기본 예제 및 컴파일
13930정성태5/17/20251484개발 환경 구성: 744. 파이썬 - Windows embeddable package 환경에서 외부 패키지 사용하는 방법(ex: UFO² 환경 구성)
13929정성태5/16/20251502오류 유형: 955. 파이썬 - "Windows embeddable package" REPL 환경에서 "NameError: name 'exit' is not defined"
13928정성태5/15/20251547오류 유형: 954. UFO² - "'Invalid URL (POST /v1/chat/completions/chat/completions)'"
13927정성태5/15/20251537오류 유형: 953. OpenAI - The API request of HOST_AGENT failed: OpenAI API request exceeded rate limit: Error code: 429
13926정성태5/14/20251906개발 환경 구성: 743. LLM과 윈도우의 만남 - Desktop AgentOS UFO² 기본 환경 구성
13925정성태5/12/20252005닷넷: 2333. C# - (Console 유형의 프로젝트에서) Clipboard 연동파일 다운로드1
13924정성태5/8/20251749닷넷: 2332. C# - (JetBrains Omea Reader 대상으로) 런타임 시에 메서드 가로채기 [2]파일 다운로드1
13923정성태5/5/20251502스크립트: 74. 파이썬 - C# - Python.NET의 RunSimpleScript, Exec, Eval 차이점파일 다운로드1
13922정성태5/3/20251746스크립트: 73. 파이썬 - Windows embeddable package 버전에서 tkinter 환경 구성
13921정성태5/3/20252250오류 유형: 952. 듀얼 채널 메모리 정렬을 지키지 않은 컴퓨터의 Windows 비정상 종료 현상(Blue Screen) [2]
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...