Skip to content
Snippets Groups Projects
Commit 656831e1 authored by Stan Hu's avatar Stan Hu
Browse files

Remove Koding integration and documentation

This integration no longer works and does not appear to be supported.

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/39697
parent a5ecb5bb
No related branches found
No related tags found
1 merge request!10495Merge Requests - Assignee
Showing
with 0 additions and 156 deletions
doc/user/project/img/koding_build-logs.png

89.2 KiB

doc/user/project/img/koding_build-success.png

71.3 KiB

doc/user/project/img/koding_commit-koding.yml.png

84 KiB

doc/user/project/img/koding_different-stack-on-mr-try.png

91.2 KiB

doc/user/project/img/koding_edit-on-ide.png

88.5 KiB

doc/user/project/img/koding_enable-koding.png

19.8 KiB

doc/user/project/img/koding_landing.png

79.1 KiB

doc/user/project/img/koding_open-gitlab-from-koding.png

10.6 KiB

doc/user/project/img/koding_run-in-ide.png

21.7 KiB

doc/user/project/img/koding_run-mr-in-ide.png

91.6 KiB

doc/user/project/img/koding_set-up-ide.png

52.8 KiB

doc/user/project/img/koding_stack-import.png

134 KiB

doc/user/project/img/koding_start-build.png

27.3 KiB

# Koding integration
> **Notes:**
> - **As of GitLab 10.0, the Koding integration is deprecated and will be removed
> in a future version.**
> - [Introduced][ce-5909] in GitLab 8.11.
This document will guide you through using Koding integration on GitLab in
detail. For configuring and installing please follow the
[administrator guide](../../administration/integration/koding.md).
You can use Koding integration to run and develop your projects on GitLab. This
will allow you and the users to test your project without leaving the browser.
Koding handles projects as stacks which are basic recipes to define your
environment for your project. With this integration you can automatically
create a proper stack template for your projects. Currently auto-generated
stack templates are designed to work with AWS which requires a valid AWS
credential to be able to use these stacks. You can find more information about
stacks and the other providers that you can use on Koding following the
[Koding documentation][koding-docs].
## Enable Integration
You can enable Koding integration by providing the running Koding instance URL
in Application Settings under **Admin area > Settings** (`/admin/application_settings`).
![Enable Koding](img/koding_enable-koding.png)
Once enabled you will see `Koding` link on your sidebar which leads you to
Koding Landing page.
![Koding Landing](img/koding_landing.png)
You can navigate to running Koding instance from here. For more information and
details about configuring the integration, please follow the
[administrator guide](../../administration/integration/koding.md).
## Set up Koding on Projects
Once it's enabled, you will see some integration buttons on Project pages,
Merge Requests etc. To get started working on a specific project you first need
to create a `.koding.yml` file under your project root. You can easily do that
by using `Set Up Koding` button which will be visible on every project's
landing page;
![Set Up Koding](img/koding_set-up-ide.png)
Once you click this will open a New File page on GitLab with auto-generated
`.koding.yml` content based on your server and repository configuration.
![Commit .koding.yml](img/koding_commit-koding.yml.png)
## Run a project on Koding
If there is `.koding.yml` exists in your project root, you will see
`Run in IDE (Koding)` button in your project landing page. You can initiate the
process from here.
![Run on Koding](img/koding_run-in-ide.png)
This will open Koding defined in the settings in a new window and will start
importing the project's stack file.
![Import Stack](img/koding_stack-import.png)
You should see the details of your repository imported into your Koding
instance. Once it's completed it will lead you to the Stack Editor and from
there you can start using your new stack integrated with your project on your
GitLab instance. For details about what's next you can follow
[this guide](https://www.koding.com/docs/creating-an-aws-stack) from step 8.
Once stack initialized you will see the `README.md` content from your project
in `Stack Build` wizard, this wizard will let you build the stack and import
your project into it. **Once it's completed it will automatically open the
related vm instead of importing from scratch**.
![Stack Building](img/koding_start-build.png)
This will take time depending on the required environment.
![Stack Building in Progress](img/koding_build-in-progress.png)
It usually takes ~4 min. to make it ready with a `t2.nano` instance on given
AWS region. (`t2.nano` is default vm type on auto-generated stack template
which can be manually changed).
![Stack Building Success](img/koding_build-success.png)
You can check out the `Build Logs` from this success modal as well.
![Stack Build Logs](img/koding_build-logs.png)
You can now `Start Coding`!
![Edit On IDE](img/koding_edit-on-ide.png)
## Try a Merge Request on IDE
It's also possible to try a change on IDE before merging it. This flow only
enabled if the target project has `.koding.yml` in it's target branch. You
should see the alternative version of `Run in IDE (Koding)` button in merge
request pages as well;
![Run in IDE on MR](img/koding_run-mr-in-ide.png)
This will again take you to Koding with proper arguments passed, which will
allow Koding to modify the stack template provided by target branch. You can
see the difference;
![Different Branch for MR](img/koding_different-stack-on-mr-try.png)
The flow for the branch stack is also same with the regular project flow.
## Open GitLab from Koding
Since stacks generated with import flow defined in previous steps, they have
information about the repository they are belonging to. By using this
information you can access to related GitLab page from stacks on your sidebar
on Koding.
![Open GitLab from Koding](img/koding_open-gitlab-from-koding.png)
## Other links
- [YouTube video on GitLab + Koding workflow][youtube]
- [Koding documentation][koding-docs]
[ce-5909]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5909
[youtube]: https://youtu.be/3wei5yv_Ye8
[koding-docs]: https://www.koding.com/docs
Loading
Loading
@@ -68,7 +68,6 @@ Currently the following names are reserved as top level groups:
- import
- invites
- jwt
- koding
- notification_settings
- oauth
- profile
Loading
Loading
Loading
Loading
@@ -66,10 +66,6 @@ module API
optional :html_emails_enabled, type: Boolean, desc: 'By default GitLab sends emails in HTML and plain text formats so mail clients can choose what format to use. Disable this option if you only want to send emails in plain text format.'
optional :import_sources, type: Array[String], values: %w[github bitbucket gitlab google_code fogbugz git gitlab_project manifest],
desc: 'Enabled sources for code import during project creation. OmniAuth must be configured for GitHub, Bitbucket, and GitLab.com'
optional :koding_enabled, type: Boolean, desc: 'Enable Koding'
given koding_enabled: ->(val) { val } do
requires :koding_url, type: String, desc: 'The Koding team URL'
end
optional :max_artifacts_size, type: Integer, desc: "Set the maximum file size for each job's artifacts"
optional :max_attachment_size, type: Integer, desc: 'Maximum attachment size in MB'
optional :max_pages_size, type: Integer, desc: 'Maximum size of pages in MB'
Loading
Loading
Loading
Loading
@@ -18,7 +18,6 @@ module Gitlab
 
# Configuration files
gitignore: '.gitignore',
koding: '.koding.yml',
gitlab_ci: '.gitlab-ci.yml',
route_map: '.gitlab/route-map.yml',
 
Loading
Loading
Loading
Loading
@@ -39,7 +39,6 @@ module Gitlab
import
invites
jwt
koding
login
notification_settings
oauth
Loading
Loading
Loading
Loading
@@ -4410,12 +4410,6 @@ msgstr ""
msgid "June"
msgstr ""
 
msgid "Koding"
msgstr ""
msgid "Koding Dashboard"
msgstr ""
msgid "Kubernetes"
msgstr ""
 
Loading
Loading
@@ -6942,9 +6936,6 @@ msgstr ""
msgid "Set up CI/CD"
msgstr ""
 
msgid "Set up Koding"
msgstr ""
msgid "Set up a %{type} Runner manually"
msgstr ""
 
Loading
Loading
Loading
Loading
@@ -4266,12 +4266,6 @@ msgstr ""
msgid "June"
msgstr ""
 
msgid "Koding"
msgstr ""
msgid "Koding Dashboard"
msgstr ""
msgid "Kubernetes"
msgstr ""
 
Loading
Loading
@@ -6774,9 +6768,6 @@ msgstr ""
msgid "Set up CI/CD"
msgstr ""
 
msgid "Set up Koding"
msgstr "Настройка на „Koding“"
msgid "Set up a %{type} Runner manually"
msgstr ""
 
Loading
Loading
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment