TaskPipe::Tool::Command_DeployTables - command to deploy taskpipe tables
Deploy the database tables which are needed by taskpipe to operate - ie taskpipe
global tables or
cache tables for an individual project.
If you are installing taskpipe from scratch, then you need to deploy global tables, which have shared usage between taskpipe processes. Ideally you should deploy these tables to a specific designated database, which only contains these global taskpipe tables. (Perhaps call this database
taskpipe_global etc.) It is possible to have taskpipe global tables sit alongside other tables in the same database, but not recommended (use the
table_prefix option to differentiate taskpipe related tables).
Running a taskpipe plan always involves using two databases - the global database (as above) and a database specfic to your project (the project database). Your project database will contain 2 groups of tables, cache and plan tables. The plan tables are tables specific to your project - so taskpipe cannot create these for you (sorry!). So deploying
project tables really means cache tables will be deployed to your designated project database.
TaskPipe uses a global database to manage jobs, threads and other information. You should run
deploy tables once with
--scope=global after running
setup, to deploy global tables.
Make sure you have
Created the database where the tables will be deployed. In MySQL:
CREATE DATABASE taskpipe_global;
Created a user and password for taskpipe to use to access your database, and given correct access permissions for taskpipe to interface with your database.
CREATE USER 'taskpipe_user'@'localhost' IDENTIFIED BY 'somecomplexpassword'; GRANT ALL PRIVILEGES ON taskpipe_global.* TO 'taskpipe_user'@'localhost';
Filled in the information about your database (database name, host, username, password) in the global configuration file (usually
global.yml, found inside
/global/confin your taskpipe directory). If you setup taskpipe in
/taskpipein your home directory, then you can modify this with a text editor. E.g. using
Look for the
TaskPipe::SchemaManager::Settings_Globalsection and change the values to suit your setup:
... TaskPipe::SchemaManager::Settings_Global: host: localhost method: dbi module: TaskPipe::GlobalSchema name: taskpipe password: somecomplexpassword table_prefix: '' type: mysql username: taskpipe_user ...
moduleis the module taskpipe will use as a template for your tables. It is not recommended you change this.
deploy tables will deploy all tables with names that start with whatever you specify in
table_prefix. It is recommended that you don't use the global database for any other purpose (ie you simply set it up and then leave it alone). In this case, the table prefix is not important, and you can leave it as an empty string (as above).
Once you have saved the global config file with the new settings, run <deploy tables>
taskpipe deploy tables --scope=global
You should then generate the schema files taskpipe will use to interface with the new tables
taskpipe generate schema --scope=global
See the help for
generate schema for more information. For more information on
taskpipe help setup
deploy tables needs to be run each time you create a new project. First deploy the files associated with the project
taskpipe deploy files --project=newproject
Next edit the project config that was created. If you used default directory settings, and you installed taskpipe into
~/taskpipe then you should find this file at
~/taskpipe/projects/newproject/conf/project.yml (remembering to change newproject to whatever name you called your project).
Find the section
TaskPipe::SchemaManager::Settings_Project and edit to suit your setup
TaskPipe::SchemaManager::Settings_Project: host: localhost method: dbi module: TaskPipe::Schema name: newproject password: somecomplexpassword table_prefix: tp_ type: mysql username: taskpipe_user
Remember the table prefix will differentiate
cache tables (which
deploy tables creates) from
plan tables (which you will create yourself as part of your project).
Create the database you are going to use for the project. E.g. in MySQL
CREATE DATABASE newproject;
and make sure your taskpipe user has permissions to the new database. E.g. in MySQL
GRANT ALL PRIVILEGES ON newproject.* TO 'taskpipe_user'@'localhost';
taskpipe deploy tables --project=newproject
You should now be ready to start building your project.
project(deploys cache tables only).
The name of the sample to use to deploy tables. This is only relevant when
globalthis will be ignored.
Tom Gracey <firstname.lastname@example.org>
Copyright (c) Tom Gracey 2018
TaskPipe is free software, licensed under
The GNU Public License Version 3