diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-06-09 00:09:17 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-06-09 00:09:17 +0300 |
commit | d48cbe178636a01db031327b93b6e3b279c12aa5 (patch) | |
tree | 6766894632e58363aa1adf17456066351055ead6 /doc | |
parent | 99c01aa6867b91b8d2279eb8d32794ea90d5dcdc (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc')
-rw-r--r-- | doc/api/access_requests.md | 14 | ||||
-rw-r--r-- | doc/api/members.md | 18 | ||||
-rw-r--r-- | doc/development/permissions.md | 17 | ||||
-rw-r--r-- | doc/integration/saml.md | 2 | ||||
-rw-r--r-- | doc/university/README.md | 1 | ||||
-rw-r--r-- | doc/university/support/README.md | 202 | ||||
-rw-r--r-- | doc/user/clusters/applications.md | 4 | ||||
-rw-r--r-- | doc/user/markdown.md | 5 |
8 files changed, 37 insertions, 226 deletions
diff --git a/doc/api/access_requests.md b/doc/api/access_requests.md index 99a9ef58361..53198d05b46 100644 --- a/doc/api/access_requests.md +++ b/doc/api/access_requests.md @@ -6,14 +6,12 @@ The access levels are defined in the `Gitlab::Access` module. Currently, these levels are recognized: -```plaintext -0 => No access -10 => Guest access -20 => Reporter access -30 => Developer access -40 => Maintainer access -50 => Owner access # Only valid for groups -``` +- No access (`0`) +- Guest (`10`) +- Reporter (`20`) +- Developer (`30`) +- Maintainer (`40`) +- Owner (`50`) - Only valid to set for groups ## List access requests for a group or project diff --git a/doc/api/members.md b/doc/api/members.md index d8129a12fa7..dadd609b7ed 100644 --- a/doc/api/members.md +++ b/doc/api/members.md @@ -4,13 +4,17 @@ The access levels are defined in the `Gitlab::Access` module. Currently, these levels are recognized: -```plaintext -10 => Guest access -20 => Reporter access -30 => Developer access -40 => Maintainer access -50 => Owner access # Only valid for groups -``` +- No access (`0`) +- Guest (`10`) +- Reporter (`20`) +- Developer (`30`) +- Maintainer (`40`) +- Owner (`50`) - Only valid to set for groups + +CAUTION: **Caution:** +Due to [an issue](https://gitlab.com/gitlab-org/gitlab/-/issues/219299), +projects in personal namespaces will not show owner (`50`) permission +for owner. ## List all members of a group or project diff --git a/doc/development/permissions.md b/doc/development/permissions.md index 7db188d17c9..06a4a03de38 100644 --- a/doc/development/permissions.md +++ b/doc/development/permissions.md @@ -41,11 +41,12 @@ can be accessed only by project members by default. Users can be members of multiple groups and projects. The following access levels are available (defined in the `Gitlab::Access` module): -- Guest -- Reporter -- Developer -- Maintainer -- Owner +- No access (`0`) +- Guest (`10`) +- Reporter (`20`) +- Developer (`30`) +- Maintainer (`40`) +- Owner (`50`) If a user is the member of both a project and the project parent group, the higher permission is taken into account for the project. @@ -56,6 +57,12 @@ can still view the groups and their entities (like epics). Project membership (where the group membership is already taken into account) is stored in the `project_authorizations` table. +CAUTION: **Caution:** +Due to [an issue](https://gitlab.com/gitlab-org/gitlab/-/issues/219299), +projects in personal namespace will not show owner (`50`) permission in +`project_authorizations` table. Note however that [`user.owned_projects`](https://gitlab.com/gitlab-org/gitlab/blob/0d63823b122b11abd2492bca47cc26858eee713d/app/models/user.rb#L906-916) +is calculated properly. + ### Confidential issues Confidential issues can be accessed only by project members who are at least diff --git a/doc/integration/saml.md b/doc/integration/saml.md index 5cb57baf353..97384d8f6cf 100644 --- a/doc/integration/saml.md +++ b/doc/integration/saml.md @@ -1,4 +1,4 @@ -# SAML OmniAuth Provider +# SAML OmniAuth Provider **(CORE ONLY)** Note that: diff --git a/doc/university/README.md b/doc/university/README.md index 1b13f9af584..df41167dbe9 100644 --- a/doc/university/README.md +++ b/doc/university/README.md @@ -203,7 +203,6 @@ The GitLab University curriculum is composed of GitLab videos, screencasts, pres NOTE: **Note:** Some content can only be accessed by GitLab team members. -1. [Support Path](support/README.md) 1. [Sales Path](https://about.gitlab.com/handbook/sales/onboarding/) 1. [User Training](training/user_training.md) 1. [GitLab Flow Training](training/gitlab_flow.md) diff --git a/doc/university/support/README.md b/doc/university/support/README.md deleted file mode 100644 index 6dbbf075e9c..00000000000 --- a/doc/university/support/README.md +++ /dev/null @@ -1,202 +0,0 @@ ---- -comments: false -type: reference ---- - -# Support Boot Camp - -**Goal:** Prepare new Service Engineers at GitLab - -For each stage, there are learning goals and content to support the learning of the engineer. -The goal of this boot camp is to have every Service Engineer prepared to help our customers -with whatever needs they might have and to also assist our awesome community with their -questions. - -Always start with the [University Overview](../README.md) and then work -your way here for more advanced and specific training. Once you feel comfortable -with the topics of the current stage, move to the next. - -## Stage 1 - -Follow the topics on the [University Overview](../README.md), concentrate on it -during your first Stage, but also: - -- Perform the [first steps](https://about.gitlab.com/handbook/support/onboarding/#first-steps) of - the on-boarding process for new Service Engineers - -### Goals - -Aim to have a good overview of the Product and main features, Git and the Company - -## Stage 2 - -Continue to look over remaining portions of the [University Overview](../README.md) and continue on to these topics: - -### Set up your development machine - -Get your development machine ready to familiarize yourself with the codebase, the components, and to be prepared to reproduce issues that our users encounter - -- Install the [GDK](https://gitlab.com/gitlab-org/gitlab-development-kit) - - [Set up OpenLDAP as part of this](https://gitlab.com/gitlab-org/gitlab-development-kit#openldap) - -### Become comfortable with the Installation processes that we support - -It's important to understand how to install GitLab in the same way that our users do. Try installing different versions and upgrading and downgrading between them. Installation from source will give you a greater understanding of the components that we employ and how everything fits together. - -Sometimes we need to upgrade customers from old versions of GitLab to latest, so it's good to get some experience of doing that now. - -- [Installation Methods](https://about.gitlab.com/install/): - - [Omnibus](https://gitlab.com/gitlab-org/omnibus-gitlab/) - - [Docker](../../install/docker.md) - - [Source](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/install/installation.md) -- Get yourself a Digital Ocean droplet, where you can install and maintain your own instance of GitLab - - Ask in #infrastructure about this - - Populate with some test data - - Keep this up-to-date as patch and version releases become available, just like our customers would -- Try out the following installation path - - [Install GitLab 4.2 from source](https://gitlab.com/gitlab-org/gitlab-foss/blob/d67117b5a185cfb15a1d7e749588ff981ffbf779/doc/install/installation.md) - - External MySQL database - - External NGINX - - Create some test data - - Populated Repos - - Users - - Groups - - Projects - - [Back up using our backup Rake task](../../raketasks/backup_restore.md#back-up-gitlab) - - [Upgrade to 5.0 source using our Upgrade documentation](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/4.2-to-5.0.md) - - [Upgrade to 5.1 source](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/5.0-to-5.1.md) - - [Upgrade to 6.0 source](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/5.1-to-6.0.md) - - [Upgrade to 7.14 source](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/update/6.x-or-7.x-to-7.14.md) - - [Perform the MySQL to PostgreSQL migration to convert your backup](../../update/mysql_to_postgresql.md) - - [Upgrade to Omnibus 7.14](https://docs.gitlab.com/omnibus/update/README.html#upgrading-from-a-non-omnibus-installation-to-an-omnibus-installation) - - [Restore backup using our Restore Rake task](../../raketasks/backup_restore.md#restore-gitlab) - - [Upgrade to latest EE](https://about.gitlab.com/update/) - - (GitLab inc. only) Acquire and apply a license for the Enterprise Edition product, ask in #support -- Perform a downgrade from [EE to CE](../../downgrade_ee_to_ce/README.md) - -### Start to learn about some of the integrations that we support - -Our integrations add great value to GitLab. User questions often relate to integrating GitLab with existing external services and the configuration involved - -- Learn about our Integrations (specially, not only): - - [LDAP](../../integration/ldap.md) - - [Jira](../../project_services/jira.md) - - [Jenkins](../../integration/jenkins.md) - - [SAML](../../integration/saml.md) - -### Goals - -- Aim to be comfortable with installation of the GitLab product and configuration of some of the major integrations -- Aim to have an installation available for reproducing customer reports - -## Stage 3 - -### Understand the gathering of diagnostics for GitLab instances - -- Learn about the GitLab checks that are available: - - [Environment Information and maintenance checks](../../raketasks/maintenance.md) - - [GitLab check](../../raketasks/check.md) - - Omnibus commands - - [Status](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/maintenance/README.md#get-service-status) - - [Starting and stopping services](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/maintenance/README.md#starting-and-stopping) - - [Starting a rails console](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/maintenance/README.md#invoking-rake-tasks) - -### Learn about the Support process - -Zendesk is our Support Center and our main communication line with our Customers. We communicate with customers through several other channels too - -- Familiarize yourself with ZenDesk: - - [UI Overview](https://support.zendesk.com/hc/en-us/articles/203661806-Introduction-to-the-Zendesk-agent-interface) - - [Updating Tickets](https://support.zendesk.com/hc/en-us/articles/212530318-Updating-and-solving-tickets) - - [Working w/ Tickets](https://support.zendesk.com/hc/en-us/articles/203690856-Working-with-tickets) *Read: avoiding agent collision.* -- Dive into our ZenDesk support process by reading how to [handle tickets](https://about.gitlab.com/handbook/support/onboarding/#handling-tickets) -- Start getting real world experience by handling real tickets, all the while gaining further experience with the Product. - - First, learn about our [Support Channels](https://about.gitlab.com/handbook/support/#support-channels) - - Ask other Service Engineers for help, when necessary, and to review your responses - - Start with [StackOverflow](https://about.gitlab.com/handbook/support/#stack-overflowa-namestack-overflowa) and the [GitLab forum](https://about.gitlab.com/handbook/support/#foruma-namegitlab-foruma) - - Here you will find a large variety of queries mainly from our Users who are self hosting GitLab CE - - Understand the questions that are asked and dig in to try to find a solution - - [Proceed on to the GitLab.com Support Forum](https://about.gitlab.com/handbook/support/#gitlabcom-support-trackera-namesupp-foruma) - - Here you will find queries regarding our own GitLab.com - - Helping Users here will give you an understanding of our Admin interface and other tools - - [Proceed on to the Twitter tickets in Zendesk](https://about.gitlab.com/handbook/support/#twitter) - - Here you will gain a great insight into our userbase - - Learn from any complaints and problems and feed them back to the team - - Tweets can range from help needed with GitLab installations, the API and just general queries - - [Proceed on to Regular email Support tickets](https://about.gitlab.com/handbook/support/#regular-zendesk-tickets-a-nameregulara) - - Here you will find tickets from our GitLab EE Customers and GitLab CE Users - - Tickets here are extremely varied and often very technical - - You should be prepared for these tickets, given the knowledge gained from previous tiers and your training -- Check out your colleagues' responses - - Hop on to the #support-live-feed channel in Slack and see the tickets as they come in and are updated - - Read through old tickets that your colleagues have worked on -- Start arranging to pair on calls with other Service Engineers. Aim to cover a few of each type of call - - [Learn about Cisco WebEx](https://about.gitlab.com/handbook/support/onboarding/#webexa-namewebexa) - - Training calls - - Information gathering calls - - It's good to find out how new and prospective customers are going to be using the product and how they will set up their infrastructure - - Diagnosis calls - - When email isn't enough we may need to hop on a call and do some debugging along side the customer - - These paired calls are a great learning experience - - Upgrade calls - - Emergency calls - -### Learn about the Escalation process for tickets - -Some tickets need specific knowledge or a deep understanding of a particular component and will need to be escalated to a Senior Service Engineer or Developer - -- Read about [Escalation](https://about.gitlab.com/handbook/support/workflows/working-with-issues.html#functional-escalation-points) -- Find the macros in Zendesk for ticket escalations -- Take a look at the [GitLab.com Team page](https://about.gitlab.com/company/team/) to find the resident experts in their fields - -### Learn about raising issues and fielding feature proposals - -- Understand what's in the pipeline and proposed features at GitLab: [Direction Page](https://about.gitlab.com/direction/) -- Practice searching issues and filtering using [labels](https://gitlab.com/gitlab-org/gitlab/-/labels) to find existing feature proposals and bugs -- If raising a new issue always provide a relevant label and a link to the relevant ticket in Zendesk -- Add [customer labels](https://gitlab.com/gitlab-org/gitlab/-/issues?label_name%5B%5D=customer) for those issues relevant to our subscribers -- Take a look at the [existing issue templates](https://gitlab.com/gitlab-org/gitlab/blob/master/CONTRIBUTING.md#issue-tracker) to see what is expected -- Raise issues for bugs in a manner that would make the issue easily reproducible. A Developer or a contributor may work on your issue - -### Goals - -- Aim to have a good understanding of the problems that customers are facing -- Aim to have gained experience in scheduling and participating in calls with customers -- Aim to have a good understanding of ticket flow through Zendesk and how to interact with our various channels - -## Stage 4 - -### Advanced GitLab topics - -Move on to understanding some of GitLab's more advanced features. You can make use of GitLab.com to understand the features from an end-user perspective and then use your own instance to understand setup and configuration of the feature from an Administrative perspective - -- Set up and try [Git LFS](../../topics/git/lfs/index.md) -- Get to know the [GitLab API](../../api/README.md), its capabilities and shortcomings -- Learn how to [migrate from SVN to Git](../../user/project/import/svn.md) -- Set up [GitLab CI/CD](../../ci/quick_start/README.md) -- Create your first [GitLab Page](../../administration/pages/index.md) -- Get to know the GitLab Codebase by reading through the source code: - - Find the differences between the [EE codebase](https://gitlab.com/gitlab-org/gitlab) - and the [CE codebase](https://gitlab.com/gitlab-org/gitlab-foss) -- Ask as many questions as you can think of on the `#support` chat channel - -### Get initiated for on-call duty - -- Read over the [public run-books to understand common tasks](https://gitlab.com/gitlab-com/runbooks) -- Create an issue on the internal Organization tracker to schedule time with the DevOps / Production team, so that you learn how to handle GitLab.com going down. Once you are trained for this, you are ready to be added to the on-call rotation. - -### Goals - -- Aim to become a fully-fledged Service Engineer! - -<!-- ## Troubleshooting - -Include any troubleshooting steps that you can foresee. If you know beforehand what issues -one might have when setting this up, or when something is changed, or on upgrading, it's -important to describe those, too. Think of things that may go wrong and include them here. -This is important to minimize requests for support, and to avoid doc comments with -questions that you know someone might ask. - -Each scenario can be a third-level heading, e.g. `### Getting error message X`. -If you have none to add when creating a doc, leave this section in place -but commented out to help encourage others to add to it in the future. --> diff --git a/doc/user/clusters/applications.md b/doc/user/clusters/applications.md index dfe70613815..d5d006fabed 100644 --- a/doc/user/clusters/applications.md +++ b/doc/user/clusters/applications.md @@ -907,10 +907,10 @@ Major upgrades might require additional setup steps, please consult the official [upgrade guide](https://docs.cilium.io/en/stable/install/upgrade/) for more information. -By default, Cilium will drop all non-whitelisted packets upon policy +By default, Cilium will drop all disallowed packets upon policy deployment. The audit mode is scheduled for release in [Cilium 1.8](https://github.com/cilium/cilium/pull/9970). In the audit -mode, non-whitelisted packets will not be dropped, and audit +mode, disallowed packets will not be dropped, and audit notifications will be generated instead. GitLab provides alternative Docker images for Cilium with the audit patch included. You can switch to the custom build and enable the audit mode by adding the following to diff --git a/doc/user/markdown.md b/doc/user/markdown.md index 3bf7bd6c52c..0d028cfe77a 100644 --- a/doc/user/markdown.md +++ b/doc/user/markdown.md @@ -1109,6 +1109,11 @@ These details <em>will</em> remain <strong>hidden</strong> until expanded. Markdown inside these tags is supported as well. +NOTE: **Note:** +If your Markdown isn't rendering correctly, try adding +`{::options parse_block_html="true" /}` to the top of the page, and add +`markdown="span"` to the opening summary tag like this: `<summary markdown="span">`. + Remember to leave a blank line after the `</summary>` tag and before the `</details>` tag, as shown in the example: |