gitlab web UI って何？

# 概要
本ページでは、gitlab web UI の機能をさらっと説明します。

また、gitlab web UI には機能がたくさんあるので、
触っても問題ない機能（ボタン）　には :ok:（OK印）
触ったら危ない機能（ボタン）　には :red_circle:（赤丸）
のマークを付けています。

### 対象とする読者
+ **とりあえず gitlab web UI が何なのか知りたい人**
+ 非開発者で issue の利用や、ファイルを閲覧するのがメインな人
+ gitlab web UI の操作に慣れていない人
+ 英語を翻訳するのがめんどくさい人（特に自分）

### 扱わない話題
+ 各機能の詳細については扱いません
+ gitlab の CUI や API の操作方法については扱いません

### 環境制約
+ gitlab version：今回解説する gitlab の version は 14.4 です
+ プロジェクトによっては、今回紹介する機能の一部が、<br>
　設定によって非表示となっているものもあります。
  - 例えば CI/CD は、CI/CD の利用を許可していないと、項目自体が表示されません


# gitlab とは？
コードのバージョン管理機能である git のライブラリの一つ。
web UI が存在し、コードの閲覧や編集、管理が可能です、

また、issue というチケットのようなシステムがあり、
チケット管理システムとしても使えます。
※個人的には、Redmine よりも優秀だと思います

余り知られていませんが、実は他にも色々なことができます。

+ 自動テスト（CI/CD）の実施
+ 短文やファイルの連携用途に
+ 各環境への資材のリリース
+ 各環境のログの閲覧やアラート管理
+ 顧客からの不具合レポートを自動でチケット起票
+ 静的な web サーバとして…などなど


## gitlab 操作の基本方針
**知らない青いボタン、赤いボタン** は基本的には押さない。
**意味の分からないアイコン** も基本的には押さない。
これは大事です。

例えば、下図の右側の青ボタンは押してはダメです（ブランチ作成）。
左は分かりにくいですが、赤文字のボタンなので押さない様に（ブランチ自動削除）。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/568441/edb480b3-2583-454c-0cbc-bbdf1651b0ad.png)

また、下図のケースではゴミ箱のアイコンだけがあり、
ぱっと見は安全そうですが、中身はブランチの削除なので押したら危険です。
（左はダウンロードボタンなので安全）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/568441/0f7267f6-5ada-0459-23c4-bf5ac50bbe64.png)

仮に押してしまっても、
下図のように確認のウィンドウが出ますので、
ここでは Cancel を押しましょう。
**右側のボタンは赤いので押さない様に！**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/568441/021ef047-ee96-1850-aa28-733c4975ea95.png)


# とりあえず覚えておきたい用語
### プロジェクト（レポジトリ）
プロジェクトとは、gitlab におけるメインページの呼称です。

ツール毎、アプリケーション毎、など、
基本的には開発者が機能毎にプロジェクトを作りますが、
運用者が "マニュアル管理"、"障害管理" など
用途毎にプロジェクトを作ることもあります。

### サイドバー
gitlab web UI のプロジェクトを開くと
左側に下図の様なメニューが出てくると思います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/568441/dc3fdfc0-4479-64c5-2ef8-d6988c53699b.png)

これをサイドバーと呼び、
gitlab の作業は基本、ここから行います。


# 逆引き
※今後追加予定

## とりあえず機能をざっと把握したい
gitlab のメイン機能は、
UI の左にあるサイドバーにほぼ集約されています。

なので、ここの機能を覚えれば、
gitlab の大体の機能はざっと把握できます。
（あくまで "ざっと" です）

サイドバーの機能については、別ページにまとめていますので、
そちらを参照してください。

前編

https://qiita.com/hanzo-k/items/6d9a473c26dbaad51e02

後編

https://qiita.com/hanzo-k/items/94d0ec180dc51bfee05a


## 課題管理をしたい
gitlab の課題管理（チケット管理）は、
issue という機能を用いて行います。

Redmine などのチケット管理システムと似ており、
無駄な機能もなく、ほぼ遜色なく使えます。

また、gitlab 上のファイルや、
開発者の更新とも連動できるので、
テスト実施者が開発者に不具合報告する際にも便利です。

issue ページにはサイドバーから遷移できます。
簡単な説明は以下に記載しています。

https://qiita.com/hanzo-k/items/6d9a473c26dbaad51e02#issues-ok


## ファイルの内容を確認したい
gitlab の本来の目的はファイル管理（資材管理）です。

なので、基本的な gitlab のプロジェクトには、
開発者や運用者が格納したファイルがたくさん格納されています。

閲覧するだけなら無害なので、
開発者でなくてもファイルの確認やダウンロードができます。

ファイルの閲覧は、サイドバーの Repository > Files から遷移します。
簡単な説明は以下を参照ください。

https://qiita.com/hanzo-k/items/6d9a473c26dbaad51e02#files-ok


## プロジェクトの使い方や注意事項を書いておきたい
gitlab のプロジェクトを最初に開くと、
基本的にはファイルの一覧が表示されます。
そのページをスクロールしていくと、
下の方に READEME と呼ばれるプロジェクトの説明が表示されます。

このファイルを編集すると、
プロジェクトに関する説明などを書いておけます。

詳細な作り方は以下を参照してください。

https://qiita.com/hanzo-k/items/6f61fe5dd47296c4071a#readmemd


## 長いログやファイルを他のメンバーに共有したい
仕事をしていて、
端末の作業ログや、そこまで大きくないテキストファイルなどを
他のメンバーに共有したい、と思う機会は多いと思います。

gitlab の snippets という機能を使うと、
短文の連携や、小さいファイルの添付（連携）ができます。

詳しい使い方は以下を参照してください。

https://qiita.com/hanzo-k/items/6f61fe5dd47296c4071a#snippets


## wiki を書きたい
社内の wiki というと、CF や pukiwiki などを思い浮かべる方も多いかと思いますが、
gitlab でも wiki は書けます。

wiki の作成は、サイドバーの wiki から行います。

https://qiita.com/hanzo-k/items/94d0ec180dc51bfee05a#wiki-ok


## issue で一部の記号が勝手に変換されてしまう
例えばこんな内容を書きたい場合。

```
-    "mode": "0644",
+    "mode": "0755",
```

そのまま書いてしまうと

-    "mode": "0644",
+    "mode": "0755",

こんな感じで `+` や `-` が箇条書きに変換されてしまいます。

対策としては、マークダウン記法の
**インラインコード**か**コードブロック**を使います。

詳しくは以下を参照してください。

https://qiita.com/hanzo-k/items/6f61fe5dd47296c4071a#%E3%82%A4%E3%83%B3%E3%83%A9%E3%82%A4%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89-%E3%81%A8-%E3%82%B3%E3%83%BC%E3%83%89%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF