apache / apisix-website Goto Github PK
View Code? Open in Web Editor NEWApache APISIX Website
Home Page: https://apisix.apache.org/
License: Apache License 2.0
Apache APISIX Website
Home Page: https://apisix.apache.org/
License: Apache License 2.0
Apache APISIX has the Apache release now: https://dist.apache.org/repos/dist/release/incubator/apisix/0.9/, so we need to add download page like https://shardingsphere.apache.org/document/current/en/downloads/
The current release guide is not complete.
The announce email for 2.1 links to
http://apisix.apache.org/docs/downloads/
which does not include the 2.1 release.
Either fix the docs/download page, or set up a redirect from /docs/download/ to /download/
Just modified this file
https://github.com/apache/apisix-website/blob/master/docs/download.md
Apache apisix official website part of the Chinese page is displayed in English
Such as, http://apisix.apache.org/zh/contribute/contributor/
refer: https://incubator.apache.org/clutch/apisix.html
Errata
Please investigate the following potential issues
Has not provided an issue tracker link
Has not provided a wiki link
ASF Events link is missing from website
Apache License link is missing from website
Apache Thanks link is missing from website
Apache Sponsorship link is missing from website
Disclaimer is missing from website
Release distribution area is not setup
必须使用 apache 官方邮箱账号生成的 gpg key。
在 GnuPG 官网下载安装包。 GnuPG 的 1.x 版本和 2.x 版本的命令有细微差别,下列说明以 GnuPG-2.1.23
版本为例。
安装完成后,执行以下命令查看版本号。
gpg --version
安装完成后,执行以下命令创建 key
。
GnuPG-2.x
可使用:
gpg --full-gen-key
GnuPG-1.x
可使用:
gpg --gen-key
根据提示完成 key
:
注意:请使用 Apache mail 生成 GPG 的 Key。
gpg (GnuPG) 2.0.12; Copyright (C) 2009 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Please select what kind of key you want:
(1) RSA and RSA (default)
(2) DSA and Elgamal
(3) DSA (sign only)
(4) RSA (sign only)
Your selection? 1
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (2048) 4096
Requested keysize is 4096 bits
Please specify how long the key should be valid.
0 = key does not expire
<n> = key expires in n days
<n>w = key expires in n weeks
<n>m = key expires in n months
<n>y = key expires in n years
Key is valid for? (0)
Key does not expire at all
Is this correct? (y/N) y
GnuPG needs to construct a user ID to identify your key.
Real name: ${输入用户名}
Email address: ${输入邮件地址}
Comment: ${输入注释}
You selected this USER-ID:
"${输入的用户名} (${输入的注释}) <${输入的邮件地址}>"
Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
You need a Passphrase to protect your secret key. # 输入密码
# gpg --list-keys
pub 4096R/30B5FD72 2020-01-02
uid ${用户名} (${注释}) <{邮件地址}>
sub 4096R/3D2F913D 2020-01-02
比如笔者本地获取的信息:
$ gpg --list-keys
/home/resty/.gnupg/pubring.gpg
------------------------------
pub 4096R/30B5FD72 2020-01-02
uid Yuansheng Wang <[email protected]>
sub 4096R/3D2F913D 2020-01-02
其中 30B5FD72 为公钥 ID。
# 最后参数是上面生成的公钥 ID。
$ gpg --keyserver hkp://pool.sks-keyservers.net --send-key 30B5FD72
gpg: sending key 30B5FD72 to hkp server pool.sks-keyservers.net
pool.sks-keyservers.net
为随意挑选的公钥服务器,每个服务器之间是自动同步的,选任意一个即可。
# 注意下方 Key fingerprint 部分
$ gpg --list-keys --fingerprint
/home/resty/.gnupg/pubring.gpg
------------------------------
pub 4096R/30B5FD72 2020-01-02
Key fingerprint = 0F91 BE0A 55A7 B22F DE1A CEEC 3352 48FD 30B5 FD72
uid Yuansheng Wang <[email protected]>
sub 4096R/3D2F913D 2020-01-02
点击左下角的 Submit changes...
按钮提交保存。
下载 svn 目录
$ svn --username=${Apache 用户名} co https://dist.apache.org/repos/dist/dev/incubator/apisix
进入 apisix 目录并查看其中文件:
$ cd apisix
$ ls
KEYS
导出公钥到追加到 KEYS 文件:
$ gpg -a --export ${GPG用户名} >> KEYS
提交修改后的 KEYS 文件,把公钥信息保存到 svn 服务器:
$ svn --username=${Apache 用户名} commit -m "added ${Apache 邮箱} gpg pub key"
Authentication realm: <https://dist.apache.org:443> ASF Committers
Password for 'membphis': # 输入密码
Store password unencrypted (yes/no)? yes
Sending KEYS
Transmitting file data .
Committed revision 37434.
每个安装包都有版本,这里以准备 1.0-rc1
版本为例。
在制作安装包之前,先确保在 github 上已经准备好分支 v1.0
。
# 进入 Apache svn 的 apisix 目录,应只有一个 KEYS 文件
$ ls
KEYS
# 新建版本号目录并进入,比如:1.0-rc1
$ mkdir 1.0-rc1 && cd 1.0-rc1
# 下载安装包
git clone -b v1.0 [email protected]:apache/incubator-apisix.git apache-apisix-1.0-incubating
# 检查版本号
$ cd apache-apisix-1.0-incubating && ./utils/check-version.sh 1.0 && cd ..
# 删除 .git 文件夹
$ rm -rf apache-apisix-1.0-incubating/.git
# 制作压缩包
$ tar zcvf apache-apisix-1.0-rc1-incubating-src.tar.gz apache-apisix-1.0-incubating
# 制作签名(这步会弹出对话框,提示你输入生成 gpg 时录入的密码)
$ gpg --armor --detach-sign apache-apisix-1.0-rc1-incubating-src.tar.gz
# 生成 sha512 校验文件
$ shasum -a512 apache-apisix-1.0-rc1-incubating-src.tar.gz > apache-apisix-1.0-rc1-incubating-src.tar.gz.sha512
# 删除 apache-apisix-1.0-rc1-incubating
$ rm -rf apache-apisix-1.0-incubating
# 后退到 Apache svn 的 apisix 根目录,并确认文件目录
$ cd .. && tree
.
├── 1.0-rc1
│ ├── apache-apisix-1.0-rc1-incubating-src.tar.gz
│ ├── apache-apisix-1.0-rc1-incubating-src.tar.gz.asc
│ └── apache-apisix-1.0-rc1-incubating-src.tar.gz.sha512
└── KEYS
1 directory, 4 files
# 添加新文件到 svn
$ svn add *
A 1.0-rc1
A (bin) 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz.asc
A (bin) 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz
A 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz.sha512
svn: warning: W150002: '/home/resty/git/apache_svn/apisix/KEYS' is already under version control
svn: E200009: Could not add all targets because some targets are already versioned
svn: E200009: Illegal target for the requested operation
# 提交修改到 Apache svn 服务器
$ svn --username=${Apache 用户名} commit -m "release 1.0-rc1"
Adding 1.0-rc1
Adding (bin) 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz
Adding (bin) 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz.asc
Adding 1.0-rc1/apache-apisix-1.0-rc1-incubating-src.tar.gz.sha512
Transmitting file data ...
Committed revision 37435.
主要参考内容:邮件发送人(apache 邮箱)、邮件标题、邮件正文(主要是修改版本号和链接地址)。
Most of the links on the download page are broken:
http://apisix.apache.org/docs/downloads/
Looks like the page has not been published correctly
Please review and ensure that the project website meets these
requirements. http://www.apache.org/foundation/marks/pmcs
For example, I don't see a reference to "Apache APISIX
software" on either the homepage or the download page.
move sshniro to the ppmc team
Hi @juzhiyuan
Please help to add the following information to the content/contribute/release/index.zh.md and content/contribute/release/index.en.md file.
Thanks.
点击此处查看参考邮件 发起投票邮件后需要等待72小时,然后统计投票结果并发送一封 result 邮件到 [email protected]。
点击此处查看参考邮件 在 [email protected] 发起投票邮件,同时需要将在 [email protected] 邮件列表中的统计结果附加到此封邮件,主要参考内容:邮件发送人(apache 邮箱)、邮件标题、邮件正文(主要是修改版本号和链接地址)。
点击此处查看参考邮件 发起投票邮件后需要等待72小时,然后统计投票结果并发送一封 result 邮件到 [email protected]。
点击此处查看参考邮件 在 [email protected] 和 [email protected] 两个邮件列表发起 announce 邮件
将RC版本的安装包修改为正式版以后移动到 此地址
更新 此地址 的下载信息, 源码在 https://github.com/apache/incubator-apisix-website
@moonming Please help set asf-site
branch under-protected, and remove the dev
branch.
The following release needs to be removed:
Hi @juzhiyuan
Please add the following information to the content/downloads/index.en.md and content/downloads/index.zh.md file.
Thanks.
<div class="flex-table row" role="rowgroup">
<div class="flex-row first" role="cell"><span class="flag-icon flag-icon-gb"></span>1.2</div>
<div class="flex-row" role="cell">2020 April 20</div>
<div class="flex-row" role="cell">
<a href="https://downloads.apache.org/incubator/apisix/1.2/">source</a>
(
<a href="https://downloads.apache.org/incubator/apisix/1.2/apache-apisix-1.2-incubating-src.tar.gz.asc">asc</a>
<a
href="https://downloads.apache.org/incubator/apisix/1.2/apache-apisix-1.2-incubating-src.tar.gz.sha512">sha512</a>
)
</div>
</div>
In apache/apisix#1724, sshniro use docsify to build a website for the doc, but I think we didn't actually present that link to users and he hasn't maintained that repo anymore.
I think maybe we could directly add the doc here. I just don't know how to sync apisix/doc here.
Apache APISIX's official webpage is at risk of hijacking
Phenomena.
Solution.
Strict-Transport-Security: max-age=172800
to ensure that subsequent users accessing the apisix website will use the https protocol by default.Download links for Source file should use mirror system, e.g https://mirrors.tuna.tsinghua.edu.cn/apache/apisix/dashboard-1.5/
We need modify the download page’s source codes, changing all src’s links to mirror site.
Those files should be modified:
Example:
<a href="https://downloads.apache.org/apisix/apisix/0.9/">源码</a>
To
<a href="https://mirrors.tuna.tsinghua.edu.cn/apache/apisix/apisix/0.9/">源码</a>
The docs currently support docsify. Therefore in order to showcase docs, I assume the following steps should be completed.
@moonming I just created the issue here.
We can add a button in the upper right corner to switch to the Chinese version
http://apisix.apache.org/contribute/release/ is for incubator project, we need to update it
The doc
prefix is not needed, and many historical releases use http://apisix.apache.org/downloads/
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.