管理ツール
目次
Trac は強力なコマンドラインの管理ツールとともに配布されています。このツールで Trac を管理/設定し、インストールを用途に合わせてカスタマイズすることができます。
これらの操作のうち主要なものについては、 管理 (英語版では Admin) Web インタフェースでも行うことができます。 WebAdmin の最新アップデートが Trac に統合されています。 (0.11 以降)
使い方
trac-admin コマンドを help オプションつきで起動することによって、利用できるコマンド/サブコマンドの分かりやすいオプションリストを見ることができます:
trac-admin help
help, about, version のサブコマンドを実行しないならば、第1引数に管理したい TracEnvironment へのパスを指定する必要があります。例えば:
trac-admin /path/to/projenv wiki list
対話モード
trac-admin は TracEnvironment のパスだけを引数に指定して起動した場合、対話モードになります。 プロンプトから入力したコマンドは指定した TracEnvironment に対して実行します。 コマンドを Tab キーで補完する機能と、最後に実行したコマンドを繰り返す機能が提供されます (非 Windows 環境の場合、 Python が readline モジュールを使用できる必要があります) 。
一度対話モードで起動すると、特定のコマンドのヘルプやコマンドのサブセットを見ることができます:
例えば、 resync コマンドの説明を得るためには以下のように実行します:
> help resync
Wiki に関するすべてのコマンドのヘルプを得るためには、以下のように実行します:
> help wiki
完全なコマンドリファレンス
help -- Show documentation initenv -- Create and initialize a new environment interactively initenv <projectname> <db> <repostype> <repospath> -- Create and initialize a new environment from arguments hotcopy <backupdir> -- Make a hot backup copy of an environment resync -- Re-synchronize trac with the repository resync <rev> -- Re-synchronize only the given <rev> upgrade -- Upgrade database to current version deploy <directory> -- Extract static resources from Trac and all plugins. permission list [user] -- List permission rules permission add <user> <action> [action] [...] -- Add a new permission rule permission remove <user> <action> [action] [...] -- Remove permission rule wiki list -- List wiki pages wiki remove <page> -- Remove wiki page wiki export <page> [file] -- Export wiki page to file or stdout wiki import <page> [file] -- Import wiki page from file or stdin wiki dump <directory> -- Export all wiki pages to files named by title wiki load <directory> -- Import all wiki pages from directory wiki upgrade -- Upgrade default wiki pages to current version ticket remove <number> -- Remove ticket ticket_type list -- Show possible ticket types ticket_type add <value> -- Add a ticket type ticket_type change <value> <newvalue> -- Change a ticket type ticket_type remove <value> -- Remove a ticket type ticket_type order <value> up|down -- Move a ticket type up or down in the list priority list -- Show possible ticket priorities priority add <value> -- Add a priority value option priority change <value> <newvalue> -- Change a priority value priority remove <value> -- Remove priority value priority order <value> up|down -- Move a priority value up or down in the list severity list -- Show possible ticket severities severity add <value> -- Add a severity value option severity change <value> <newvalue> -- Change a severity value severity remove <value> -- Remove severity value severity order <value> up|down -- Move a severity value up or down in the list component list -- Show available components component add <name> <owner> -- Add a new component component rename <name> <newname> -- Rename a component component remove <name> -- Remove/uninstall component component chown <name> <owner> -- Change component ownership version list -- Show versions version add <name> [time] -- Add version version rename <name> <newname> -- Rename version version time <name> <time> -- Set version date (Format: "YYYY-MM-DD", "now" or "") version remove <name> -- Remove version milestone list -- Show milestones milestone add <name> [due] -- Add milestone milestone rename <name> <newname> -- Rename milestone milestone due <name> <due> -- Set milestone due date (Format: "YYYY-MM-DD", "now" or "") milestone completed <name> <completed> -- Set milestone completed date (Format: "YYYY-MM-DD", "now" or "") milestone remove <name> -- Remove milestone resolution list -- Show possible ticket resolutions resolution add <value> -- Add a resolution value option resolution change <value> <newvalue> -- Change a resolution value resolution remove <value> -- Remove resolution value resolution order <value> up|down -- Move a resolution value up or down in the list
Notes
initenv では --inherit オプションを使用できるようになりました。これは Environment 作成時に [inherit] file オプションを指定できます。このオプションはグローバル設定ファイルの中では 設定しない でください。新たに作成された Environment の conf/trac.ini ファイルに書き出されてしまいます。 詳細は TracIni#GlobalConfiguration を参照してください。
Trac 0.11 では initenv の最後の引数であるt <templatepath> が廃止されました。この引数は以前のバージョンでは templates ディレクトリの場所を指定していました。コマンド 'trac-admin /path/to/trac/ initenv <projectname> <db> <repostype> <repospath>' を使用した時に 'Wrong number of arguments to initenv: 4' というエラーが発生した場合、使用している trac-admin のスクリプトが 古い バージョンの Trac のものである可能性があります。
See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni, TracMigrate