You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/06/17 05:57:24 UTC
[GitHub] [apisix] avinal commented on a diff in pull request #7262: docs: Add configuration docs for apisix and env variables
avinal commented on code in PR #7262:
URL: https://github.com/apache/apisix/pull/7262#discussion_r899786750
##########
docs/en/latest/configuration/config-yaml.md:
##########
@@ -0,0 +1,556 @@
+---
+title: Configuration Options
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+This page describes the configuration options defined in the `conf/config-default.yaml`.
+
+## `apisix`
+
+ <table>
+ <thead>
+ <tr>
+ <th>Config Options</th>
+ <th>Type</th>
+ <th>Default Value</th>
+ <th>Description</th>
+ <th>Remarks</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td rowspan=4>
+ <code>admin_api_mtls
+ <ul>
+ <li>admin_ssl_cert</li>
+ <li>admin_ssl_cert_jey</li>
+ <li>admin_ssl_ca_cert</li>
+ </ul>
+ </code>
+ </td>
+ <td colspan=3>Depends on <code>port_admin</code> and <code>https_admin</code>.</td>
+ <td></td>
+ </tr>
+ <tr>
+ <td>string</td>
+ <td>""</td>
+ <td>Path of you self-signed server side certificate.</td>
+ </tr>
+ <tr>
+ <td>string</td>
+ <td>""</td>
+ <td>Path of your self-signed server side key.</td>
+ </tr>
+ <tr>
+ <td>string</td>
+ <td>""</td>
+ <td>Path of your self-signed CA certificate. The CA is used to sign all admin api callers certificates.
+ </td>
+ </tr>
+ <tr>
+ <td rowspan=3><code>admin_listen
+ <ul><li>ip</li>
+ <li>port</li>
+ </ul>
+ </code>
+ </td>
+ <td></td>
+ <td></td>
+ <td>Use a separate configuration for admin to listen on.</td>
+ <td rowspan=3>Disabled by default</td>
+ </tr>
+ <tr>
+ <td>IP address</td>
+ <td>127.0.0.1</td>
+ <td>Specific IP, if not set, then the default value is 0.0.0.0</td>
+ </tr>
+ <tr>
+ <td>port</td>
+ <td>9180</td>
+ <td>Specific port</td>
+ </tr>
+ <tr>
+ <td><code>allow_admin</code></td>
+ <td>IP list</td>
+ <td>127.0.0.0/24</td>
+ <td>Allow admins only on specified addresses. Allows on all addresses when not IP list is set.</td>
+ <td>Put valid IP addresses only. For IPv6 <code>::/64</code>.</td>
+ </tr>
+ <tr>
+ <td><code>config_center</code></td>
+ <td>string</td>
+ <td>etcd</td>
+ <td>Use config from yaml file or store config to etcd.</td>
+ <td>Possible values: <em>etcd</em> or <em>yaml</em></td>
+ </tr>
+ <tr>
+ <td rowspan=3>
+ <code>control
+ <ul>
+ <li>ip</li>
+ <li>port</li>
+ </ul>
+ </code>
+ </td>
+ <td colspan=3></td>
+ <td rowspan=3>Disabled by default</td>
+ </tr>
+ <tr>
+ <td>IP address</td>
+ <td>127.0.0.1</td>
+ <td></td>
+ </tr>
+ <tr>
+ <td>port</td>
+ <td>9090</td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><code>delete_uri_tail_slash</code></td>
+ <td>boolean</td>
+ <td>false</td>
+ <td>Enabling this will remove any terminating <strong>/</strong> from the end of the URI.</td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><code>disable_sync_configuration_during_start</code></td>
+ <td>boolean</td>
+ <td>false</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><code>dns_resolver</code></td>
+ <td>IP addresses</td>
+ <td>1.1.1.1, 8.8.8.8</td>
Review Comment:
It is Cloudflare DNS service just like Google DNS: https://www.cloudflare.com/learning/dns/what-is-1.1.1.1/
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org