densocreate/timetracker repository overview

⁠概要

TimeTracker の Docker イメージです。このイメージを使用することで簡単に TimeTracker を起動し、TimeTracker の各機能をお使いいただけます。

⁠前提条件

• Docker がインストールされていること。Docker のインストール方法については公式のドキュメント等を参照してください。
• TimeTracker のライセンスキーを入手していること。用途に合わせて以下の方法でお申込みください。
  • 評価版（3ヶ月無償版）：評価申込フォーム⁠ で「評価版」を選択してください。(3～5営業日以内にサポートからライセンスキーを送付します。)
  • 正式版：ご契約後にライセンスキーをご連絡します。ご契約の流れは 価格ページ⁠を参照してください。

⁠クイックスタート

TimeTracker はプロジェクトや工数などのデータをデータベースに保存します。 TimeTracker の Docker イメージにはデータベースは含まれていないため、SQL Server の Docker イメージとともに使用する必要があります。

以下の手順で TimeTracker のコンテナを実行できます。

1. 任意のディレクトリに以下の内容で compose.yml ファイルを作成します。<タグ名>、<your password> の部分は変更してください。
   • Microsoft SQL Server を使用する場合

   services:
     redis:
       image: redis:latest
       ports:
         - 6379:6379
       volumes:
         - tt-redis-data:/data
     db:
       image: mcr.microsoft.com/mssql/server:2022-latest
       ports:
         - 1433:1433
       environment:
         - ACCEPT_EULA=Y
         - MSSQL_SA_PASSWORD=<your password>
       healthcheck:
         test: ["CMD", "/opt/mssql-tools18/bin/sqlcmd", "-U", "sa", "-P", "<your password>", "-No", "-Q", "select 1"]
         interval: 5s
         timeout: 30s
         retries: 3
       volumes:
         - tt-db-data:/var/opt/mssql
         - tt-sample:/usr/local/timetracker/sample
     web:
       image: densocreate/timetracker:<タグ名>
       ports:
         - 8080:8080
       environment:
         - TT_DB_TYPE=sqlserver
         - TT_DB_SERVER=db
         - TT_DB_PORT=1433
         - TT_DB_USER=sa
         - TT_DB_PASSWORD=t3stP@ssw0rd
         - TT_REDIS_GLOBALCACHE=redis:6379
         - TT_REDIS_HANGFIRE=redis:6379
         - TT_REDIS_BACKGROUNDJOB=redis:6379
       volumes:
         - ./logs:/usr/local/timetracker/Logs
         - tt-sample:/usr/local/timetracker/sample
       depends_on:
         redis:
           condition: service_started
         db:
           condition: service_healthy
   volumes:
     tt-redis-data:
     tt-db-data:
     tt-sample:
   

   Copy
   • PostgreSQL を使用する場合

   services:
     redis:
       image: redis:latest
       ports:
         - 6379:6379
       volumes:
         - tt-redis-data:/data
     db:
       image: postgres:16
       ports:
         - 5432:5432
       environment:
         - POSTGRES_USER=postgres
         - POSTGRES_PASSWORD=<your password>
       healthcheck:
         test: ["CMD", "psql", "-U", "postgres", "-c", "select 1"]
         interval: 5s
         timeout: 30s
         retries: 3
       volumes:
         - tt-db-data:/var/lib/postgresql/data
     web:
       image: densocreate/timetracker:<タグ名>
       ports:
         - 8080:8080
       environment:
         - TT_DB_TYPE=postgresql
         - TT_DB_SERVER=db
         - TT_DB_PORT=5432
         - TT_DB_USER=postgres
         - TT_DB_PASSWORD=t3stP@ssw0rd
         - TT_REDIS_GLOBALCACHE=redis:6379
         - TT_REDIS_HANGFIRE=redis:6379
         - TT_REDIS_BACKGROUNDJOB=redis:6379
       volumes:
         - ./logs:/usr/local/timetracker/Logs
       depends_on:
         redis:
           condition: service_started
         db:
           condition: service_healthy
   volumes:
     tt-redis-data:
     tt-db-data:
   

   Copy
2. compose.yml ファイルを作成したディレクトリに移動してコンテナを起動します。

   sudo docker compose up -d
   

   Copy
3. ブラウザで http://localhost:8080/ にアクセスするとセットアップ画面が表示されるため、ライセンスキーを入力してください。
   詳細な手順は「セットアップガイド⁠」を参照してください。

⁠高度な使い方

データの永続化や HTTPS 化などの本番運用向けの高度な使い方についてはヘルプドキュメントを参照してください。

• TimeTracker ヘルプドキュメント⁠
• TimeTracker セットアップガイド⁠
• データの管理⁠

⁠ライセンス

以下の使用許諾の内容をご確認頂き、同意頂ける場合にご利用ください。

• 使用許諾契約書⁠