CubeCobra 下載 - CubeCobra 原始碼下載

立方體眼鏡蛇

其他源碼

Release

下載

立方體眼鏡蛇

用於建置、管理和測試 Magic: the Gathering 立方體的開源 Web 應用程式。

貢獻

如果您有興趣為 Cube Cobra 做出貢獻，請閱讀該專案的貢獻指南。

設定

安裝先決條件

您需要安裝 NodeJS、Redis 和您喜歡的 IDE（我推薦 VSCode）。您可以在這裡找到必要的資源：

NodeJS

節點20

NodeJS：https://nodejs.org/en/download/

雷迪斯

Redis伺服器：

Windows：https://github.com/microsoftarchive/redis
Mac： brew install redis
Linux： apt-get install redis

安裝redis後，啟動伺服器。在 Mac 上，執行此操作的捷徑是brew services start redis 。您可以使用brew services list查看狀態。

本地堆疊

Localstack 提供執行 CubeCobra 所需的 AWS 服務的本機模擬，包括 S3、DynamoDB 和 Cloudwatch。

您可以遵循 localstack 網站的安裝指南。建議的設定包括在 Docker 容器中執行 localstack，這也需要 Docker Desktop。

Windows：從 localstack 下載並安裝二進位文件
Mac： brew install localstack/tap/localstack-cli
Linux：使用 localstack 中的curl指令

安裝 localstack 後，您可以使用 CLI 在背景啟動伺服器： localstack start --detached 。您可以使用localstack status查看狀態。

程式碼編輯器（IDE）

VSCode（強烈推薦，但不是必要）：https://code.visualstudio.com/ VSCode 的 ESLint 擴充：https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint VSCode 的 Prettier 擴充：https ://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode

VSCode（具有 ESLint 和 Prettier 擴充功能）是建議的環境。使用此設定時，請確保您選擇的工作空間是您複製的根資料夾，這將確保 ESLint 外掛程式可以與我們的 linting 規則配合使用。 Prettier 會自動將標準格式套用至您的程式碼。使用這些插件將使遵守 linting 和程式碼格式化規則變得更加容易。

初始設定

對於第一次設置，您需要運行：

yarn install && yarn build
yarn setup:local

這將：

安裝依賴項
建立應用程式程式碼以運行設定腳本
運行安裝腳本以：
- 建立一個 .env 文件，其中已設定用於在本地運行應用程式的值
- 使用 s3 儲存桶設定 localstack
- 設定本機檔案以實現應用程式持久性
- 設定 localstack dynamodb 表（例如使用者、多維資料集、卡片等）
- 從 scryfall 下載批量卡數據，保存到文件並將其加載到 localstack s3

如果您使用的是 Windows，則需要將 bash 設定為腳本 shell：

您需要確保已在某處安裝了bash並執行以下命令[用您的bash路徑取代下面的路徑]。

yarn config set script-shell " C: \ Program Files \ git \ bin \ bash.exe "

運行立方體眼鏡蛇

然後你可以像這樣啟動程式：

yarn start:dev

該腳本將：

確保 localstack 正在運行
確保卡片過濾器的幾乎解析器已編譯
編譯並觀看 scss (bootstrap) 樣式
使用 nodemon 編譯並監視伺服器 javascript
運行並觀察 webpack 開發伺服器

現在您可以打開瀏覽器並透過以下方式連接到應用程式：http://localhost:8080。

（儘管節點在日誌中顯示它正在連接埠 5000 上運行，但您應該使用連接埠 8080 進行連線。）

只要來源檔案發生更改，Nodemon 就會重新啟動應用程式。

在本機存取應用程式後，您將需要使用導覽列上的「Resister」連結建立一個新的使用者帳戶。

環境變數和連接到 AWS

環境變數是從.env檔填充的。沒有簽入.env文件，因此安裝腳本將.env_EXAMPLE複製到.env並使用一些預設值來支援 LocalStack 支援的 CubeCobra。

如果需要，您可以針對真實的 AWS 資源而不是 LocalStack 執行 Cube Cobra 的本機執行個體。使用您的 AWS 帳戶設定 S3、DynamoDB 和 Cloudwatch 後，您可以將憑證插入.env檔案中。

以下是如何填寫環境變數的表格：

|變數名稱 |描述 |必需的？ | | ---------------------- | -------------------------------------------------- -------------------------------------------------- ---- | ---------| ---| | AWS_ACCESS_KEY_ID | AWS_ACCESS_KEY_ID您帳戶的 AWS 存取金鑰。 |是的 | | AWS_ENDPOINT | AWS_ENDPOINT用於 AWS 的基本端點。用於指向 localstack 而不是託管的 AWS。 | | | AWS_LOG_GROUP | AWS_LOG_GROUP | AWS_LOG_GROUP要使用的 AWS CloudWatch 日誌組的名稱。 |是的 | | AWS_LOG_STREAM | AWS_LOG_STREAM | AWS_LOG_STREAM要使用的 AWS CloudWatch 日誌流的名稱。 | | | AWS_區域 |要使用的 AWS 區域（預設值：us-east-2）。 |是的 | | AWS_SECRET_ACCESS_KEY | AWS_SECRET_ACCESS_KEY |您帳號的 AWS 秘密存取金鑰。 |是的 | | CUBECOBRA_版本 | Cube Cobra 的版本。 | | |數據桶 |要使用的 AWS S3 儲存桶的名稱。您需要在您的帳戶中建立此儲存桶。 |是的 | |域名 |伺服器的網域名稱。用於外部重定向，例如電子郵件。 |是的 | | DOWNTIME_ACTIVE | 停機時間站點是否處於停機模式。 | | | DYNAMO_PREFIX | DYNAMO_PREFIX |用於 DynamoDB 表的前綴。您可以將此保留為預設值 |是的 | | EMAIL_CONFIG_PASSWORD |用於傳送電子郵件的電子郵件帳號的密碼。 | | | EMAIL_CONFIG_USERNAME |用於發送電子郵件的電子郵件帳戶的使用者名稱。 | | |環境|運行 Cube Cobra 的環境。是的 | | | NITROPAY_ENABLED | NITROPAY_ENABLED |是否啟用我們的廣告提供者 NitroPay。 | | | NODE_ENV |運行 Cube Cobra 的環境。是的 | | PATREON_CLIENT_ID | | Patreon OAuth 應用程式的用戶端 ID。 | | | PATREON_CLIENT_秘密 | Patreon OAuth 應用程式的用戶端金鑰。 | | | PATREON_HOOK_秘密 | Patreon webhook 的秘密。 | | | PATREON_重定向 | Patreon OAuth 應用程式的重定向 URL。 | | |港口|運行 Cube Cobra 的連接埠。 |是的 | | REDIS_HOST | REDIS_主機Redis 伺服器的 URL。 |是的 | | REDIS_SETUP | REDIS_SETUP |是否設置 Redis 伺服器 - Redis 需要此設置，但 Elasticache 不需要。 | | |秘密 |用於加密的秘密短語。您可以保留預設值。 |是的 | |會話秘密 |用於會話加密的秘密短語。您可以保留預設值。 |是的 | |會議|會話 cookie 的名稱。您可以保留預設值。 |是的 | | TCG_PLAYER_PRIVATE_KEY | TCGPlayer API 的私鑰。 | | | TCG_PLAYER_PUBLIC_KEY | TCG_PLAYER_PUBLIC_KEY | TCGPlayer API 的公鑰。 | | | CACHE_ENABLED | 快取啟用是否啟用快取。 | | |自動縮放群組 |運行此實例的自動伸縮組的名稱，用於分散式快取。 | | |快取_秘密 |分散式快取的秘密。 | |