天天看点

运维脚本规范

51运维脚本规范

目录

前言:

一、命名规范

1.1脚本命名

1.2变量命名

1.3参数命名

1.4函数命名规范

二、编写规范

2.1.基本信息

2.2代码注释规范

2.3空行

2.4缩进

2.5续行

2.6输出

2.7 调用系统变量

2.8 脚本中使用命令

2.9 输入与退出

三、调试

3.1 错误退出

3.2脚本语法检查

3.3调试

本规范目的是保证运维成员编码的统一。

本规范的核心规则就是脚本的命名规则。

此规范必要是可以打破。

  1.1脚本命名

      脚本的名字需与其功能保持一致,让人一看名字就大概知道是干什么用。

  1.2变量命名

      变量的命名应遵循某种规范,使用"_"作为单词间的分隔符,单词尽量使用全名                  

 如:

   1.3参数命名

    参数命名原则全用小写

    如:

   1.4函数命名规范

    函数表示的是一个动作,所以它的结构应该是动词+名词,动词必须小写,后面的名称首字母大写,如getMaterialCode。函数命名尽量不要使用缩写,而且它的名称应该使人一目了然,能够从名称就知道这个函数的功能。当函数名称不足以表达其功能时,应使用在函数头部加上让调用者足够明白的注释。

如下面例子:

  2.1.基本信息

    (1)在每个脚本模块的最上面,勿忘记添加开头#!/bin/bash

    (2)脚本编写人(使用英文名或中文拼音缩写)

    (3)脚本创建时间、

    (4)脚本修改时间、修改说明、输入参数、输出参数、

    (5)脚本描述等。

    如下面例子:

可通过.vimrc文件编辑脚本时,自动在文件头加信息

    注释务必做到准确简洁,能够充分表达代码实现的功能。

例如:

    空行是区分代码块与块的间隔,在函数之间必须加上空行;而在函数内部,变量声明块和实现块(实现块指除变量声明外的其他代码)要使用空行来间隔,实现块的内部,通过空行来标识一个功能段。

    必须严格执行缩进,变量声明块不缩进,实现块必须保证全部缩进(不可能有实现块是行首对齐的);对于基本的控制结构来说,必须要有缩进,如IF、DO、WITH、FOR、WHILE块。

    对于过长的语句来说,必须使用续行,续行位置要有明显意义,例如,sql ="SELECT [code],[name] FROM [Person]"_&"WHERE [code] LIKE'001%'"。

对于使用比较频繁的代码块来说,最好将其写成函数,并尽量将功能复杂的大函数拆分成小函数。

    非交互式脚本,后台运行的脚本,脚本不允许输出内容到屏幕上,一律定向到/dev/null

    例如:

    脚本中需要调用系统变量时,需要在脚本中重新定义该变量

例如:

   脚本中使用系统命令时,需在命令行正确执行,测试得出正确结果,再将命令行中执行正确的命令粘贴至脚本中

    脚本需要从参数或者直接脚本中定义调用文件时,需要判断文件是否存在

   脚本非注释开头加上set -e,当脚本执行错误时,中断脚本执行,防止脚本发生死循环

  脚本非注释开头加上set -n,读一遍脚本中的命令但不执行,验证脚本是否能正常执行

   脚本非注释开头加上set -x,判断哪里出错。