如何在 IIS 上搭建 mercurial server

時間 2019-11-10

標籤如何 iis 搭建 mercurial server 欄目 Python 简体版

原文原文鏈接

mercurial serverhtml

對於代碼管理工具，更多的人可能更熟悉 Git 一些(Git 太火了)。其實另一款分佈式代碼管理工具也被普遍的使用，它就是 mercurial。多人協做時，最好可以經過建立一個 mercurial server 對用戶進行權限認證，同時也會方便持續集成。python

關於建立 mercurial server 的步驟，mercurial 官方的 wiki 有說明，網上也有不少朋友分享了本身的建立過程。但筆者在建立的過程當中仍是頗費了一番周折才最終成功，因此也在此分享一下本身的經驗，但願對朋友們有所幫助。web

文章來源：葡萄城產品技術社區api

1、環境及軟件安裝瀏覽器

筆者使用的操做系統爲 Server2012R2 x64 Standard 中文版。服務器

首先，在安裝其餘工具前，須要先安裝 IIS。安裝 IIS 時須要注意，必定要把 CGI 和 ISAPI 這兩個選項都勾選上。架構

而後，安裝 Python，使用默認設置安裝 python 2.7.x。app

最後，安裝 mercurial server，請從這裏在這裏下載 mercurial server 的安裝包並安裝，安裝完成後檢查 C:\Python27\Lib\site-packages\mercurial 目錄是否被正確安裝！分佈式

注意，python 和 sercurial server 必須保持相同的架構，不要一個安裝 x86 另外一個安裝 x64。工具

2、設置 IIS 服務器支持 python 模塊

在 IIS 管理器中選擇 IIS server，雙擊」ISAPI 和 CGI 限制」，添加一項新的擴展：

喜歡使用命令行的同窗也能夠經過一行命令直接搞定：

C:\Windows\system32\inetsrv\appcmd set config /section:isapiCgiRestriction /+"[path='C:\Python27\python.exe -u %22%s%22',description='Python',allowed='True']"

3、建立網站

在 IIS 中建立一個新的網站，端口綁定81(80端口已被默認網站佔用)。在網站的根目錄中添加 web.config 文件，web.config 文件的內容爲：

[html] view plain copy

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="Python" path="*.cgi" verb="*" modules="CgiModule" scriptProcessor="C:\Python27\python.exe -u &quot;%s&quot;" resourceType="Unspecified" requireAccess="Script" />
    </handlers>
  </system.webServer>
</configuration>

須要注意文件中 python.exe 的路徑，請根據本身機器上的安裝目錄進行配置。

網站的基本設置已經完成，下面寫個簡單的測試文件檢查一下網站可否正常工做。

在網站的根目錄下建立 test.cgi 文件，文件內容以下：

print 'Status: 200 OK'
print 'Content-Type: text/html'
print
print '<html><body><h1>Hello world!</h1></body></html>'

在瀏覽器中訪問 http://localhost:81/test.cgi，若是看不到」Hello world!」，請檢查前面的步驟是否執行正確。

4、配置 mercurial server

1. 在網站的根目錄下添加 hgweb.config 文件，內容以下：

[collections]
C:\repos = C:\repos

[web]
push_ssl = false
allow_push = *

2. 在網站的根目錄下添加 hgweb.cgi 文件，內容以下：

#!/usr/bin/env python
# Path to repo or hgweb config to serve (see 'hg help hgweb')
config = "xxxxx\hgweb.config"

from mercurial import demandimport; demandimport.enable()
from mercurial.hgweb import hgweb, wsgicgi
application = hgweb(config)
wsgicgi.launch(application)

注意，請按實際狀況配置 config 的路徑。

這就 OK 了，讓咱們在 c:\repos 目錄下初始化一個庫而後訪問 http://localhost:81/hgweb.cgi 看看：

5、配置 URL 重定向

每次都要在 URL 中輸入 /hgweb.cgi，一來不方便，二來總感受怪怪的。能不能輸入 http://localhost:81 就能夠正常訪問呢？固然能夠，只需添加一個重定向的配置就能夠了。

首先，須要下載並安裝IIS的插件：http://www.iis.net/downloads/microsoft/url-rewrite

而後，在 web.config 文件中添加 rewrite 元素，新的 web.config 文件內容爲：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="Python" path="*.cgi" verb="*" modules="CgiModule" scriptProcessor="C:\Python27\python.exe -u &quot;%s&quot;" resourceType="Unspecified" requireAccess="Script" />
    </handlers>
    <rewrite>
      <rules>
        <rule name="rewrite to hgwebdir" patternSyntax="Wildcard">
          <match url="*" />
          <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
          </conditions>
          <action type="Rewrite" url="hgweb.cgi/{R:1}" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

好了，如今訪問下 http://localhost:81 試試，和訪問 http://localhost:81/hgweb.cgi 是同樣的。

6、設置匿名訪問權限

默認狀況下咱們已經可使用匿名權限從服務器克隆庫並進行操做了，可是當你執行 hg push 命令時會收到一個 HTTP Error 502: Bad Gateway 的錯誤。出現這個錯誤，是由於匿名用戶沒有修改服務器上文件的權限，因此咱們須要給匿名身份驗證設置一個有修改文件權限的用戶。

如今就能夠正常執行 push 操做了。

總結，相比其餘工具的一鍵式安裝與配置，mercurial server 的安裝和配置稍顯複雜。咱們這裏只是配置了最簡單的匿名訪問，並不支持 ssl，不過這在局域網中基本也夠用了。