up doc

.obsidian/appearance.json

@@ -1,3 +1,3 @@
 {
-  "baseFontSize": 13
+  "baseFontSize": 24
 }

.obsidian/workspace

@@ -9,7 +9,7 @@
         "state": {
           "type": "markdown",
           "state": {
-            "file": "ubuntu/fdisk/linux 分区满了，如何进行扩容.md",
+            "file": "git/45 个 Git 操作场景，专治不会合代码.md",
             "mode": "source",
             "source": false
           }
@@ -69,7 +69,7 @@
             "state": {
               "type": "backlink",
               "state": {
-                "file": "ubuntu/fdisk/linux 分区满了，如何进行扩容.md",
+                "file": "git/45 个 Git 操作场景，专治不会合代码.md",
                 "collapseAll": false,
                 "extraContext": false,
                 "sortOrder": "alphabetical",
@@ -89,15 +89,15 @@
   },
   "active": "0a8ca340a6b98c99",
   "lastOpenFiles": [
-    "ubuntu/fdisk/linux 分区满了，如何进行扩容.md",
-    "ubuntu/fdisk/嵌入式开发之 Vmware 虚拟机磁盘扩容.md",
-    "ubuntu/fdisk/assets/Pasted image 20220623023724.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023412.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023642.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023436.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023455.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023512.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023520.png",
-    "ubuntu/fdisk/assets/Pasted image 20220623023529.png"
+    "git/45 个 Git 操作场景，专治不会合代码.md",
+    "git/GIt push失败.pdf",
+    "web/docker-compose一键部署蘑菇博客设置SSL证书.md",
+    "web/蘑菇博客设置SSL证书.md",
+    "web/assets/image-20220709181337201.png",
+    "web/assets/image-20220709181251481.png",
+    "web/assets/image-20220709183408851.png",
+    "web/assets/image-20220709183124753.png",
+    "未命名.assets/image-20220506232148429.png.md",
+    "spring-cloud/eureka/Eureka 自我保护机制、健康检查的作用、actuator 模块监控.md"
   ]
 }

git/45 个 Git 操作场景，专治不会合代码.md

@@ -0,0 +1,938 @@
+> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [mp.weixin.qq.com](https://mp.weixin.qq.com/s/nP15K6-_etSwgpBf1HFJKA)
+
+**大家好，我是磊哥。**
+
+**git** 对于大家应该都不太陌生，熟练使用 git 已经成为程序员的一项基本技能，尽管在工作中有诸如 `Sourcetree`这样牛 X 的客户端工具，使得合并代码变的很方便。但找工作面试和一些需彰显个人实力的场景，仍然需要我们掌握足够多的 git 命令。
+
+下边我们整理了 45 个日常用 git 合代码的经典操作场景，基本覆盖了工作中的需求。
+
+### 我刚才提交了什么?
+
+如果你用 `git commit -a` 提交了一次变化 (changes)，而你又不确定到底这次提交了哪些内容。你就可以用下面的命令显示当前 `HEAD`上的最近一次的提交 (commit):
+
+```sh
+(main)$ git show  
+```
+
+或者
+
+```sh
+$ git log -n1 -p  
+```
+
+### 我的提交信息 (commit message) 写错了
+
+如果你的提交信息 (`commit message`)写错了且这次提交 (commit) 还没有推(push), 你可以通过下面的方法来修改提交信息(`commit message`):
+
+```shell
+$ git commit --amend --only
+```
+
+这会打开你的默认编辑器, 在这里你可以编辑信息. 另一方面, 你也可以用一条命令一次完成:
+
+```shell
+$ git commit --amend --only -m 'xxxxxxx'  
+```
+
+如果你已经推 (push) 了这次提交 (commit), 你可以修改这次提交(commit) 然后强推(`force push`), 但是不推荐这么做。
+
+### 我提交 (commit) 里的用户名和邮箱不对
+
+如果这只是单个提交 (commit)，修改它：
+
+```shell
+$ git commit --amend --author "New Authorname <authoremail@mydomain.com>"  
+```
+
+如果你需要修改所有历史, 参考'git filter-branch'的指南页.
+
+### 我想从一个提交 (commit) 里移除一个文件
+
+通过下面的方法，从一个提交 (commit) 里移除一个文件:
+
+```shell
+$ git checkout HEAD^ myfile  
+$ git add -A  
+$ git commit --amend  
+```
+
+这将非常有用，当你有一个开放的补丁 (`open patch`)，你往上面提交了一个不必要的文件，你需要强推 (`force push`) 去更新这个远程补丁。
+
+### 我想删除我的的最后一次提交 (commit)
+
+如果你需要删除推了的提交 (`pushed commits`)，你可以使用下面的方法。可是，这会不可逆的改变你的历史，也会搞乱那些已经从该仓库拉取 (pulled) 了的人的历史。简而言之，如果你不是很确定，千万不要这么做。
+
+```shell
+$ git reset HEAD^ --hard  
+$ git push -f [remote] [branch]  
+```
+
+如果你还没有推到远程, 把 Git 重置 (reset) 到你最后一次提交前的状态就可以了(同时保存暂存的变化):
+
+```shell
+(my-branch*)$ git reset --soft HEAD@{1}  
+```
+
+这只能在没有推送之前有用. 如果你已经推了, 唯一安全能做的是 `git revert SHAofBadCommit`， 那会创建一个新的提交 (commit) 用于撤消前一个提交的所有变化(changes)；或者, 如果你推的这个分支是 rebase-safe 的 (例如：其它开发者不会从这个分支拉), 只需要使用 `git push -f`。
+
+### 删除任意提交 (commit)
+
+同样的警告：不到万不得已的时候不要这么做.
+
+```shell
+$ git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT  
+$ git push -f [remote] [branch]  
+```
+
+或者做一个 交互式 rebase 删除那些你想要删除的提交 (commit) 里所对应的行。
+
+### 我尝试推一个修正后的提交 (amended commit) 到远程，但是报错：
+
+```shell
+To https://github.com/yourusername/repo.git  
+! [rejected]        mybranch -> mybranch (non-fast-forward)  
+error: failed to push some refs to 'https://github.com/tanay1337/webmaker.org.git'  
+hint: Updates were rejected because the tip of your current branch is behind  
+hint: its remote counterpart. Integrate the remote changes (e.g.  
+hint: 'git pull ...') before pushing again.  
+hint: See the 'Note about fast-forwards' in 'git push --help' for details.  
+```
+
+注意, rebasing(见下面)和修正 (amending) 会用一个**新的提交 (commit) 代替旧的**, 所以如果之前你已经往远程仓库上推过一次修正前的提交 (commit)，那你现在就必须强推 (`force push`) (`-f`)。注意 – _总是_ 确保你指明一个分支!
+
+```shell
+(my-branch)$ git push origin mybranch -f
+```
+
+一般来说, **要避免强推**. 最好是创建和推 (push) 一个新的提交(commit)，而不是强推一个修正后的提交。后者会使那些与该分支或该分支的子分支工作的开发者，在源历史中产生冲突。
+
+### 我意外的做了一次硬重置 (hard reset)，我想找回我的内容
+
+如果你意外的做了 `git reset --hard`, 你通常能找回你的提交 (commit), 因为 Git 对每件事都会有日志，且都会保存几天。
+
+```sh
+(main)$ git reflog
+```
+
+你将会看到一个你过去提交 (commit) 的列表, 和一个重置的提交。选择你想要回到的提交 (commit) 的 SHA，再重置一次:
+
+```sh
+(main)$ git reset --hard SHA1234
+```
+
+这样就完成了。
+
+暂存 (Staging)
+--------------
+
+### 我需要把暂存的内容添加到上一次的提交 (commit)
+
+```sh
+(my-branch*)$ git commit --amend
+```
+
+### 我想要暂存一个新文件的一部分，而不是这个文件的全部
+
+一般来说, 如果你想暂存一个文件的一部分, 你可这样做:
+
+```sh
+$ git add --patch filename.x
+```
+
+`-p` 简写。这会打开交互模式， 你将能够用 `s` 选项来分隔提交 (commit)；然而, 如果这个文件是新的, 会没有这个选择， 添加一个新文件时, 这样做:
+
+```sh
+$ git add -N filename.x
+```
+
+然后, 你需要用 `e` 选项来手动选择需要添加的行，执行 `git diff --cached` 将会显示哪些行暂存了哪些行只是保存在本地了。
+
+### 我想把在一个文件里的变化 (changes) 加到两个提交 (commit) 里
+
+`git add` 会把整个文件加入到一个提交. `git add -p` 允许交互式的选择你想要提交的部分.
+
+### 我想把暂存的内容变成未暂存，把未暂存的内容暂存起来
+
+多数情况下，你应该将所有的内容变为未暂存，然后再选择你想要的内容进行 commit。但假定你就是想要这么做，这里你可以创建一个临时的 commit 来保存你已暂存的内容，然后暂存你的未暂存的内容并进行 stash。然后 reset 最后一个 commit 将原本暂存的内容变为未暂存，最后 stash pop 回来。
+
+```sh
+$ git commit -m "WIP"  
+$ git add .  
+$ git stash  
+$ git reset HEAD^  
+$ git stash pop --index 0
+```
+
+注意 1: 这里使用 `pop`仅仅是因为想尽可能保持幂等。注意 2: 假如你不加上 `--index`你会把暂存的文件标记为为存储。
+
+未暂存 (Unstaged) 的内容
+------------------------
+
+### 我想把未暂存的内容移动到一个新分支
+
+```sh
+$ git checkout -b my-branch
+```
+
+### 我想把未暂存的内容移动到另一个已存在的分支
+
+```sh
+$ git stash  
+$ git checkout my-branch  
+$ git stash pop
+```
+
+### 我想丢弃本地未提交的变化 (uncommitted changes)
+
+如果你只是想重置源 (origin) 和你本地 (local) 之间的一些提交(commit)，你可以：
+
+```sh
+# one commit  
+(my-branch)$ git reset --hard HEAD^  
+# two commits  
+(my-branch)$ git reset --hard HEAD^^  
+# four commits  
+(my-branch)$ git reset --hard HEAD~4  
+# or  
+(main)$ git checkout -f
+```
+
+重置某个特殊的文件, 你可以用文件名做为参数:
+
+```sh
+$ git reset filename
+```
+
+### 我想丢弃某些未暂存的内容
+
+如果你想丢弃工作拷贝中的一部分内容，而不是全部。
+
+签出 (checkout) 不需要的内容，保留需要的。
+
+```sh
+$ git checkout -p  
+# Answer y to all of the snippets you want to drop
+```
+
+另外一个方法是使用 `stash`， Stash 所有要保留下的内容, 重置工作拷贝, 重新应用保留的部分。
+
+```sh
+$ git stash -p  
+# Select all of the snippets you want to save  
+$ git reset --hard  
+$ git stash pop
+```
+
+或者, stash 你不需要的部分, 然后 stash drop。
+
+```sh
+$ git stash -p  
+# Select all of the snippets you don't want to save  
+$ git stash drop
+```
+
+分支 (Branches)
+---------------
+
+### 我从错误的分支拉取了内容，或把内容拉取到了错误的分支
+
+这是另外一种使用 `git reflog` 情况，找到在这次错误拉 (pull) 之前 HEAD 的指向。
+
+```sh
+(main)$ git reflog  
+ab7555f HEAD@{0}: pull origin wrong-branch: Fast-forward  
+c5bc55a HEAD@{1}: checkout: checkout message goes here
+```
+
+重置分支到你所需的提交 (desired commit):
+
+```sh
+$ git reset --hard c5bc55a
+```
+
+完成。
+
+### 我想扔掉本地的提交 (commit)，以便我的分支与远程的保持一致
+
+先确认你没有推 (push) 你的内容到远程。
+
+`git status` 会显示你领先 (ahead) 源(origin)多少个提交:
+
+```sh
+(my-branch)$ git status  
+# On branch my-branch  
+# Your branch is ahead of 'origin/my-branch' by 2 commits.  
+#   (use "git push" to publish your local commits)
+```
+
+一种方法是:
+
+```sh
+(main)$ git reset --hard origin/my-branch
+```
+
+### 我需要提交到一个新分支，但错误的提交到了 main
+
+在 main 下创建一个新分支，不切换到新分支, 仍在 main 下:
+
+```sh
+(main)$ git branch my-branch
+```
+
+把 main 分支重置到前一个提交:
+
+```sh
+(main)$ git reset --hard HEAD^
+```
+
+`HEAD^` 是 `HEAD^1` 的简写，你可以通过指定要设置的 `HEAD`来进一步重置。
+
+或者, 如果你不想使用 `HEAD^`, 找到你想重置到的提交 (commit) 的 hash(`git log` 能够完成)， 然后重置到这个 hash。使用 `git push` 同步内容到远程。
+
+例如, main 分支想重置到的提交的 hash 为 `a13b85e`:
+
+```sh
+(main)$ git reset --hard a13b85e  
+HEAD is now at a13b85e
+```
+
+签出 (checkout) 刚才新建的分支继续工作:
+
+```sh
+(main)$ git checkout my-branch
+```
+
+### 我想保留来自另外一个 ref-ish 的整个文件
+
+假设你正在做一个原型方案 (原文为 working spike (see note)), 有成百的内容，每个都工作得很好。现在, 你提交到了一个分支，保存工作内容:
+
+```sh
+(solution)$ git add -A && git commit -m "Adding all changes from this spike into one big commit."
+```
+
+当你想要把它放到一个分支里 (可能是 `feature`, 或者 `develop`), 你关心是保持整个文件的完整，你想要一个大的提交分隔成比较小。
+
+假设你有:
+
+* 分支 solution, 拥有原型方案， 领先 develop 分支。
+* 分支 develop, 在这里你应用原型方案的一些内容。
+
+我去可以通过把内容拿到你的分支里，来解决这个问题:
+
+```sh
+(develop)$ git checkout solution -- file1.txt
+```
+
+这会把这个文件内容从分支 `solution` 拿到分支 `develop` 里来:
+
+```sh
+# On branch develop  
+# Your branch is up-to-date with 'origin/develop'.  
+# Changes to be committed:  
+#  (use "git reset HEAD <file>..." to unstage)  
+#  
+#        modified:   file1.txt
+```
+
+然后, 正常提交。
+
+> Note: Spike solutions are made to analyze or solve the problem. These solutions are used for estimation and discarded once everyone gets clear visualization of the problem.
+
+### 我把几个提交 (commit) 提交到了同一个分支，而这些提交应该分布在不同的分支里
+
+假设你有一个 `main`分支， 执行 `git log`, 你看到你做过两次提交:
+
+```sh
+(main)$ git log  
+  
+commit e3851e817c451cc36f2e6f3049db528415e3c114  
+Author: Alex Lee <alexlee@example.com>  
+Date:   Tue Jul 22 15:39:27 2014 -0400  
+  
+    Bug #21 - Added CSRF protection  
+  
+commit 5ea51731d150f7ddc4a365437931cd8be3bf3131  
+Author: Alex Lee <alexlee@example.com>  
+Date:   Tue Jul 22 15:39:12 2014 -0400  
+  
+    Bug #14 - Fixed spacing on title  
+  
+commit a13b85e984171c6e2a1729bb061994525f626d14  
+Author: Aki Rose <akirose@example.com>  
+Date:   Tue Jul 21 01:12:48 2014 -0400  
+  
+    First commit
+```
+
+让我们用提交 hash(commit hash) 标记 bug (e3851e8 for #21, 5ea5173 for #14).
+
+首先, 我们把 `main`分支重置到正确的提交 (`a13b85e`):
+
+```sh
+(main)$ git reset --hard a13b85e  
+HEAD is now at a13b85e
+```
+
+现在, 我们对 bug21 创建一个新的分支:
+
+```sh
+(main)$ git checkout -b 21  
+(21)$
+```
+
+接着, 我们用\_cherry-pick\_把对 bug21 的提交放入当前分支。这意味着我们将应用 (apply) 这个提交(commit)，仅仅这一个提交(commit)，直接在 HEAD 上面。
+
+```sh
+(21)$ git cherry-pick e3851e8
+```
+
+这时候, 这里可能会产生冲突， 参见交互式 rebasing 章 **冲突节** 解决冲突.
+
+再者， 我们为 bug #14 创建一个新的分支, 也基于 main 分支
+
+```sh
+(21)$ git checkout main  
+(main)$ git checkout -b 14  
+(14)$
+```
+
+最后, 为 bug #14 执行 cherry-pick:
+
+```sh
+(14)$ git cherry-pick 5ea5173
+```
+
+### 我想删除上游 (upstream) 分支被删除了的本地分支
+
+一旦你在 github 上面合并 (merge) 了一个 `pull request`, 你就可以删除你 fork 里被合并的分支。如果你不准备继续在这个分支里工作, 删除这个分支的本地拷贝会更干净，使你不会陷入工作分支和一堆陈旧分支的混乱之中。
+
+```sh
+$ git fetch -p
+```
+
+### 我不小心删除了我的分支
+
+如果你定期推送到远程, 多数情况下应该是安全的，但有些时候还是可能删除了还没有推到远程的分支。让我们先创建一个分支和一个新的文件:
+
+```sh
+(main)$ git checkout -b my-branch  
+(my-branch)$ git branch  
+(my-branch)$ touch foo.txt  
+(my-branch)$ ls  
+README.md foo.txt
+```
+
+添加文件并做一次提交
+
+```sh
+(my-branch)$ git add .  
+(my-branch)$ git commit -m 'foo.txt added'  
+(my-branch)$ foo.txt added  
+ 1 files changed, 1 insertions(+)  
+ create mode 100644 foo.txt  
+(my-branch)$ git log  
+  
+commit 4e3cd85a670ced7cc17a2b5d8d3d809ac88d5012  
+Author: siemiatj <siemiatj@example.com>  
+Date:   Wed Jul 30 00:34:10 2014 +0200  
+  
+    foo.txt added  
+  
+commit 69204cdf0acbab201619d95ad8295928e7f411d5  
+Author: Kate Hudson <katehudson@example.com>  
+Date:   Tue Jul 29 13:14:46 2014 -0400  
+  
+    Fixes #6: Force pushing after amending commits
+```
+
+现在我们切回到主 (main) 分支，‘不小心的’删除 `my-branch`分支
+
+```sh
+(my-branch)$ git checkout main  
+Switched to branch 'main'  
+Your branch is up-to-date with 'origin/main'.  
+(main)$ git branch -D my-branch  
+Deleted branch my-branch (was 4e3cd85).  
+(main)$ echo oh noes, deleted my branch!  
+oh noes, deleted my branch!
+```
+
+在这时候你应该想起了 `reflog`, 一个升级版的日志，它存储了仓库 (repo) 里面所有动作的历史。
+
+```sh
+(main)$ git reflog  
+69204cd HEAD@{0}: checkout: moving from my-branch to main  
+4e3cd85 HEAD@{1}: commit: foo.txt added  
+69204cd HEAD@{2}: checkout: moving from main to my-branch
+```
+
+正如你所见，我们有一个来自删除分支的提交 hash(commit hash)，接下来看看是否能恢复删除了的分支。
+
+```sh
+(main)$ git checkout -b my-branch-help  
+Switched to a new branch 'my-branch-help'  
+(my-branch-help)$ git reset --hard 4e3cd85  
+HEAD is now at 4e3cd85 foo.txt added  
+(my-branch-help)$ ls  
+README.md foo.txt
+```
+
+看! 我们把删除的文件找回来了。Git 的 `reflog` 在 rebasing 出错的时候也是同样有用的。
+
+### 我想删除一个分支
+
+删除一个远程分支:
+
+```sh
+(main)$ git push origin --delete my-branch
+```
+
+你也可以:
+
+```sh
+(main)$ git push origin :my-branch
+```
+
+删除一个本地分支:
+
+```sh
+(main)$ git branch -D my-branch
+```
+
+### 我想从别人正在工作的远程分支签出 (checkout) 一个分支
+
+首先, 从远程拉取 (fetch) 所有分支:
+
+```sh
+(main)$ git fetch --all
+```
+
+假设你想要从远程的 `daves`分支签出到本地的 `daves`
+
+```sh
+(main)$ git checkout --track origin/daves  
+Branch daves set up to track remote branch daves from origin.  
+Switched to a new branch 'daves'
+```
+
+(`--track` 是 `git checkout -b [branch] [remotename]/[branch]` 的简写)
+
+这样就得到了一个 `daves`分支的本地拷贝, 任何推过 (pushed) 的更新，远程都能看到.
+
+Rebasing 和合并 (Merging)
+-------------------------
+
+### 我想撤销 rebase/merge
+
+你可以合并 (merge) 或 rebase 了一个错误的分支, 或者完成不了一个进行中的 rebase/merge。Git 在进行危险操作的时候会把原始的 HEAD 保存在一个叫 ORIG\_HEAD 的变量里, 所以要把分支恢复到 rebase/merge 前的状态是很容易的。
+
+```sh
+(my-branch)$ git reset --hard ORIG_HEAD
+```
+
+### 我已经 rebase 过, 但是我不想强推 (force push)
+
+不幸的是，如果你想把这些变化 (changes) 反应到远程分支上，你就必须得强推(`force push`)。是因你快进 (`Fast forward`) 了提交，改变了 Git 历史, 远程分支不会接受变化 (changes)，除非强推 (force push)。
+
+这就是许多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一， 开发者的强推 (force push) 会使大的团队陷入麻烦。使用时需要注意，一种安全使用 rebase 的方法是，不要把你的变化 (changes) 反映到远程分支上, 而是按下面的做:
+
+```sh
+(main)$ git checkout my-branch  
+(my-branch)$ git rebase -i main  
+(my-branch)$ git checkout main  
+(main)$ git merge --ff-only my-branch
+```
+
+### 我需要组合 (combine) 几个提交(commit)
+
+假设你的工作分支将会做对于 `main` 的 pull-request。一般情况下你不关心提交 (commit) 的时间戳，只想组合 **所有** 提交 (commit) 到一个单独的里面, 然后重置(reset) 重提交 (recommit)。确保主(main) 分支是最新的和你的变化都已经提交了, 然后:
+
+```sh
+(my-branch)$ git reset --soft main  
+(my-branch)$ git commit -am "New awesome feature"
+```
+
+如果你想要更多的控制, 想要保留时间戳, 你需要做交互式 rebase (interactive rebase):
+
+```sh
+(my-branch)$ git rebase -i main
+```
+
+如果没有相对的其它分支， 你将不得不相对自己的 `HEAD` 进行 rebase。例如：你想组合最近的两次提交 (commit), 你将相对于 `HEAD~2` 进行 rebase， 组合最近 3 次提交 (commit), 相对于 `HEAD~3`, 等等。
+
+```sh
+(main)$ git rebase -i HEAD~2
+```
+
+在你执行了交互式 rebase 的命令 (interactive rebase command) 后, 你将在你的编辑器里看到类似下面的内容:
+
+```sh
+pick a9c8a1d Some refactoring  
+pick 01b2fd8 New awesome feature  
+pick b729ad5 fixup  
+pick e3851e8 another fix  
+  
+# Rebase 8074d12..b729ad5 onto 8074d12  
+#  
+# Commands:  
+#  p, pick = use commit  
+#  r, reword = use commit, but edit the commit message  
+#  e, edit = use commit, but stop for amending  
+#  s, squash = use commit, but meld into previous commit  
+#  f, fixup = like "squash", but discard this commit's log message  
+#  x, exec = run command (the rest of the line) using shell  
+#  
+# These lines can be re-ordered; they are executed from top to bottom.  
+#  
+# If you remove a line here THAT COMMIT WILL BE LOST.  
+#  
+# However, if you remove everything, the rebase will be aborted.  
+#  
+# Note that empty commits are commented out
+```
+
+所有以 开头的行都是注释, 不会影响 rebase.
+
+然后，你可以用任何上面命令列表的命令替换 `pick`, 你也可以通过删除对应的行来删除一个提交 (commit)。
+
+例如, 如果你想 **单独保留最旧 (first) 的提交(commit), 组合所有剩下的到第二个里面**, 你就应该编辑第二个提交 (commit) 后面的每个提交(commit) 前的单词为 `f`:
+
+```sh
+pick a9c8a1d Some refactoring  
+pick 01b2fd8 New awesome feature  
+f b729ad5 fixup  
+f e3851e8 another fix
+```
+
+如果你想组合这些提交 (commit) **并重命名这个提交 (commit)**, 你应该在第二个提交 (commit) 旁边添加一个 `r`，或者更简单的用 `s` 替代 `f`:
+
+```sh
+pick a9c8a1d Some refactoring  
+pick 01b2fd8 New awesome feature  
+s b729ad5 fixup  
+s e3851e8 another fix
+```
+
+你可以在接下来弹出的文本提示框里重命名提交 (commit)。
+
+```sh
+Newer, awesomer features  
+  
+# Please enter the commit message for your changes. Lines starting  
+# with '#' will be ignored, and an empty message aborts the commit.  
+# rebase in progress; onto 8074d12  
+# You are currently editing a commit while rebasing branch 'main' on '8074d12'.  
+#  
+# Changes to be committed:  
+# modified:   README.md
+```
+
+如果成功了, 你应该看到类似下面的内容:
+
+```sh
+(main)$ Successfully rebased and updated refs/heads/main.
+```
+
+#### 安全合并 (merging) 策略
+
+`--no-commit` 执行合并 (merge) 但不自动提交, 给用户在做提交前检查和修改的机会。`no-ff` 会为特性分支 (feature branch) 的存在过留下证据, 保持项目历史一致。
+
+```sh
+(main)$ git merge --no-ff --no-commit my-branch
+```
+
+#### 我需要将一个分支合并成一个提交 (commit)
+
+```sh
+(main)$ git merge --squash my-branch
+```
+
+#### 我只想组合 (combine) 未推的提交(unpushed commit)
+
+有时候，在将数据推向上游之前，你有几个正在进行的工作提交 (commit)。这时候不希望把已经推(push) 过的组合进来，因为其他人可能已经有提交 (commit) 引用它们了。
+
+```sh
+(main)$ git rebase -i @{u}
+```
+
+这会产生一次交互式的 rebase(interactive rebase), 只会列出没有推 (push) 的提交(commit)， 在这个列表时进行 reorder/fix/squash 都是安全的。
+
+### 检查是否分支上的所有提交 (commit) 都合并 (merge) 过了
+
+检查一个分支上的所有提交 (commit) 是否都已经合并 (merge) 到了其它分支, 你应该在这些分支的 head(或任何 commits)之间做一次 diff:
+
+```sh
+(main)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll
+```
+
+这会告诉你在一个分支里有而另一个分支没有的所有提交 (commit), 和分支之间不共享的提交(commit) 的列表。另一个做法可以是:
+
+```sh
+(main)$ git log main ^feature/120-on-scroll --no-merges
+```
+
+### 交互式 rebase(interactive rebase) 可能出现的问题
+
+#### 这个 rebase 编辑屏幕出现'noop'
+
+如果你看到的是这样:
+
+```sh
+noop
+```
+
+这意味着你 rebase 的分支和当前分支在同一个提交 (commit) 上, 或者 _领先 (ahead)_ 当前分支。你可以尝试:
+
+* 检查确保主 (main) 分支没有问题
+* rebase HEAD~2 或者更早
+
+#### 有冲突的情况
+
+如果你不能成功的完成 rebase, 你可能必须要解决冲突。
+
+首先执行 `git status` 找出哪些文件有冲突:
+
+```sh
+(my-branch)$ git status  
+On branch my-branch  
+Changes not staged for commit:  
+  (use "git add <file>..." to update what will be committed)  
+  (use "git checkout -- <file>..." to discard changes in working directory)  
+  
+ modified:   README.md
+```
+
+在这个例子里面, `README.md` 有冲突。打开这个文件找到类似下面的内容:
+
+```sh
+ <<<<<<< HEAD  
+   some code  
+   =========  
+   some code  
+   >>>>>>> new-commit
+```
+
+你需要解决新提交的代码 (示例里, 从中间 `==`线到 `new-commit`的地方) 与 `HEAD` 之间不一样的地方.
+
+有时候这些合并非常复杂，你应该使用可视化的差异编辑器 (visual diff editor):
+
+```sh
+(main*)$ git mergetool -t opendiff
+```
+
+在你解决完所有冲突和测试过后, `git add` 变化了的 (changed) 文件, 然后用 `git rebase --continue` 继续 rebase。
+
+```sh
+(my-branch)$ git add README.md  
+(my-branch)$ git rebase --continue
+```
+
+如果在解决完所有的冲突过后，得到了与提交前一样的结果, 可以执行 `git rebase --skip`。
+
+任何时候你想结束整个 rebase 过程，回来 rebase 前的分支状态, 你可以做:
+
+```sh
+(my-branch)$ git rebase --abort
+```
+
+Stash
+-----
+
+### 暂存所有改动
+
+暂存你工作目录下的所有改动
+
+```sh
+$ git stash
+```
+
+你可以使用 `-u`来排除一些文件
+
+```sh
+$ git stash -u
+```
+
+### 暂存指定文件
+
+假设你只想暂存某一个文件
+
+```sh
+$ git stash push working-directory-path/filename.ext
+```
+
+假设你想暂存多个文件
+
+```sh
+$ git stash push working-directory-path/filename1.ext working-directory-path/filename2.ext
+```
+
+### 暂存时记录消息
+
+这样你可以在 `list`时看到它
+
+```sh
+$ git stash save <message>
+```
+
+或
+
+```sh
+$ git stash push -m <message>
+```
+
+### 使用某个指定暂存
+
+首先你可以查看你的 `stash`记录
+
+```sh
+$ git stash list
+```
+
+然后你可以 `apply`某个 `stash`
+
+```sh
+$ git stash apply "stash@{n}"
+```
+
+此处，'n'是 `stash`在栈中的位置，最上层的 `stash`会是 0
+
+除此之外，也可以使用时间标记 (假如你能记得的话)。
+
+```sh
+$ git stash apply "stash@{2.hours.ago}"
+```
+
+### 暂存时保留未暂存的内容
+
+你需要手动 create 一个 `stash commit`， 然后使用 `git stash store`。
+
+```sh
+$ git stash create  
+$ git stash store -m "commit-message" CREATED_SHA1
+```
+
+杂项 (Miscellaneous Objects)
+----------------------------
+
+### 克隆所有子模块
+
+```sh
+$ git clone --recursive git://github.com/foo/bar.git
+```
+
+如果已经克隆了:
+
+```sh
+$ git submodule update --init --recursive
+```
+
+### 删除标签 (tag)
+
+```sh
+$ git tag -d <tag_name>  
+$ git push <remote> :refs/tags/<tag_name>
+```
+
+### 恢复已删除标签 (tag)
+
+如果你想恢复一个已删除标签 (tag), 可以按照下面的步骤: 首先, 需要找到无法访问的标签 (unreachable tag):
+
+```sh
+$ git fsck --unreachable | grep tag
+```
+
+记下这个标签 (tag) 的 hash，然后用 Git 的 update-ref
+
+```sh
+$ git update-ref refs/tags/<tag_name> <hash>
+```
+
+这时你的标签 (tag) 应该已经恢复了。
+
+### 已删除补丁 (patch)
+
+如果某人在 GitHub 上给你发了一个 `pull request`, 但是然后他删除了他自己的原始 fork, 你将没法克隆他们的提交 (commit) 或使用 `git am`。在这种情况下, 最好手动的查看他们的提交 (commit)，并把它们拷贝到一个本地新分支，然后做提交。
+
+做完提交后, 再修改作者，参见变更作者。然后, 应用变化, 再发起一个新的 `pull request`。
+
+跟踪文件 (Tracking Files)
+-------------------------
+
+### 我只想改变一个文件名字的大小写，而不修改内容
+
+```sh
+(main)$ git mv --force myfile MyFile
+```
+
+### 我想从 Git 删除一个文件，但保留该文件
+
+```sh
+(main)$ git rm --cached log.txt
+```
+
+配置 (Configuration)
+--------------------
+
+### 我想给一些 Git 命令添加别名 (alias)
+
+在 OS X 和 Linux 下, 你的 Git 的配置文件储存在 `~/.gitconfig`。我在 `[alias]` 部分添加了一些快捷别名 (和一些我容易拼写错误的)，如下:
+
+```sh
+[alias]  
+    a = add  
+    amend = commit --amend  
+    c = commit  
+    ca = commit --amend  
+    ci = commit -a  
+    co = checkout  
+    d = diff  
+    dc = diff --changed  
+    ds = diff --staged  
+    f = fetch  
+    loll = log --graph --decorate --pretty=oneline --abbrev-commit  
+    m = merge  
+    one = log --pretty=oneline  
+    outstanding = rebase -i @{u}  
+    s = status  
+    unpushed = log @{u}  
+    wc = whatchanged  
+    wip = rebase -i @{u}  
+    zap = fetch -p
+```
+
+### 我想缓存一个仓库 (repository) 的用户名和密码
+
+你可能有一个仓库需要授权，这时你可以缓存用户名和密码，而不用每次推 / 拉 (push/pull) 的时候都输入，Credential helper 能帮你。
+
+```sh
+$ git config --global credential.helper cache  
+# Set git to use the credential memory cache
+```
+
+```sh
+$ git config --global credential.helper 'cache --timeout=3600'  
+# Set the cache to timeout after 1 hour (setting is in seconds)
+```
+
+### 我不知道我做错了些什么
+
+你把事情搞砸了：你 `重置(reset)` 了一些东西, 或者你合并了错误的分支, 亦或你强推了后找不到你自己的提交 (commit) 了。有些时候, 你一直都做得很好, 但你想回到以前的某个状态。
+
+这就是 `git reflog` 的目的， `reflog` 记录对分支顶端 (the tip of a branch) 的任何改变, 即使那个顶端没有被任何分支或标签引用。基本上, 每次 HEAD 的改变, 一条新的记录就会增加到 `reflog`。遗憾的是，这只对本地分支起作用，且它只跟踪动作 (例如，不会跟踪一个没有被记录的文件的任何改变)。
+
+```sh
+(main)$ git reflog  
+0a2e358 HEAD@{0}: reset: moving to HEAD~2  
+0254ea7 HEAD@{1}: checkout: moving from 2.2 to main  
+c10f740 HEAD@{2}: checkout: moving from main to 2.2
+```
+
+上面的 reflog 展示了从 main 分支签出 (checkout) 到 2.2 分支，然后再签回。那里，还有一个硬重置 (hard reset) 到一个较旧的提交。最新的动作出现在最上面以 `HEAD@{0}`标识.
+
+如果事实证明你不小心回移 (move back) 了提交(commit), reflog 会包含你不小心回移前 main 上指向的提交(0254ea7)。
+
+```sh
+$ git reset --hard 0254ea7
+```
+
+然后使用 `git reset`就可以把 main 改回到之前的 commit，这提供了一个在历史被意外更改情况下的安全网。

java/jdk8/Lambda.md

@@ -1,12 +1,14 @@
 ## Lambda 表达式-函数式编程
 
-#### 介绍
+[TOC]
+
+### 介绍
 
 + 只有是函数式的接口才可以使用lambda表达式
 + 接口中有且只有一个抽象方法的接口称为函数式接口
 + @FunctionalInterface 注解强制检测是否为函数式接口
 
-#### 用法
+### 用法
 
 + 无参数，无返回值：()-> 具体实现
 + 有一个参数，无返回值：（x）-> 具体实现
@@ -14,111 +16,108 @@
 + 若有多个参数，多条语句，加个大括号就行了：（x,y）-> { 具体实现 }
 + 若 lambda 中只有一条语句，return 和大括号都可以省略不写，如`Comparator<Integer>com = (x,y) -> Integer.compare(x,y)`
 
-#### 四大内置函数式接口
+### 四大内置函数式接口
 
-|           接口           |       语法        |
-| :----------------------: | :---------------: |
-|  Consumer<T> 消费型接口  | void accept(T t)  |
-|  Supplier<T> 供给型接口  |      T get()      |
-| Function<T,R> 函数型接口 |   R apply(T t)    |
-| Predicate<T> 断言型接口  | boolean test(T t) |
+|             接口              |       语法        |
+| :---------------------------: | :---------------: |
+| Consumer&lt;T&gt; 消费型接口  | void accept(T t)  |
+| Supplier&lt;T&gt; 供给型接口  |      T get()      |
+|   Function<T,R> 函数型接口    |   R apply(T t)    |
+| Predicate&lt;T&gt; 断言型接口 | boolean test(T t) |
 
-+ ##### Consumer
+### 案例演示
 
-  + ##### 实例
+#### Consumer
 
-  ```java
-  String name = "大山";
-  private void consumer(Consumer<String> consumer){
-      consumer.accept(name);
-  }
-  
-  @Test
-  public void test1(){
-      consumer((name)-> System.out.println("我的名字:"+name));
-      // 若只有一个参数，小括号可以省略不写：x -> 具体实现
-      consumer(name-> System.out.println("他的名字:"+name));
-  }
-  ```
++ ##### 示例
 
-  + ##### 输出内容
+```java
+String name = "大山";
+private void consumer(Consumer<String> consumer){
+    consumer.accept(name);
+}
 
-  ```
-  我的名字:大山
-  他的名字:大山
-  ```
+@Test
+public void test1(){
+    consumer((name)-> System.out.println("我的名字:"+name));
+    // 若只有一个参数，小括号可以省略不写：x -> 具体实现
+    consumer(name-> System.out.println("他的名字:"+name));
+}
+```
 
-+ ##### Supplier
++ ##### 输出内容
 
-  + ##### 实例
+```
+我的名字:大山
+他的名字:大山
+```
 
-  ```java
-  private void supplier(Supplier<Integer> supplier){
-  	System.out.println("今日生产数量:"+supplier.get());
-  }
-  
-  @Test
-  public void test2(){
-  	supplier(()-> {return 123;});
-  	// 若 lambda 中只有一条语句，return 和大括号都可以省略不写，如`Comparator<Integer>com = (x,y) -> 			Integer.compare(x,y)`
-  	supplier(()-> 150);
-  }
-  ```
+#### Supplier
 
-  + ##### 输出内容
++ ##### 示例
 
-  ```sh
-  今日生产数量:123
-  今日生产数量:150
-  ```
+```java
+private void supplier(Supplier<Integer> supplier){
+	System.out.println("今日生产数量:"+supplier.get());
+}
 
-  
+@Test
+public void test2(){
+	supplier(()-> {return 123;});
+	// 若 lambda 中只有一条语句，return 和大括号都可以省略不写，如`Comparator<Integer>com = (x,y) -> 			Integer.compare(x,y)`
+	supplier(()-> 150);
+}
+```
 
-+ ##### Function
++ ##### 输出内容
 
-  + ##### 实例
+```sh
+今日生产数量:123
+今日生产数量:150
+```
 
-  ```java
-  private void function(String num,Function<String,Integer> function){
-  	System.out.println("生产数量："+(function.apply(num)+100));
-  }
-  
-  @Test
-  public void test3(){
-  	function("200",num-> Integer.parseInt(num));
-  }
-  ```
+#### Function
 
-  + ##### 输出内容
++ ##### 示例
 
-  ```
-  生产数量：300
-  生产数量：120
-  ```
+```java
+private void function(String num,Function<String,Integer> function){
+	System.out.println("生产数量："+(function.apply(num)+100));
+}
 
-  
+@Test
+public void test3(){
+	function("200",num-> Integer.parseInt(num));
+}
+```
 
-+ ##### Predicate
++ ##### 输出内容
 
-  + 实例
+```
+生产数量：300
+生产数量：120
+```
 
-  ```java
-  private void predicate(Integer age,Predicate<Integer> predicate){
-      System.out.println("我今年成年了吗:"+predicate.test(age));
-  }
-  
-  @Test
-  public void test4(){
-      predicate(15,age->age>=18);
-      predicate(23,age->age>=18);
-  }
-  ```
+#### Predicate
 
-  + ##### 输出内容
++ ##### 示例
 
-  ```
-  我今年成年了吗:false
-  我今年成年了吗:true
-  ```
+```java
+private void predicate(Integer age,Predicate<Integer> predicate){
+    System.out.println("我今年成年了吗:"+predicate.test(age));
+}
+
+@Test
+public void test4(){
+    predicate(15,age->age>=18);
+    predicate(23,age->age>=18);
+}
+```
+
++ ##### 输出内容
+
+```
+我今年成年了吗:false
+我今年成年了吗:true
+```
 
-  

java/jdk8/方法引用.md

@@ -1,10 +1,14 @@
 ## 方法引用
 
-#### 介绍
+[TOC]
+
+### 介绍
+
++ 熟悉lambda表达式才可以进行本章学习
 
 + 若 **lambda体** 中的内容有方法已经实现了，我们可以使用 “方法引用” （可以理解为方法引用是 lambda 表达式的另外一种表现形式）
 
-#### 用法
+### 用法
 
 + 通过对象名引用成员方法 对象 :: 成员方法名
 + 通过类名访问静态方法 类 :: 静态方法名
@@ -13,90 +17,213 @@
 + 构造器引用 类名 :: new 
 + 数组引用 Type[] :: new 
 
-#### 实例
+### 案例演示
 
-+ ##### 对象 :: 成员方法名
+#### 对象 :: 成员方法名
 
-  + ##### 实例
++ ##### 示例
 
-  ```java
-  
-  ```
+```java
+public class TestA{
+    private void consumer(String name,Consumer<String> consumer){
+        consumer.accept(name);
+    }
 
-  + ##### 输出内容
+    @Test
+    public void test5(){
+        FunctionRef functionRef = new FunctionRef();
 
-  ```
-  
-  ```
+        consumer("大山",functionRef::outName);
+        consumer("小红",functionRef::outName);
 
-  
+    }
+}
 
-+ ##### 类 :: 静态方法名
+class FunctionRef{
 
-  + ##### 实例
+    public void outName(String name){
+        System.out.println("名字:"+name);
+    }
 
-  ```java
-  
-  ```
+}
+```
 
-  + ##### 输出内容
++ ##### 输出内容
 
-  ```
-  
-  ```
+```
+名字:大山
+名字:小红
+```
 
-+ ##### super :: 成员方法名
+#### 类 :: 静态方法名
 
-  + ##### 实例
++ ##### 示例
 
-  ```java
-  
-  ```
+```java
+public class TestA{
+    private void consumer(String name,Consumer<String> consumer){
+        consumer.accept(name);
+    }
 
-  + ##### 输出内容
+    @Test
+    public void test6(){
+        consumer("大山",FunctionRef::staticOutName);
+        consumer("小红",FunctionRef::staticOutName);
+    }
+}
+class FunctionRef{
+    public static void staticOutName(String name){
+        System.out.println("名字:"+name);
+    }
+}
+```
 
-  ```
-  
-  ```
++ ##### 输出内容
 
-+ ##### this :: 成员方法名
+```
+名字:大山
+名字:小红
+```
 
-  + ##### 实例
+#### super :: 成员方法名
 
-  ```java
-  
-  ```
++ ##### 示例
 
-  + ##### 输出内容
+```java
+public class TestA extends FunctionRef{
+    private void consumer2(String str,Consumer<String> consumer){
+        consumer.accept(str);
+    }
 
-  ```
-  
-  ```
+    @Test
+    public void test7(){
+        consumer("  大山   ",super::trim);
+        consumer("  小红   ",super::trim);
+    }
+}
+class FunctionRef{
+	public void trim(String str){
+        System.out.println(str.trim());
+    }
+}
+```
 
-+ ##### 类名 :: new 
++ ##### 输出内容
 
-  + ##### 实例
+```
+大山
+小红
+```
 
-  ```java
-  
-  ```
+#### this :: 成员方法名
 
-  + ##### 输出内容
++ ##### 示例
 
-  ```
-  
-  ```
+```java
+public class TestA{
+    public void trim(String str){
+        System.out.println(str.trim());
+    }
 
-+ #####  Type[] :: new 
+    @Test
+    public void test8(){
+        consumer("  大山   ",this::trim);
+        consumer("  小红   ",this::trim);
+    }
+}
+```
 
-  + ##### 实例
++ ##### 输出内容
 
-  ```java
-  
-  ```
+```
+大山
+小红
+```
 
-  + ##### 输出内容
+#### 类名 :: new 
 
-  ```
-  
-  ```
++ ##### 示例
+
+```java
+public class TestA{
+    private void supplier2(Supplier<FunctionRef> refSupplier){
+        refSupplier.get().printName();
+    }
+
+    private void funcation2(String name,Function<String,FunctionRef> function){
+        function.apply(name).printName();
+    }
+    
+    @Test
+    public void test9(){
+        supplier2(FunctionRef::new);
+
+        funcation2("大山",FunctionRef::new);
+        funcation2("小红",FunctionRef::new);
+    }
+}
+class FunctionRef{
+	private String name;
+    
+    public FunctionRef(){
+        System.out.println("使用无参构造方法创建对象");
+        name="NULL";
+    }
+
+    public FunctionRef(String name){
+        System.out.println("使用有参构造方法创建对象");
+        this.name=name;
+    }
+
+    public void printName() {
+        System.out.println("名字："+name);
+    }
+}
+```
+
++ ##### 输出内容
+
+```
+使用无参构造方法创建对象
+名字：NULL
+使用有参构造方法创建对象
+名字：大山
+使用有参构造方法创建对象
+名字：小红
+```
+
+####  Type[] :: new 
+
++ ##### 示例
+
+```java
+public class TestA{
+	@SafeVarargs
+    private final <R> R[] intFunction(IntFunction<R[]> function, R... rs){
+        R[] apply = function.apply(rs.length);
+        System.arraycopy(rs, 0, apply, 0, rs.length);
+        return apply;
+    }
+
+    @Test
+    public void test10(){
+
+        System.out.println(Arrays.toString(intFunction(String[]::new, "叶凡", "萧炎")));
+
+        System.out.println(Arrays.toString(intFunction(Integer[]::new, 120, 130)));
+
+        System.out.println(Arrays.toString(intFunction(Integer[]::new)));
+
+    }
+}
+```
+
++ ##### 输出内容
+
+```
+[叶凡, 萧炎]
+[120, 130]
+[]
+```
+
+> 示例主要用于演示用法，可能并不适合实际开发场景

java/内置API/Annotation.md

@@ -0,0 +1,86 @@
+## 注解
+
+### @SafeVarargs 
+
+在声明具有模糊类型（比如：泛型）的可变参数的构造函数或方法时，Java 编译器会报 unchecked 警告。鉴于这些情况，如果程序员断定声明的构造函数和方法的主体不会对其 varargs 参数执行潜在的不安全的操作，可使用 @SafeVarargs 进行标记，这样的话，Java 编译器就不会报 unchecked 警告。
+
+先看看 @SafeVarargs 在 Java SE 中的声明：
+
+```java
+package java.lang;
+
+import java.lang.annotation.*;
+
+@Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.CONSTRUCTOR, ElementType.METHOD})
+public @interface SafeVarargs {}
+
+```
+
+由 Java 源代码声明我们了解到：@SafeVarargs 注解，只能用于标记构造函数和方法，由于保留策略声明为 RUNTIME，所以此注解可以在运行时生效。
+
+使用的时候要注意：@SafeVarargs 注解，对于非 static 或非 final 声明的方法，不适用，会编译不通过。
+
+@SafeVarargs 使用示例如下：
+
+```java
+package org.springmorning.demo.javabase.annotation.pre;
+
+/**
+ * @author 春晨
+ * @date 2019/1/19 9:26
+ * Copyright ©2019 春晨 https://www.cnblogs.com/springmorning/p/10285780.html
+ */
+public class SafeVarargsAnnotation<S>{
+
+    private S[] args;
+
+    //构造函数可以使用@SafeVarargs标记
+    @SafeVarargs
+    public SafeVarargsAnnotation(S... args){
+        this.args = args;
+    }
+
+    //此处不能使用@SafeVarargs，因为此方法未声明为static或final方法，如果要抑制unchecked警告，可以使用@SuppressWarnings注解
+    @SuppressWarnings("unchecked")
+    //@SafeVarargs
+    public void loopPrintArgs(S... args){
+        for (S arg : args) {
+            System.out.println(arg);
+        }
+    }
+
+    //final方法可以使用@SafeVarargs标记
+    @SafeVarargs
+    public final void printSelfArgs(S... args){
+        for (S arg : this.args) {
+            System.out.println(arg);
+        }
+    }
+
+    public static void main(String[] args) {
+        SafeVarargsAnnotation.loopPrintInfo("A", "B", "C");
+    }
+
+    //static方法可以使用@SafeVarargs标记
+    @SafeVarargs
+    public static <T> void loopPrintInfo(T ... infos){
+        for (T info : infos) {
+            System.out.println(info);
+        }
+    }
+
+}
+
+```
+
+如果以上把 @SafeVarargs 标记注释掉，在编译时就会报 unchecked 警告：
+
+![](assets/1578080-20190119095853997-1722091659.png)
+
+加上 @SafeVarargs 注解，警告被抑制：
+
+![](assets/1578080-20190119100022568-1102767552.png)
+
+> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [www.cnblogs.com](https://www.cnblogs.com/springmorning/p/10285780.html)

proxy/nginx 的 6 种负载均衡策略.md

@@ -0,0 +1,161 @@
+在服务器集群中，Nginx 起到一个反向代理服务器的作用。为了避免单独一个服务器压力过大导致服务器奔溃，就需要将不同用户的请求转发给不同给不同的服务器，保证集群中的每一台服务器都能正常运作，这种机制就叫做负载均衡。
+
+下面说一下 Nginx 支持的 6 种负载均衡策略。
+
+轮询（默认）
+
+轮询是 Nginx 支持的默认负载均衡策略，轮询策略就是指每个请求会按时间顺序逐一分配到不同的后台服务器上。比如说一个集群中只有服务器 A 和服务器 B，第一次访问是服务器 A，第二次访问就是服务器 B，第三次访问就是服务器 A... 以此类推。
+
+```
+upstream balanceServer {
+    server localhost:8081;
+    server localhost:8082;
+    server localhost:8083;
+    server localhost:8084;
+}
+
+```
+
+轮询策略提供如下参数：
+
+<table dir="ltr" border="1" frame="vsides" rules="all" cellspacing="1" cellpadding="1"><tbody><tr><td>fail_timeout</td><td>与 max_fails 结合使用，表示 max_fails 次失败后服务器暂停的时间。</td></tr><tr><td>max_fails</td><td>设置在 fail_timeout 参数设置的时间内最大失败次数，默认是 1，如果在这个时间内，所有针对该服务器的请求都失败了，那么认为该服务器会被认为是停机了，返回 proxy_next_upstream 模块定义的错误。</td></tr><tr><td>fail_time</td><td>服务器会被认为停机的时间长度, 默认为 10s。</td></tr><tr><td>backup</td><td>标记该服务器为备用服务器。当主服务器停止时，请求会被发送到它这里，当其他所有的非 backup 机器 down 掉或者繁忙的时候才会请求 backup 服务器，因此这台机器压力会最低。</td></tr><tr><td>down</td><td>标记服务器永久停机了，表示当前的 server 暂时不参与负载。</td></tr><tr><td>weight</td><td>负载的权重，默认为 1。weight 越大，表示这台服务器被访问的几率就越大。</td></tr></tbody></table>
+
+在轮询策略下，如果集群中的某个服务器挂掉了，就会自动剔除该服务器。
+
+轮询策略适合服务器配置相当，无状态且短平快的服务使用。
+
+权重（weight，加权轮询）
+
+权重策略是在轮询策略的基础上，另外指定了轮询的几率。
+
+```
+upstream balanceServer {
+    server localhost:8081;
+    server localhost:8082 backup;
+    server localhost:8083 max_fails=3 fail_timeout=20s;
+    server localhost:8084 weight=2;
+}
+
+```
+
+在上面的例子中，weight 参数用来指定轮询的几率，weight 的默认值为 1，weight 的数值与访问比率成正比，比如 8084 端口的服务器被访问的几率是其他服务器的两倍。
+
+权重越高，分配到需要处理的请求就越多。
+
+权重策略可以与 least_conn 和 ip_hash 结合使用。
+
+权重策略比较适合服务器的硬件配置差别较大的情况。
+
+根据 IP 分配（ip_hash）
+
+这种策略是按照客户端的 IP 去分配服务器，使同一个客户端的请求都转发到同一个后台服务器，保证了 Session 的统一性，可以用来解决 Session 的跨域问题。
+
+```
+upstream balanceServer {
+    ip_hash; # 指定负载均衡策略为ip_hash
+    server localhost:8081;
+    server localhost:8082 backup;
+    server localhost:8083 max_fails=3 fail_timeout=20s;
+    server localhost:8084 weight=2;
+}
+
+```
+
+在 Nginx 的 1.3.1 版本之前，不能在这种策略种使用权重（weight）。
+
+ip_hash 不能和 backup 参数同时使用。
+
+这个策略适用于有状态服务，比如说 Session 会话。
+
+当有服务器需要剔除的时候，必须手动 down 掉。
+
+最少连接（least_conn）
+
+这个策略是把请求转发给连接数较少的后端服务器。前面的轮询策略是把请求平均地转发给集群中的每个后台服务器，使得它们的负载大致相同，但是有些请求可能占用的时间会很长，可能导致所在的后端负载过高。这种情况下选用 least_conn 策略就能达到更好的负载均衡效果。
+
+```
+upstream balanceServer {
+    least_conn; # 指定负载均衡策略为least_conn
+    server localhost:8081;
+    server localhost:8082 backup;
+    server localhost:8083 max_fails=3 fail_timeout=20s;
+    server localhost:8084 weight=2;
+}
+
+```
+
+这个策略适合用在请求处理时间长短不一造成服务器过载的场景。
+
+响应时间（fair）
+
+这种策略是按照服务器的响应时间来分配请求，响应时间短的优先分配。
+
+```
+upstream balanceServer {
+    fair; # 指定负载均衡策略为fair
+    server localhost:8081;
+    server localhost:8082;
+    server localhost:8083;
+    server localhost:8084;
+}
+
+```
+
+fair 策略是一种第三方策略，需要安装第三方插件。
+
+根据 URL 分配（url_hash）
+
+这种策略是按照访问 url 的 hash 结果来分配请求，使得每个 url 定向到同一个后端服务器，要配合缓存命中来使用。同一个资源多次请求，可能会到达不同的服务器上，导致不必要的多次下载，缓存命中率不高，以及一些资源时间的浪费。而使用 url_hash 的话，就可以使得同一个 url（也就是同一个资源请求）到达同一台服务器，一旦缓存住了资源，再次收到请求，就可以从缓存中读取。
+
+```
+upstream balanceServer {
+    url_hash; # 指定负载均衡策略为url_hash
+    server localhost:8081;
+    server localhost:8082;
+    server localhost:8083;
+    server localhost:8084;
+}
+
+```
+
+url_hash 策略是一种第三方策略，需要安装第三方插件。
+
+配置实例
+
+```
+# user yanggb;
+worker_processes  4;
+
+events {
+    # 最大并发数
+    worker_connections  1024;
+}
+
+http {
+    # 待选服务器列表
+    upstream balanceServer {
+        server 10.1.40.129:8099 fail_timeout=60s;
+        server 10.1.40.23:9088;
+        server 10.1.40.77:7086;
+    }
+
+    server {
+        # 监听端口
+        listen 80;
+        
+        # 根目录下
+        location / {
+            # 选择哪个服务器列表
+            proxy_pass http://balanceServer;
+        }
+    }
+    
+}
+
+```
+
+总结
+
+Nginx 的负载均衡其实也可以看作是 5 种，因为其中的权重轮询其实可以归类到轮询策略中。除了轮询策略（包括权重轮询）外的其他负载均衡策略都是使用不同的算法实现的，在实际的运用中，需要根据不同的场景有针对性地去选择不同的负载均衡策略（可以多种策略组合使用），来响应实际的需求。
+
+> 转自 [www.cnblogs.com](https://www.cnblogs.com/yanggb/p/10895326.html)

web/docker-compose一键部署蘑菇博客设置SSL证书.md

@@ -0,0 +1,227 @@
+> 注意：必须要有已经备案的域名才能配置HTTPS
+>
+> 建议在操作之前先创建快照进行备份 以防出现位置错误
+>
+> 演示环境：阿里云轻量应用服务器，使用系统为Ubuntu20.04
+
+## 一、解析域名
+
+**首先需要添加三天解析记录，演示时我使用my.cn作为需要解析的顶级域名，我这里演示的是从阿里云购买的域名**
+
+| **二级域名**      | **作用**     |
+| ----------------- | ------------ |
+| **pic.my.cn**     | **图片服务** |
+| **gateway.my.cn** | **网关**     |
+| **www. my.cn**    | **门户网站** |
+
+**阿里云添加解析记录：**
+
+**解析线路、TTL默认不用修改，记录类型选择A，主机记录填写二级域名，记录值填写服务器ip地址(确保此服务器绑定域名为当前解析的顶级域名，并且蘑菇服务部署在此服务器)**
+
+![image-20220709181337201](assets/image-20220709181337201.png)
+
+## 二、 申请阿里云免费SSL证书
+
+[阿里云数字证书管理服务控制台](https://yundunnext.console.aliyun.com/)
+
+**按照以下步骤操作申请证书**
+
+![image-20220709183408851](assets/image-20220709183408851.png)
+
+**填写申请信息,证书绑定域名要对应自己解析的门户网站域名，添加联系人信息，其他的不需要进行修改**
+
+![image-20220711232827267](assets/image-20220711232827267.png)
+
+**点击下一步会自动弹出该页面，并且会在域名解析中自动添加一条txt的记录，如果是其他服务商购买的域名可能需要进行手动添加TXT解析记录，这里我没有尝试过其他服务商的域名**
+
+**接下来手动验证一下DNS是否正确，我这里验证错误是因为证书绑定域名填写不正确**
+
+**验证成功之后直接点击提交审核，一般在几分钟内就会完成审核**
+
+![image-20220711233141557](assets/image-20220711233141557.png)
+
+
+
+**审核通过后下载Nginx服务器类型的证书到本地**
+
+**完成此项后在重复执行以上操作完成pic.my.cn gateway.my.cn的证书申请和下载**
+
+![image-20220711233902022](assets/image-20220711233902022.png)
+
+## 三、 设置蘑菇mogu_data配置文件
+
+按照蘑菇官方引导安装的地址是在`/root`下  我这里以root路径下做演示
+
+1. **修改mogu_data nginx配置文件**
+
+   ```sh
+   ##进入到配置文件路径下
+   cd /root/docker-compose/config
+   ##创建mogu_data 文件夹并移动配置文件到此文件夹中，后面要挂载到mogu_data docker容器上
+   mkdir mogu_data
+   mv mogu_data.conf ./mogu_data
+   
+   ##在mogu_data 文件夹下创建cert文件夹 用于存放ssl证书文件，
+   cd mogu_data
+   mkdir cert
+   ```
+
+   上传ssl证书文件到cert目录下
+
+   ![image-20220711234313684](assets/image-20220711234313684.png)
+
+   ```sh
+   
+   vim mogu_data.conf
+   ##编辑mogu_data.conf文件为以下内容
+   ##图片服务代理
+   server {
+       listen       443 ssl;
+       server_name  pic.my.cn;		#记着要修改成自己的图片服务域名
+       add_header Access-Control-Allow-Origin *;
+       add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
+       add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization,lang,access-token';
+       if ($request_method = 'OPTIONS') {
+           return 204;
+       }
+   
+       ssl_certificate conf.d/cert/pic.my.cn.pem;  #配置指定的证书文件 这里只需要修改证书文件名称
+       ssl_certificate_key conf.d/cert/pic.my.cn.key; #配置指定的证书文件 这里只需要修改证书文件名称
+       location / {
+               root   /home/mogu_blog/mogu_data/;
+               index  index.html index.htm;
+       }
+   }
+   
+   
+   ##网关服务代理配置
+   server {
+       listen      443 ssl;
+       server_name gateway.my.cn;
+       ssl_certificate conf.d/cert/gateway.my.cn.pem;  #配置指定的证书文件 这里只需要修改证书文件名称
+       ssl_certificate_key conf.d/cert/gateway.my.cn.key; #配置指定的证书文件 这里只需要修改证书文件名称
+       location / {
+       	#这里的请求头配置一定要加上不然后台服务无法获取客户端ip地址
+           proxy_set_header Host $http_host;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header REMOTE-HOST $remote_addr;
+           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+           proxy_set_header Public-Network-URL http://$http_host$request_uri;
+           proxy_pass   http://39.107.103.48:8607/;
+       }
+   }
+   
+   ##门户网站代理配置
+   server {
+       listen      443 ssl;
+       server_name www.my.cn;	#修改成自己的门户网站域名
+       ssl_certificate conf.d/cert/www.my.cn.pem;  #配置指定的证书文件 这里只需要修改证书文件名称
+       ssl_certificate_key conf.d/cert/www.my.cn.key; #配置指定的证书文件 这里只需要修改证书文件名称
+       location / {
+           proxy_pass   http://vue_mogu_web/;
+       }
+   }
+   
+   
+   ##将门户网站http请求转发到https地址上
+   server {
+       listen 80;
+       server_name www.my.cn;
+       return 301 https://www.my.cn$request_uri;
+   }
+   ##将图片服务http请求转发到https地址上
+   server {
+       listen 80;
+       server_name picture.daiss.work;
+       return 301 https://pic.my.cn$request_uri;
+   }
+   ##此模块不需要改动
+   server {
+       listen       8600;
+       server_name  localhost;
+   
+       add_header Access-Control-Allow-Origin *;
+       add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
+       add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization,lang,access-token';
+       if ($request_method = 'OPTIONS') {
+           return 204;
+       }
+   
+       location / {
+               root   /home/mogu_blog/mogu_data/;
+               index  index.html index.htm;
+       }
+   }
+   ```
+
+2. **修改vue_mogu_web.env**
+
+   ```shell
+   ##进入到配置文件路径下
+   cd /root/docker-compose/config
+   vim vue_mogu_web.env
+   ##修改vue_mogu_web.env文件
+   NODE_ENV=production
+   VUE_MOGU_WEB=https://www.my.cn		##替换为自己的门户网站域名
+   PICTURE_API=https://gateway.my.cn/mogu-picture 	##替换为自己的网关服务域名 下面三项也需要进行替换
+   WEB_API=https://gateway.my.cn/mogu-web
+   SEARCH_API=https://gateway.my.cn/mogu-search
+   Spider_API=https://gateway.my.cn/mogu-spider
+   ```
+
+3. **修改mogu_data yml文件修改**
+
+   ```shell
+   ##进入到docker-compose yaml配置文件目录下
+   cd /root/docker-compose/yaml
+   vim mogu_data.yml
+   ##修改mogu_data.yml文件为以下内容
+   version: '3'
+   services:
+     #授权服务
+     mogu_data:
+       image: registry.cn-shenzhen.aliyuncs.com/mogublog/nginx
+       container_name: mogu_data
+       restart: always
+       ports:
+         - 80:80
+         - 8600:8600
+         - 443:443 #映射443端口 https使用的端口是443
+       networks:
+         - mogu
+       volumes:
+         - ../data/mogu_data/:/home/mogu_blog/mogu_data/
+         - ../config/mogu_data/:/etc/nginx/conf.d/ #直接挂载mogu_data/ 到容器的conf.d/
+   networks:
+     mogu:
+       external: true
+   ```
+
+
+## 四、重载mogu_data、vue_mogu_web容器
+
+```sh
+##停止mogu_data vue_mogu_web容器
+docker stop mogu_data vue_mogu_web
+##删除mogu_data vue_mogu_web容器
+docker rm mogu_data vue_mogu_web
+
+##重新构建启动mogu_data.yml容器
+docker-compose -f mogu_data.yml up -d
+##重新构建启动vue_mogu_web.yml容器
+docker-compose -f vue_mogu_web up -d
+```
+
+## 五、修改后台本地文件存储地址
+
+系统管理-->系统配置-->本地文件存储-->本地文件域名
+
+修改域名地址为自己的图片服务域名地址
+
+![image-20220711231553819](assets/image-20220711231553819.png)
+
+## 六、访问测试
+
+按照以上配置 完成后访问自己的门户网站地址查看是否生效 https://www.my.cn
+
+如果访问不到，就等待一会因为域名解析时长需要十分钟