警告
Torchbox.comのこのバージョンは、廃止されました。おそらくhttps://github.com/torchbox/torchbox.comが必要です。
古いReameコンテンツは、参照のために以下に保存されています。
* * * * * * * * * *
これはメインのTorchbox.comのWebサイトです。このサイトのキャリアセクションは、Torchbox/Careersで見つけることができます。
このプロジェクトには、 /docsフォルダーのMarkdownで書かれた技術文書が含まれています。これは、とりわけカバーしています:
実行することでmkdocsを使用して表示できます。
mkdocs serveドキュメントは、http:// localhost:8001/で入手できます。
このリポジトリには、ローカルドッカーコンテナでプロジェクトを実行するためのdocker-compose構成と、これをプロビジョニングおよび管理するためのFabFileが含まれています。
ファブリックスクリプトを使用した開発を支援する他の多くのコマンドがあります。それらすべてを見るには、実行してください:
fab -lローカル環境を実行するには、以下が必要です。指定された最小バージョンは、機能していることが確認されています。すでにインストールされている古いバージョンがある場合は、動作する可能性がありますが、そうすることは保証されていません。
Mac OSでは、古いバージョンのファブリックがインストールされている場合は、古いバージョンをアンインストールしてから、PIP3で新しいバージョンをインストールする必要がある場合があることに注意してください。
pip uninstall fabric
pip3 install fabric pyenv :https://realpython.com/intro-to-pyenv/をセットアップすることで、さまざまなPythonバージョンを管理できます。
さらに、生産 /ステージング環境と対話するためには、次のことが必要です。
Dockerデスクトップを使用している場合は、リソースを確認してください。ファイル共有設定により、クローン化されたディレクトリをWebコンテナに取り付けます(ビルドステップの最後にOCIランタイム障害のmountingを避けます)。
ローカルビルドを開始することは、実行することで実行できます。
git clone [email protected]:torchbox/wagtail-torchbox.git
cd wagtail-torchbox
fab build
fab migrate
fab startこれにより、バックグラウンドでコンテナが開始されますが、Djangoは開始されません。これを行うには、 fab shを使用してWebコンテナに接続し、 honcho start 。
次に、実行中のコンテナに再び接続します( fab sh )と:
dj createcachetable
dj createsuperuserこのサイトは、http://127.0.0.1:8000/のホストマシンで入手できる必要があります。
フロントエンドまたはバックエンドのツールのみを実行する場合のみ、 honcho実行するコマンドはdocker/Procfileにあります。
最初にコンテナを起動すると、静的ファイルが存在しないか、古くなっていない場合があります。これを解決するには、 npm run buildを実行するだけです。
一般的なコマンドは次のとおりです。
# Install front-end dependencies.
npm install
# Start the Webpack build in watch mode, without live-reload.
npm run start
# Start the Webpack server build on port 3000 only with live-reload.
npm run build
# Do a one-off Webpack production build.
npm run build:prodフロントエンドツールを実行するには、次の2つの方法があります。
FRONTEND=localでプロジェクトルート( .env.exampleを参照)に.envファイルを作成します。 fab start frontendコンテナを起動しなくなります。現在、 fab startを実行すると、DockerはFrontend Devサーバーに必要なポートにバインドしようとしません。つまり、ローカルで実行できます。すべてのツールはまだコンテナで利用可能です。 Pythonパッケージは、Webコンテナにpoetryを使用してインストールできます。
fab sh
poetry add wagtail-guide
インストールされた依存関係をリセットするには、 poetry.lockファイルにどのように依存しているかに戻ります。
fab sh
poetry install --no-root
展開するには、機能ブランチをmasterまたはstagingブランチにマージします。 CIパイプラインが通過すると、それぞれのHerokuサイトに自動的に展開されます。
これは、Heroku Githubの統合によって行われます。