Giter Site home page Giter Site logo

sap-docs / btp-cloud-platform Goto Github PK

View Code? Open in Web Editor NEW
48.0 33.0 88.0 45.31 MB

Markdown source for the SAP BTP documentation. Enables feedback and contributions to improve the documentation.

License: Creative Commons Attribution 4.0 International

source-in-ditacms documentation sap open-documentation-initiative sap-btp

btp-cloud-platform's Introduction

REUSE status

Contributions to the SAP BTP Documentation

Found a mistake in our documentation? Always wanted to change some description or add a step in one of our procedures that could save many others much time? You're then at the right place! All contributions made to the Markdown files in the docs directory are reviewed, and if deemed valuable be added to our official documentation on SAP Help Portal. The easiest way is to start there, and choose Edit to find the right Markdown file to contribute to.

Requirements

For contributions, it's required that you have a GitHub account. For more information, see Signing up for a new GitHub account in the GitHub documentation.

Contributing

We recommend using the documentation of SAP Business Technology Platform (SAP BTP) on SAP Help Portal as a starting point for contributions:

  1. Open the SAP BTP Documentation.

  2. You can either:

    • Choose Feedback > Edit page to suggest a change for the current page you see in the Help Portal viewer, or
    • Choose Feedback > Create issue to open a GitHub issue in this repository.

    Choosing any of these options allows you start a conversation with us. We can clarify the proposed changes or issues and then update the documentation properly.

If you only make a small contribution, that's the quickest way to propose a change. For larger contributions, we recommend forking this repository to work locally. The filenames in the docs directory are created based on the title of the page on SAP Help Portal.

More information: Contribution Guidelines

Code of Conduct

Adhere to the SAP Open Source Code of Conduct to ensure a welcoming and open culture for everyone involved in contributions to SAP documentation.

Licensing

See our LICENSE for copyright and license information.

btp-cloud-platform's People

Contributors

anjanicolekretz avatar annawenger20 avatar clnative avatar danachkov avatar ditaccms-bot avatar ekaterina-mitova avatar fwilhe avatar gregorwolf avatar iwonahahn avatar je-hal avatar joysie avatar lilyanarangelova avatar mado0803 avatar mahatmafatalerror avatar mar-blu avatar marco-porru avatar martinstenzig avatar mgradl avatar michaelglaun avatar michaelpshea avatar nhingerl avatar nikolasimeonov77 avatar peteva avatar qmacro avatar santoshmadhusudhana avatar saraherdmann avatar sdanter avatar slavipande avatar thomaswiegandsap avatar yasminavanrooij avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

btp-cloud-platform's Issues

Feedback for "Org Management Using the SAP BTP Command Line Interface (btp CLI) [Feature Set B]"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/aee40e1afa56445a9bd57c2621d6eaaa.html

Hello, I found the API and the documentation to be confusing because it's not consistent with with the BTP Cockpit and its terminology. I expect that most users are like me, and start by learning the processes and terminology from BTP Cockpit to manually create and update configuration. When I started to implemented scripted processes, my first instinct was naturally to assume that the processes and vocabulary were the same as in the Cockpit. Where they are consistent - which is most of the time - it's quite intuitive. However, for the Cockpit process "Enable Cloud Foundry", the equivalent API (btp create accounts/environment-instance) is quite different in some key aspects - eg API: "display-name" "parameters{instance-name:}" BTP contradictory names: see screen shot attached

Screenshot Enable Cloud Foundry

IMHO it would be better to explicitly document the differences between API and Cockpit. I am sure this is extra work if the Cockpit and API are developed by different teams, but that's SAP's problem, not the user's.

Feedback for "Configure a Custom Identity Provider"

https://help.sap.com/docs/BTP/65de2977205c403bbc107264b8eccf4b/67bcc6e2d4d749659faf3ede1853f19e.html?locale=en-US&state=PRODUCTION&version=Cloud

In Results -> Caution there is a wrong redirect url: https://dashboard.kyma.cloud.sap/
It must be https://dashboard.kyma.cloud.sap (no final slash)

There is also a missing comma in this json:

"oidc": {
    "issuerURL": "{issuerURL}",
    "clientID": "{clientID}",
    "usernameClaim": "email",
    "groupsClaim": "groups",
    "signingAlgs": ["RS256"],
    "usernamePrefix": "-"
  }
  "administrators": ["user-admin1", ... ]

Feedback for "Developing Your First Application" - not correct rendered link

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/bc8d5c0598774f87a54cb63cb6abecc6.html?locale=en-US&version=Cloud

The link to the CAP starter scenario in the Markdown file is correct but however, gets broken by the rendering of the Help Portal โ†’ (https://help.sap.com/docs/link-disclaimer?site=https%3A%2F%2Fdevelopers.sap.com%2Fmission.cp-starter-extensions-cap.html). Not sure who is responsible and should have a look on it. (The second link is working, for the third one we are still in contact with @Joysie, cause the linked tutorials are no longer on developers.sap.com.)
2022-01-10_14-39-15

Best regards,
Iwona

Feedback for "Developing Java in the Cloud Foundry Environment"

Hi colleagues,
This guide
https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/a3f90069d6cd41da82f34a6123d82ce6.html --> components mentioned calculator V1 is by default
Memory Calculator V1 (SAP JVM Memory Calculator) - by default

But in guide Memory Calculator
https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/505a71ae53e84c7a972bb6c34b4316fb.html
V2 is marked as default:
Memory Calculator V2 - this memory calculator is activated by default.

May I know which version exactly is used by default in sap java buildpack?

Thanks,
Donny

Feedback for "Technical Communication with Tightly Coupled Developments"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/92d82380f45a45c4b157f92a61307da1.html?locale=en-US

cf create-service xsuaa application servb-uaa -c /appa/security/xs-security.json why do we use App A xs-security.json for servb-uaa?
Also several lines down:
cf create-service xsuaa application appa-uaa -c /servb/security/xs-security.json we're using Serv B xs-security.json for appa-uaa.
Looks inconsistent or it needs more clarifications.

Feedback for "Configure Entitlements and Quotas for Subaccounts"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/5ba357b4fa1e4de4b9fcc4ae771609da.html?locale=en-US&version=Cloud

This page does not help with the message that I got:
Unable to start application example: Cannot start application 'example'; there is no compute unit quota for subaccount 'hzahylnfp5'.
You can:

  1. Check the compute unit quotas of your subaccount
  2. Configure compute unit size for the application with parameter --size

Feedback for "Valid Redirect URIs for OAuth 2.0 Authorization Code Flow"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/4f28d335fa2543d7b24e27f7e8e399f7.html?locale=en-US

When the redirect URIs are not maintained, it obviously works after deployment of the MTA project.
In the past as soon as we maintained at least one redirect-uri it seemed to exclude the host on which it was deployed and only specifically allowed the URIs that were maintained. I now tested again maintaining a redirect-uri (in my case localhost for local development) and still the deployed version is working fine. So it seems that this configuration is not excluding any URI that does not match but it seems to allow the host of the deployed app as well as additionally the configured redirect URIs

Is this correct?

Feedback for "Regions and API Endpoints Available for the Cloud Foundry Environment"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/f344a57233d34199b2123b9620d0bb41.html?locale=en-US&version=Cloud

Hi,
when working in SAP CPI in region eu10, is it necessary to provide all listed NAT IPs to 3rd party service providers?
Some months ago through testing, we found that only 3 of all the 27 IPs are used for SAP CPI outgoing data transfer.
Is there an overview which NAT IPs belong to which BTP service or do you advise to always include all IPs regarding region eu10?

Kind regards
Stefan

Feedback for "Create Service Instances Using kubectl"

Doc Reference:

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/b53be623b96547cdb5545577b1804ba9.html
https://kubernetes.io/docs/concepts/extend-kubernetes/service-catalog/

While creating service instance under spec ServiceClassExternalName and ServicePlanExternalName needs to be replaced with clusterServiceClassExternalName and clusterServicePlanExternalName.

cat <<EOF | kubectl apply -f -
apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
name: {INSTANCE_NAME}
namespace: {YOUR_NAMESPACE}
spec:
clusterServiceClassExternalName: {SERVICE_NAME}
clusterServicePlanExternalName: {PLAN_NAME}
parameters:
param-1: value-1
param-2: value-2
EOF

SaaS registry issue : Not able to subscribe to multi-tenant application in the subscriber sub account

Description of erroneous behaviour
we are building a multi-tenant application using the guideline : https://cap.cloud.sap/docs/guides/deployment/as-saas

We have been advised by cap colleagues to raise SaaS registry issue.

the deployment went through , but subscription of the application fails with following error :
image

Detailed steps to reproduce:
For example (โ†’ replace by appropriate ones for your case):

  1. git clone https://github.com/danielsdevhub/AuthorReadings.git
    in the above git repo : https://github.com/danielsdevhub/AuthorReadings/tree/main/application/author-readings-mt-noui
  2. try deployment and registering to the service "author-readings" in subscriber sub-account.
    we get the following issue : Couldn't create the subscription to application 'author-readings'. Please view details for more information. Internal Server Error (500)

image
image

Feedback for "Regions and API Endpoints Available for the Cloud Foundry Environment"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/f344a57233d34199b2123b9620d0bb41.html?locale=en-US

Hi, I am worry for this content because sometimes the IP adressess in this document are updated, and people don't know when there are new ip adressess. So I think, could you put this information in a SAP Note? As you know, People can set a SAP Note as a favorite, and an email is sent each time the SAP note is updated. I think it would be very usefull.

But, if there is another way to get that kind of notification, please write me.

I'm lokking forward for yout response.

Kind Regards

Feedback for "Add Users from SAP ID Service for Multi-Environment Subaccounts"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/760ab77e5afd4c15ae70ec7ff59e02ef.html?version=Cloud
"Create users and assign role collections to users in Security > Users It's possible to create users in custom identity providers and in the SAP ID service. For more information, see Working with Users."

Do you really create users in the SAP ID service when you add a user in BTP cockpit on subaccount level? You do not provide user credentials (password) etc. It's "just" the mail address. AFAIK user can only register in SAP ID service through self service or through S-User creation; see also https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/ebe42f6900384c75bb7def32c011fa40.html?version=Cloud
Leveraging the mentioned way in BTP Cockpit - are you really creating user in SAP ID Service?

Thanks for clarification

Feedback for "Access a Kyma Instance Using kubectl"

Hello,

at the moment of raising this issue, the documentation section for accessing the Kyma cluster via kubectl (https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/3e25944e491049b2aeec68c562a5ee48.html) is out of sync with the live functionality provided in the SAP BTP Cockpit for at least the productive landscapes EU10 and trial.

The referred to link KubeconfigURL is not present and, thus, the described functionality is not accessible. For the moment, it is not obvious if the documentation is wrong or at least unclear or if the BTP Cockpit does not provide the functionality as described.

Best Regards,
Sebastian

btp_cockpit_kyma_kubeconfig_missing_report

Feedback for "Add Organization Members Using the Cloud Foundry Command Line Interface"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/1422a5daa53d498f9270727135005884.html?locale=en-US&version=Cloud

The parts mentioned in section "Context" is only applicable for customers on Feature Set A.
For customer having Feature Set B as long as user is registered in SAP ID Service, you can use "cf set-org-role USERNAME ORG ROLE --origin sap.ids" command. At least it worked for me. Would you please clarify in more detail.

Feedback for "Including SAP Systems in a Formation"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/68b04fa73aa740cb96ed380a85a4761a.html?locale=en-US&version=Cloud

This seems to be a new step in the help tutorial, since I don't recognize this since last visit in december. It would be awesome to know what this formation does more techincally. Could there be a section added to this?

And I am a bit worried this is chosen to be on global account level. I am SAP partner, working as external consultant for customers. Often we are not allowed to be assigned roles on global level, only subaccount. This troubles this setup, as the customer often would not know what to do and needs help. It seems complicating things having these things set on such high level.

Feedback for "Getting an Access Token for SAP Cloud Management Service APIs"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/3670474a58c24ac2b082e76cbbd9dc19.html

The "Prerequisites" section states

Your global account admin has entitled at least SAP ONE Service service plan from the SAP Cloud Management service in your subaccount. See SAP Cloud Management Service - Service Plans and Managing Entitlements and Quotas Using the Cockpit.

However, this service plan doesn't seem to exist and isn't mentioned in the referenced child page either: https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/a508b724bf6d457ca7ac024b8e4b8457.html

Feedback for "SAP Business Technology Platform"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/6a2c1ab5a31b4ed9a2ce17a5329e1dd8.html?locale=en-US

Hi, I tried to download PDF Version of SAP BTP documentation, but I didn't get any response. I see this URL when I chose the option Download PDF/Download PDF:

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/undefined/doc/bd6250c40c9c4c5391e3009a6f26dc3b/Cloud/en-US/SAP_Cloud_Platform.pdf

I could see these messages in my Browser console:

LAUNCH: local_sap_s: sap_s.referrer (1): undefined
launch-8b3c5ca29b9e.min.js:9 LAUNCH: local_sap_s: sap_s.referrer (2): https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/6a2c1ab5a31b4ed9a2ce17a5329e1dd8.html?locale=en-US
VM190:3 SWA RUNNING
VM193:2 LAUNCH: kaltura object listener attempt 1
VM193:2 LAUNCH: kaltura object listener attempt 2
VM193:2 LAUNCH: kaltura object listener attempt 3
VM193:2 LAUNCH: kaltura object listener attempt 4
VM193:2 LAUNCH: kaltura object listener attempt 5
VM193:2 LAUNCH: kaltura object listener attempt 6
VM193:2 LAUNCH: kaltura object listener attempt 7
VM193:2 LAUNCH: kaltura object listener attempt 8
VM193:2 LAUNCH: kaltura object listener attempt 9
VM193:2 LAUNCH: kaltura object listener attempt 10
VM193:2 LAUNCH: no kaltura widget detected

In the old version of the documentation it always worked, but currently it doesn't works...

Could you check it please?

Feedback for "Set Up an HTTP Destination"

https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/3884bc38209843ac900d92adb9c2a863.html?locale=en-US&version=Cloud

Instead of creating a destination from your own Destination service instance, you can configure destinations directly on subaccount level, in the subaccount in which the ABAP instance resides (recommended).

We should change this to

Instead of creating a destination from your own Destination service instance, you can configure destinations directly on subaccount level, in the subaccount in which the ABAP instance resides or for a SaaS solution in the consumer subaccount (recommended).

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.