Azure Container Apps へ bicep、Azure Container Registry、GitHub Actions を使って React Web アプリをデプロイしてみました。一連の手順の紹介です。

Azure Container Appsへbicep,Azure Container Registry,GitHub Actionsを使ってデプロイ

Azure Container Apps へ bicep、GitHub Container Registry、GitHub Actions を使って React Web アプリをデプロイしてみました。一連の手順の紹介です。

Azure Container Appsへbicep,GitHub Container Registry,GitHub Actionsを使ってデプロイ

Python FastAPI React PostgreSQLのプロジェクト gaganpreet/fastapi-starter を動かしてみました。動かし方、動作内容、構成等の解説記事です。

Python FastAPI React PostgreSQLのプロジェクトを動かして紐解いてみた

アプリ実装→GitLab CI/CD パイプライン発動→自動テスト／ビルド→自動Docker ビルド→自動デプロイ　を実現する全手順です。

Kotlin＋Spring Bootのアプリを GitLab CI/CD によるDockerデプロイまで全手順

# はじめに

Kotlin ＋ SpringBoot で REST API 実装 
↓ 
Gradle / FatJar のビルド 
↓ 
Docker ビルド 
の流れを最初から最後までの全手順になります。

 

<blockquote class="warn">
どちらかと言うと、Dockerビルドが主題で、REST APIの実装は、主題ではありません。そのため、かなり簡素な実装で進めます。
</blockquote>

 

この記事の Docker ビルドについては、公式ドキュメント 
<a href="https://spring.io/guides/gs/spring-boot-docker/" target="_blank">Spring Boot with Docker</a> 
の 
Example 3 
Kotlin 版という感じです。

<blockquote class="warn">
【検証環境】
<code>Ubuntu 20.04.2 LTS</code>
　<code>IntelliJ IDEA 2022.1.2(Community Edition)</code>
　<code>openjdk version "17.0.3"</code>
　<code>org.springframework.boot 2.6.8</code>
　<code>kotlin("jvm") version "1.6.21"</code>
　<code>kotlin("plugin.spring") version "1.6.21"</code>
　<code>gradle-7.4.1</code>
　<code>Docker version 20.10.17, build 100c701</code>
　　<code>openjdk:17-jdk-alpine</code>
</blockquote>

 

# プロジェクト作成

Spring initializr にて、プロジェクトのテンプレートをダウンロードします。

 

有料の IntelliJ IDEA Ultimate には、 Spring initializr が備わっていますが、今回は、無料の IntelliJ IDEA Community を使う前提です。

<blockquote class="info">
【余談】
initializr が initializer じゃないのが気になりましたが、
initializr.com にインスパイアされたという情報がありました。
その initializr.com は、なぜ initializr なのかは謎ですが...。
</blockquote>

 

Project: `Gradle Project` 
Language: `Kotlin` 
Spring Boot: `2.6.8` 
Packing: `Jar` 
Java: `17` 
Dependencies: `Spring Web` 
を選択します。

 

プロジェクトの名前は、任意ですが、最初から表示されている `demo` で進めていきます。

 

選択したら、GENERATE をクリックします。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image1.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image1.png" alt="Spring initializrでGENERATE" width="1454" height="868" loading="lazy"></a>

 

# API 実装

IntelliJ IDEA Community をインストールします。 
インストール手順は、別記事「<a href="https://itc-engineering-blog.netlify.app/blogs/kotless-localstack-s3" target="_blank">Kotless と LocalStack で疑似サーバーレス - AWS S3 ダウンロード</a>」にありますので、省略して、Ubuntu に IntelliJ IDEA Community Linux をインストールしたものとして、進めていきます。

 

Spring initializr から入手した、`demo.zip` を展開します。

 

今回は、`/home/admin/demo` に展開したものとします。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image2.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image2.png" alt="/home/admin/demoにdemo.zipを展開" width="883" height="593" loading="lazy"></a>

 

IntelliJ IDEA Community で読み込みます。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image3.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image3.png" alt="IntelliJ IDEA Community で読み込み" width="792" height="642" loading="lazy"></a>

 

最初は、いろいろダウンロードが始まるので、終わるまで待ちます。（作業していても良いです。）

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image4.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image4.png" alt="IntelliJ いろいろダウンロード中" width="1184" height="729" loading="lazy"></a>

 

`src/main/kotlin/com/example/demo/DemoApplication.kt` を編集します。

 

最初は、以下の状態でした。

```kotlin:DemoApplication.kt
package com.example.demo

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication

@SpringBootApplication
class DemoApplication

fun main(args: Array<String>) {
	runApplication<DemoApplication>(*args)
}
```

 

編集後、以下のようにします。 
GET /api 　 → 　`Hello world!` と返す。 
POST /api 　 → 　 POST パラメーターの `value` の値をそのまま返す。 
という単純な実装です。

```kotlin:DemoApplication.kt
package com.example.demo

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
import org.springframework.web.bind.annotation.*

@SpringBootApplication
class DemoApplication

fun main(args: Array<String>) {
	runApplication<DemoApplication>(*args)
}

@RestController
@RequestMapping("/api")
class IndexController {
	@GetMapping
	fun get(): String? = "Hello world!"
	@PostMapping
	fun post(@RequestParam("value") value: String?): String? = value
}
```

 

テストプログラム 
`src/test/kotlin/com/example/demo/DemoApplicationTests.kt` 
を編集します。 
最初は、以下の状態でした。

```kotlin:DemoApplicationTests.kt
package com.example.demo

import org.junit.jupiter.api.Test
import org.springframework.boot.test.context.SpringBootTest

@SpringBootTest
class DemoApplicationTests {

	@Test
	fun contextLoads() {
	}

}
```

 

編集後、以下のようにします。 
GET /api 　 → 　`Hello world!` と返ってくるかどうか確認。 
`value=hello` で POST /api 　 → 　`hello` と返ってくるかどうか確認。 
という単純な実装です。

```kotlin:DemoApplicationTests.kt
package com.example.demo

import org.junit.jupiter.api.Test
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
import org.springframework.boot.test.context.SpringBootTest
import org.springframework.test.web.servlet.MockMvc
import org.springframework.test.web.servlet.get
import org.springframework.test.web.servlet.post

@SpringBootTest
@AutoConfigureMockMvc
class DemoApplicationTests {

	@Autowired
	private lateinit var mockMvc: MockMvc

	@Test
	fun get() {
		mockMvc.get("/api").andExpect {
			status { isOk() }
			content {
				contentTypeCompatibleWith("text/plain")
				string("Hello world!")
			}
		}
	}

	@Test
	fun post() {
		mockMvc.post("/api") {
			param("value", "hello")
		}.andExpect {
			status { isOk() }
			content {
				string("hello")
			}
		}.andDo {
			print()
			handle {
				println(it.response.characterEncoding)
			}
		}
	}

}
```

 

テストを実行します。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image5.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image5.png" alt="IntelliJ でテストを実行" width="1212" height="806" loading="lazy"></a>

 

あるいは、端末から、

```shellsession
$ cd /home/admin/demo
$ ./gradlew test
```

で実行します。

 

結果、問題無しでした。

 

アプリを実行します。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image6.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/spring-boot-kotlin-docker/image6.png" alt="IntelliJ でアプリを実行" width="1208" height="806" loading="lazy"></a>

 

あるいは、端末から、

```shellsession
$ cd /home/admin/demo
$ ./gradlew bootRun
```

で実行します。

 

端末から API を呼び出してみます。

```shellsession
$ curl http://localhost:8080/api
Hello world!
```

```shellsession
$ curl -d "value=hello" http://localhost:8080/api
hello
```

ＯＫです！

 

# Kotlin ビルド

ビルドして、Fat JAR を生成します。 
実行可能 jar ファイル（Fat JAR）の作成を担当するタスク bootJar タスク でビルドします。 
bootJar タスク は、SpringBoot プラグインのタスクです。

```shellsession
# cd /home/admin/demo
# ./gradlew bootJar
```

<blockquote class="info">
【 Fat JAR 】
Fat JAR（または uber-jar とも呼ばれる）アーカイブは通常、すべての依存ライブラリを１つにまとめた単一のJARファイルで、Javaを使ってスタンドアロンのアプリケーションとして起動することができます。
</blockquote>

<blockquote class="info">
【 bootJarタスク 】
<code>./gradlew build</code> あるいは、<code>./gradlew assemble</code> でも bootJar タスクが実行されますが、他のタスクに興味は無いため、<code>./gradlew bootJar</code> としています。
</blockquote>

```shellsession
# find build/libs
build/libs
build/libs/demo-0.0.1-SNAPSHOT.jar
```

ビルドできました！

 

# Docker インストール

docker コマンドを使ってビルドするため、docker をインストールします。

```shellsession
# apt update
# apt install -y apt-transport-https ca-certificates software-properties-common
# curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
# apt update
# apt install -y docker-ce
# docker -v
Docker version 20.10.17, build 100c701
```

 

# Dockerfile 作成

Dockerfile を作成します。

 

<blockquote class="alert">
注意：下記「公式ドキュメント」 は、リンク切れになりました。
</blockquote>

 

内容は、公式ドキュメント 
<a href="https://spring.io/guides/gs/spring-boot-docker/" target="_blank">Spring Boot with Docker</a> 
Example 3 
に書いてある通りで、アプリ名の部分だけ以下のように変えました。 
`hello.Application` → `com.example.demo.DemoApplicationKt`

 

`MANIFEST.MF` に載っている 
`Start-Class: com.example.demo.DemoApplicationKt` 
です。（`MANIFEST.MF`は、この後の jar 展開のところで出てきます。）

```shellsession
# cd /home/admin/demo
# vi Dockerfile
```

```dockerfile
FROM openjdk:17-jdk-alpine
RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring
ARG DEPENDENCY=target/dependency
COPY ${DEPENDENCY}/BOOT-INF/lib /app/lib
COPY ${DEPENDENCY}/META-INF /app/META-INF
COPY ${DEPENDENCY}/BOOT-INF/classes /app
ENTRYPOINT ["java","-cp","app:app/lib/*","com.example.demo.DemoApplicationKt"]
```

 

# jar 展開

Dockerfile の中で、BOOT-INF と META-INF をコピーしています。 
この BOOT-INF と META-INF は、jar の中にあるため、展開しておきます。

```shellsession
# mkdir build/dependency
# cd build/dependency
# jar -xf ../libs/*.jar
```

```shellsession
# apt -y install tree
# cd ../../
# tree -L 3 build/dependency
build/dependency
├── BOOT-INF
│   ├── classes
│   │   ├── application.properties
│   │   ├── com
│   │   ├── META-INF
│   │   ├── static
│   │   └── templates
│   ├── classpath.idx
│   ├── layers.idx
│   └── lib
│   ├── annotations-13.0.jar
│   ├(略)
│   └── tomcat-embed-websocket-9.0.63.jar
├── META-INF
│   └── MANIFEST.MF
└── org
 └── springframework
 └── boot

11 directories, 39 files
# cat build/dependency/META-INF/MANIFEST.MF
Manifest-Version: 1.0
Main-Class: org.springframework.boot.loader.JarLauncher
Start-Class: com.example.demo.DemoApplicationKt
Spring-Boot-Version: 2.6.8
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/
Spring-Boot-Classpath-Index: BOOT-INF/classpath.idx
Spring-Boot-Layers-Index: BOOT-INF/layers.idx
```

準備完了です！

 

# Docker ビルド

Docker ビルドし、コンテナを起動します。 
イメージのタグは、公式ドキュメントと同じ `springio/gs-spring-boot-docker` にしています。
`--build-arg DEPENDENCY=build/dependency ` により、Dockerfile 内の `${DEPENDENCY}` が `build/dependency` になるようにしています。

```shellsession
# docker build --build-arg DEPENDENCY=build/dependency -t springio/gs-spring-boot-docker .
・・・
Step 8/8 : ENTRYPOINT ["java","-cp","app:app/lib/*","com.example.demo.DemoApplicationKt"]
 ---> Running in 5a37a2c857c1
Removing intermediate container 5a37a2c857c1
 ---> fbf91ab1c9ed
Successfully built fbf91ab1c9ed
Successfully tagged springio/gs-spring-boot-docker:latest
# docker run -p 8080:8080 springio/gs-spring-boot-docker

 . ____ _ __ _ _
 /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/ ___)| |_)| | | | | || (_| | ) ) ) )
 ' |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot :: (v2.6.8)

2022-06-11 10:25:52.896 INFO 1 --- [ main] com.example.demo.DemoApplicationKt : Starting DemoApplicationKt using Java 17-ea on 2183b7ba3a37 with PID 1 (/app started by spring in /)
・・・
```

できました！

 

# 動作確認

```shellsession
# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
springio/gs-spring-boot-docker latest fbf91ab1c9ed 7 minutes ago 348MB
openjdk 17-jdk-alpine 264c9bdce361 11 months ago 326MB
# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2183b7ba3a37 springio/gs-spring-boot-docker "java -cp app:app/li…" 3 minutes ago Up 3 minutes 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp vigorous_lewin
```

コンテナ起動ヨシ！

 

端末から API を呼び出してみます。

```shellsession
$ curl http://localhost:8080/api
Hello world!
```

```shellsession
$ curl -d "value=hello" http://localhost:8080/api
hello
```

ヨシ！！

 

# bootBuildImage

ここまで書いておいて、なんですが、 
Kotlin ビルド ～ Docker ビルドまで １行で済む別のビルド方法があります。

```shellsession
# ./gradlew bootBuildImage --imageName=springio/gs-spring-boot-docker
```

とすると、自動的に Docker ビルドされます。 
Dockerfile 不要です。（docker のインストールは必要です。）

 

```shellsession
# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
paketobuildpacks/run base-cnb d212cf6a84ff 2 days ago 88.6MB
springio/gs-spring-boot-docker latest 4108c09ba48e 42 years ago 279MB
paketobuildpacks/builder base beb5e13e1cee 42 years ago 980MB

# docker run -it -d -p 8080:8080 springio/gs-spring-boot-docker
# curl http://localhost:8080/api
Hello world!
# curl -d "value=hello" http://localhost:8080/api
hello
# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f2433f94adc9 springio/gs-spring-boot-docker "/cnb/process/web" 16 seconds ago Up 15 seconds 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp nice_tereshkova
# docker exec -it nice_tereshkova head -n2 /etc/*-release
==> /etc/lsb-release <==
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=18.04

==> /etc/os-release <==
NAME="Ubuntu"
VERSION="18.04.6 LTS (Bionic Beaver)"
```

CREATED が `42 years ago` になっているのが気になりましたが、動作は正常でした。

 

Ubuntu 18.04.6 LTS で起動しているようでした。

Kotlin ＋ SpringBootプロジェクト作成から REST API 実装、Gradle / FatJar のビルド、Docker ビルドまで最初から最後までの全手順記事です。

Kotlin ＋ Spring Boot ＋ Dockerビルド(Gradle, Fat JAR)まで全手順

LocalStack、Kotlin のサーバーレスフレームワーク Kotless、メール配信サービスの SendGrid のモック環境を構築しました。構成の説明と構築手順の記事になります。

LocalStack Kotless(Kotlin) SendGridのオフライン動作環境構築

LocalStackのSQS機能を利用して、オフラインで、AWS SQS機能の動作確認をしました。さらに、Ruby on Rails ＋ キューイングバックエンドとして Shoryuken を使って、プログラムによるキューの出し入れを動作確認しました。

LocalStackをAWS SQSにしてRuby on Rails Shoryukenを使ってみた

KotlinのサーバーレスフレームワークKotlessでAWS S3のバケットをダウンロードするプログラムを作ってみました。本物のAWSではなく、LocalStackで動作します。

KotlessとLocalStackで疑似サーバーレス - AWS S3ダウンロード

Ubuntu 20.04 LTS のオンプレミス環境に Kubernetes 環境を構築しました。マスターノード、ワーカーノードを作成し、ワーカーノードにNginx Podを追加しました。そこまでの全手順です。

Ubuntu 20.04 LTSのオンプレにKubernetes環境構築からnginx Pod稼働まで

httpsのGitLabをDocker for Windowsでdocker runとdocker-composeの２方式で構築しました。VMware Workstation 16のWindows10仮想マシンにDockerをインストールするところからの手順です。

httpsのGitLabをDocker for Windowsでdocker run,docker-compose

前回記事「AD(Active Directory)の中身を覗いてみた - ldapsearch,php,PowerShell」の続きで、今回は、「Active Directory ユーザーとコンピュータ」で設定した値がどの `属性: 値` に該当するのかを調査した結果をまとめました。

AD(Active Directory)の設定項目と属性名を紐付けてみた

VS Code(Visual Studio Code)をインストールした直後の状態から、 ・コードフォーマッター（Black）導入 ・リンター（flake8）導入 ・インデント色分け（indent-rainbow）導入 までの手順を書きたいと思います。 なお、Blackは、Python3.6以上が必要です。

VS CodeでPythonのコードフォーマッター(black)、リンター(flake8)をセットアップ

URLリンクからアプリを起動できるカスタムURLスキーム（custom url scheme, custom protocol）というのがあります。カスタムプロトコルに対応するアプリが無い場合、アラートを表示するプログラムを作成しました。

カスタムURLスキームのアプリに対応しているか検知する方法

Power Apps のキャンバスアプリ開発について、最初から知っていたら、手戻り無かったり、スムーズに開発できたような事柄を１５個まとめた前回の続きで、前回と合わせると３０個のTips集のようなものになりました。

Power Appsキャンバスアプリ 【続】最初から知っていたら嬉しかった１５のこと

# はじめに
git commit コマンドですが、複数行のコメントを指定できます。 
やり方がいろいろありますので、試してみました。

 

各バージョンは、以下の通りです。
```sh
# gitlab-rake gitlab:env:info
GitLab information
Version: 13.11.2
GitLab Shell
Version: 13.17.0
# git --version
git version 2.25.1
```

シェルは、bashで 
`GNU bash, version 5.0.17(1)-release (x86_64-pc-linux-gnu)`
です。 

 

<blockquote class="warn">
本題に入る前に・・・
commitのコメントの２行目は空白にするのが推奨されます。（今回も全て空白にして試しました。）
理由は、コミットメッセージの最初の空白行までのテキストはコミットタイトルとして扱われ、空白行が無いと、ずっとタイトルだと思われるからのようです。
<a href="https://git-scm.com/docs/git-commit#_discussion" target="_blank">（情報元）</a>
</blockquote>

 

# オプション無しでcommit
オプション無しでcommitするだけになります。

```sh
# git commit
```

<blockquote class="info">
OSの設定によるのですが、標準のエディタで編集します。
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/editor.png)

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目
 ４行目
 ５行目
```

複数行コメント付きでコミットされています。

<blockquote class="info">
オプションの -1 は直近のcommit情報を見るという意味です。
</blockquote>

 

GitLabで見ても複数行コメント付きでコミットされています。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab1.png)

 

# git commit -m その１
-mを行数分指定します。

```sh
# git commit -m "１行目" -m "" -m "３行目" -m "４行目" -m "５行目"
```

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目

 ４行目

 ５行目
```

空白行ができました。 

 

GitLabで見ても空白行があるようです。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab2.png)

 

# git commit -m その２

複数行コピーして、teratermに貼り付けます。 
※git commit -m "<エンター>→１行目<エンター>・・・のように１行ずつ打ち込んでいっても同じです。

```sh
# git commit -m "
１行目

３行目
４行目
５行目
"
```

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目
 ４行目
 ５行目
```

複数行コメント付きでコミットされています。

 

GitLabで見ても複数行コメント付きでコミットされています。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab1.png)

 

# git commit -m その３

$'...\n...\n...'を使います。

<blockquote class="warn">
bashのみでしか確認していません。
</blockquote>

```sh
# git commit -m $'１行目\n\n３行目\n４行目\n５行目'
```

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目
 ４行目
 ５行目
```

複数行コメント付きでコミットされています。

 

GitLabで見ても複数行コメント付きでコミットされています。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab1.png)

 

# git commit -F その１
-Fオプションでヒアドキュメントの出力(マイナス記号の部分)を受け取ります。

```sh
# git commit -F- << EOM
１行目

３行目
４行目
５行目
EOM
```

 

--file= を使った以下でも全く同じ意味です。

```sh
# git commit --file=- << EOM
１行目

３行目
４行目
５行目
EOM
```

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目
 ４行目
 ５行目
```

複数行コメント付きでコミットされています。

 

GitLabで見ても複数行コメント付きでコミットされています。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab1.png)

 

# git commit -F その２
-Fオプションでファイルを指定します。

以下の内容のcommit.txtを作成
```sh
１行目

３行目
４行目
５行目
```
↓
```sh
# git commit -F commit.txt
```

 

--file= を使った以下でも全く同じ意味です。

```sh
# git commit --file=commit.txt
```

 

```sh
# git log -1
commit [commit ID]
Author: [Author名] <[Authorメールアドレス]>
Date: [タイムスタンプ]

 １行目

 ３行目
 ４行目
 ５行目
```

複数行コメント付きでコミットされています。

 

GitLabで見ても複数行コメント付きでコミットされています。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab_commit/GitLab1.png)

git commit コマンドですが、複数行のコメントを指定できます。 やり方がいろいろありますので、試してみました。 各バージョンは、以下の通りです。 # gitlab-rake gitlab:env:info GitLab information Version:        13.11.2 GitLab Shell Version:        13.17.0 # git --version git version 2.25.1 シェルは、bashで GNU bash, version 5.0.17(1)-release (x86_64-pc-linux-gnu) です。 本題に入る前に・・・ commitのコメントの２行目は空白にするのが推奨されます。（今回も全て空白にして試しました。）

GitLab git commit 複数行コメントのやり方いろいろ

Material UI(MUI)v5 x-date-pickersを日本語化して、土日の色調整、週単位選択を実装しました。その手順と実装内容の記事です。

Material UI(MUI)v5 x-date-pickers日本語化・土日の色調整・週単位選択

Microsoft Power Apps で登場する 関数の意味、構文、使い方をまとめました。コントロール名の命名規則、型についてもまとめました。

Power Apps 向けの Power Fx 関数 まとめ

# はじめに
CentOS-8.3 にインストールした Rocket.Chat-3.13.3 を少し使ってみました。少し使ってみただけで、マニュアルとかではありません。 
Webブラウザの画面は、全てMicrosoft Edgeブラウザを使用しています。 

 

# 初回管理者登録
 
## 管理者情報
 
管理者の名前、ユーザー名、メールアドレス、パスワードを入力します。 
この画面で一番に登録した人が管理者です。 
名前：表示名 
ユーザー名：アカウントID 
の関係です。

<blockquote class="warn">
ユーザー名は半角文字(英数字・ドット・マイナス)だけ使用可能です。
</blockquote>

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image1.png) 

 

## 組織情報

自社で使う分には、入力内容は何でも良いと思います。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image2.png) 

 

## サーバー情報

「電子メールを介した2ファクタ認証の新規ユーザーの自動選択」ですが、英語では、「Auto opt in new users for Two Factor via Email」でして、プロフィール関連のアクション（メールの変更、パスワードの変更、アバターの変更）でメールを使用して、2FA（二要素認証）が求められるようです。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image3.png) 

 

## サーバーを登録する

今回、（メール送信以外）インターネットとは無関係で運用したいので、「次を自分で実施し、スタンドアローン利用する」にします。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image4.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image5.png) 

 

## ワークスペースを開く

「ワークスペースを開く」をクリックします。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image6.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image7.png) 

 

# ユーザー登録

## ユーザー登録方法１

管理者以外でアクセスすると、このような画面になりますので、「新しいアカウントを登録」にて、アカウント登録できます。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image8.png) 

 

ここで入力するのは、名前です。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image9.png) 

 

ユーザー名を入力します。 

<blockquote class="warn">
ユーザー名は半角文字(英数字・ドット・マイナス)だけ使用可能です。
</blockquote>

※ユーザー名「太郎」とエラーにしています。 
↓
![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image10.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image11.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image12.png) 

 

## ユーザー登録方法２

管理者でログインします。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image13.png) 

 

アカウントのアイコンのところをクリックして、「管理」をクリックします。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image14.png) 

 

「ユーザー」をクリックします。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image15.png) 

 

「+ New」をクリックします。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image16.png) 

 

「ユーザーを追加」部分に新規アカウント情報を入力します。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image17.png) 

 

<blockquote class="warn">
「パスワードの変更を要求」の部分は、初回ログイン時にパスワードの変更を強制するかどうかです。今回は、有効にします。
</blockquote>

 

「保存」をクリックします。 
※「バイオ」と書いてある部分は、バイオグラフィーの事です。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image18.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image19.png) 

 

## 追加したユーザーでログイン

ユーザー名（半角英数）、パスワードでログインします。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image20.png) 

 

パスワードを変更します。

<blockquote class="warn">
「パスワードの変更を要求」を有効にした場合です。
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image21.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image23.png) 

 

# 新しいチャンネルを作成

チャンネルを追加します。

<blockquote class="info">
「チャンネル」は、"トークルーム"と同じ意味です。「ルーム」や「Room」と書かれている場合もあります。
</blockquote>

「新しいチャンネルを作成」アイコンをクリックします。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image24.png) 

 

「チャンネル」をクリックします。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image25.png) 

 

必要事項入力、設定後、「作成」をクリックします。

<blockquote class="info">
「暗号化」は、おろらく開発中のため、有効化できませんでした。
今回、「プライベート」を有効にしたため、招待を受けた人しかトークに参加できません。「Add Members」に入れておけば、招待せずに参加者となります。後で招待することもできます。
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image26.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image27.png) 

 

# メッセージ入力

## 基本

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image28.png) 

 

画面下の入力欄にメッセージを入れて送信ボタン（入力欄の右のボタン）を押すと入力したメッセージが反映されます。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image29.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image30.png) 

## 文字修飾

一番下の 「B」アイコンをクリックして、文字を入力すると、太字になります。
\*は、自分で入力しても良いです。
ただし、\*[スペース]太字[スペース]\* のようにするのは、ＮＧです。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image31.png) 


その他、「B」の右隣から 
\_斜体\_ 
 
\~取り消し線\~ 
 
\`インラインコード\` 
 
\`\`\` 
マルチラインコード 
\`\`\` 
 
になります。 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image40.png) 

<blockquote class="info">
KaTeX（数式表示）も対応しているようで、
<a href="https://katex.org/docs/supported.html" target="_blank">https://katex.org/docs/supported.html</a> のサンプルを元に記述します。
ただ、サンプルに <pre><code>\tilde{a}</code></pre> とある場合、\[ \] で囲んで、<pre><code>\[\tilde{a}\]</code></pre> としないといけませんでした。
また、複数行の場合、１行にしないといけませんでした。
<pre><code>\begin{matrix}
 a & b \\
 c & d
\end{matrix}</code></pre>
↓
<pre><code>\[\begin{matrix} a & b \\ c & d \end{matrix}\]</code></pre>
※改行は、CTRL+エンター、または、SHIFT+エンターですが、&lt;br&gt;と表示されてしまいます。
</blockquote>

<blockquote class="warn">
[URLリンク](https://itccorporation.jp/)などのMarkDown記法もできましたが、ヘッダー（# title）は、初期状態の場合、そのまま「# title」と表示されて、Markdownと認識させるために　管理→メッセージ→Markdown→「ヘッダーを有効にする」　の有効化が必要でした。</a> 
</blockquote>

 

## メンション機能

メッセージ欄に @ユーザ名 をつけると、対象のユーザにメッセージが来たことをメール等でおしらせする事ができます。※これを メンション 機能といいます。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image41.png) 

 

ユーザ名 メッセージ の表示になります。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image42.png) 

 

## 引用
 
メッセージを選択して、「引用」アイコンをクリックすると、新規メッセージの下に引用されたメッセージが表示されます。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image43.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image44.png) 
 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image45.png) 

 

## スレッド
 
メッセージを選択して、「スレッドで返信」アイコンをクリックすると、そのメッセージ関して、スレッドを作成して、議論できます。（そのメッセージに関するやり取りが起点メッセージのところでまとめられます。）

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image46.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image47.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image48.png) 

 

## ファイル送信
 
メッセージ入力欄の＋マークを選択します。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image53.png) 

 

ファイルを追加する から コンピューター　を選択します。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image57.png) 

 

ファイルを選択します。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image54.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image58.png) 

 

メッセージの下にファイル名、画像（.gif, .png, .jpg）の場合は、画像がそのまま表示されます。

<blockquote class="info">
.bmpは通常ファイル扱い。.svgは、エラーになりました。</a> 
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image55.png) 

 

画像をクリックすると、拡大表示されます。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image60.png) 

 

ファイル名の横にある、下矢印のアイコンを選択すると、ファイルのダウンロードが行えます。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image59.png) 

 

# アプリ

## Windows アプリ

<a href="https://github.com/RocketChat/Rocket.Chat.Electron/releases/" target="_blank">https://github.com/RocketChat/Rocket.Chat.Electron/releases/</a> から rocketchat-setup-3.1.1.exe をダウンロードしてインストールしてみました。 

 

最初にサーバーURLを入力します。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image61.png) 

 

メールアドレスまたはユーザー名、パスワードを入力してログインします。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image62.png) 

 

ログインできました。左側のアイコンは、サーバーが選択できるようです。（サーバーは上のファイルメニューで追加できます。）その他、上のメニュー以外ブラウザ画面とほぼ同一のインターフェイスのようです。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image63.png) 

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image64.png) 

 

アプリ版は、OSの通知がありました。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/image65.png) 

 

## Android アプリ

ようこその画面が正しく表示されないようでした。（日本語の取得に失敗している？） 
※バージョンは、4.16.1.23831 です。

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/Android01.png) 

 

構わず、青いボタンで先に進めると、また正しく表示されませんが、エラーメッセージから推測して、Rocket.ChatサーバーのURLを入力しました。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/Android02.png) 

 

エラーになり、先に進めず、今回は断念しました。

<blockquote class="warn">
エラー内容によると、http:// だからのようです。https:// にする必要があります。</a> 
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/Android03.png) 

 

## iOS アプリ

Android版同様、ようこその画面が正しく表示されないようでした。（日本語の取得に失敗している？） 
※バージョンは、4.16.1.23838 です。

 

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/iOS01.png) 

 

構わず、青いボタンで先に進めると、また正しく表示されませんが、エラーメッセージから推測して、Rocket.ChatサーバーのURLを入力しました。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/iOS02.png) 

 

ログイン画面まで進んでログインできました。

<blockquote class="info">
最初「ログイン」ボタンが反応しなかったのですが、もう一度起動したら反応しました。</a> 
</blockquote>

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/iOS03.png) 

 

通知機能が使えて、特に問題無さそうでした。

![](https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/using_rocketchat/iOS04.png)

CentOS-8.3 にインストールした Rocket.Chat-3.13.3 を少し使ってみました。少し使ってみただけで、マニュアルとかではありません。 Webブラウザの画面は、全てMicrosoft Edgeブラウザを使用しています。 初回管理者登録 管理者情報 管理者の名前、ユーザー名、メールアドレス、パスワードを入力します。 この画面で一番に登録した人が管理者です。 名前：表示名 ユーザー名：アカウントID の関係です。 ユーザー名は半角文字(英数字・ドット・マイナス)だけ使用可能です。 組織情報 自社で使う分には、入力内容は何でも良いと思います。

Rocket.Chatを使ってみた

SDDL形式(Security Descriptor Definition Language)のテキストファイルを作成するphpプログラムを作成し、大量のアクセス権を高速で付与することに成功しました。

icaclsとSDDLファイルを使って大量のアクセス権を高速で付与

WindowsのAD(Active Directory)は、LDAPのように、ツリー構造のデータベースで管理されています。そのため、OpenLDAPのldapsearchコマンドで中身を見られます。ldapsearch以外にもいろいろな方法で中身を見てみました。

[関連技術で絞り込み結果]