「アマゾンの最強の働き方」を読んだ

書店で見かけ気になったので購入して読んだ。数々のイノベーションを起こしてきたアマゾンではどのような働き方を実践しているのか、自分の職場や働き方をアップデートするヒントを得たい、というのが本書に向き合うモチベーションだ。

アマゾンといえば、「地球上で最もお客様を大切にする企業になる」という企業理念で知られている。多くの企業がマインド・アイデンディティである『企業理念』なるものを掲げているが、なかなか組織の活動や意思決定プロセスの細部まで、組織メンバーの大勢が徹底して実践できている企業は多くはないのではなかろうか。本書を読んで強く印象に残ったのは、理念を具体化した行動規範である「リーダーシップ・プリンシパル」があらゆる仕事とプロセスで実践されている、ということだ。バリューとも言えるだろうか。これは、一朝一夕で成されるものでなく、長い年月をかけて築き上げられるものである。こうして積みあげられた組織カルチャーが模倣困難性を高め、持続的な優位性の獲得につながっているのだと感じる。もちろん、AWSのような巨大なクラウドコンピューティングサービスを実現する技術もとんでもなくすごい。

本書では、現在アマゾンで展開されている、または、立ち上がったものの軌道にのることができなかった事業やサービスについて、実際に立ち上げに関わった著者の視点で当時の状況が説明されている。意思決定のプロセス、失敗に学ぶ姿勢など、まさにリーダーシップ・プリンシパルが実践されている様を感じとることができる。徹底的なこだわり、顧客志向の考え方など、学ベることが多い。

本書の中で、私が仕事の中ですぐに実践していきたいコミュニケーション手法の１つにナラティブ形式による資料というものがあった。１つは、有名な６ページ資料、もう１つは顧客ニーズを起点として新商品開発を行うワーキング・バックワーズである。いずれの手法も、練りに練られた思考を凝集し言語化したアウトプットの塊が成果物である。パワーポイントのような資料は一本道でストーリーを語るには適しているかもしれないが、深い思考を伴う検討が必要なプロセスにおいてはナラティブ形式が適しているというものらしい。このナラティブ形式のアイデア元は、イエール大学エドワード・タフテ教授の論文と記されている。私も企画でアイデア出しに関わることがある。パワーポイントのようなストーリーを語る形式とナラティブ形式を状況に合わせて使い分けていきたい。

Node.jsでumzug+SequelizeによるDBマイグレーション

コメントを残す

今回は、Node.jsでデータベースマイグレーションツールであるumzugについて整理したいと思います。umzugを使うと、アプリケーション内やコマンドラインからDBマイグレーションを実行するプログラムを作成することができます。

Sequelizeのmigration

Node.jsのORMとして有名なOSSの１つとしてSequelizeがあります。そして、sequelizeにはsequelize-cliというコマンドラインインターフェースがあり、初期データを投入するためのseedや、データベースのスキーマ移行をするためのmigrationがあります。ただ、sequelize-cliが生成してくれるテンプレートはJavaScriptであり、私がGitHubを眺めていた時点では（本記事作成時点）TypeScriptへの対応はまだされていないようでした。

例えば、以下のようになコマンドでUser modelを生成してみます。

$ ./node_modules/.bin/sequelize-cli model:create --name User --attributes name:string
Sequelize CLI [Node: 16.13.2, CLI: 6.4.1, ORM: 6.17.0]
New model was created at /Users/guest/workspace/umzug/migration/models/user.js .
New migration was created at /Users/guest/workspace/umzug/migration/migrations/20220227081854-create-user.js

$ ./node_modules/.bin/sequelize-cli model:create --name User --attributes name:string

Sequelize CLI [Node: 16.13.2, CLI: 6.4.1, ORM: 6.17.0]

New model was created at /Users/guest/workspace/umzug/migration/models/user.js .

New migration was created at /Users/guest/workspace/umzug/migration/migrations/20220227081854-create-user.js

生成されたUser modelの中身は以下のようになっています。

'use strict';
const {
Model
} = require('sequelize');
module.exports = (sequelize, DataTypes) => {
class User extends Model {
/**
* Helper method for defining associations.
* This method is not a part of Sequelize lifecycle.
* The `models/index` file will call this method automatically.
*/
static associate(models) {
// define association here
}
}
User.init({
name: DataTypes.STRING
}, {
sequelize,
modelName: 'User',
});
return User;
};

'use strict';

const {

Model

} = require('sequelize');

module.exports = (sequelize, DataTypes) => {

class User extends Model {

/**

* Helper method for defining associations.

* This method is not a part of Sequelize lifecycle.

* The `models/index` file will call this method automatically.

static associate(models) {

// define association here

}

User.init({

}, {

sequelize,

modelName: 'User',

});

return User;

};

sequelize-cliをtypescript対応にしているnpmパッケージもありましたが、あまり更新が活発ではないようでした。

umzug

umzugは、sequelize-cliの内部で使われているマイグレーションツールフレームワークです。sequelize-cliのソースを見ると、マイグレーション実行部分はumzugが担っていることが分かります。sequelize-cliは、umzugを使いやすくしたツールと言えます。umzugはTypeScriptに対応しています。

テスト環境の準備

手元の環境は以下の通りです。

OS	macOS Catalina 10.15.7
Node.js	v16.13.2
sequelize	6.17.0
sequelize-cli	6.4.1
umzug	3.0.0
TypeScript	4.5.5
ts-node	10.5.0
sqlite3	5.0.2

テスト環境の初期化

テスト環境の初期化を行ないます。今回は、ts-nodeを使ってTypeScriptコードをNode.jsから実行できるようにします。

npm install -D typescript
npm install -D @types/node
npx tsc --init
npm install -D ts-node

npm install -D typescript

npm install -D @types/node

npx tsc --init

npm install -D ts-node

こんなコードを書いて、実行できることを確認しておきます。

import * as fs from "fs";
import * as path from "path";
import { Sequelize } from "sequelize";
import { Umzug, SequelizeStorage } from "umzug";
console.log("hello umzug");

import * as fs from "fs";

import * as path from "path";

import { Sequelize } from "sequelize";

import { Umzug, SequelizeStorage } from "umzug";

console.log("hello umzug");

ついでにpackage.jsonに書いて、npm runできるようにしておきます。

{
"name": "migration",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"migrate": "ts-node migrate.ts"
},
"author": "",
"license": "ISC",
"dependencies": {
"sequelize": "^6.17.0",
"sequelize-cli": "^6.4.1",
"sqlite3": "^5.0.2",
"umzug": "^3.0.0"
},
"devDependencies": {
"@types/node": "^17.0.21",
"ts-node": "^10.5.0",
"typescript": "^4.5.5"
}
}

{

"name": "migration",

"version": "1.0.0",

"description": "",

"main": "index.js",

"scripts": {

"migrate": "ts-node migrate.ts"

"author": "",

"license": "ISC",

"dependencies": {

"sequelize": "^6.17.0",

"sequelize-cli": "^6.4.1",

"sqlite3": "^5.0.2",

"umzug": "^3.0.0"

"devDependencies": {

"@types/node": "^17.0.21",

"ts-node": "^10.5.0",

"typescript": "^4.5.5"

}

npm runコマンドを実行してみます。

$ npm run migrate
> migration@1.0.0 migrate
> ts-node migrate.ts
hello umzug

$ npm run migrate

> migration@1.0.0 migrate

> ts-node migrate.ts

hello umzug

よさそうです。

最小サンプル

雰囲気を掴むため、小さなサンプルを見てみたいと思います。以下は、GitHubに掲載されているサンプルと同じです。

import { Sequelize } from "sequelize";
import { Umzug, SequelizeStorage } from "umzug";
const sequelize = new Sequelize({ dialect: "sqlite", storage: "./db.sqlite" });
const umzug = new Umzug({
migrations: { glob: "migrations/*.{js,ts}" },
context: sequelize,
storage: new SequelizeStorage({ sequelize }),
logger: console,
});
(async () => {
// Checks migrations and run them if they are not already applied. To keep
// track of the executed migrations, a table (and sequelize model) called SequelizeMeta
// will be automatically created (if it doesn't exist already) and parsed.
await umzug.up();
})();

import { Sequelize } from "sequelize";

import { Umzug, SequelizeStorage } from "umzug";

const sequelize = new Sequelize({ dialect: "sqlite", storage: "./db.sqlite" });

const umzug = new Umzug({

migrations: { glob: "migrations/*.{js,ts}" },

context: sequelize,

storage: new SequelizeStorage({ sequelize }),

logger: console,

});

(async () => {

// Checks migrations and run them if they are not already applied. To keep

// track of the executed migrations, a table (and sequelize model) called SequelizeMeta

// will be automatically created (if it doesn't exist already) and parsed.

await umzug.up();

})();

Sequelizeインスタンスを作成
UmzugのsequelizeインスタンスをDBドライバとして渡す
upで上位レベルに向かってマイグレーションを実行

migrationsディレクトリが空でも実行可能です。実行すると以下のような結果になります。

$ npm run migrate
> migration@1.0.0 migrate
> ts-node migrate.ts
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

$ npm run migrate

> migration@1.0.0 migrate

> ts-node migrate.ts

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

SequelizeMetaはマイグレーションのメタデータを管理するテーブルです。

TypeScriptファイルの雛形からマイグレーションファイルを生成する

続いて、TypeScriptでマイグレーションファイルを生成するようにしてみます。

migrate.tsファイルを以下のように書き換えます。

import * as fs from "fs";
import * as path from "path";
import { Sequelize } from "sequelize";
import { Umzug, SequelizeStorage } from "umzug";
const sequelize = new Sequelize({ dialect: "sqlite", storage: "./db.sqlite" });
const umzug = new Umzug({
migrations: { glob: "migrations/*.{js,ts}" },
context: sequelize,
storage: new SequelizeStorage({ sequelize }),
logger: console,
create: {
folder: path.join(__dirname, "migrations"),
template: (filepath) => [
[
filepath,
fs
.readFileSync(path.join(__dirname, "templates/sampleMigration.ts"))
.toString(),
],
],
},
});
(async () => {
await umzug.runAsCLI();
})();

import * as fs from "fs";

import * as path from "path";

import { Sequelize } from "sequelize";

import { Umzug, SequelizeStorage } from "umzug";

const sequelize = new Sequelize({ dialect: "sqlite", storage: "./db.sqlite" });

const umzug = new Umzug({

migrations: { glob: "migrations/*.{js,ts}" },

context: sequelize,

storage: new SequelizeStorage({ sequelize }),

logger: console,

create: {

folder: path.join(__dirname, "migrations"),

[

filepath,

.readFileSync(path.join(__dirname, "templates/sampleMigration.ts"))

.toString(),

});

(async () => {

await umzug.runAsCLI();

})();

違いは、以下の２点です。

Umzugの引数にcreateプロパティを追加
umzug.up()をrunAsCLI()に変更

runAsCLI()は、umzug ver3で使用可能なcli実行インターフェースです。こうしておくことで、npm run migrate create -- --name setup.tsのように引数を渡してumzugに渡して実行することができます。

テンプレートファイルは以下のようにしてみます。

import { DataTypes, Sequelize } from "sequelize";
import { MigrationFn } from "umzug";
export const up: MigrationFn<Sequelize> = async ({ context: sequelize }) => {
const t = await sequelize.transaction();
// eslint-disable-next-line @typescript-eslint/no-unused-vars
const queryInterface = sequelize.getQueryInterface();
try {
await sequelize.query("raise fail('up migration not implemented')");
await t.commit();
} catch (error) {
await t.rollback();
}
};
export const down: MigrationFn<Sequelize> = async ({ context: sequelize }) => {
const t = await sequelize.transaction();
// eslint-disable-next-line @typescript-eslint/no-unused-vars
const queryInterface = sequelize.getQueryInterface();
try {
await sequelize.query("raise fail('down migration not implemented')");
await t.commit();
} catch (error) {
await t.rollback();
}
};

import { DataTypes, Sequelize } from "sequelize";

import { MigrationFn } from "umzug";

export const up: MigrationFn<Sequelize> = async ({ context: sequelize }) => {

const t = await sequelize.transaction();

// eslint-disable-next-line @typescript-eslint/no-unused-vars

const queryInterface = sequelize.getQueryInterface();

try {

await sequelize.query("raise fail('up migration not implemented')");

await t.commit();

} catch (error) {

await t.rollback();

}

};

export const down: MigrationFn<Sequelize> = async ({ context: sequelize }) => {

const t = await sequelize.transaction();

// eslint-disable-next-line @typescript-eslint/no-unused-vars

const queryInterface = sequelize.getQueryInterface();

try {

await sequelize.query("raise fail('down migration not implemented')");

await t.commit();

} catch (error) {

await t.rollback();

}

};

では、migrateターゲットでcreateコマンドを実行してみます。

$ npm run migrate create -- --name setup.ts
> migration@1.0.0 migrate
> ts-node migrate.ts "create" "--name" "setup.ts"
{
event: 'created',
path: '/Users/guest/workspace/umzug/migration/migrations/2022.02.28T15.49.12.setup.ts'
}
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

$ npm run migrate create -- --name setup.ts

> migration@1.0.0 migrate

> ts-node migrate.ts "create" "--name" "setup.ts"

{

event: 'created',

path: '/Users/guest/workspace/umzug/migration/migrations/2022.02.28T15.49.12.setup.ts'

}

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

migrationsディレクトリにsetup.tsファイルが作成されることを確認できます。

ついでに、usersテーブルを作成するマイグレーションを実行してみましょう。

import { DataTypes, Sequelize } from "sequelize";
import { MigrationFn } from "umzug";
export const up: MigrationFn<Sequelize> = async ({ context: sequelize }) => {
const t = await sequelize.transaction();
const queryInterface = sequelize.getQueryInterface();
try {
await queryInterface
.createTable("users", {
id: { type: DataTypes.INTEGER, autoIncrement: true, primaryKey: true },
username: { type: DataTypes.STRING(32), allowNull: false },
email: { type: DataTypes.STRING(255), allowNull: false },
password: { type: DataTypes.STRING(255), allowNull: false },
})
.then(() => {
return queryInterface.addIndex("users", {
fields: ["username"],
unique: true,
});
})
.then(() => {
return queryInterface.addIndex("users", {
fields: ["email"],
unique: true,
});
});
await t.commit();
} catch (error) {
await t.rollback();
}
};
export const down: MigrationFn<Sequelize> = async ({ context: sequelize }) => {
const t = await sequelize.transaction();
const queryInterface = sequelize.getQueryInterface();
try {
await queryInterface.dropTable("users");
await t.commit();
} catch (error) {
await t.rollback();
}
};

import { DataTypes, Sequelize } from "sequelize";

import { MigrationFn } from "umzug";

export const up: MigrationFn<Sequelize> = async ({ context: sequelize }) => {

const t = await sequelize.transaction();

const queryInterface = sequelize.getQueryInterface();

try {

await queryInterface

.createTable("users", {

id: { type: DataTypes.INTEGER, autoIncrement: true, primaryKey: true },

username: { type: DataTypes.STRING(32), allowNull: false },

email: { type: DataTypes.STRING(255), allowNull: false },

password: { type: DataTypes.STRING(255), allowNull: false },

})

.then(() => {

return queryInterface.addIndex("users", {

fields: ["username"],

unique: true,

});

})

.then(() => {

return queryInterface.addIndex("users", {

fields: ["email"],

unique: true,

});

await t.commit();

} catch (error) {

await t.rollback();

}

};

export const down: MigrationFn<Sequelize> = async ({ context: sequelize }) => {

const t = await sequelize.transaction();

const queryInterface = sequelize.getQueryInterface();

try {

await queryInterface.dropTable("users");

await t.commit();

} catch (error) {

await t.rollback();

}

};

生成したsetupマイグレーションファイルを上記のように修正します。そして、再びマイグレーションを実行します。

$ npm run migrate up
> migration@1.0.0 migrate
> ts-node migrate.ts "up"
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
{ event: 'migrating', name: '2022.02.28T15.49.12.setup.ts' }
Executing (86537b2f-f180-4b52-9afd-d2c1487f319b): BEGIN DEFERRED TRANSACTION;
Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);
Executing (default): CREATE UNIQUE INDEX `users_username` ON `users` (`username`)
Executing (default): CREATE UNIQUE INDEX `users_email` ON `users` (`email`)
Executing (86537b2f-f180-4b52-9afd-d2c1487f319b): COMMIT;
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);
{
event: 'migrated',
name: '2022.02.28T15.49.12.setup.ts',
durationSeconds: 0.182
}
{ event: 'up', message: 'applied 1 migrations.' }
$ sqlite3 db.sqlite 
SQLite version 3.28.0 2019-04-15 14:49:49
Enter ".help" for usage hints.
sqlite> .schema
CREATE TABLE `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
CREATE TABLE `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);
CREATE TABLE sqlite_sequence(name,seq);
CREATE UNIQUE INDEX `users_username` ON `users` (`username`);
CREATE UNIQUE INDEX `users_email` ON `users` (`email`);
sqlite> select * from SequelizeMeta;
2022.02.28T15.49.12.setup.ts

$ npm run migrate up

> migration@1.0.0 migrate

> ts-node migrate.ts "up"

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

{ event: 'migrating', name: '2022.02.28T15.49.12.setup.ts' }

Executing (86537b2f-f180-4b52-9afd-d2c1487f319b): BEGIN DEFERRED TRANSACTION;

Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);

Executing (default): CREATE UNIQUE INDEX `users_username` ON `users` (`username`)

Executing (default): CREATE UNIQUE INDEX `users_email` ON `users` (`email`)

Executing (86537b2f-f180-4b52-9afd-d2c1487f319b): COMMIT;

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);

{

event: 'migrated',

durationSeconds: 0.182

}

{ event: 'up', message: 'applied 1 migrations.' }

$ sqlite3 db.sqlite

SQLite version 3.28.0 2019-04-15 14:49:49

Enter ".help" for usage hints.

sqlite> .schema

CREATE TABLE `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

CREATE TABLE `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);

CREATE TABLE sqlite_sequence(name,seq);

CREATE UNIQUE INDEX `users_username` ON `users` (`username`);

CREATE UNIQUE INDEX `users_email` ON `users` (`email`);

sqlite> select * from SequelizeMeta;

2022.02.28T15.49.12.setup.ts

無事にusersテーブルが作成されました。

マイグレーションファイルのOrder

辞書でソートされた順にファイルが読み込まれる。タイムスタンプをプリフィックスに元ファイル名にすると良いと思います。

m1.js、m2、…、m10.jsの場合、m1.js、m10.js、…となります。m2.jsよりm10.jsが先にくるということになります。

その他の使用方法

GitHubの公式のドキュメントを見ながら試してみましょう。マイグレーションフォルダには２つの定義を入れています。

$ ls  migrations/
2022.02.28T15.49.12.setup.ts                 2022.02.28T15.49.13.addColumnsToUserTable.ts

1 2	$ ls migrations/ 2022.02.28T15.49.12.setup.ts 2022.02.28T15.49.13.addColumnsToUserTable.ts

ペンディング中のマイグレーションの取得

pendingコマンドを実行します。

$ ./node_modules/.bin/ts-node migrate.ts pending
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
2022.02.28T15.49.12.setup.ts
2022.02.28T15.49.13.addColumnsToUserTable.ts

$ ./node_modules/.bin/ts-node migrate.ts pending

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

2022.02.28T15.49.12.setup.ts

2022.02.28T15.49.13.addColumnsToUserTable.ts

未適用の2件が表示されます。

適用済みのマイグレーションの取得

executedコマンドの実行前にDBを空にして、upコマンド実行後に再度executedコマンドを実行してみます。

$ ./node_modules/.bin/ts-node migrate.ts executed
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
$ ./node_modules/.bin/ts-node migrate.ts up
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
{ event: 'migrating', name: '2022.02.28T15.49.12.setup.ts' }
Executing (9212aec3-4ede-4ea6-821d-ea73c72607dc): BEGIN DEFERRED TRANSACTION;
Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);
Executing (default): CREATE UNIQUE INDEX `users_username` ON `users` (`username`)
Executing (default): CREATE UNIQUE INDEX `users_email` ON `users` (`email`)
Executing (9212aec3-4ede-4ea6-821d-ea73c72607dc): COMMIT;
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);
{
event: 'migrated',
name: '2022.02.28T15.49.12.setup.ts',
durationSeconds: 0.173
}
{
event: 'migrating',
name: '2022.02.28T15.49.13.addColumnsToUserTable.ts'
}
Executing (97939936-9fef-43a4-823d-85bdde73aaa7): BEGIN DEFERRED TRANSACTION;
Executing (default): ALTER TABLE `users` ADD `status` INTEGER;
Executing (97939936-9fef-43a4-823d-85bdde73aaa7): COMMIT;
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);
{
event: 'migrated',
name: '2022.02.28T15.49.13.addColumnsToUserTable.ts',
durationSeconds: 0.24
}
{ event: 'up', message: 'applied 2 migrations.' }
$ ./node_modules/.bin/ts-node migrate.ts executed
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
2022.02.28T15.49.12.setup.ts
2022.02.28T15.49.13.addColumnsToUserTable.ts

$ ./node_modules/.bin/ts-node migrate.ts executed

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

$ ./node_modules/.bin/ts-node migrate.ts up

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

{ event: 'migrating', name: '2022.02.28T15.49.12.setup.ts' }

Executing (9212aec3-4ede-4ea6-821d-ea73c72607dc): BEGIN DEFERRED TRANSACTION;

Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `username` VARCHAR(32) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL);

Executing (default): CREATE UNIQUE INDEX `users_username` ON `users` (`username`)

Executing (default): CREATE UNIQUE INDEX `users_email` ON `users` (`email`)

Executing (9212aec3-4ede-4ea6-821d-ea73c72607dc): COMMIT;

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);

{

event: 'migrated',

durationSeconds: 0.173

}

{

event: 'migrating',

}

Executing (97939936-9fef-43a4-823d-85bdde73aaa7): BEGIN DEFERRED TRANSACTION;

Executing (default): ALTER TABLE `users` ADD `status` INTEGER;

Executing (97939936-9fef-43a4-823d-85bdde73aaa7): COMMIT;

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): INSERT INTO `SequelizeMeta` (`name`) VALUES ($1);

{

event: 'migrated',

durationSeconds: 0.24

}

{ event: 'up', message: 'applied 2 migrations.' }

$ ./node_modules/.bin/ts-node migrate.ts executed

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

2022.02.28T15.49.12.setup.ts

2022.02.28T15.49.13.addColumnsToUserTable.ts

マイグレーション実行後に2件の適用済みリストが表示されます。

マイグレーションの巻き戻し

最後に適用したマイグレーションを巻き戻してみます。

$ ./node_modules/.bin/ts-node migrate.ts down
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;
{
event: 'reverting',
name: '2022.02.28T15.49.13.addColumnsToUserTable.ts'
}
Executing (e684de26-fa9d-4912-83a2-ed2b90f43e4f): BEGIN DEFERRED TRANSACTION;
Executing (default): PRAGMA TABLE_INFO(`users`);
Executing (default): PRAGMA INDEX_LIST(`users`)
Executing (default): PRAGMA INDEX_INFO(`users_username`)
Executing (default): PRAGMA INDEX_INFO(`users_email`)
Executing (default): PRAGMA foreign_key_list(`users`)
Executing (default): CREATE TABLE IF NOT EXISTS `users_backup` (`id` INTEGER PRIMARY KEY, `username` VARCHAR(32) NOT NULL UNIQUE, `email` VARCHAR(255) NOT NULL UNIQUE, `password` VARCHAR(255) NOT NULL);
Executing (default): INSERT INTO `users_backup` SELECT `id`, `username`, `email`, `password` FROM `users`;
Executing (default): DROP TABLE `users`;
Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY, `username` VARCHAR(32) NOT NULL UNIQUE, `email` VARCHAR(255) NOT NULL UNIQUE, `password` VARCHAR(255) NOT NULL);
Executing (default): INSERT INTO `users` SELECT `id`, `username`, `email`, `password` FROM `users_backup`;
Executing (default): DROP TABLE `users_backup`;
Executing (e684de26-fa9d-4912-83a2-ed2b90f43e4f): COMMIT;
Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);
Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)
Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)
Executing (default): DELETE FROM `SequelizeMeta` WHERE `name` = '2022.02.28T15.49.12.addColumnsToUserTable.ts'
{
event: 'reverted',
name: '2022.02.28T15.49.13.addColumnsToUserTable.ts',
durationSeconds: 0.143
}
{ event: 'down', message: 'reverted 1 migrations.' }

$ ./node_modules/.bin/ts-node migrate.ts down

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): SELECT `name` FROM `SequelizeMeta` AS `SequelizeMeta` ORDER BY `SequelizeMeta`.`name` ASC;

{

event: 'reverting',

}

Executing (e684de26-fa9d-4912-83a2-ed2b90f43e4f): BEGIN DEFERRED TRANSACTION;

Executing (default): PRAGMA TABLE_INFO(`users`);

Executing (default): PRAGMA INDEX_LIST(`users`)

Executing (default): PRAGMA INDEX_INFO(`users_username`)

Executing (default): PRAGMA INDEX_INFO(`users_email`)

Executing (default): PRAGMA foreign_key_list(`users`)

Executing (default): CREATE TABLE IF NOT EXISTS `users_backup` (`id` INTEGER PRIMARY KEY, `username` VARCHAR(32) NOT NULL UNIQUE, `email` VARCHAR(255) NOT NULL UNIQUE, `password` VARCHAR(255) NOT NULL);

Executing (default): INSERT INTO `users_backup` SELECT `id`, `username`, `email`, `password` FROM `users`;

Executing (default): DROP TABLE `users`;

Executing (default): CREATE TABLE IF NOT EXISTS `users` (`id` INTEGER PRIMARY KEY, `username` VARCHAR(32) NOT NULL UNIQUE, `email` VARCHAR(255) NOT NULL UNIQUE, `password` VARCHAR(255) NOT NULL);

Executing (default): INSERT INTO `users` SELECT `id`, `username`, `email`, `password` FROM `users_backup`;

Executing (default): DROP TABLE `users_backup`;

Executing (e684de26-fa9d-4912-83a2-ed2b90f43e4f): COMMIT;

Executing (default): CREATE TABLE IF NOT EXISTS `SequelizeMeta` (`name` VARCHAR(255) NOT NULL UNIQUE PRIMARY KEY);

Executing (default): PRAGMA INDEX_LIST(`SequelizeMeta`)

Executing (default): PRAGMA INDEX_INFO(`sqlite_autoindex_SequelizeMeta_1`)

Executing (default): DELETE FROM `SequelizeMeta` WHERE `name` = '2022.02.28T15.49.12.addColumnsToUserTable.ts'

{

event: 'reverted',

durationSeconds: 0.143

}

{ event: 'down', message: 'reverted 1 migrations.' }

最後に適用したaddColumnsToUserTableが打ち消されます。

まとめ

umzugを使うと、Sequelizeを使ったDBマイグレーションのプログラムを独自に実装できます。
umzug#runAsCLI()を使うと、コマンドラインのマイグレーションプログラムを容易に実行することができます。

参考リンク

Sequelize ORM
- https://sequelize.org
umzug
- https://github.com/sequelize/umzug
sequelize/cli
- https://github.com/sequelize/cli
- https://sequelize.org/master/manual/migrations.html

Nuxt3をさわってみる

コメントを残す

Nuxt3はbeta版になっている、Nuxt3の雰囲気をつかむためインストールから起動するところまでやってみる。

インストール

nuxiという新しいCLIを使う。

npx nuxi init nuxt3-app
cd nuxt3-app
npm install

npx nuxi init nuxt3-app

cd nuxt3-app

npm install

nuxiについて、プロジェクトのトップでinfoコマンドを実行してみる。

$ npx nuxi info
Nuxt CLI v3.0.0-27389502.88da719
RootDir: /Users/guests/workspace/nuxt/nuxt3-app
Nuxt project info:
------------------------------
- Operating System: `Darwin`
- Node Version:     `v16.13.2`
- Nuxt Version:     `3.0.0-27389502.88da719`
- Package Manager:  `npm@8.1.2`
- Bundler:          `Vite`
- User Config:      `-`
- Runtime Modules:  `-`
- Build Modules:    `-`
------------------------------
👉 Report an issue: https://github.com/nuxt/framework/issues/new
👉 Suggest an improvement: https://github.com/nuxt/framework/discussions/new
👉 Read documentation: https://v3.nuxtjs.org

$ npx nuxi info

Nuxt CLI v3.0.0-27389502.88da719

RootDir: /Users/guests/workspace/nuxt/nuxt3-app

Nuxt project info:

------------------------------

- Operating System: `Darwin`

- Node Version: `v16.13.2`

- Nuxt Version: `3.0.0-27389502.88da719`

- Package Manager: `npm@8.1.2`

- Bundler: `Vite`

- User Config: `-`

- Runtime Modules: `-`

- Build Modules: `-`

------------------------------

👉 Report an issue: https://github.com/nuxt/framework/issues/new

👉 Suggest an improvement: https://github.com/nuxt/framework/discussions/new

👉 Read documentation: https://v3.nuxtjs.org

ディレクトリ構造

initした直後は以下の感じ。Nuxt2までのようなlayoutsやpagesのようなディレクトリがなく、プロジェクト作成直後はとてもすっきりしている。

$ ls -a | sort
.
..
.gitignore
README.md
app.vue
node_modules
nuxt.config.ts
package-lock.json
package.json
tsconfig.json

$ ls -a | sort

.gitignore

README.md

app.vue

node_modules

nuxt.config.ts

package-lock.json

package.json

tsconfig.json

ドキュメントを見ると、今までのようなlayoutsやpagesといったディレクトリは、Nuxt3でも有効であることが分かる。これらは、アプリの特性に合わせて作成すればよいのだと思う。なお、ディレクトリについては、pluginsディレクトリ下のプラグインファイルが自動で読み込まれるなど新しい点もあるので注意したい。

参考リンク

https://v3.nuxtjs.org/docs/usage/data-fetching

アプリ起動

この状態でrun devするとWelcomeビューが表示される。

httpsオプションで自己署名証明書を使ってhttpsモードで起動ができる。Nuxt2では、nuxt.configのserverオプションで指定していたと思うけれど、この辺りとても簡単になっている。

npm run dev -- --https

1	npm run dev -- --https

Welcomeビューを変更するには、app.vueを編集するか、pages/index.vueのような新たなビューを作る。

srcDirの変更

公式ドキュメントにあるようなclientの下にアプリリソースを配置する構成にしてみる。ディレクトリを作成し、nuxt.configのsrcDirにclientリソースを格納するディレクトリを指定、そして今ままでのようなlayoutsやpagesにビューを作成する。

mkdir -p client/{assets,components,composables,layouts,middleware,pages,plugins}
rm app.vue

1 2	mkdir -p client/{assets,components,composables,layouts,middleware,pages,plugins} rm app.vue

// nuxt.config.ts
import { defineNuxtConfig } from "nuxt3";
export default defineNuxtConfig({
srcDir: "client/",
});

// nuxt.config.ts

import { defineNuxtConfig } from "nuxt3";

export default defineNuxtConfig({

srcDir: "client/",

});

<template>
<div>page/index.vue</div>
</template>

<div>page/index.vue</div>

</template>

<template>
<div>
<h1>Nuxt3</h1>
<slot />
</div>
</template>

<div>

</div>

</template>

上記の変更を加え、改めてrun devしてみると以下のように作成したビューが表示されることを確認できる。

npm run dev

1	npm run dev

参考リンク

https://v3.nuxtjs.org/getting-started/commands

開発業務から企画開発業務になる

コメントを残す

最近は企画開発業務に携わるようになった。今まで、現場でインフラやアプリケーション開発エンジニアとして過ごしてきたので、慣れない業務にシフトしてあたふたしている。年齢的には良いチャレンジのタイミングでもある。重要なのは、自分の意志でやりたいこと、である。

期待されていることの最終的なゴールのイメージはついているが、グループメンバと同じ方向を向いて、同じ目線で深堀りしながら議論や検討を重ねていくには、私自身のスキル不足を感じる。コミュニケーション、ファシリテーション、良い問立て、課題設定、仮説構築、いろいろ。プロセスやアウトプットの基準を整えてレールを敷かなれば、なかなか前に進みづらい。決済権を有する関係者とのしっかりとした対話も必要だ。

進め方を試行錯誤しているが、やり方の見直しが必要だ。先人の知見とノウハウに学ぼう。

インプットした書籍

とても分かりやすい。アイデア発想法から事業計画作成までの流れが網羅されている。流れや各フェーズでのアウトプットもイメージがつきやすい。事業計画書のテンプレもついているので、状況に合わせてカスタマイズしていけるだろう。ビジネスモデルキャンバスについても説明がある。アイデア発想のためのフレームワークなどを重視したい場合は、別の書籍にもあたるのが良いと感じた。

シンプルでとても分かりやすい。企画の前の段階で確認しておくべきことについても触れられている。特に社内で企画に関わる人にとっては重要なポイントだと思う。また、アイデア発想のための思考フレームワークや効果についても整理されていて、こんな切り口で考えを整理したいときにどの考え方が使えるだろう？、といったニーズにマッチするだろう。思考の切り口に悩んでいる人には有用だと感じた。事業計画や計画書に網羅すべき点の詳細を知りたい場合は、別の書籍にもあたるのが良いと感じた。

こちらはフレームワークを中心に知りたい人向け。フレームワークの種類をたくさん説明しているというより、フレームワークのタイプを体系化して説明してくれている感じである。フレームワークに沿うと思考が整理しやすくなる。ただ、フレームワークの型に沿って必要な項目を埋めていけば、良い分析ができるかというとそうはならない。フレームワークはあくまで思考を整理しやすくするためのツール。フレームワークの背景にある考え方や有用なケースを知っていれば、うまくツールを使いこなせる。今まで、背景にある考え方を説明している書はあまり見てこなかったので、本書は大変参考になった。フレームワークのタイプを体系化しているので、フレームワークを組み合わせたり、自身で応用したりもできるだろう。

世の中のビジネスモデルを知るのに良い。普段目にしているサービスや事業がどんなビジネスモデルになっているのか俯瞰できる。本書では、戦略モデルキャンバスというフレームワークが紹介されている。ビジネスモデルキャンバスに、コンテキストという要素が追加されている。コンテキストには、ビジネスモデルが成立するための妥当性と正当性を書く、となっている。モデル成功の前提を書く、というものであり思考を整理しやすくなっている。

Mattermost Dockerのconfig.jsonの指定

コメントを残す

Mattermostのdockerコンテナで、mattermostコマンドを使って設定更新操作を行なうと、あらかじめ作成しておいたconfig.jsonが何故が初期化されてしまう事象に遭遇してしまった、？？。（再現性を確認できていないが、pluginをenableやdeleteして何らかのschedulerが動くタイミングで発生している？）

そこで、本記事ではMattermostの設定方法について整理する。

本動作検証バージョンはv5.37.4である。

MattermostのConfiguration

Mattermostは、設定情報をconfig.jsonファイルで管理する。通常、mattermost/configディレクトリにあるconfig.jsonファイルが対象となる。環境変数MM_CONFIGでconfig.jsonファイルのパスを指定することもできる。設定情報は、System Consoleや直接ファイルを編集することで更新できる。設定を更新するとconfigの変更を検知してリロードしてくれる。

v.5.10からはデータベースで構成管理をすることができる。

ファイルで管理する場合

環境変数MM_CONFIGにconfig.jsonファイルのパスを指定する。指定がない場合は、config/config.jsonが対象となる。

MM_CONFIG=/path/to/config.json

1	MM_CONFIG=/path/to/config.json

ローカルテスト環境で起動する場合は、以下のようにする。Dockerコンテナ環境が必要である。macであれば、Docker Desktop For Mac（個人利用は無料：ライセンスは公式を確認のこと）を使うとよいだろう。

# バックグラウンド起動（デフォルト）
$ make run-server
# バックグラウンド起動しない場合
$ make RUN_IN_BACKGROUND=false run-server

# バックグラウンド起動（デフォルト）

$ make run-server

# バックグラウンド起動しない場合

$ make RUN_IN_BACKGROUND=false run-server

参考：Setting up Your Development Environment – Mattermost

データベースで管理する場合

MM_CONFIGにDatabase DSNを指定する。mysqlの場合は以下のようになる。

MM_CONFIG='mysql://mmuser:mostest@tcp(localhost:3306)/mattermost_test?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s&multiStatements=true'

1	MM_CONFIG='mysql://mmuser:mostest@tcp(localhost:3306)/mattermost_test?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s&multiStatements=true'

参考：Configuration in the Mattermost Database

起動時にカスタムのデフォルト設定を適用したい場合は、以下の環境変数を指定する。

export MM_CUSTOM_DEFAULTS_PATH=/path/to/custom.json

1	export MM_CUSTOM_DEFAULTS_PATH=/path/to/custom.json

現在有効な設定はデーターベースに接続して確認できる。

select Id, CreateAt, Value, Active from Configurations where Active = 1 \G

1	select Id, CreateAt, Value, Active from Configurations where Active = 1 \G

mattermostコマンドでconfigを更新してみる。

./bin/mattermost config set ServiceSettings.IdleTimeout 8080

1	./bin/mattermost config set ServiceSettings.IdleTimeout 8080

データベースのConfigurationsのレコード件数を見ると新たにレコードが増えていることが分かる。

mysql> select count(*) from Configurations; 
+----------+
| count(*) |
+----------+
|        6 |
+----------+
1 row in set (0.00 sec)
mysql> select count(*) from Configurations;
+----------+
| count(*) |
+----------+
|        7 |
+----------+
1 row in set (0.00 sec)

mysql> select count(*) from Configurations;

+----------+

| count(*) |

+----------+

| 6 |

+----------+

1 row in set (0.00 sec)

mysql> select count(*) from Configurations;

+----------+

| count(*) |

+----------+

| 7 |

+----------+

1 row in set (0.00 sec)

値も反映されている。

mysql> select Id, CreateAt, Value, Active from Configurations where Active = 1 \G
*************************** 1. row ***************************
Id: qoo1g868jp8s58318rxeeyxr1h
CreateAt: 1639889307586
Value: {
"ServiceSettings": {
"SiteURL": "",
"WebsocketURL": "",
"LicenseFileLocation": "",
"ListenAddress": ":8065",
"ConnectionSecurity": "",
"TLSCertFile": "",
"TLSKeyFile": "",
"TLSMinVer": "1.2",
"TLSStrictTransport": false,
"TLSStrictTransportMaxAge": 63072000,
"TLSOverwriteCiphers": [],
"UseLetsEncrypt": false,
"LetsEncryptCertificateCacheFile": "./config/letsencrypt.cache",
"Forward80To443": false,
"TrustedProxyIPHeader": [
"X-Forwarded-For",
"X-Real-IP"
],
"ReadTimeout": 300,
"WriteTimeout": 300,
"IdleTimeout": 8080,
...省略

mysql> select Id, CreateAt, Value, Active from Configurations where Active = 1 \G

*************************** 1. row ***************************

Id: qoo1g868jp8s58318rxeeyxr1h

CreateAt: 1639889307586

Value: {

"ServiceSettings": {

"SiteURL": "",

"WebsocketURL": "",

"LicenseFileLocation": "",

"ListenAddress": ":8065",

"ConnectionSecurity": "",

"TLSCertFile": "",

"TLSKeyFile": "",

"TLSMinVer": "1.2",

"TLSStrictTransport": false,

"TLSStrictTransportMaxAge": 63072000,

"TLSOverwriteCiphers": [],

"UseLetsEncrypt": false,

"LetsEncryptCertificateCacheFile": "./config/letsencrypt.cache",

"Forward80To443": false,

"TrustedProxyIPHeader": [

"X-Forwarded-For",

"X-Real-IP"

"ReadTimeout": 300,

"WriteTimeout": 300,

"IdleTimeout": 8080,

...省略

configファイルの変更検知を停止する

Mattermostでは、構成の変更を検知するconfig watcherが動いており、構成情報の変更を検知して反映する。本機能を止めるには、以下のオプションを起動時に指定する。

--disableconfigwatch

1	--disableconfigwatch

config watcherを停止して何度かmattermostコマンドでpluginのenable/deleteを繰り返した限りでは、config.jsonの予期せぬ上書きに遭遇はしなかった。

なお、v5.38からはconfig.jsonの自動リロードはDeprecatedとなっているようである。設定のリロードは、mmctlコマンドで明示的に行なう、となっている。（以下リンクより）

参考：Configuration Settings

今後は、configの変更後、mmctlコマンド（mmctl config reload）で反映という手順になるのであろう。

なお、config watcherを停止した場合、configの変更はmmctlコマンドでリロードしないと反映されなかった。これは、データベース管理でも同様であった。config watcherを停止した場合は、反映漏れがないように気をつけたい。

参考

https://developers.mattermost.com/contribute/server/developer-setup/
https://github.com/mattermost/mattermost-server/blob/v5.37.4/config/store.go#L94
config.jsonの上書きに関連するissue（最新情報は公式を参照のこと）
- https://github.com/mattermost/mattermost-server/issues/16607
- https://forum.mattermost.org/t/mattermost-resets-config-file-periodically-on-startup/11116/15

デバッグライフ

プログラミングや日常の記録など

「アマゾンの最強の働き方」を読んだ

Node.jsでumzug+SequelizeによるDBマイグレーション

Sequelizeのmigration

umzug

テスト環境の準備

最小サンプル

TypeScriptファイルの雛形からマイグレーションファイルを生成する

マイグレーションファイルのOrder

その他の使用方法

ペンディング中のマイグレーションの取得

適用済みのマイグレーションの取得

マイグレーションの巻き戻し

まとめ

参考リンク

Nuxt3をさわってみる

インストール

ディレクトリ構造

アプリ起動

srcDirの変更

参考リンク

開発業務から企画開発業務になる

Mattermost Dockerのconfig.jsonの指定

MattermostのConfiguration

ファイルで管理する場合

データベースで管理する場合

configファイルの変更検知を停止する

参考