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 zipFilePath;
if (args.Length == 1)
{
targetDir = args[0];
zipFilePath = Path.Combine(Environment.CurrentDirectory, Path.GetFileName(targetDir) + ".zip");
}
else
{
zipFilePath = args[0];
targetDir = args[1];
}
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('\\', '/'); // 디렉터리 구분자를 *NIX 스타일로 변경
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
(
첨부 파일은 이 글의 예제 코드를 포함합니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]