Microsoft MVP성태의 닷넷 이야기
개발 환경 구성: 371. Azure Web App 확장 예제 - Simple WebSite Extension [링크 복사], [링크+제목 복사]
조회: 2692
글쓴 사람
홈페이지
첨부 파일
 

Azure Web App 확장 예제 - Simple WebSite Extension

Azure의 Web App(App Service)에는 '확장'이라는 것을 설치할 수 있습니다. 일례로 Let's encrypt 무료 인증서를 쉽게 설치/갱신해주는 확장도,

Azure Let's Encrypt 
; https://www.siteextensions.net/packages/letsencrypt/

Azure VM/App Services(Web Apps)에 Let's Encrypt 무료 인증서 적용 방법
; https://www.sysnet.pe.kr/2/0/11502

그 형식으로 만들어진 것입니다. 그럼, 이런 걸 우리도 만들 수 있지 않을까요? ^^ 이에 대해 다음의 글에서 자세하게 설명하고 있습니다.

Azure Web Sites Extensions
; https://azure.microsoft.com/en-us/blog/azure-web-sites-extensions/

그리고 그 시작으로 github에 확장 예제가 공개되어 있습니다.

Azure - Site Extensions
; https://github.com/projectkudu/FileCounterSiteExtension

빌드 및 배포 방법은 역시 README.md 파일에 다음과 같이 잘 소개하고 있습니다.

## To build it and directly upload it to a site

  1. Clone this repository.
  2. Run `build.cmd`.  This will zip the extension files in `artifacts\Release\zip` folder.
  3. Copy `Deployment Trigger Url` from Azure portal for your website (in CONFIGURE TAB when you have git enabled).
  4. Upload extension to your website by `artifacts\Release\zip\DeployExtension.cmd "<deploy-trigger-url>"`.
  5. Restart your site.  You may use Portal to do so.
  6. You can now access this simple extension via `<scm-url>/filecounter`.

이를 위해 nuget.exe를 다운로드해,

NuGet - Installing
; https://docs.nuget.org/consume/command-line-reference
; https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

PATH 환경 변수의 연결된 경로에 복사하고 build.cmd 파일을 실행합니다.

E:\sample\FileCounterSite> build.cmd
Microsoft (R) Build Engine version 4.7.2556.0
[Microsoft .NET Framework, version 4.0.30319.42000]
Copyright (C) Microsoft Corporation. All rights reserved.

E:\sample\FileCounterSite\artifacts\Release\zip\SimpleWebSiteExtension.zip created.
Attempting to build package from 'FileCounter.nuspec'.
Successfully created package 'artifacts\Release\filecounter.1.0.21.nupkg'.

그다음 Azure Portal에서 해당 App Services의 "속성"으로 가면 다음과 같은 형식의 "Deployment Trigger Url(배포 트리거 URL)"을 구할 수 있습니다.

appservice_ext_deploy_url_1.png

https://...[생략]...xr6@[yoursitename].scm.azurewebsites.net/deploy

따라서, 저 경로를 DeployExtension.cmd의 인자로 넘겨 주면 내부에서 curl.exe를 이용해 서버로 전송합니다.

E:\sample\FileCounterSite> artifacts\Release\zip\DeployExtension.cmd https://...[생략]...xr6@[yoursitename].scm.azurewebsites.net/deploy

그런데 DeployExtension.cmd 안의 내용을 보면 curl.exe가 "%ProgramFiles(x86)%\git\bin" 폴더에 있다고 가정하기 때문에 curl.exe를 그 폴더에 넣어 두어야 합니다. 또는, 그냥 다음과 같이 curl.exe를 직접 실행해도 무방합니다.

[형식]
curl.exe -k -v -T "[업로드할 zip 파일 경로]" "[마지막 deploy 경로를 자른 Deployment Trigger Url]/zip"

curl로 실행할 때 주의할 것은 "Deployment Trigger Url"로 구한 "https://...[생략]...xr6@[yoursitename].scm.azurewebsites.net/deploy" 경로에서 마지막 "/deploy"를 "/zip"으로 교체해야 한다는 것입니다. 따라서 다음과 같이 실행하면 됩니다.

E:\sample\FileCounterSite> curl.exe -k -v -T "E:\sample\FileCounterSite\artifacts\Release\zip\SimpleWebSiteExtension.zip" "https://...[생략]...@[yoursitename].scm.azurewebsites.net/zip"

*   Trying 52.231.32.120...
* Connected to [yoursitename].scm.azurewebsites.net (52.231.32.120) port 443 (#0)
* schannel: SSL/TLS connection with [yoursitename].scm.azurewebsites.net port 443 (step 1/3)
...[생략]...
* schannel: decrypted data returned 409
* schannel: decrypted data buffer: offset 0 length 16384
< HTTP/1.1 200 OK
< Cache-Control: no-cache
< Pragma: no-cache
< Expires: -1
< Server: Microsoft-IIS/10.0
< x-ms-request-id: 834c7086-4afc-4c8a-a252-36294aa19b99
< X-AspNet-Version: 4.0.30319
< X-Powered-By: ASP.NET
< Set-Cookie: ARRAffinity=661589...[생략]...f0bb;Path=/;HttpOnly;Domain=[yoursitename].scm.azurewebsites.net
< Date: Wed, 18 Apr 2018 06:42:39 GMT
< Content-Length: 0
<
* Connection #0 to host [yoursitename].scm.azurewebsites.net left intact

위와 같이 배포 후 Azure Portal을 통해 해당 App Service를 재시작한 후 다음의 경로로 방문하면,

https://[yoursitename].scm.azurewebsites.net/filecounter

여러분들의 Web App 사이트에 몇 개의 파일이 있는지 보여주는 페이지가 뜨게 됩니다. 참고로, App Service를 재시작하지 않으면 다음과 같은 오류 화면만 보게 됩니다.

"No route registered for '/filecounter'"




curl.exe로 "Deployment Trigger Url(배포 트리거 URL)"에 배포하면 다음의 경로에 확장 파일들이 풀립니다.

%HOME%\SiteExtensions\filecounter
                            \applicationHost.xdt
                            \default.aspx

(%HOME% == d:\home)

2개의 배포 파일 내용은 다음과 같습니다.

[applicationHost.xdt 파일]

<?xml version="1.0"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <system.applicationHost>
    <sites>
      <site name="%XDT_SCMSITENAME%" xdt:Locator="Match(name)">
        <application path="/filecounter" xdt:Locator="Match(path)" xdt:Transform="Remove" />
        <application path="/filecounter" applicationPool="%XDT_APPPOOLNAME%" xdt:Transform="Insert">
          <virtualDirectory path="/" physicalPath="%XDT_EXTENSIONPATH%" />
        </application>
      </site>
    </sites>
  </system.applicationHost>
</configuration>

[default.aspx 파일]

<%@ language="C#" Debug="true" %>
<%@ Import Namespace="System.IO" %>

<%
    // Find the site's web root
    string folder = Environment.ExpandEnvironmentVariables(@"%HOME%\site\wwwroot");
    
    int fileCount = Directory.GetFiles(folder, "*.*", SearchOption.AllDirectories).Length;
%>

<h1>World's most amazing file counter</h1>
<h2>Your site has <%= fileCount %> files!</h2>

대충 감이 오시죠? ^^ 그러니까, Azure Web App 확장도 역시 하나의 웹 사이트일 뿐입니다. 참고로 FileCounter 확장에 대한 좀 더 자세한 설명은 다음의 글에서 읽어볼 수 있습니다.

Writing a Site Extension for Azure Websites
; https://azure.microsoft.com/en-us/blog/writing-a-site-extension-for-azure-websites/




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

[연관 글]





[최초 등록일: ]
[최종 수정일: 4/19/2018 ]

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

비밀번호

댓글 쓴 사람
 




... [31]  32  33  34  35  36  37  38  39  40  41  42  43  44  45  ...
NoWriterDateCnt.TitleFile(s)
11536정성태6/8/20183662.NET Framework: 760. Microsoft Build 2018 - The future of C# 동영상 내용 정리 [1]파일 다운로드1
11535정성태6/7/20183574.NET Framework: 759. C# - System.Span<T> 성능 [1]
11534정성태10/7/20195034.NET Framework: 758. C# 7.2 - Span<T> [3]
11533정성태6/8/20187234.NET Framework: 757. 포인터 형 매개 변수를 갖는 C++ DLL의 함수를 C#에서 호출하는 방법파일 다운로드1
11532정성태6/5/20183530.NET Framework: 756. JSON의 escape sequence 문자 처리 방식
11531정성태6/5/20186477오류 유형: 468. JSON.parse가 허용하지 않는 문자 [9]
11530정성태6/10/20184369.NET Framework: 755. C# 7.2 - 스택에만 생성할 수 있는 값 타입 지원 - "ref struct" [2]파일 다운로드1
11529정성태5/23/20183324.NET Framework: 754. 닷넷의 관리 포인터(Managed Pointer)와 System.TypedReference [5]파일 다운로드1
11528정성태6/10/20183295.NET Framework: 753. C# 7.2 - 3항 연산자에 ref 지원(conditional ref operator) [1]
11527정성태5/17/20183011오류 유형: 467. RDP 로그인 에러 - This could be due to CredSSP encryption oracle remediation.
11526정성태6/10/20182710.NET Framework: 752. C# 7.2 - 메서드의 반환값 및 로컬 변수에 ref readonly 기능 추가파일 다운로드1
11525정성태6/10/20182967.NET Framework: 751. C# 7.2 - 메서드의 매개 변수에 in 변경자 추가파일 다운로드1
11524정성태6/10/20183957.NET Framework: 750. C# 7.2 - readonly 구조체 [3]파일 다운로드1
11523정성태5/15/20183312.NET Framework: 749. C# - 값 형식의 readonly 인스턴스에 대한 메서드 호출 시 defensive copy 발생 [1]파일 다운로드1
11522정성태5/15/20182130개발 환경 구성: 378. Azure - VM 진단 설정 화면의 "This subscription is not registered with the Microsoft.Insights resource provider."
11521정성태5/15/20182146개발 환경 구성: 377. Azure - 원하는 성능 데이터로 모니터링 대시보드 구성
11520정성태5/12/20182786.NET Framework: 748. C# 7.1 - 참조 어셈블리(Ref Assemblies)
11519정성태3/13/20193021개발 환경 구성: 376. ASP.NET Web Application 프로젝트의 FileSystem 배포(Publish) 시 Before/After Task 설정 방법 [1]
11518정성태5/11/20182684.NET Framework: 747. C# 7.0에서도 부분적으로 가능해진 "타입 추론을 통한 튜플의 변수명 자동 지정"
11517정성태5/10/20183042.NET Framework: 746. Azure runbook 예제 - 6시간 동안 수행 중인 VM을 중지 [1]파일 다운로드1
11516정성태5/9/20182347.NET Framework: 745. Azure runbook을 PowerShell 또는 C# 코드로 실행하는 방법파일 다운로드1
11515정성태6/8/20182727.NET Framework: 744. C# 6 - Expression bodied function
11514정성태5/3/20184110오류 유형: 466. Bitvise - Error in component session/transport/kexHandler [2]
11513정성태5/10/20185221.NET Framework: 743. C# 언어의 공변성과 반공변성 [5]파일 다운로드1
11512정성태5/3/20182404개발 환경 구성: 375. Azure runbook 실행 시 "Errors", "All Logs"에 오류 메시지가 출력되는 경우
11511정성태5/2/20182750개발 환경 구성: 374. Azure - Runbook 기능 소개
... [31]  32  33  34  35  36  37  38  39  40  41  42  43  44  45  ...