e1a4001c by Unknown

complete quick start

1 parent 9e148a0e
...@@ -776,10 +776,8 @@ You can use different log level to output different error messages, it's based o ...@@ -776,10 +776,8 @@ You can use different log level to output different error messages, it's based o
776 } 776 }
777 } 777 }
778 778
779 ## 配置管理 779 ##Configuration
780 beego支持解析ini文件, beego默认会解析当前应用下的`conf/app.conf`文件 780 Beego supports to parse .ini file in path `conf/app.conf`, and you have following options:
781
782 通过这个文件你可以初始化很多beego的默认参数
783 781
784 appname = beepkg 782 appname = beepkg
785 httpaddr = "127.0.0.1" 783 httpaddr = "127.0.0.1"
...@@ -789,23 +787,23 @@ beego圾ni辣, beego暺恕隡圾銝conf/app.conf ...@@ -789,23 +787,23 @@ beego圾ni辣, beego暺恕隡圾銝conf/app.conf
789 autorecover = false 787 autorecover = false
790 viewspath = "myview" 788 viewspath = "myview"
791 789
792 上面这些参数会替换beego默认的一些参数。 790 If you set value in configuration file, Beego uses it to replace default value.
793 791
794 你可以在配置文件中配置应用需要用的一些配置信息,例如下面所示的数据库信息: 792 You can also have other values for your application, for example, database connection information:
795 793
796 mysqluser = "root" 794 mysqluser = "root"
797 mysqlpass = "rootpass" 795 mysqlpass = "rootpass"
798 mysqlurls = "127.0.0.1" 796 mysqlurls = "127.0.0.1"
799 mysqldb = "beego" 797 mysqldb = "beego"
800 798
801 那么你就可以通过如下的方式获取设置的配置信息: 799 Then use following code to load your settings:
802 800
803 beego.AppConfig.String("mysqluser") 801 beego.AppConfig.String("mysqluser")
804 beego.AppConfig.String("mysqlpass") 802 beego.AppConfig.String("mysqlpass")
805 beego.AppConfig.String("mysqlurls") 803 beego.AppConfig.String("mysqlurls")
806 beego.AppConfig.String("mysqldb") 804 beego.AppConfig.String("mysqldb")
807 805
808 AppConfig持如下方法 806 AppConfig supports following methods:
809 807
810 - Bool(key string) (bool, error) 808 - Bool(key string) (bool, error)
811 - Int(key string) (int, error) 809 - Int(key string) (int, error)
...@@ -813,91 +811,92 @@ AppConfig瘜 ...@@ -813,91 +811,92 @@ AppConfig瘜
813 - Float(key string) (float64, error) 811 - Float(key string) (float64, error)
814 - String(key string) string 812 - String(key string) string
815 813
816 ## 系统默认参数 814 ##Beego arguments
817 beego中带有很多可配置的参数,我们来一一认识一下它们,这样有利于我们在接下来的beego开发中可以充分的发挥他们的作用: 815 Beego has many configurable arguments, let me introduce to you all of them, so you can use them for more usage in your application:
818 816
819 * BeeApp 817 * BeeApp
820 818
821 beego默认启动的一个应用器入口,在应用import beego的时候,在init中已经初始化的。 819 Entry point of Beego, it initialized in init() function when you import Beego package.
822 820
823 * AppConfig 821 * AppConfig
824 822
825 beego的配置文件解析之后的对象,也是在init的时候初始化的,里面保存有解析`conf/app.conf`下面所有的参数数据 823 It stores values from file `conf/app.conf` and initialized in init() function.
826 824
827 * HttpAddr 825 * HttpAddr
828 826
829 应用监听地址,默认为空,监听所有的网卡IP 827 Application listening address, default is empty for listening all IP.
830 828
831 * HttpPort 829 * HttpPort
832 830
833 应用监听端口,默认为8080 831 Application listening port, default is 8080.
834 832
835 * AppName 833 * AppName
836 834
837 应用名称,默认是beego 835 Application name, default is "beego".
838 836
839 * RunMode 837 * RunMode
840 838
841 应用的模式,默认是dev,为开发模式,在开发模式下出错会提示友好的出错页面,如前面错误描述中所述。 839 Application mode, default is "dev" develop mode and gives friendly error messages.
842 840
843 * AutoRender 841 * AutoRender
844 842
845 是否模板自动渲染,默认值为true,对于API类型的应用,应用需要把该选项设置为false,不需要渲染模板。 843 This value indicates whether auto-render or not, default is true, you should set to false for API usage applications.
846 844
847 * RecoverPanic 845 * RecoverPanic
848 846
849 是否异常恢复,默认值为true,即当应用出现异常的情况,通过recover恢复回来,而不会导致应用异常退出。 847 This value indicates whether recover from panic or not, default is true, and program will not exit when error occurs.
850 848
851 * PprofOn 849 * PprofOn
852 850
853 是否启用pprof,默认是false,当开启之后,用户可以通过如下地址查看相应的goroutine执行情况 851 This value indicates whether enable pprof or not, default is false, and you can use following address to see goroutine execution status once you enable this feature.
854 852
855 /debug/pprof 853 /debug/pprof
856 /debug/pprof/cmdline 854 /debug/pprof/cmdline
857 /debug/pprof/profile 855 /debug/pprof/profile
858 /debug/pprof/symbol 856 /debug/pprof/symbol
859 关于pprof的信息,请参考官方的描述[pprof](http://golang.org/pkg/net/http/pprof/) 857
858 For more information about pprof, please read [pprof](http://golang.org/pkg/net/http/pprof/)
860 859
861 * ViewsPath 860 * ViewsPath
862 861
863 模板路径,默认值是views 862 Template path, default is "views".
864 863
865 * SessionOn 864 * SessionOn
866 865
867 session是否开启,默认是false 866 This value indicate whether enable session or not, default is false.
868 867
869 * SessionProvider 868 * SessionProvider
870 869
871 session的引擎,默认是memory 870 Session engine, default is memory.
872 871
873 * SessionName 872 * SessionName
874 873
875 存在客户端的cookie名称,默认值是beegosessionID 874 Name for cookie that save in client browser, default is "beegosessionID".
876 875
877 * SessionGCMaxLifetime 876 * SessionGCMaxLifetime
878 877
879 session过期时间,默认值是3600秒 878 Session expired time, default is 3600 seconds.
880 879
881 * SessionSavePath 880 * SessionSavePath
882 881
883 session保存路径,默认是空 882 Save path of session, default is empty.
884 883
885 * UseFcgi 884 * UseFcgi
886 885
887 是否启用fastcgi,默认是false 886 This value indicates whether enable fastcgi or not, default is false.
888 887
889 * MaxMemory 888 * MaxMemory
890 889
891 文件上传默认内存缓存大小,默认值是`1 << 26`(64M) 890 Maximum memory size for file upload, default is `1 << 26`(64M).
892 891
893 ## 第三方应用集成 892 ##Integrated third-party applications
894 beego支持第三方应用的集成,用户可以自定义`http.Handler`,用户可以通过如下方式进行注册路由: 893 Beego supports to integrate third-party application, you can customized `http.Handler` as follows:
895 894
896 beego.RouterHandler("/chat/:info(.*)", sockjshandler) 895 beego.RouterHandler("/chat/:info(.*)", sockjshandler)
897 896
898 sockjshandler实现了接口`http.Handler` 897 sockjshandler implemented interface `http.Handler`.
899 898
900 目前在beego的example中有支持sockjs的chat例子,示例代码如下: 899 Beego has an example for supporting chat of sockjs, here is the code:
901 900
902 package main 901 package main
903 902
...@@ -942,10 +941,10 @@ sockjshandler摰鈭`http.Handler` ...@@ -942,10 +941,10 @@ sockjshandler摰鈭`http.Handler`
942 beego.Run() 941 beego.Run()
943 } 942 }
944 943
945 通过上面的代码很简单的实现了一个多人的聊天室。上面这个只是一个sockjs的例子,我想通过大家自定义`http.Handler`,可以有很多种方式来进行扩展beego应用。 944 The above example implemented a simple chat room for sockjs, and you can use `http.Handler` for more extensions.
946 945
947 ## 部署编译应用 946 ##Deployment
948 Go语言的应用最后编译之后是一个二进制文件,你只需要copy这个应用到服务器上,运行起来就行。beego由于带有几个静态文件、配置文件、模板文件三个目录,所以用户部署的时候需要同时copy这三个目录到相应的部署应用之下,下面以我实际的应用部署为例: 947 Go compiles program to binary file, you only need to copy this binary to your server and run it. Because Beego uses MVC model, so you may have folders for static files, configuration files and template files, so you have to copy those files as well. Here is a real example for deployment.
949 948
950 $ mkdir /opt/app/beepkg 949 $ mkdir /opt/app/beepkg
951 $ cp beepkg /opt/app/beepkg 950 $ cp beepkg /opt/app/beepkg
...@@ -953,7 +952,7 @@ Go霂剛銝銝芯辣嚗閬opy餈 ...@@ -953,7 +952,7 @@ Go霂剛銝銝芯辣嚗閬opy餈
953 $ cp -fr static /opt/app/beepkg 952 $ cp -fr static /opt/app/beepkg
954 $ cp -fr conf /opt/app/beepkg 953 $ cp -fr conf /opt/app/beepkg
955 954
956 这样在`/opt/app/beepkg`目录下面就会显示如下的目录结构: 955 Here is the directory structure pf `/opt/app/beepkg`.
957 956
958 . 957 .
959 ├── conf 958 ├── conf
...@@ -966,17 +965,15 @@ Go霂剛銝銝芯辣嚗閬opy餈 ...@@ -966,17 +965,15 @@ Go霂剛銝銝芯辣嚗閬opy餈
966 └── index.tpl 965 └── index.tpl
967 ├── beepkg 966 ├── beepkg
968 967
969 这样我们就已经把我们需要的应用搬到服务器了,那么接下来就可以开始部署了,我现在服务器端用两种方式来run, 968 Now you can run your application in server, here are two good ways to manage your applications, and I recommend the first one.
970 969
971 - Supervisord 970 - Supervisord
972 971
973 安装和配置见[Supervisord](Supervisord.md) 972 More information: [Supervisord](Supervisord.md)
974 973
975 - nohup 974 - nohup
976 975
977 nohup ./beepkg & 976 nohup ./beepkg &
978 977
979 个人比较推荐第一种方式,可以很好的管理起来应用
980
981 - [Introduction](README.md) 978 - [Introduction](README.md)
982 - [Step by step](Tutorial.md) 979 - [Step by step](Tutorial.md)
...\ No newline at end of file ...\ No newline at end of file
......
1 ##supervisord
2
3 1. Installation
4
5 wget http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg
6
7 sh setuptools-0.6c11-py2.7.egg
8
9 easy_install supervisor
10
11 echo_supervisord_conf >/etc/supervisord.conf
12
13 mkdir /etc/supervisord.conf.d
14
15 2. Configure /etc/supervisord.conf
16
17 [include]
18 files = /etc/supervisord.conf.d/*.conf
19
20 3. Add new application
21
22 cd /etc/supervisord.conf.d
23 vim beepkg.conf
24
25 Configuration file:
26
27 [program:beepkg]
28 directory = /opt/app/beepkg
29 command = /opt/app/beepkg/beepkg
30 autostart = true
31 startsecs = 5
32 user = root
33 redirect_stderr = true
34 stdout_logfile = /var/log/supervisord/beepkg.log
...\ No newline at end of file ...\ No newline at end of file
1 # 一步一步跟我写博客
2
3 ## 创建项目
4
5 ## 数据库结构设计
6
7 ## 控制器设计
8
9 ## 模板设计
10
11 ## 用户登陆退出
12
13 ## 数据库操作
...\ No newline at end of file ...\ No newline at end of file
Styling with Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!