环境

以下环境仅代表本文测试环境,其它版本应该也可以。
* 虚拟机 Linux: CentOS Linux release 7.4.1708 (Core)
* 物理机 Windows: Windows 10 1709
* 移动端 Android: 7.1.1

CentOS 7 网络配置

虚拟机配置(在物理机 Windows 10 中)

需将网络连接方式改为桥接模式,否则手机端无法连接到虚拟机中的CentOS,Vmware和VirtualBox都有这个功能,不赘述。

查看物理机网络配置(在物理机 Windows 10 中)

右键开始菜单,打开Windows PowerShell(此处为无线连接,有线连接可以去查看有线网卡)

PS C:\Users\smy13> ipconfig
...

无线局域网适配器 WLAN:

   连接特定的 DNS 后缀 .
阅读全文 “利用 CentOS 7 samba 服务器与 ES 文件浏览器实现手机端在线播放电脑端视频”

Schemas是一种机器可读的文档,描述了API的端点,它们的URLs和所支持的操作。
Schemas可以用于自动生成文档,也可以用来驱动可以与API交互的动态客户端库。

Core API

为了提供Schemas支持,REST框架使用了Core API。
安装coreapi

pip install coreapi

添加schema

REST框架既支持自定义Schemas视图,也支持自动生成Schemas视图。
由于我们使用的是viewset和route,我们可以简单地自动生成Schemas视图。

现在我们需要通过在URL中配置一个自动生成的Schemas视图,为我们的API添加一个Schemas。
编辑urls.py

from rest_framework.schemas import get_schema_view

schema_view = get_schema_view(title='Pastebin API')

urlpatterns = [
    url(r'^schema/$', schema_view),
    ...
]

我们通过命令行的形式访问该接口,并指定接收格式为corejson

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# http https://127.0.0.1:80/schema/ Accept:application/coreapi+json
HTTP/1.0
阅读全文 “Django REST framework 学习纪要 Tutorial 7 Schemas & client libraries”

REST 框架包含了处理ViewSet的抽象,这样开发者就可以专注于API的状态和交互,而不用去管URL的构造,URL会按照
公共约定自动构造。
ViewSet类和View类差不多,不同的是ViewSet提供如read,update等方法,而不是get或是put
一个ViewSet类只绑定一组方法处理程序,当它被实例化为一组views时,通常用一个Router类来处理复杂的url。

重构代码以使用ViewSets

首先将我们现有的UserListUserDetail重构合并为UserViewSet
编辑views.py

from rest_framework import viewsets


class UserViewSet(viewsets.ReadOnlyModelViewSet):
    """
    这个ViewSet提供`list`和`detail`两个功能
    """
    queryset = User.objects.all()
    serializer_class = UserSerializer

这里我们使用的ReadOnlyModelViewSet类会提供默认的只读操作。
像以前一样,我们依然定义querysetserializer_class属性,只不过之前需要在两个类里面定义,现在只需要定义一遍。

接下来我们将现有的SnippetList, SnippetDetail, SnippetHighlight重构合并为SnippetViewSet
编辑views.py阅读全文 “Django REST framework 学习纪要 Tutorial 6 ViewSets & Routers”

目前我们使用主键来表示模型之间的关系。在本章,我们将提高API的凝聚性和可读性。

为我们API的根节点创建URL

之前我们给snippetsusers创建了URL接口,但我们没有一个根节点的URL。
在此我们创建一个简单的,基于函数的views,并为它加上@api_view装饰器,修改snippets/views.py

from rest_framework.decorators import api_view
from rest_framework.response import Response
from rest_framework.reverse import reverse


@api_view(['GET'])
def api_root(request, format=None):
    return Response({
        'users': reverse('user-list', request=request, format=format),
        'snippets': reverse('snippet-list', request=request, format=format)
    })

需要注意两点:
* 我们使用REST框架中的reverse方法来返回完全符合规则的url
* url参数将会与我们之后在snippets/urls中定义的相同

编写snippets/urls.py阅读全文 “Django REST framework 学习纪要 Tutorial 5 Relationships & Hyperlinked APIs”

目前为止,我们的代码没有限制谁可以编辑和删除代码片段,此节我们需要实现以下功能
* 代码片段需要与创建者关联
* 只有通过验证的用户才能创建代码片段
* 只有创建者才能修改或删除代码片段
* 没有通过验证的用户拥有只读权限

给model添加字段

我们需要添加两个字段,一个用于存储代码片段的创建者信息,一个用于存储代码的高亮信息

    style = models.CharField(choices=STYLE_CHOICES, default='friendly', max_length=100)
    owner = models.ForeignKey('auth.User', related_name='snippets', on_delete=models.CASCADE)
    highlighted = models.TextField()

同时,我们需要在该模型类执行保存操作时,自动填充highlighted字段,使用pygments库。
首先,导入一些包

from pygments.lexers import get_lexer_by_name
from pygments.formatters.html import HtmlFormatter
from pygments import highlight

然后为Snippet重写父类的save方法

    def save(self, *args, **kwargs):
        """
        use the 'pygments' library to create a highlighted HTML
        representation of code snippet
        """
        lexer = get_lexer_by_name(self.language)
        linenos = self.linenos
阅读全文 “Django REST framework 学习纪要 Tutorial 4 Authentication & Permissions”

基于类的views

之前我们创建的views都是基于函数的,我们也可以基于类来写views

from snippets.models import Snippet
from snippets.serializers import SnippetSerializer
from django.http import Http404
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status


class SnippetList(APIView):
    """
    list all snippets, or create a new snippet
    """
    def get(self, request, format=None):
        snippets = Snippet.objects.all()
        serializer = SnippetSerializer(snippets, many=True)
        return Response(serializer.data)

    def post(self, request, format=None):
        serializer = SnippetSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data,
阅读全文 “Django REST framework 学习纪要 Tutorial 3 Class-based Views”

Request 对象

REST 框架引入了Request对象,继承于HttpRequest,相比HttpRequest提供了更多请求解析,最核心的功能是request.data属性,类似于request.POST,以下是不同之处。
* request.POST
1. 只能处理form表单数据;
2. 只能处理POST请求。
* request.data
1. 能够处理任意一种数据;
2. 能够处理POST、PUT、PATCH请求

Response对象

REST框架也引入了Response对象,它是一个TemplateResponse类型,能够将未处理的文本转换为合适的类型返回给客户端

return Response(data)

状态码

REST框架提供了更可读的状态信息,比如HTTP_400_BAD_REQUEST

API views封装

  • 对于函数views,可以使用@api_view装饰器
  • 对于类views,可以继承于APIView

views应用

  • 修改snippets/views.py
阅读全文 “Django REST framework 学习纪要 Tutorial 2 Requests and Responses”

依赖

  • Python 3.6.3 [ Python (2.7, 3.2, 3.3, 3.4, 3.5, 3.6) 都可以 ]
  • Django 1.11.7 [ Django (1.10, 1.11, 2.0 alpha) 都可以 ]

安装、创建并配置虚拟环境

mkdir django_rest_framework && cd django_rest_framework
pyenv virtualenv 3.6.3 django_rest_framework
pyenv local django_rest_framework
  • 安装相关包
pip install django djangorestframework
pip install pygments  # 项目中会用到,提供代码高亮功能

Django项目初始化

  • 创建tutorial项目与snippets应用
django-admin startproject tutorial
cd tutorial/

python manage.py
阅读全文 “Django REST framework 学习纪要 Tutorial 1 Serialization”

环境

CentOS-7-x86_64-Minimal-1708

Pyenv介绍

  • 可以实现多版本Python并存
  • 使用插件后,可以为不同的项目创建不同的虚拟环境

Pyenv安装

  • 安装依赖
yum -y install gcc git zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel xz xz-devel
  • 下载pyenv源代码
git clone git://github.com/yyuu/pyenv.git ~/.pyenv
  • 添加环境变量
cat << "EOF" >> ~/.bashrc
export PYENV_ROOT="${HOME}/.pyenv"

if [ -d "${PYENV_ROOT}" ]; then
  export PATH="${PYENV_ROOT}/bin:${PATH}"
  eval "$(pyenv init -)"
fi
EOF

source ~/.bashrc
阅读全文 “Python版本管理工具 Pyenv的安装与使用”

0 环境

CentOS-7-x86_64-Minimal-1708

1 部署环境

CentOS-7-x86_64-Minimal-1708
阿里云下载源:https://mirrors.aliyun.com/centos/7.4.1708/isos/x86_64/CentOS-7-x86_64-Minimal-1708.iso

2 系统环境初始化

解决yum包无法正常安装和无法正常ssh的问题

vi /etc/sysconfig/network-scripts/ifcfg-ens33

ONBOOT=no改为ONBOOT=yes
(文件名不一定为ifcfg-ens33,不同的机器可能不一样,一般是以ifcfg开头的。)

重启网络

systemctl restart network

无法使用ifconfig查看IP

yum install net-tools

3 部署内容

部署说明

环境部署较为繁琐,因而写了个自动化部署环境的脚本。

由于MySQL服务器较为不稳定,因而用yum install --downloadonly命令将安装mysql所需的rpm包下了下来,放在了required_rpms文件夹内,和脚本放在了一起,在脚本中会自动调用。

shell脚本的内容都上传至了GitHub,但所需的MySQL的rpm包因为文件过大(部分文件超过了100M无法上传),所以gitignore掉了,把脚本的完整内容放在了百度网盘,大家直接在上一步初始化好的环境下运行即可。

自动化部署脚本下载地址

(下载地址可能会变,如若收藏请收藏文章链接,脚本下载链接如果改变会及时更新)
链接:https://pan.baidu.com/s/1gf4ETbl阅读全文 “个人技术博客项目开发纪要__1 环境部署”