OSS歸屬構建器是一個網站,可幫助團隊為軟件產品創建歸因文檔。歸因文檔是幾乎每個列出了使用的軟件組件及其許可的軟件應用程序中的文本文件,網頁或屏幕。它們通常在關於屏幕上,有時被標記為“開源通知”,“信用”或其他類似的行話。
螢幕截圖
docker-compose upadmin測試管理功能。 請參閱文檔:
歸屬構建器最初是亞馬遜內部工具。必須刪除一些部分以使其成為明智的開源項目。因此,有一些疣:
這些都將及時固定,但請注意,有些事情可能有一段時間很奇怪。
如果您準備將歸因構建器集成到您自己的環境中,則需要設置一些內容:
打開config/default.js並戳四周。當您運行docker-compose或以其他方式啟動應用程序時,此配置會啟動。
歸因構建器支持兩種類型的許可定義:
SPDX標識符僅用於預先填寫許可證選擇器,但(當前)沒有文本。更有用的許可類型是“已知”許可證,您(管理員)在其中提供許可的文本以及您要應用的任何標籤。
有關添加您自己的“已知”許可證的信息,請參見“許可證”。在同一目錄中有兩個現有許可證,您可以查看示例。
標籤允許您將任意驗證規則添加到許可證。它們對:
有關標籤可以執行的信息以及如何創建自己的信息,請參閱標籤讀數。
歸屬構建器提供了某種形式的擴展名,可讓您更改客戶端站點的行為和外觀,而無需修補內部內容。這可以更容易組成。
有關詳細信息,請參見“擴展名”。
歸因構建器支持能夠使用項目ACL限制對某些人或團體的訪問。這些也可以用於管理和“驗證”軟件包(在後面的部分中有關該軟件包的詳細信息)。對於大多數環境,默認實現nullauth並不是很有用。在更廣泛的啟動時,您將需要自己寫自己的文章。
有關實現詳細信息,請參見基本驗證界面。
要啟動服務器,您應該在使用npm run build構建後運行build/server/localserver.js 。運行時可能需要設置一些環境變量:
NODE_ENV最有可能將其設置為productionCONFIG_NAME應設置為您上面創建的配置文件的Basename(無擴展)。默認值為“默認值”。服務器僅在HTTP中運行。您可能想在其前面放置薄的HTTPS Web服務器或代理。
有關信息,請參見貢獻。
npm install ,然後npm run dev將使您脫穎而出,以進行本地開發。這將啟動一個用於PostgreSQL的Docker容器,但將使用TSC,WebPack,Node等的本地副本,因此您可以快速迭代。
一旦開始,您可以打開http://0.0.0.0:2425/webpack-dev-server/。這將自動重新加載瀏覽器更改,並且後端還將自動重新啟動服務器端更改。
方便的環境變量:
NODE_ENV :當解開或development ,您將獲得完整的源地圖和調試日誌DEBUG_SQL :設置(到任何東西)時,這將在執行時在終端上顯示SQL查詢npm test將運行單位測試。這些主要是服務器的重點。
npm run test-ui將運行硒測試。如果您想要自定義驅動程序,則可以設置環境變量SELENIUM_DRIVER - 默認情況下,它將嘗試使用Chrome,如果不可用,則會返回到Phantomjs。
在調試UI測試時,更容易將standalone-chrome更改為docker-compose.selenium.yml中的standalone-chrome-debug ,然後通過VNC(端口5900,密碼“秘密”)連接到容器。分別運行容器和測試:
docker-compose -f docker-compose.selenium.yml up --buildtsc && jasmine --stop-on-failure=true 'build/selenium/*.spec.js'測試似乎沒有理由? driver.sleep不起作用?確保您的測試中的茉莉超時時間足夠高。