Strings - 字符类型


> Dockerfile 是一个包含用于组合映像的命令的文本文档。可以使用在命令行中调用任何命令。 Docker 通过读取 Dockerfile 中的指令自动生成映像。 docker build 命令用于从 Dockerfile 构建映像。可以在 docker build 命令中使用-f 标志指向文件系统中任何位置的 Dockerfile。

## 文件说明

Docker 从上到下的顺序运行 Dockerfile 的指令，第一条指令必须是 FROM。

1. FROM

用于设置基本映像，FROM 必须作为第一条指令

2. MAINTAINER

docker 镜像和指令的创建者

3. CMD

用于执行映像的应用程序

```dockerfile
CMD ["executable","param1","param2"]
```

4. RUN

用于执行当前映像的任何命令

```dockerfile
RUN /bin/bash -c "source $HOME/.bashrc;echo $HOME"
```

5. LABEL

用于添加标签，设置映像标签

```dockerfile
LABEL maintainer="manon.icu"
```

6. EXPOSE

用于暴露端口到网络

```bash
#暴露80端口

expose 80

expose 80/tcp
```

7. ENV

设置环境变量

```bash
FROM node:12

ENV workdirectory /usr/node
```

8. COPY/ADD

用于将源文件复制到目的地

```dockerfile
COPY dist /www/dist
```

9. ENTRYPOINT

docker 镜像启动后的第一条执行命令

```bash
FROM ubuntu:latest

ENTRYPOINT ["ls"]
```

10. VOLUME

挂载卷

```bash
FROM node:12
RUN mkdir /node
WORKDIR /node
RUN echo "Welcome to Node.js" > node
VOLUME /node
```

12. USER

设置运行容器的账户

```bash
USER admin
#
RUN adduser -D admin
USER admin
```

13. WORKDIR

用于为 RUN/CMD/COPY 指令设置工作目录，如不存在，会默认创建

14. ARG

用于在创建时接收的参数

```bash
ARG JAVA_PATH=/opt/jdk/jdk1.8.0_251

ENV JAVA_HOME ${JAVA_PATH}
```

15. ONBUILD

用于指定将 `Dockerfile` 中的镜像用作另一个镜像的基础镜像时运行的命令

```bash
FROM node:12
RUN mkdir -p /usr/node/app
WORKDIR /usr/node/app
ONBUILD COPY package.json /usr/node/app/
ONBUILD RUN npm install
ONBUILD COPY . /usr/node/app
CMD [ "npm", "start" ]
```

16. STOPSIGNAL

```bash
STOPSIGNAL SIGQUIT
```

17. SHELL

设置 docker 镜像默认的终端

```bash
SHELL ["/bin/bash","-c","echo hello"]
```

18. HEALTHCHECK

检查镜像是否健康运行，需要在镜像内部持续运行一段命令

```bash
FROM ubuntu:latest
HEALTHCHECK --interval=60s --timeout=5s \
CMD curl -f http://fosstechnix.info/ || exit 1
EXPOSE 80
```

19. .dockerignore

用于设置 docker 镜像构建过程中忽略的文件

```bash
sudo vim .dockerignore

*.yaml
__pycache__/
.git
.aws
.env
```

## 完整的 Dockerfile

```dockerfile
FROM node:lts-alpine

WORKDIR /app
ADD . /app
RUN npm install

CMD ["npm", "start"]
```

## 更多


Dockerfile 是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明

Dockerfile


Background（背景）在 CSS 中是指应用于元素的背景图像、颜色、位置和重复方式。在 CSS 中，可以使用 background 属性设置元素的背景。

以下是一些 background 属性的详细解释：

- background-color：设置元素的背景颜色。可以使用颜色名称、十六进制、RGB 或 HSL 值来设置。
- background-image：设置元素的背景图像。可以使用 URL 或者 CSS 渐变来设置。
- background-repeat：设置元素背景图像的重复方式。有四种选项：repeat（水平和垂直方向都重复）、repeat-x（水平方向重复）、repeat-y（垂直方向重复）和 no-repeat（不重复）。
- background-position：设置元素背景图像的位置。可以使用像素、百分比、关键字（如 top、bottom、left、right、center）或者两个值（第一个值为水平位置，第二个值为垂直位置）来设置。
- background-attachment：设置元素背景图像的滚动方式。有两种选项：scroll（背景图像会随着元素滚动）和 fixed（背景图像固定在视口中，不随元素滚动）。
- background-size：设置元素背景图像的大小。可以使用像素、百分比或关键字（如 cover 或 contain）来设置。
- background-origin：指定背景图像的原点位置。有三种选项：padding-box（背景图像从内边距区域开始），border-box（背景图像从边框区域开始）和 content-box（背景图像从内容区域开始）。
- background-clip：指定背景图像的剪裁方式。有三种选项：padding-box（背景图像从内边距区域开始），border-box（背景图像从边框区域开始）和 content-box（背景图像从内容区域开始）。

通过灵活使用这些 background 属性，可以轻松地设置元素的背景，并创建出各种不同的视觉效果。


css - Backgrounds


到目前为止，使用 `Link` 组件从一个页面导航到另一个页面。使用 `Router` 组件也可以实现相同的功能。

更新`index.js`

```jsx
import Router from 'next/router'
import Head from 'next/head'

function HomePage(props) {
  return (
    <>
      <Head>
        <title>Welcome to Next.js!</title>
      </Head>
      <div>Welcome to Next.js!</div>
      <span onClick={() => Router.push('/posts/one')}>First Post</span>
      <br />
      <div>Next stars: {props.stars}</div>
      <img src="/logo.png" alt="Logo" />
    </>
  )
}

export async function getServerSideProps(context) {
  const res = await fetch('https://api.github.com/repos/vercel/next.js')
  const json = await res.json()
  return {
    props: {stars: json.stargazers_count}
  }
}

export default HomePage
```

启动服务

```bash
npm run dev
```

验证结果

![iZhXRv](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/iZhXRv.png)


Next.js - Imperative Routing


Js 中的 `assert` 模块用于测试 `Node.js` 应用程序中的功能表达式。如果测试结果返回 `false`,`assert` 将抛出一个错误并停止程序。

可以将 `assert` 模块与 `unit Js`、 `Mocha` 和 `Chai` 等单元测试工具一起使用。

开发人员使用 `assert` 来测试应用程序中的不变量。

## assert

`assert`接收两个参数：

- `condition`: 测试的条件。
- `message`: 如果条件不成立，则抛出的错误消息。

```js
var assert = require('assert')
var a = 5
var b = 3

assert(a < b)
// 抛出错误: AssertionError: a < b
```

## assert.deepStrictEqual

`assert.deepStrictEqual` 方法用于检查两个值是否相等。

deepEqual 方法用来比较两个对象。只要它们的属性一一对应，且值都相等，就认为两个对象相等，否则抛出一个错误。

```js
const assert = require('assert')
assert.deepStrictEqual({a: 1}, {a: '1'})
// 抛出错误: AssertionError: { a: 1 } deepStrictEqual { a: '1' }
```

## assert.fail

`assert.fail`接收两个参数：

- `message`: 如果条件不成立，则抛出的错误消息。
- `actual`: 实际值。

该方法共有四个参数，但是不管参数是什么值，它总是抛出一个错误。如果 message 参数对应的布尔值不为 false，抛出的错误信息就是 message，否则错误信息就是“实际值 + 分隔符 + 预期值”。

```js
const assert = require('assert').strict

/** AssertionError [ERR_ASSERTION]: Failed. This just prints failed as error message. This is not a good practice**/
assert.fail()

// AssertionError [ERR_ASSERTION]: This is why I failed
assert.fail('This is why I failed')

// TypeError: This is why I failed
assert.fail(new TypeError('This is why I failed'))
```

## assert.deepEqual

`assert.deepEqual`接收两个参数：

- `actual`: 实际值。
- `expected`: 期望值。

deepEqual 方法用来比较两个对象。只要它们的属性一一对应，且值都相等，就认为两个对象相等，否则抛出一个错误。

```js
const assert = require('assert')

const val1 = {
  x: {
    y: 1
  }
}
const val2 = {
  x: {
    y: 2
  }
}
const val3 = {
  x: {
    y: 1
  }
}

assert.deepEqual(val1, val3)
// Returns OK since val1 is equal to val3

// Values of b are different (Child properties)
assert.deepEqual(val1, val2)
// AssertionError: { a: { b: 1 } } deepEqual { a: { b: 2 } }
```

## assert.equal

`equal`接收两个参数：

- `actual`: 实际值。
- `expected`: 期望值。

```js
const assert = require('assert')

assert.equal(1, 1)
// This throws no exception since 1 == 1

assert.equal(1, '1')
/** This throws no exception since with abstract equality comparison 1 == '1' **/

assert.equal(NaN, NaN)
// This throws no exception

assert.equal(1, 2)
// This throws an error, AssertionError: 1 == 2

assert.equal({a: {x: 1}}, {a: {x: 1}})
/**This throws an error AssertionError: { a: { x: 1 } } == { a: { x: 1 } } because it dosen't check child value**/
```

## assert.notEqual

`notEqual`和`notStrictEqual`效果相同

```js
const assert = require('assert')

assert.notEqual(1, 1)
// This throws an exception since 1 == 1

assert.notEqual(1, '1')
/** This throws an exception since with abstract equality comparison 1 == '1' **/

assert.notEqual(1, 2)
// This throws no error, since 1 !== 2
```

## assert.notDeepEqual

`notDeepEqual` 方法与 `deepEqual` 方法正好相反，用来断言两个对象是否不相等。

```js
const assert = require('assert')

const val1 = {
  x: {
    y: 1
  }
}
const val2 = {
  x: {
    y: 2
  }
}
const val3 = {
  x: {
    y: 1
  }
}

assert.notDeepEqual(val1, val3)
// Returns an error, since val1 is equal to val3

// Values of b are different (Child properties)
assert.deepEqual(val1, val2)
// Returns no error since the child properties are not equal
```

[Assert 参考](https://javascript.ruanyifeng.com/nodejs/assert.html#toc5)
[Using Assert Module](https://blog.logrocket.com/using-assert-modules-to-verify-invariants-in-nodejs/)


使用 Assert 模块验证 Node.js 中的不变量

Node.js - Assertion


`pages/api` 目录下的任何文件都将作为 `API` 端点映射到 `/api/*`，而不是 `page`。这些文件只会增加服务端文件包的体积，而不会增加客户端文件包的大小。

`Next.js`中创建 rest api 的方式如下：

```jsx
export default (req, res) => {
  console.log(req, res)
  return {}
}
```

- req: 请求对象，http.IncomingMessage 实例
- res: 响应对象，http.ServerResponse 实例

## 响应

- `res.status(code)`：设置响应状态码
- `res.json(data)`：设置响应数据
- `res.send(data)`：设置响应数据
- `res.redirect(url)`：重定向

创建一个响应：

```jsx
export default function handler(req, res) {
  res.status(200).json({message: 'Hello from Next.js!'})
}
```

## 创建路由

创建一个简单的 rest api

```jsx
export default (req, res) => {
  res.statusCode = 200
  res.setHeader('Content-Type', 'application/json')
  res.json({
    message: 'Hello World'
  })
}
```

创建动态 API 路由：`pages/api/post/[pid].js`

```jsx
export default function handler(req, res) {
  const {pid} = req.query
  res.end(`Post: ${pid}`)
}
```

创建匹配所有路由：`pages/api/post/[...slug].js`

```jsx
export default function handler(req, res) {
  const {slug} = req.query
  res.end(`Post: ${slug.join(', ')}`)
}
```

启动服务：

```bash
npm run dev
```

验证结果：

![Y72joU](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/Y72joU.png)


Next.js - API Routes


**export**用于设置或显示环境变量。

## 使用方法

```bash
export TEST="test"
# TEST代表变量名，test代表变量值

export -n TEST
#-n参数代表一出TEST变量
```

## 参数：

- -f 　代表[变量名称]中为函数名称。
- -n 　删除指定的变量。变量实际上并未删除，只是不会输出到后续指令的执行环境中。
- -p 　列出所有的 shell 赋予程序的环境变量。


export用于设置或显示环境变量。