bower私服部署

bower私服部署

简介

1、私服服务器:private-bower

2、包管理模式：git

工具清单

nodejs
git
private-bower

安装

安装nodejs

已安装nodejs可忽略本节内容

1、下载nodejs 程序包

打开nodejs官网下载页面https://nodejs.org/en/download/。右键复制Linux Binaries (x64)的下载链接。执行以下代码下载,并解压

    cd ~
    #注意：当前下载版本为v10.15.3
    #下载
    wget https://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz
    #解压
    xz -d node-v10.15.3-linux-x64.tar.xz
    #注意：xz 命令执行后node-v10.15.3-linux-x64.tar.xz被输出为node-v10.15.3-linux-x64.tar
    tar -xvf node-v10.15.3-linux-x64.tar
    #移动node程序文件夹到/opt/nodejs/v10
    mv ./node-v10.15.3-linux-x64 /opt/nodejs/v10

2、添加nodejs path到$PATH

    #通过修改profile文件:
    vim /etc/profile
    #找到设置PATH的行
    /export PATH
    #在export PATH之前，添加环境变量
    PATH=/opt/node/v10/bin:$PATH
    #保存
    #生效方法：系统重启
    #有效期限：永久有效
    #用户局限：对所有用户
    #执行以下命令使之立即生效
    source /etc/profile
    #或 执行点命令
    /etc/profile
    #执行以下命令测试nodejs是否已经正确安装
    node --version

安装`git`

    yum install -y git git-daemon

安装`private-bower`

    npm install -g private-bower

配置private-bower

    cd /opt
    mkdir ./private-bower
    vi mybowerconfig.json

mybowerconfig.json 配置范例如下：

{
    "port": 5678,
    "registryFile": "/opt/private-bower/bowerRepository.json",
    "timeout": 144000,
    "public": {
        "disabled": false,
        "registry": "http://https://registry.bower.io",
        "registryFile": "/opt/private-bower/bowerRepositoryPublic.json",
        "whitelist": [],
        "blacklist": []
    },
    "authentication": {
        "enabled": false,
        "key": "password"
    },
    "repositoryCache": {
        "cachePrivate": false,
        "git": {
            "enabled": false,
            "cacheDirectory": "/opt/private-bower/gitRepoCache",
            "host": "localhost",
            "port": 6789,
            "publicAccessURL" : null,
            "refreshTimeout": 10
        },
        "svn": {
            "enabled": false,
            "cacheDirectory": "/opt/private-bower/svnRepoCache",
            "host": "localhost",
            "port": 7891,
            "publicAccessURL" : null,
            "refreshTimeout": 10
        }
    },
    "proxySettings" : {
        "enabled": false,
        "host": "proxy",
        "username": "name",
        "password" : "pass",
        "port": 8080,
        "tunnel": false
    },
    "log4js" : {
        "enabled": true,
        "configPath" : "/opt/private-bower/log4js.conf.json"
    }
}

mybowerconfig.json关键配置说明

port：外部网络访问端口
registryFile：通过bower register name xxx 命令注册bower包的记录文件
log4js:configPath :日志配置

log4js.conf.json 配置

{
"appenders": [
    {
    "type": "dateFile",
    "filename": "private-bower.log",
    "pattern": "-yyyy-MM-dd",
    "alwaysIncludePattern": false
    },
    {
    "type": "console"
    }
],
"replaceConsole": true
}

启动private-bower

cd /opt/private-bower
private-bower --config ./mybowerconfig.json

开放端口

#以下代码为centos7
# 开放端口
firewall-cmd --zone=public --add-port=5678/tcp --permanent
# 更新规则
firewall-cmd --reload
# 启动|关闭|重新启动 防火墙，（注意：如果执行`firewall-cmd --reload`命令后仍无法访问则重启服务
systemctl [start|stop|restart] firewalld.service

开机启动/注册为服务

略

private-bower测试

1、创建.bowerrc文件

如果window下无法通过资源管理器创建时在命令行中(cmd)中执行以下代码

type null>.bowerrc

2、编辑以下内容

 {"registry":"http://<bower私服ip地址>:5678"}

3、在命令行中执行以下命令测试

bower search jquery

创建bower包

创建bower包需要满足以下条件

git :bower包依赖git仓库，公网可以选择github，私服可以搭建gitlab
git仓库的tags使用标准版本号格式：bower 通过读取git仓库tags识别bower版本号。版本号建议使用标准版本号格式，即xx.xx.xx[.xx]，并且支持v作为前缀的版本号。有效tag如：1.1.0、v1.1.1
git仓库根目录包含bower.json ：该文件声明bower包的相关信息

创建`bower.json`

# 执行以下命令，根据提示输入即可
bower init

bower.json文件基本结构

{
  "name": "bower_name",
  "authors": [
    "xxx"
  ],
  "description": "",
  "main": "",
  "license": "MIT",
  "homepage": "",
  "private": false,
  "ignore": [
    "**/.*",
    "node_modules",
    "bower_components",
    "test",
    "tests"
  ]
}

创建git仓库

基本流程

1、创建仓库

2、添加bower.json文件到master分支根目录

3、创建仓库tag

注册bower包到私服

在包含.bowerrc文件的目录下打开命令行，并且.bowerrc文件必须包含私服的定义

cd /d xxx  #xxx为包含.bowerrc文件的目录
bower register name xxx.git #xxx.git为bower包项目git地址

bower包建议

对于只需要引用必要资源文件的项目可以创建单独的git分支用于bower的发布，也可以使用bower.json文件配置忽略项目。

例如：

git仓库创建专门的用于bower发布的分支，该分支仅包含发布的必要文件，排除原始代码文件、示例、脚本等。创建tag时仅对该分支创建tag。如以下范例,其中bower分支为bower包的发布分支

master
- src
- dist
- examples
- bower.json
- readme.md
bower
- dist
- bower.json
tags->分支bower
- 1.1.1
- 1.1.2

客户端使用

创建基础配置

在需要通过bower管理包的项目根目录创建bower.json和.bowerrc。

1、创建.bowerrc

    #window环境下使用cmd创建
    type null>.bowerrc

编辑.bowerrc文件

{
  "registry": {
    "register": "http://<私服 IP or URL>:5678",
    "search": [
      "http://<私服 IP or URL>:5678",
      "https://registry.bower.io"
    ]
  },
  "directory": "wwwroot/lib"
}

配置说明

registry:register ：bower register name xxx 命令的注册地址
registry:search : bower包搜索安装的路径
directory : bower包放置路径

2、创建bower.json

通过bower init命令创建bower.json。创建后添加dependencies配置节点,该节点用于应用依赖项，bower还原时自动下载依赖项。配置如下

{
  "name": "projectname",
  "authors": [
    "xxx"
  ],
  "description": "",
  "main": "",
  "license": "MIT",
  "homepage": "",
  "ignore": [
    "**/.*",
    "node_modules",
    "bower_components",
    "wwwroot/lib",
    "test",
    "tests"
  ],
  "dependencies": {
    "d3": "v5.9.2"
  }
}